vjrj
a5ba2cdcf1
El smoke-test contra prod revelo MongoDB 3.2.11 (EOL): el driver v6 exige >=4.2 y no conecta. Cambios: - mongodb ^3.7.4 + @types/mongodb; db.ts con useUnifiedTopology, sin retryWrites - sends.ts: deteccion de duplicate-key (11000) sin depender de MongoServerError - poller.ts: FilterQuery en vez de Filter - tests de integracion migrados de mongodb-memory-server a un fake en memoria (test/fake-repo.ts) porque no hay mongod 3.x ejecutable en hosts modernos; emula operadores ($ne/$in/$gte/$exists), $set/$unset e indice unico (11000) - docs: legacy-behavior.md §0 (entorno MongoDB 3.2, sin change streams -> fase 1b usara polling; recomendacion de upgrade de Mongo como fase propia) 47 tests en verde, typecheck y build OK. Datos reales del import: 413 pendientes FCM, 0 email, 8176 users con fireBaseToken.
75 lines
3.2 KiB
Markdown
75 lines
3.2 KiB
Markdown
# tcef-notifications
|
|
|
|
Microservicio de **envío de notificaciones** para *Todos contra el Fuego*
|
|
(alertas tempranas de incendios NASA FIRMS). Sustituye el envío de push que
|
|
hacía la web Meteor con la API legacy de GCM (apagada por Google en jun-2024) y
|
|
saca el envío del observer de Meteor a una cola controlada.
|
|
|
|
Fase **1a** del [plan de modernización](../plan-modernizacion/fase-1a-notif-workers.md):
|
|
solo **workers de envío**. Consume la colección `notifications` que hoy genera
|
|
node-red; el *matching* geoespacial (fase 1b) y Telegram (fase 1c) vienen
|
|
después.
|
|
|
|
## Qué hace
|
|
|
|
- **poller**: cada N s busca docs pendientes en `notifications` (con los nombres
|
|
de campo **correctos** — el cron viejo tenía un typo, ver
|
|
[`docs/legacy-behavior.md`](docs/legacy-behavior.md) §2) y encola un job por
|
|
canal.
|
|
- **fcm-worker**: envía push con `firebase-admin` (FCM HTTP v1), preservando el
|
|
payload que espera la app Flutter (`FLUTTER_NOTIFICATION_CLICK`, collapseKey =
|
|
`_id`, data). Purga tokens muertos sin reintentar.
|
|
- **email-worker**: `nodemailer` + las plantillas `new-fire` portadas verbatim.
|
|
- **idempotencia persistente**: colección `notification_sends`, índice único
|
|
`(notificationId, channel)` — sobrevive reinicios y replays de cola.
|
|
|
|
## Salvaguardas anti-spam
|
|
|
|
El riesgo nº1 es spamear a los usuarios. Por eso:
|
|
|
|
- **Modos graduales** `MODE`: `dry-run` → `shadow` → `canary` → `full`. Nunca se
|
|
salta un modo; `full` solo con confirmación explícita del usuario.
|
|
- **Exclusión mutua por canal**: `OWNED_CHANNELS` aquí + `notifDisabledChannels`
|
|
en Meteor. El viejo y el nuevo jamás envían por el mismo canal a la vez.
|
|
- **Kill switch**: `KILL_SWITCH=1` detiene todo envío al instante.
|
|
- **Límites**: máx envíos/usuario/día y circuit breaker por batch (para y
|
|
alerta).
|
|
|
|
Detalle del despliegue y la secuencia de cutover: [`docs/rollout.md`](docs/rollout.md).
|
|
|
|
## Desarrollo
|
|
|
|
```bash
|
|
npm ci
|
|
npm test # 47 tests (vitest + fake-repo en memoria, sin infra externa)
|
|
npm run typecheck
|
|
npm run build # -> dist/ (+ plantillas)
|
|
```
|
|
|
|
> **Nota MongoDB**: producción corre **MongoDB 3.2** (EOL), así que el servicio
|
|
> usa el driver `mongodb` **v3.7** (el moderno no conecta a 3.2) y no hay change
|
|
> streams (fase 1b usará polling). Los tests van contra un fake en memoria
|
|
> porque no hay mongod tan antiguo ejecutable en hosts modernos. Detalle en
|
|
> [`docs/legacy-behavior.md`](docs/legacy-behavior.md) §0.
|
|
|
|
## Ejecución
|
|
|
|
Config por env (ver [`.env.example`](.env.example)) o `config.json` (ver
|
|
`config.example.json`); env gana. Secretos (Mongo, `MAIL_URL`, service account
|
|
de Firebase) desde el repo privado `tcef-private-config` — nunca en este repo.
|
|
|
|
```bash
|
|
MODE=dry-run OWNED_CHANNELS=fcm MONGO_URL=... npm start
|
|
```
|
|
|
|
Despliegue en shiva: `deploy/tcef-notifications.service` (systemd) o
|
|
`deploy/pm2-tcef-notifications.json`. Node 22 standalone (no el Node 8 del
|
|
sistema) + Redis local. En fase 3 pasa a Docker Compose.
|
|
|
|
## Estado
|
|
|
|
- [x] Workers FCM v1 + email, poller, idempotencia, salvaguardas, tests.
|
|
- [x] Flag de cutover en Meteor (`notifDisabledChannels`).
|
|
- [ ] **Falta**: service account de Firebase (pedir al usuario) para poder
|
|
enviar push de verdad.
|
|
- [ ] Rollout en shiva (dry-run → shadow → canary → full), con el usuario.
|