# Shivao · Diário de Bordo

Aplicativo web para registro de viagens, manutenções e segurança de um veleiro
(em uso pelo veleiro **Shivao**), com recursos de GPS, vigia de fundeio com
alarme remoto, geofencing, sincronização na nuvem e notificações automáticas.

## Estrutura do projeto

```
shivao-projeto/
├── README.md           ← este arquivo (visão geral)
├── HANDOFF.md          ← estado atual + pendências para o time
├── DEPLOY.md           ← guia de deploy no Coolify (Hetzner VPS)
├── API.md              ← referência completa da API REST
├── ARCHITECTURE.md     ← decisões técnicas e fluxos
├── BACKLOG.md          ← melhorias futuras sugeridas
├── CONTRIBUTING.md     ← convenções, como rodar localmente
│
├── app/
│   └── diario-bordo.html    ← FRONTEND completo (HTML standalone, ~200 KB)
│
└── server/
    ├── Dockerfile           ← imagem Node 20 alpine
    ├── docker-compose.yml
    ├── package.json
    ├── .env.example         ← template de variáveis de ambiente
    ├── README.md            ← documentação focada no backend
    ├── public/
    │   └── index.html       ← cópia do frontend (servido pelo backend)
    └── src/
        ├── index.js         ← entrypoint Express
        ├── db.js            ← SQLite (better-sqlite3)
        └── notifications.js ← Telegram, ntfy, e-mail, Twilio, webhook
```

## Visão geral em 30 segundos

O **frontend** é um único arquivo HTML que funciona offline-first e pode ser
"instalado" no Android via "Adicionar à tela inicial" do Chrome. Armazena
tudo em **localStorage** (dados estruturados) e **IndexedDB** (mídias).

O **backend opcional** é um servidor Node.js com SQLite que provê:

- **Sincronização na nuvem** dos dados entre dispositivos
- **Dead-man switch**: se o app pára de mandar heartbeat enquanto fundeado,
  o servidor dispara o alarme sozinho
- **Notificações fan-out**: uma chamada de alarme do app → e-mail, Telegram,
  ntfy, SMS, WhatsApp para todos os contatos configurados
- **Compartilhamento público**: link temporário que mostra a posição do barco
  ao vivo num mapa para a tripulação em terra
- **Mídia**: upload e armazenamento de fotos/áudios/vídeos do app

## Funcionalidades implementadas

### Navegação e segurança
- ⛵ Registro de **travessias** com tripulação, datas, horímetro, vento, distância, observações
- 🛰 **Rastreio GPS** em tempo real com mapa Leaflet, distância em milhas náuticas, velocidade em nós
- ⚓ **Vigia de fundeio** com âncora + centro de giro independente, raio editável, auto-recentro,
  alarme sonoro (Web Audio) + vibração + tela vermelha em caso de deriva
- 🚧 **Geofencing** com zonas de proibição (alarme) e atenção (aviso), detecção em tempo real
- 📍 **Compartilhamento público** com URL temporária para a tripulação ver no mapa

### Manutenção
- 🔧 Registro de **reparos** com horímetro, custo, prestador, fotos, notas fiscais
- 📋 **Lista de pendências** com data prevista OU horímetro alvo, prioridades, custo estimado
- 🔔 **Alertas** automáticos quando manutenção está próxima ou atrasada
- 📋 **Checklists** customizáveis (segurança, motor, vela, fundeio, travessia longa)

### Mídia
- 📷 Foto da câmera (input com `capture`)
- 🎙 Áudio com gravador embutido (MediaRecorder)
- 🎥 Vídeo da câmera ou galeria
- Visualização em tela cheia, download, exclusão

### Tempo
- 🌬 **Windy Point Forecast API** (chave premium) para vento, ondas, temperatura
- 🌊 Fallback para Open-Meteo (grátis, sem chave)
- ⚡ **Modo economia de energia** que ajusta GPS conforme nível de bateria

### Cloud
- ☁️ Sync automático com servidor próprio
- 🔄 Webhooks diretos do app: Telegram, Discord, genérico
- 🚨 Dead-man switch via servidor
- 📤 Compartilhamento de posição em tempo real

### Import/export
- 📥 **Importar GPX** de chartplotter, Navionics, Garmin, etc.
- 📤 **Exportar GPX** de cada travessia
- 📦 Backup/restore JSON completo (com mídias em base64)
- 📊 Export CSV de viagens, manutenções, pendências
- 🖨 Imprimir/PDF

### UX
- Design **maritime editorial** (Fraunces serif itálico + Manrope + JetBrains Mono)
- Paleta pergaminho/marinha/latão envelhecido
- Mobile-first, instalável como PWA
- Suporte a viewport seguro (safe-area-inset)

## Próximo passo

Ver **HANDOFF.md** para o estado atual e o que falta para entrar em produção.

---

Projeto pessoal — uso interno do veleiro Shivao.