From 65dc4d10ae7fe6a7e79e29d5c9fb54f26ad40ee7 Mon Sep 17 00:00:00 2001 From: brobert Date: Sat, 25 Oct 2025 11:00:09 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20completar=20fases=200-2=20y=20actualiza?= =?UTF-8?q?r=20onboarding=20(5=E2=80=9310s,=20<14=20d=C3=ADgitos)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: aider (openrouter/openai/gpt-5) --- docs/plan-onboarding-comandos.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/plan-onboarding-comandos.md b/docs/plan-onboarding-comandos.md index e6118bf..5084162 100644 --- a/docs/plan-onboarding-comandos.md +++ b/docs/plan-onboarding-comandos.md @@ -25,7 +25,7 @@ Principios --- -## Fase 0 — Auditoría y decisiones de compatibilidad +## Fase 0 — Auditoría y decisiones de compatibilidad (Completada) Objetivos - Acordar defaults y compatibilidad de comandos. @@ -53,7 +53,7 @@ Criterios de aceptación --- -## Fase 1 — Alias y routing de comandos (sin onboarding aún) +## Fase 1 — Alias y routing de comandos (sin onboarding aún) (Completada) Objetivos - Añadir y mapear alias “info” → “ayuda”; “mias” → “ver mis”; “todas” → “ver todas”. @@ -77,12 +77,12 @@ Impacto en tests --- -## Fase 2 — Infra de Onboarding por DM en paquetes (2 DMs, migración mínima para interacción) +## Fase 2 — Infra de Onboarding por DM en paquetes (2 DMs, migración mínima para interacción) (Completada) Objetivos - Enviar un paquete de 2 DMs (Mensaje 1 + Mensaje 2) por usuario cuando se crea una tarea en un grupo. - Mensaje 1: CTA “/t tomar {CÓDIGO}” + “/t info”. - - Mensaje 2: mini‑chuleta (“/t mias”, “/t todas”, “/t configurar …”, “/t web”), 3–8 s después del Mensaje 1. + - Mensaje 2: mini‑chuleta (“/t mias”, “/t todas”, “/t configurar …”, “/t web”), 5–10 s después del Mensaje 1. - Repetir el mismo paquete una única vez más si pasan ≥ 14 días sin interacción del usuario (si hubo interacción, no se envía el segundo paquete). - Cap por evento; sin mensajes en grupos. @@ -99,12 +99,12 @@ Overview de cambios - ResponseQueue: - enqueueOnboarding(recipient, message, metadata) con metadata canónica: { kind: 'onboarding', variant: 'initial'|'reminder', part: 1|2, bundle_id, group_id, task_id, display_code }. - getOnboardingStats(recipient): { total, lastSentAt, lastVariant?: 'initial'|'reminder' } consultando response_queue por metadata.kind='onboarding'. - - Soportar programar el segundo DM del paquete con next_attempt_at = now + ONBOARDING_BUNDLE_DELAY_MS (por defecto 4000–8000ms). + - Soportar programar el segundo DM del paquete con un retraso aleatorio de 5000–10000ms. - CommandService (en /t nueva): - Tras crear la tarea en grupo, construir candidatos: - miembros activos del grupo (GroupSync.listActiveMemberIds), - excluir creador, asignados y el número del bot, - - filtrar por /^\d+$/, + - filtrar por dígitos puros con longitud < 14, - si GROUP_GATING_MODE=enforce y el grupo no está allowed → no enviar. - Cap por evento (ONBOARDING_EVENT_CAP, p. ej. 30). - Para cada destinatario: @@ -118,7 +118,7 @@ Copys de onboarding (exactos) - “Hola, soy el bot de tareas. En ‘{Grupo}’ acaban de crear una tarea: #{CÓDIGO} {descripción corta} Encárgate: /t tomar {CÓDIGO} · Más info: /t info Nota: nunca respondo en grupos; solo por privado.” -- Mensaje 2 (mini‑chuleta; se envía tras 3–8 s, en ambos disparos): +- Mensaje 2 (mini‑chuleta; se envía tras 5–10 s, en ambos disparos): - “Guía rápida (este es un mensaje único): · Tus tareas: /t mias · Todas: /t todas · Recordatorios: /t configurar diario | l‑v | semanal | off @@ -138,7 +138,7 @@ Notas sobre migraciones --- -## Fase 3 — Ajustes de ayuda (Help v2) y refuerzos en DMs operativos +## Fase 3 — Ajustes de ayuda (Help v2) y refuerzos en DMs operativos (No se implementará) Objetivos - Actualizar help rápido/completo con alias y nuevas recomendaciones. @@ -163,7 +163,7 @@ Impacto en tests --- -## Fase 4 — Métricas y flags de configuración +## Fase 4 — Métricas y flags de configuración (No se implementará) Objetivos - Medir adopción y salud del onboarding y de alias. @@ -199,7 +199,7 @@ Overview de cambios --- -## Fase 5 — Tests y validación end-to-end +## Fase 5 — Tests y validación end-to-end (No se implementará) Objetivos - Cubrir alias nuevos, cambios de routing, y lógica de onboarding. @@ -223,7 +223,7 @@ Objetivos --- -## Fase 6 — Despliegue y control +## Fase 6 — Despliegue y control (No se implementará) Objetivos - Desplegar con seguridad y capacidad de rollback. @@ -240,7 +240,7 @@ Checklist de despliegue --- -## Fase 7 — Consideraciones futuras (no bloqueantes) +## Fase 7 — Consideraciones futuras (no bloqueantes) (No se implementará) Ideas a evaluar después - “Bienvenida al primer DM inbound” (mensaje corto de bienvenida una única vez cuando el usuario inicia chat). @@ -291,7 +291,7 @@ Ideas a evaluar después 2) Onboarding — Mensaje 2 (reminder, único) - “Guía rápida (este es un mensaje único): · Tus tareas: /t mias · Todas: /t todas - · Recordatorios: /t configurar diario | l‑v | semanal + · Recordatorios: /t configurar diario | l‑v | semanal | off · Web: /t web” 3) Transición cuando se intenta listar desde grupo (responder por DM)