workspace/projects/erp-suite/docs/02-especificaciones-tecnicas/saas-platform/roadmap/ROADMAP-EPICAS-SAAS.md

Roadmap Épicas SaaS Platform - ERP Suite

Resumen Ejecutivo

Épica	SP	Sprints	Dependencias	Prioridad
EPIC-MGN-017 Stripe	34	22-24	MGN-016 Billing	P0 - Base
EPIC-MGN-021 AI Tokens	26	24-26	MGN-016, MGN-017	P0
EPIC-MGN-020 Onboarding	42	23-25	MGN-017, MGN-004	P0
EPIC-MGN-018 WhatsApp	55	25-28	MGN-017, MGN-001, MGN-021	P1
EPIC-MGN-019 Mobile Apps	89	29-36	MGN-001, APIs verticales	P1

Total Story Points: 246 SP Duración Estimada: 15 Sprints (Sprint 22-36)

---

Grafo de Dependencias

                    ┌─────────────────┐
                    │  MGN-016        │
                    │  Billing        │
                    │  (EXISTENTE)    │
                    └────────┬────────┘
                             │
                    ┌────────▼────────┐
                    │  MGN-017        │
                    │  Stripe         │◄──── PUNTO DE INICIO
                    │  34 SP          │
                    └────────┬────────┘
                             │
           ┌─────────────────┼─────────────────┐
           │                 │                 │
  ┌────────▼────────┐ ┌──────▼───────┐ ┌──────▼───────┐
  │  MGN-020        │ │  MGN-021     │ │  MGN-001     │
  │  Onboarding     │ │  AI Tokens   │ │  Auth        │
  │  42 SP          │ │  26 SP       │ │  (EXISTENTE) │
  └────────┬────────┘ └──────┬───────┘ └──────┬───────┘
           │                 │                 │
           │                 │                 │
           │          ┌──────▼───────┐         │
           │          │  MGN-018     │         │
           └─────────►│  WhatsApp    │◄────────┘
                      │  55 SP       │
                      └──────┬───────┘
                             │
                      ┌──────▼───────┐
                      │  MGN-019     │
                      │  Mobile Apps │
                      │  89 SP       │
                      └──────────────┘

---

Fase 1: Fundamentos de Cobro (Sprint 22-24)

EPIC-MGN-017: Stripe Integration

Objetivo: Establecer la infraestructura de cobros automatizados.

Sprint	Entregables	SP
22	US-001: Vincular cuenta Stripe	3
22	US-002: Agregar tarjeta de crédito	5
23	US-003: Crear suscripción al activar tenant	5
23	US-004: Actualizar cantidad de usuarios	5
24	US-005: Procesar webhooks	8
24	US-006: Manejar pagos fallidos	5
24	US-007: Portal de facturación	3

Criterios de Salida:

• Flujo completo de suscripción funcionando
• Webhooks procesando eventos en tiempo real
• Dunning (cobro de deuda) automatizado
• Tests de integración con Stripe Test Mode

Riesgos:

• Complejidad de webhooks de Stripe
• Manejo de edge cases en prorratas

---

Fase 2: Control de IA y Onboarding (Sprint 24-26)

EPIC-MGN-021: Control de Tokens IA

Objetivo: Sistema de medición y facturación de uso de IA.

Sprint	Entregables	SP
24	US-001: Registrar tokens por llamada	5
24	US-006: Configurar precios de tokens	3
25	US-002: Dashboard de consumo	3
25	US-003: Validar límites antes de ejecutar	5
25	US-004: Alertas de consumo alto	3
26	US-005: Calcular costo en factura	5
26	US-007: Comprar paquetes adicionales	3

Criterios de Salida:

• Tracking de tokens en tiempo real
• Límites por plan aplicados
• Alertas configurables funcionando
• Línea de tokens en facturas Stripe

EPIC-MGN-020: Onboarding (Sprint 23-25)

Objetivo: Gestión del proceso de implementación y cobro de servicios profesionales.

Sprint	Entregables	SP
23	US-001: Registrar prospecto	3
23	US-002: Levantamiento de requerimientos	5
24	US-003: Generar cotización	5
24	US-004: Aceptar y pagar anticipo	5
24	US-010: Crear tenant al aprobar	3
25	US-005: Checklist de configuración	5
25	US-006: Marcar tareas completadas	3
25	US-007: Documentar progreso	3
25	US-008: Cobrar pagos por hitos	5
25	US-009: Dashboard de proyectos	5

Criterios de Salida:

• Flujo completo de prospecto a tenant activo
• Templates de cotización por vertical
• Checklists de implementación
• Cobros parciales via Stripe

---

Fase 3: Comunicación con IA (Sprint 25-28)

EPIC-MGN-018: WhatsApp Business + Agente IA

Objetivo: Atención automatizada 24/7 via WhatsApp.

Sprint	Entregables	SP
25	US-001: Conectar número WhatsApp	5
25	US-002: Recibir mensajes via webhook	5
26	US-003: Identificar usuario por teléfono	3
26	US-004: Enviar mensajes de respuesta	5
26	US-011: Registrar tokens IA usados	3
27	US-005: Consultar información ERP	8
27	US-006: Crear registros via WA	8
28	US-007: Notificaciones proactivas	5
28	US-008: Historial de conversaciones	5
28	US-009: Escalar a humano	5
28	US-010: Métricas de uso	3

Criterios de Salida:

