rckrdmrd 848324e8e8 [MCH-DOC] docs: Corregir estado real de épicas y crear roadmap

Cambios realizados:
- Corregido estado de 10 épicas que estaban mal documentadas
- MCH-010, MCH-011: Pendiente (submodulos vacíos, BLOQUEANTES)
- MCH-012, MCH-013: Pendiente (bloqueados por dependencias)
- MCH-006, MCH-007: Pendiente (sin implementación)
- MCH-022, MCH-026: Pendiente (sin implementación)
- MCH-024, MCH-027: Parcial/Mock (requieren integración real)

Documentos nuevos:
- ESTADO-REAL-EPICAS.md: Estado validado vs código
- ROADMAP-CORREGIDO.md: Plan de desarrollo respetando dependencias

Estadísticas reales:
- Completadas: 14 (40%)
- Parciales/Mock: 4 (11%)
- Pendientes: 10 (29%)
- Planificadas: 7 (20%)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-17 05:47:22 -06:00

12 KiB

Raw Blame History

Roadmap Corregido - MiChangarrito

Fecha: 2026-01-17 Versión: 1.0.0 Base: Estado real del código validado

Principios del Roadmap

Respetar dependencias - No iniciar épica si sus dependencias no están completas
Desbloquear primero - Priorizar épicas que desbloquean a otras
Mock → Producción - Completar integraciones mock antes de nuevas features
Core antes de expansión - Asegurar MVP funcional antes de features avanzadas

Grafo de Dependencias Críticas

                    ┌─────────────────────────────────────────────────────────────┐
                    │                    BLOQUEADORES CRÍTICOS                     │
                    │                                                              │
                    │   MCH-010 (MCP Server) ────► MCH-012, MCH-013, MCH-019       │
                    │          ❌ VACÍO                                            │
                    │                                                              │
                    │   MCH-011 (WhatsApp) ────► MCH-012, MCH-013, MCH-015, MCH-017│
                    │          ❌ VACÍO                                            │
                    │                                                              │
                    └─────────────────────────────────────────────────────────────┘

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  MCH-010    │────►│  MCH-012    │────►│  MCH-013    │────►│  MCH-015    │
│ MCP Server  │     │ Chat Dueño  │     │ Chat Cliente│     │ Pedidos WA  │
│   ❌ VACÍO  │     │  ❌ BLOQ    │     │  ❌ BLOQ    │     │  ❌ BLOQ    │
└─────────────┘     └─────────────┘     └─────────────┘     └──────┬──────┘
       │                   ▲                   ▲                    │
       │                   │                   │                    ▼
       │            ┌──────┴───────────────────┘             ┌─────────────┐
       │            │                                        │  MCH-016    │
       │     ┌─────────────┐                                 │  Entregas   │
       └────►│  MCH-011    │                                 │  ❌ BLOQ    │
             │  WhatsApp   │                                 └─────────────┘
             │   ❌ VACÍO  │
             └──────┬──────┘
                    │
                    ▼
             ┌─────────────┐
             │  MCH-017    │
             │Notificaciones│
             │  ⚠️ PARCIAL │
             └─────────────┘

Plan de Desarrollo Priorizado

SPRINT 0: Estabilización (Prerequisito)

Objetivo: Completar integraciones mock para tener MVP funcional

Prioridad	Épica	Estado Actual	Acción	Dependencias
P0.1	MCH-005	⚠️ Parcial	Agregar Mercado Pago	Ninguna
P0.2	MCH-020	⚠️ Parcial	Agregar OXXO	MCH-005

Entregables:

Integración Mercado Pago funcional
Pago con OXXO para suscripciones

SPRINT 1: Desbloqueo de IA (Crítico)

Objetivo: Implementar MCH-010 y MCH-011 que desbloquean 6 épicas

Prioridad	Épica	Bloquea	Esfuerzo	Dependencias
P1.1	MCH-010	3 épicas	2-3 sem	Ninguna
P1.2	MCH-011	4 épicas	2-3 sem	Ninguna

MCH-010 - MCP Server:

Tareas:
1. Inicializar submodulo mcp-server/
2. Configurar MCP SDK TypeScript
3. Implementar tools básicos:
   - buscar_producto
   - registrar_venta
   - consultar_stock
   - obtener_fiados
4. Implementar autenticación por tenant
5. Tests de integración

MCH-011 - WhatsApp Service:

Tareas:
1. Inicializar submodulo whatsapp-service/
2. Configurar Meta Cloud API
3. Implementar webhook de verificación
4. Implementar envío/recepción de mensajes
5. Detección de tipo de usuario
6. Tests de integración

Entregables:

