From 105b13a148a0e40102ec07a1712305163688e595 Mon Sep 17 00:00:00 2001 From: brobert Date: Fri, 17 Oct 2025 10:27:08 +0200 Subject: [PATCH] docs: reflejar fin de A2 y actualizar .env.example Co-authored-by: aider (openrouter/openai/gpt-5) --- .env.example | 1 + docs/plan-onboarding-usuarios.md | 5 ++++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/.env.example b/.env.example index 8809474..50e4aff 100644 --- a/.env.example +++ b/.env.example @@ -18,6 +18,7 @@ NODE_ENV="production" # production | development | test TZ="Europe/Madrid" # Zona horaria usada para "hoy/mañana" y render de fechas WEB_BASE_URL="https://taskbot.server.brobert.net" # Host público de la web (p.ej. https://wtask.org en producción) # DB_PATH="./data/tasks.db" # Si se define, ignora DATA_DIR y usa esta ruta exacta +ONBOARDING_FALLBACK_MIN_DIGITS=8 # A2: longitud mínima para conservar números en menciones/tokens; por defecto 8 # Sincronización de grupos (opcional) # Intervalo en milisegundos; por defecto 86400000 (24h). En desarrollo puede bajarse (mínimo recomendable 10000ms). diff --git a/docs/plan-onboarding-usuarios.md b/docs/plan-onboarding-usuarios.md index 6b942bc..50f3b76 100644 --- a/docs/plan-onboarding-usuarios.md +++ b/docs/plan-onboarding-usuarios.md @@ -38,11 +38,14 @@ Fase A1 — Aprendizaje “agresivo” al entrar en grupos (Completada) - Si el payload incluye id + jid, rellena alias automáticamente. - Mantener activo ContactsService.updateFromWebhook para capturar correlaciones adicionales en los primeros minutos. -Fase A2 — Ajuste clave sin fricción: conservar menciones con números +Fase A2 — Ajuste clave sin fricción: conservar menciones con números (Completada) +- Estado: completada (deploy tras commit 8b1af56). - En src/services/command.ts, al construir los candidatos a assignees: - Si normalizeWhatsAppId(token) produce dígitos y resolveAliasOrNull devuelve null, CONSERVAR ese número (no descartarlo). - Asegurar ensureUserExists para esos IDs conservados antes de usarlos. - Filtrar CHATBOT_PHONE_NUMBER para evitar autoasignaciones al bot. +- Métrica: se incrementa onboarding_assign_failures_total con labels {group_id, source, reason} cuando una mención/token no es resoluble ni plausible. +- Configuración: ONBOARDING_FALLBACK_MIN_DIGITS (por defecto 8) controla la longitud mínima para considerar un número “plausible”. - Efecto: reduce drásticamente los fallos de asignación por mención sin necesidad de DM. Fase A3 — Mensaje único por grupo con wa.me (solo si hace falta)