• Integración Meta Cloud API funcionando
• Agente IA procesando intents
• Validación de permisos por usuario
• Tokens contabilizados y facturados
• Escalamiento a humano funcionando

Riesgos:

• Políticas de Meta para WhatsApp Business
• Latencia en respuestas de IA
• Costo de tokens puede escalar rápido

---

Fase 4: Plataforma Móvil (Sprint 29-36)

EPIC-MGN-019: Apps Móviles por Perfil

Objetivo: Digitalizar operaciones en campo con apps especializadas.

Sub-Fase 4.1: Core + App Encargado Obra (Sprint 29-32)

Sprint	Entregables	SP
29	Core: Auth package	3
29	Core: API package	5
30	Core: Storage package (WatermelonDB)	5
30	Core: Sync package	5
31	Biometrics: Facial recognition	8
31	Biometrics: Fingerprint	5
32	Camera: Fotos geolocalizadas	5
32	Push: Notificaciones	3
32	App Encargado: UI específica	8

Entregable: App Encargado de Obra funcional (21 SP de features específicas + 37 SP core)

Sub-Fase 4.2: Apps Construcción (Sprint 33-34)

Sprint	Entregables	SP
33	App Almacén: Entradas/salidas	8
33	App Almacén: Inventario offline	5
34	App Derechohabiente: Estado vivienda	8
34	App Derechohabiente: Citas/documentos	5

Entregable: Apps Almacén y Derechohabiente funcionales

Sub-Fase 4.3: Apps Otras Verticales (Sprint 35-36)

Sprint	Entregables	SP
35	App Producción Vidrio	13
36	App Técnico Mecánicas	13

Entregable: Apps para Vidrio Templado y Mecánicas

Criterios de Salida Fase 4:

• 7 apps publicadas en App Store y Play Store
• Reconocimiento facial con liveness detection
• Modo offline completo
• Sincronización automática

---

Timeline Visual

Sprint:  22   23   24   25   26   27   28   29   30   31   32   33   34   35   36
         │    │    │    │    │    │    │    │    │    │    │    │    │    │    │
MGN-017  ████████████████
Stripe   [========34 SP========]
         │    │    │    │    │    │    │    │    │    │    │    │    │    │    │
MGN-021       │    ████████████████
AI Tokens     │    [=====26 SP=====]
         │    │    │    │    │    │    │    │    │    │    │    │    │    │    │
MGN-020       ██████████████████
Onboard  │    [=======42 SP=======]
         │    │    │    │    │    │    │    │    │    │    │    │    │    │    │
MGN-018                 ████████████████████████
WhatsApp                [=========55 SP=========]
         │    │    │    │    │    │    │    │    │    │    │    │    │    │    │
MGN-019                                          ████████████████████████████████
Mobile                                           [=============89 SP=============]
         │    │    │    │    │    │    │    │    │    │    │    │    │    │    │

---

Hitos Principales

Hito	Sprint	Entregable	Impacto de Negocio
H1	24	Cobros Stripe funcionando	Inicio de facturación automática
H2	25	Onboarding operativo	Venta de implementaciones
H3	26	Control de tokens IA	Monetización de IA
H4	28	WhatsApp + Agente IA	Atención 24/7
H5	32	Primera app móvil	Operación en campo
H6	36	Suite móvil completa	Digitalización total

---

Recursos Requeridos

Equipo Backend

• 2 desarrolladores senior (Stripe, WhatsApp integrations)
• 1 desarrollador mid (Token tracking, billing logic)

Equipo Frontend/Mobile

• 2 desarrolladores React Native senior
• 1 desarrollador mid (UI components)

DevOps

• 1 ingeniero (infraestructura, CI/CD para apps)

IA/ML

• 1 especialista en integraciones LLM

Total: 7-8 desarrolladores por 15 sprints

---

Métricas de Éxito

Métrica	Target Sprint 24	Target Sprint 28	Target Sprint 36
Tenants con Stripe activo	10	50	200
Revenue mensual suscripciones	$50K MXN	$200K MXN	$500K MXN
Implementaciones vendidas	5	20	50
Revenue implementaciones	$200K MXN	$800K MXN	$2M MXN
Conversaciones WA/día	-	100	1,000
Apps instaladas	-	-	500

---

Riesgos y Mitigaciones

Riesgo	Probabilidad	Impacto	Mitigación
Retrasos en aprobación de Meta WA Business	Media	Alto	Iniciar proceso de verificación en Sprint 24
Costos de IA mayores a proyectados	Media	Medio	Límites estrictos por plan, alertas tempranas
Complejidad de sincronización offline	Alta	Alto	Usar WatermelonDB probado, diseñar conflictos desde inicio
Rechazo en App Stores	Baja	Alto	Guidelines review pre-submit, beta testing
Stripe compliance en México	Baja	Alto	Consultar con Stripe México desde Sprint 22

---

Próximos Pasos Inmediatos

1. Sprint 22 - Semana 1:

   • Configurar cuenta Stripe Connect
   • Crear productos y precios en Stripe Dashboard
   • Implementar StripeService básico

2. Sprint 22 - Semana 2:

   • Endpoint de vinculación de Customer
   • Stripe Elements para tarjetas
   • Tests de integración

3. Paralelo:

   • Iniciar verificación WhatsApp Business con Meta
   • Setup de proyecto React Native monorepo

---

Creado por: Requirements-Analyst Fecha: 2025-12-05 Versión: 1.0