docs: actualizar documentación Evolution API y webhooks incrementales

Co-authored-by: aider (openrouter/openai/gpt-5) <aider@aider.chat>
pull/1/head
borja 2 months ago
parent e11978663d
commit b7b4f0aabe

@ -27,7 +27,7 @@ Un chatbot de WhatsApp para gestionar tareas en grupos, integrado con Evolution
- Recordatorios por DM (daily/weekly) por usuario; evita duplicados y respeta TZ.
- Cola de respuestas persistente con reintentos (backoff exponencial + jitter) y recuperación tras reinicios.
- Nombres amigables vía caché de contactos (sin llamadas de red en tests).
- Sincronización de miembros de grupos (snapshot periódica; tolerante a fallos en webhooks).
- Sincronización de miembros de grupos (snapshot periódica + webhooks incrementales; tolerante a fallos).
- Mensajes compactos con emojis y cursiva; fechas dd/MM; vencidas con ⚠️.
## Requisitos
@ -136,6 +136,7 @@ bun test
- Basic error handling (`server.test.ts`).
- WhatsApp ID normalization (`whatsapp.test.ts`).
- Group sync operations (`group-sync.test.ts`).
- Webhook handlers de membresías (alta/baja/cambio de rol) (`group-sync.*.test.ts`).
- **Needed:** Tests for `ensureUserExists` integration, `isGroupActive` integration, `CommandService` logic, `ResponseQueue` processing (mocking API), `TaskService` operations.
- All 170 unit tests passing. Added unit tests for CommandService (date parsing "hoy/mañana", DM help, dd/MM formatting, default assignment rules) y para RemindersService (daily/weekly, duplicados por día, hora/TZ, “… y X más”) y configuración de recordatorios.

@ -6,7 +6,7 @@ Estado general: listo para piloto con la junta directiva; 170 tests pasando. Rie
- Servidor webhook
- Endpoint /health, validación de entorno, extracción robusta de texto (conversation/extended/captions).
- Detección DM vs grupo y política “solo DM”.
- Registro/verificación de webhooks y sincronización de grupos activos con caché; sincronización periódica de miembros.
- Registro/verificación de webhooks y sincronización de grupos activos con caché; sincronización periódica de miembros y handlers incrementales (alta/baja/rol) idempotentes.
- Rate limiting por usuario (15/min por defecto; desactivado en tests; aviso con cooldown).
- Base de datos y migraciones
- Inicialización con PRAGMA FK y timestamps de alta precisión.
@ -86,4 +86,5 @@ Estado general: listo para piloto con la junta directiva; 170 tests pasando. Rie
- Recordatorios por DM (daily/weekly) con preferencias: completado.
- Rate limiting por usuario: completado.
- Ayuda por DM y formato de mensajes unificado: completado.
- Sincronización de miembros (full sync + webhooks incrementales): completado.
- Limpieza/retención de historiales de cola: completado.

@ -75,7 +75,7 @@ Este documento define el plan para implementar una sincronización robusta de mi
- Webhook y full sync preferiblemente en red interna; si no, proteger con allowlist/proxy.
## Plan por etapas
Etapa 1 — Esquema + servicio
Etapa 1 — Esquema + servicio — COMPLETADA
- Migración: crear groups y group_members + índices.
- Servicio GroupSync:
- syncGroups(): lista grupos + reconcilia miembros.
@ -85,7 +85,7 @@ Etapa 1 — Esquema + servicio
- Migración up-only.
- Reconciliación: de [A,B,C] a [A,C,D] → B inactivo, D añadido; tiempos/roles actualizados.
Etapa 2 — Integración con Evolution API
Etapa 2 — Integración con Evolution API — COMPLETADA
- Full sync: llamadas reales a endpoints (respetando paginación y límites).
- Webhooks: registro y handlers idempotentes (alta/baja/rol/rename).
- Tests:

Loading…
Cancel
Save