5b02feae50
Importação inicial do projeto Shivão (Diário de Bordo do veleiro) em estado pronto pra produção, já incluindo as 5 mudanças de hardening implementadas pela squad shivao-melhoria em 2026-04-27. Mudanças de hardening (HANDOFF.md seção "✅ Pronto"): 1. **Rate limiting nos 3 endpoints públicos de share** - express-rate-limit ^8.4.1, 60 req/min/IP - server/src/index.js linhas 38, 262, 271, 279 2. **Tamanho de upload reduzido pra 50MB** (era 200MB) - multer linha 84 3. **Validação Zod nos endpoints autenticados** (POST /api/data e /zones) - novo arquivo server/src/schemas/index.js - middleware validate() retorna 400 com top 5 issues 4. **Audit log de ações sensíveis** - nova tabela audit_log + funções db.audit() e db.recentAudit() - 6 endpoints instrumentados (state_set, media_insert/delete, share_create/revoke/zones_update) - novo endpoint GET /api/audit (autenticado) 5. **Catch silencioso de webhook em zona PROIBIDA tratado** - app/diario-bordo.html + server/public/index.html linha 3280 - agora loga erro + exibe toast ao usuário Status final do HANDOFF: - 🔴 Críticos restantes: 1 (CORS — decisão consciente single-tenant, não-acionável) - 🟡 Importantes: 4 itens (testes, vigia reconnect, refator frontend, demais catches) - 🟢 Bom-ter: 5 itens Stack: Node 20 ESM + Express + better-sqlite3 + Docker (Coolify) Single-tenant pessoal · single-file frontend HTML · offline-first Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
105 lines
4.5 KiB
Markdown
105 lines
4.5 KiB
Markdown
# 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.
|