MCP Server corriendo en puerto 3142
WhatsApp Service corriendo en puerto 3143
10+ tools MCP funcionales
Webhook WhatsApp operativo

SPRINT 2: Chat LLM (Desbloqueado por Sprint 1)

Objetivo: Implementar chat conversacional con IA

Prioridad	Épica	Dependencias	Esfuerzo
P2.1	MCH-012	MCH-010, MCH-011	1.5 sem
P2.2	MCH-013	MCH-012	1 sem

Dependencias verificadas:

✅ MCH-010 (MCP Server) - Sprint 1
✅ MCH-011 (WhatsApp) - Sprint 1

Entregables:

Dueño puede consultar vía WhatsApp
Cliente puede hacer pedidos vía WhatsApp
Tracking de tokens por conversación

SPRINT 3: Pedidos y Notificaciones

Objetivo: Completar flujo de pedidos y notificaciones

Prioridad	Épica	Dependencias	Esfuerzo
P3.1	MCH-017	MCH-011	1 sem
P3.2	MCH-015	MCH-011, MCH-013, MCH-014	1.5 sem
P3.3	MCH-016	MCH-015	1 sem

Dependencias verificadas:

✅ MCH-011 (WhatsApp) - Sprint 1
✅ MCH-013 (Chat Cliente) - Sprint 2
✅ MCH-014 (Clientes) - Ya completo

Entregables:

Push notifications funcionales
Flujo completo de pedidos vía WhatsApp
Sistema de entregas a domicilio

SPRINT 4: Inteligencia

Objetivo: Completar features de inteligencia artificial

Prioridad	Épica	Dependencias	Esfuerzo
P4.1	MCH-006	MCH-002, MCH-003	1.5 sem
P4.2	MCH-007	MCH-003	1 sem

Dependencias verificadas:

✅ MCH-002 (Auth) - Ya completo
✅ MCH-003 (Productos) - Ya completo

Entregables:

Onboarding inteligente vía WhatsApp
500+ templates de proveedores cargados

SPRINT 5: Integraciones Reales

Objetivo: Reemplazar mocks por integraciones reales

Prioridad	Épica	Estado Actual	Esfuerzo
P5.1	MCH-024	Mock	2 sem
P5.2	MCH-027	Mock	2-3 sem

MCH-024 - CoDi/SPEI Real:

Tareas:
1. Contrato con STP/Arcus para CLABE virtual
2. Certificación con Banxico para CoDi
3. Implementar generación real de QR
4. Implementar webhook de confirmación
5. Tests con dinero real (sandbox)

MCH-027 - SAT Real:

Tareas:
1. Contrato con PAC (Facturapi recomendado)
2. Obtener credenciales sandbox
3. Implementar generación de XML CFDI
4. Implementar timbrado real
5. Generación de PDF con formato SAT
6. Tests de timbrado en sandbox

SPRINT 6: Mobile y Offline

Objetivo: Implementar aplicación móvil

Prioridad	Épica	Dependencias	Esfuerzo
P6.1	MCH-022	MCH-004	3-4 sem
P6.2	MCH-025	MCH-004	1 sem
P6.3	MCH-026	Ninguna	1 sem

MCH-022 - Modo Offline:

Tareas:
1. Inicializar submodulo mobile/ con Expo
2. Configurar SQLite local
3. Implementar sync de productos
4. Registro offline de ventas
5. Cola de sincronización
6. Resolución de conflictos

SPRINT 7+: Enterprise Features

Objetivo: Features empresariales avanzados

Épica	Dependencias	Esfuerzo
MCH-029	Ninguna	2-3 sem
MCH-030	MCH-029	1 sem
MCH-031	Ninguna	1 sem
MCH-032	MCH-029, MCH-018	1 sem
MCH-033	MCH-029	1 sem
MCH-034	MCH-031, MCH-021	2 sem
MCH-035	MCH-034, MCH-021	2 sem

Orden de Ejecución Validado

Secuencia Correcta (Respetando Dependencias)

FASE 1: Ya Completa
├── MCH-001 ✅
├── MCH-002 ✅
├── MCH-003 ✅
├── MCH-004 ✅
└── MCH-008 ✅

FASE 2: Sprint 0 (Estabilización)
├── MCH-005 → Completar Mercado Pago
└── MCH-020 → Completar OXXO

FASE 3: Sprint 1 (Desbloqueo Crítico)
├── MCH-010 → MCP Server (NUEVO)
└── MCH-011 → WhatsApp Service (NUEVO)

FASE 4: Sprint 2 (Desbloqueado)
├── MCH-012 → Chat Dueño (requiere 010, 011)
└── MCH-013 → Chat Cliente (requiere 012)

