monitora.flow — Meu trajeto

Coletor + banco + API + app (PWA) com dados abertos do Rio de Janeiro: GPS dos BRTs e ônibus (SMTR), chuva medida (Alerta Rio), previsão (Open-Meteo) e geocodificação (IPP). A API também serve o MOVA.

⚠️ A velocidade é a dos ônibus/BRTs, um indicador indireto. Não é a velocidade dos carros nem a contagem de veículos da via. A chegada do ônibus é uma estimativa experimental nossa, não um horário oficial.

• Fontes testadas, licenças e o que ficou de fora: docs/FONTES.md
• Fórmulas, escolhas experimentais e limitações: docs/METODOLOGIA.md
• Campos do banco e da API: docs/DICIONARIO.md · OpenAPI em GET /openapi
• Parâmetros: src/lib/parametros.ts · Pontos monitorados: src/config/pontos.ts

Arquitetura

GitHub Actions (cron */10, UTC)
   └─► POST /api/coletar (Vercel, com Bearer CRON_SECRET)
                                                 │ GPS BRT + SPPO: valida (zod), descarta placa, filtra
                                                 ▼
                                Postgres Neon (projeto monitora-flow, us-east-1)
                                ├─ posicoes   observado, 60 min
                                ├─ agregados  calculado, ponto × fonte × 5 min, 183 dias
                                └─ coletas    log
                                                 ▲
App "Meu trajeto" (/) e MOVA ──► /agora /historico /habitual /linhas/{l}/veiculos /chegada
                                 /chuva /tempo /geocodificar /paradas /ocorrencias /pontos /openapi
                                 (chuva, tempo e geocodificação são repassados ao vivo, com cache)

App "Meu trajeto" (/)

PWA instalável, mobile-first, claro/escuro. Trajetos favoritos ficam só no aparelho (localStorage), sem cadastro. Blocos: 🚌 chegada da linha · 🚗 velocidade dos ônibus no local e comparação com o habitual · 🌧️ chuva medida e previsão · ⚠️ ocorrências (sem fonte aberta ainda) · 🗺️ mapa MapLibre/OpenStreetMap com os ônibus da linha e os pluviômetros.

Rodar localmente

npm install
cp .env.example .env.local   # DATABASE_URL e CRON_SECRET
npm run db:migrar            # cria as tabelas
npm run coletar              # uma coleta manual
npm run dev                  # http://localhost:3000
npm test                     # testes com fixtures reais

Implantação atual

• Banco: Neon, projeto monitora-flow (us-east-1). Esquema em db/schema.sql.
• Web/API: Vercel, região iad1 (mesma do banco, ver vercel.json), com DATABASE_URL e CRON_SECRET nas variáveis do projeto.
• Agendador: .github/workflows/coletar.yml (GitHub Actions, */10 * * * *), com os secrets COLETOR_URL e CRON_SECRET.
• Alternativa guardada: functions/disparador.ts (Neon Function + Function Trigger). Foi trocada pelo GitHub porque o painel do Neon não permite definir o CRON_SECRET da função sem passar o segredo pela API.