ROADMAP-05 / PHASED_EXECUTION_PLAN / ESTIMADO 4-5 SEMANAS

Plan de Desarrollo Secuencial y Cronograma de Entregas

Estrategia de construcción iterativa que minimiza el riesgo técnico validando primero la integración con Kapso mediante un Spike, antes de construir el frontend y la API transaccional.

Cronograma Visual de Fases & Hitos

Vista ejecutiva del tiempo estimado de desarrollo por módulos

5 Semanas MVP

Fase / Módulo

Sem 1 Sem 2 Sem 3 Sem 4 Sem 5

F0 Spike Técnico Kapso

48 Horas

F1 Core Innovia & DB

Semana 1

F2 Campañas & CSV

Semana 2

F3 Tracking & Métricas

Semana 3

F4 API Pública /v1

Semana 4

F5 Validación Piloto

Go-To-Market

Diagrama Gantt Técnico

Secuencia temporal con dependencias críticas entre tareas

100%

Gantt

gantt title Cronograma Innovia Messaging MVP dateFormat YYYY-MM-DD section Fase 0: Spike Validación API Kapso & Webhooks :done, f0_1, 2026-09-17, 3d Reporte Técnico de Decisión :done, f0_2, after f0_1, 1d section Fase 1: Core Innovia Scaffolding & PostgreSQL Schema :active, f1_1, after f0_2, 3d Auth, Multi-tenancy & Adapters :active, f1_2, after f1_1, 4d section Fase 2: Campañas Sincronización Templates & CSV :f2_1, after f1_2, 4d Orquestador Broadcasts & BullMQ :f2_2, after f2_1, 3d section Fase 3: Tracking Webhooks Normalizer & Rollup :f3_1, after f2_2, 4d Dashboard UI Métricas en Vivo :f3_2, after f3_1, 3d section Fase 4: API Pública API Keys & Endpoint /v1/messages :f4_1, after f3_2, 4d Rate Limiting & Webhooks Salientes:f4_2, after f4_1, 3d section Fase 5: Validación Piloto con 1er Cliente Real :f5_1, after f4_2, 7d

Detalle de Tareas Técnicas y Definición de Terminado (DoD)

Fase 0 — Spike Técnico

Días 1 a 3

Ejecución de llamadas REST directas a Kapso: Customer, Setup Link, conexión de línea de prueba, envío de 1 plantilla y recepción de webhooks en un túnel local.

Criterio de Aceptación (DoD): Línea conectada mediante Embedded Signup, mensaje recibido en dispositivo real y webhooks de entrega analizados.

Fase 1 — Core de Innovia & Capa de Proveedor

Semana 1

Base de datos PostgreSQL, autenticación de usuarios, multi-tenancy estricto, implementación de la interfaz `MessagingProvider` y la clase concreta `KapsoAdapter`.

Criterio de Aceptación (DoD): Dos clientes registrados independientemente pueden solicitar un Setup Link y ver sus líneas de forma totalmente aislada.

Fase 2 — Campaign Manager

Semana 2

Catálogo local de templates Meta, procesador de archivos CSV con validación de teléfonos E.164, mapeo dinámico de variables por destinatario y encolador diferido (BullMQ/Redis).

Criterio de Aceptación (DoD): Subir audiencia de prueba, programar envío masivo y verificar ejecución exitosa del Broadcast a la hora pactada.

Fase 3 — Tracking & Métricas Agregadas

Semana 3

Normalizador de webhooks entrantes, persistencia de auditoría de eventos y acumulador en tiempo real de métricas (Enviados, Entregados, Leídos, Fallidos).

Criterio de Aceptación (DoD): Visualizar en el panel web el embudo de efectividad de campaña actualizándose automáticamente sin refrescar la página.

Fase 4 — Messaging API Pública

Semana 4

Gestión de credenciales API Key (`inn_live_...`), endpoints transaccionales `POST /v1/messages`, rate limiting y webhooks salientes hacia URLs de clientes.

Criterio de Aceptación (DoD): Un sistema externo envía notificaciones transaccionales vía API y recibe el webhook de confirmación en su propio servidor.