# 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