FASE 5: Sprint 3 (Desbloqueado)
├── MCH-017 → Notificaciones (requiere 011)
├── MCH-015 → Pedidos WhatsApp (requiere 011, 013, 014)
└── MCH-016 → Entregas (requiere 015)

FASE 6: Sprint 4 (Independiente)
├── MCH-006 → Onboarding Inteligente
└── MCH-007 → Templates

FASE 7: Sprint 5 (Integraciones)
├── MCH-024 → CoDi/SPEI Real
└── MCH-027 → SAT Real

FASE 8: Sprint 6 (Mobile)
├── MCH-022 → Modo Offline
├── MCH-025 → Widgets
└── MCH-026 → Multi-idioma

FASE 9: Sprint 7+ (Enterprise)
├── MCH-029 → Infra SaaS
├── MCH-030 → OAuth (requiere 029)
├── MCH-031 → Auditoría
├── MCH-032 → Feature Flags (requiere 029, 018)
├── MCH-033 → Onboarding Wizard (requiere 029)
├── MCH-034 → Analytics (requiere 031, 021)
└── MCH-035 → Reportes (requiere 034, 021)

Validación de Dependencias

Verificación Pre-Sprint

Antes de iniciar cada sprint, verificar:

# Sprint 1 - Sin dependencias previas
✅ Puede iniciar inmediatamente

# Sprint 2 - Requiere Sprint 1
□ MCH-010 (MCP Server) funcional
□ MCH-011 (WhatsApp) funcional

# Sprint 3 - Requiere Sprint 2
□ MCH-012 (Chat Dueño) funcional
□ MCH-013 (Chat Cliente) funcional

# Sprint 4 - Sin dependencias de sprints anteriores
✅ Puede ejecutarse en paralelo con Sprint 2-3

# Sprint 5 - Sin dependencias de sprints anteriores
✅ Puede ejecutarse en paralelo con Sprint 3-4

# Sprint 6 - Sin dependencias de sprints anteriores
✅ Puede ejecutarse en paralelo

Épicas que Pueden Ejecutarse en Paralelo

Grupo A	Grupo B	Grupo C
MCH-010	MCH-006	MCH-024
MCH-011	MCH-007	MCH-027
		MCH-022

Nota: Los grupos pueden ejecutarse en paralelo entre sí, pero dentro de cada grupo puede haber dependencias internas.

Timeline Estimado

Semana  1  2  3  4  5  6  7  8  9  10 11 12 13 14 15 16
        |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
Sprint0 ██                                              (Estabilización)
Sprint1    ██████                                       (MCP + WhatsApp)
Sprint2          █████                                  (Chat LLM)
Sprint3                █████                            (Pedidos)
Sprint4 ─────────────────────██████                     (Paralelo: Inteligencia)
Sprint5 ─────────────────────────────██████             (Paralelo: Integraciones)
Sprint6                                     ████████    (Mobile)

TOTAL: 16 semanas para MVP completo con IA

Criterios de Completitud por Sprint

Sprint 1 Completo Cuando:

npm run build pasa en mcp-server/
npm run build pasa en whatsapp-service/
10+ tools MCP responden correctamente
Webhook WhatsApp recibe mensajes
Tests de integración pasan

Sprint 2 Completo Cuando:

Dueño puede preguntar "¿Cuánto vendí hoy?" y recibir respuesta
Cliente puede preguntar "¿Tienen refrescos?" y recibir respuesta
Tokens se consumen correctamente por conversación

Sprint 3 Completo Cuando:

Push notification llega al dispositivo
Pedido vía WhatsApp se registra en BD
Flujo pedido → confirmación → entrega funciona

Generado por: Planificación SIMCO 4.0.1 Última actualización: 2026-01-17

12 KiB Raw Blame History

Roadmap Corregido - MiChangarrito

Principios del Roadmap

Grafo de Dependencias Críticas

Plan de Desarrollo Priorizado

SPRINT 0: Estabilización (Prerequisito)

SPRINT 1: Desbloqueo de IA (Crítico)

SPRINT 2: Chat LLM (Desbloqueado por Sprint 1)

SPRINT 3: Pedidos y Notificaciones

SPRINT 4: Inteligencia

SPRINT 5: Integraciones Reales

SPRINT 6: Mobile y Offline

SPRINT 7+: Enterprise Features

Orden de Ejecución Validado

Secuencia Correcta (Respetando Dependencias)

Validación de Dependencias

Verificación Pre-Sprint

Épicas que Pueden Ejecutarse en Paralelo

Timeline Estimado

Criterios de Completitud por Sprint

Sprint 1 Completo Cuando:

Sprint 2 Completo Cuando:

Sprint 3 Completo Cuando:

12 KiB

Raw Blame History