Diário de bordo digital do veleiro Shivão (HTML standalone + Node/Express + SQLite)
Find a file
PontualTech / Karlão 5a64e0897f
Some checks failed
Build Android (APK + AAB) / build-android (push) Has been cancelled
feat(iot): controle Smart Life/Tuya — Casa do Barco v1.12.0
Servidor (proxy assinado):
- server/src/tuya.js: cliente Tuya OpenAPI com HMAC-SHA256 + token cache
  (2h TTL, retry 1x em token expirado), helpers categoryLabel
- 3 endpoints novos em server/src/index.js (todos requireAuth):
  * GET  /api/iot/devices              → lista devices da conta Smart Life
  * GET  /api/iot/status/:deviceId     → DPs (data points) atuais
  * POST /api/iot/command/:deviceId    → envia comandos {code,value}
- Audit log via db.audit('iot_command', ...) pra histórico de toggles
- 503 graceful quando TUYA_ACCESS_ID/SECRET ausentes

Client (UI):
- Card 🏠 Casa do Barco em Arquivo (após Bluetooth, antes Raymarine)
- Modal "Adicionar dispositivo" lista devices da conta Smart Life,
  permite escolher quais aparecem no Shivão (multi-select via toque)
- Cards por device com ícone por categoria (cz=tomada, dj=lâmpada,
  fs=ventilador, kt=ar-cond, sd=robô, etc.) + toggle ON/OFF + status
  online/offline + tempo desde último ping
- Toggle optimistic UI: marca novo estado imediato, reverte se falhar
- Polling 10s pra sync de status, pausa em background (economiza
  Starlink + bateria)
- Backoff: 3 falhas consec → marca offline, retry 30s
- state.smartDevices[] persistido no localStorage (mesmo padrão btDevices)

Setup (admin, 1x):
- Karlão precisa criar projeto em iot.tuya.com (5 min, gratuito) e
  adicionar TUYA_ACCESS_ID + TUYA_ACCESS_SECRET no env Coolify
- Documentação completa no .env.example com passo a passo
- Sem credenciais: card mostra "⚙ Tuya não configurado"

Bumps:
- APP_VERSION 1.11.0 → 1.12.0
- sw.js VERSION shivao-v1.11.0 → shivao-v1.12.0
- mobile/package.json + build.gradle (versionCode 32→33)
- LATEST_APK_URL atualizado pro release v1.12.0

Fix gitignore:
- .env.example em pastas nested (server/.env.example) estava bloqueado
  por **/.env.* — adicionado !**/.env.example pra liberar.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 18:34:02 -03:00
.forgejo/workflows docs(ci): SETUP-RUNNER.md com token pré-gerado + instruções 5min 2026-04-28 05:26:57 -03:00
app feat(iot): controle Smart Life/Tuya — Casa do Barco v1.12.0 2026-05-10 18:34:02 -03:00
mobile feat(iot): controle Smart Life/Tuya — Casa do Barco v1.12.0 2026-05-10 18:34:02 -03:00
scripts feat(mobile): scaffold Capacitor pra Android Play Store + adapter nativo 2026-04-27 16:02:34 -03:00
server feat(iot): controle Smart Life/Tuya — Casa do Barco v1.12.0 2026-05-10 18:34:02 -03:00
.gitignore feat(iot): controle Smart Life/Tuya — Casa do Barco v1.12.0 2026-05-10 18:34:02 -03:00
API.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00
ARCHITECTURE.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00
BACKLOG.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00
CONTRIBUTING.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00
DEPLOY.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00
HANDOFF.md feat(reliability): vigia reconnect (Wake Lock release + GPS retry exponencial) 2026-04-27 13:28:09 -03:00
PROJECT_CONTEXT.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00
README.md chore: initial commit + security hardening (4 runs squad shivao-melhoria) 2026-04-27 13:24:08 -03:00

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.