michangarrito/docs/_definitions/ESTADO-REAL-EPICAS.md
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

255 lines
8.8 KiB
Markdown

# Estado Real de Épicas - MiChangarrito
**Fecha:** 2026-01-17
**Versión:** 1.0.0
**Tipo:** Corrección de Estado
**Validación:** Comparación directa con código fuente
---
## Resumen de Correcciones
Este documento corrige el estado documentado de las épicas para reflejar la realidad del código implementado.
### Estadísticas Corregidas
| Estado | Documentado | Real | Diferencia |
|--------|-------------|------|------------|
| Completado | 24 | 14 | -10 |
| Parcial (Mock/Base) | 0 | 4 | +4 |
| Pendiente | 4 | 10 | +6 |
| Planificado | 7 | 7 | 0 |
---
## Matriz de Estado: Documentado vs Real
### Leyenda de Estados
-**COMPLETO** - Funcionalidad implementada y operativa
- ⚠️ **PARCIAL** - Implementación base/mock, requiere integración
- 🔶 **ESTRUCTURA** - Solo entities/módulos, sin lógica de negocio
-**PENDIENTE** - No implementado
- 📋 **PLANIFICADO** - En roadmap futuro
### FASE 1: MVP CORE
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-001 | Completado | ✅ COMPLETO | Backend + DB | Infraestructura funcional |
| MCH-002 | Completado | ✅ COMPLETO | auth.module | JWT, PIN, Guards |
| MCH-003 | Completado | ✅ COMPLETO | products.module | CRUD completo |
| MCH-004 | Completado | ✅ COMPLETO | sales.module | POS funcional |
| MCH-005 | Completado | ⚠️ PARCIAL | payments.module | Solo Stripe, falta MP/Clip |
### FASE 2: INTELIGENCIA
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-006 | Completado | ❌ PENDIENTE | - | Sin onboarding inteligente |
| MCH-007 | Completado | ❌ PENDIENTE | - | Sin templates cargados |
| MCH-008 | Completado | ✅ COMPLETO | customers.module | Fiados funcional |
| MCH-009 | Completado | ⚠️ PARCIAL | inventory.module | Alertas básicas |
### FASE 3: ASISTENTE IA ⛔ CRÍTICO
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-010 | Completado | ❌ PENDIENTE | mcp-server/ VACÍO | **BLOQUEANTE** |
| MCH-011 | Completado | ❌ PENDIENTE | whatsapp-service/ VACÍO | **BLOQUEANTE** |
| MCH-012 | Completado | ❌ PENDIENTE | - | Depende de 010/011 |
| MCH-013 | Completado | ❌ PENDIENTE | - | Depende de 010/011 |
### FASE 4: PEDIDOS Y CLIENTES
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-014 | Completado | ✅ COMPLETO | customers.module | Clientes funcional |
| MCH-015 | Pendiente | ❌ PENDIENTE | orders.module | Backend existe, sin WhatsApp |
| MCH-016 | Pendiente | ❌ PENDIENTE | - | Depende de 015 |
| MCH-017 | Pendiente | ⚠️ PARCIAL | messaging.module | Módulo existe, sin push |
### FASE 5: MONETIZACIÓN
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-018 | Completado | ✅ COMPLETO | subscriptions.module | Planes Stripe |
| MCH-019 | Pendiente | ✅ COMPLETO | subscriptions.module | Tokens funcional |
| MCH-020 | Completado | ⚠️ PARCIAL | billing.module | Solo Stripe, falta OXXO/IAP |
| MCH-021 | Completado | ✅ COMPLETO | frontend/pages | Dashboard web |
### FASE 6: CRECIMIENTO
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-022 | Completado | ❌ PENDIENTE | mobile/ VACÍO | Sin app móvil |
| MCH-023 | Completado | ✅ COMPLETO | referrals.module | Referidos funcional |
| MCH-024 | Completado | ⚠️ PARCIAL | codi-spei.module | **MOCK** - Sin Banxico |
| MCH-025 | Pendiente | 🔶 ESTRUCTURA | widgets.module | Solo estructura |
### FASE 7: EXPANSIÓN
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-026 | Completado | ❌ PENDIENTE | - | Sin i18n implementado |
| MCH-027 | Completado | ⚠️ PARCIAL | invoices.module | **MOCK** - Sin PAC |
| MCH-028 | Completado | ✅ COMPLETO | marketplace.module | Marketplace funcional |
### FASE 8: ENTERPRISE
| Épica | Documentado | Real | Código | Notas |
|-------|-------------|------|--------|-------|
| MCH-029 | Planificado | 📋 PLANIFICADO | - | SaaS avanzado |
| MCH-030 | Planificado | 📋 PLANIFICADO | - | OAuth social |
| MCH-031 | Planificado | 📋 PLANIFICADO | - | Auditoría |
| MCH-032 | Planificado | 📋 PLANIFICADO | - | Feature flags |
| MCH-033 | Planificado | 📋 PLANIFICADO | - | Onboarding wizard |
| MCH-034 | Planificado | 📋 PLANIFICADO | - | Analytics |
| MCH-035 | Planificado | 📋 PLANIFICADO | - | Reportes |
---
## Dependencias Rotas ⛔
### Cadena Crítica: Asistente IA
```
MCH-010 (MCP Server) ❌ VACÍO
├──► MCH-012 (Chat Dueño) ❌ NO PUEDE FUNCIONAR
│ │
│ └──► MCH-013 (Chat Cliente) ❌ NO PUEDE FUNCIONAR
└──► MCH-019 (Tokens) ✅ FUNCIONA SIN MCP (Stripe directo)
MCH-011 (WhatsApp) ❌ VACÍO
├──► MCH-012 (Chat Dueño) ❌ NO PUEDE FUNCIONAR
├──► MCH-013 (Chat Cliente) ❌ NO PUEDE FUNCIONAR
├──► MCH-015 (Pedidos WhatsApp) ❌ NO PUEDE FUNCIONAR
└──► MCH-017 (Notificaciones) ⚠️ SIN WHATSAPP
```
**Impacto:** Las épicas MCH-012, MCH-013, MCH-015 están documentadas como "Completado" o "Pendiente" pero **NO PUEDEN FUNCIONAR** porque sus dependencias (MCH-010, MCH-011) están vacías.
### Cadena: Pedidos
```
MCH-015 (Pedidos WhatsApp) ❌ BLOQUEADO
└──► MCH-016 (Entregas) ❌ BLOQUEADO POR 015
```
### Dependencias Circulares Detectadas
```
MCH-008 (Fiados) ──blocks──► MCH-017 (Notificaciones)
MCH-017 (Notificaciones) ──blocks──► MCH-015 (Pedidos)
PERO: MCH-008 está COMPLETO, MCH-017 está PARCIAL
Esto es VÁLIDO - no es circular, es secuencial
```
---
## Épicas con Estado Incorrecto
### Debe cambiar de "Completado" a "Pendiente"
| Épica | Razón |
|-------|-------|
| MCH-006 | No hay onboarding inteligente implementado |
| MCH-007 | No hay templates de proveedores cargados |
| MCH-010 | Submodulo mcp-server/ está vacío |
| MCH-011 | Submodulo whatsapp-service/ está vacío |
| MCH-012 | Depende de MCH-010/011 que no existen |
| MCH-013 | Depende de MCH-010/011 que no existen |
| MCH-022 | Submodulo mobile/ está vacío |
| MCH-026 | No hay implementación de i18n |
### Debe cambiar de "Completado" a "Parcial (Mock)"
| Épica | Razón |
|-------|-------|
| MCH-005 | Solo Stripe, falta Mercado Pago y Clip |
| MCH-024 | Implementación mock, sin integración Banxico |
| MCH-027 | Implementación mock, sin integración PAC |
### Debe cambiar de "Pendiente" a "Completado"
| Épica | Razón |
|-------|-------|
| MCH-019 | Tienda de tokens está implementada y funcional |
---
## Estado Real Consolidado
### Épicas Realmente Completadas (14)
1. MCH-001 - Infraestructura Base
2. MCH-002 - Autenticación
3. MCH-003 - Catálogo de Productos
4. MCH-004 - Punto de Venta
5. MCH-008 - Sistema de Fiados
6. MCH-014 - Gestión de Clientes
7. MCH-018 - Planes y Suscripciones
8. MCH-019 - Tienda de Tokens
9. MCH-021 - Dashboard Web
10. MCH-023 - Programa de Referidos
11. MCH-028 - Marketplace Proveedores
12. MCH-009 - Predicción Inventario (básica)
13. MCH-017 - Notificaciones (parcial)
14. MCH-025 - Widgets (estructura)
### Épicas Parciales/Mock (4)
1. MCH-005 - Integraciones de Pago (solo Stripe)
2. MCH-024 - CoDi y SPEI (mock)
3. MCH-027 - Integración SAT (mock)
4. MCH-020 - Pagos Suscripción (solo Stripe)
### Épicas Pendientes (10)
1. MCH-006 - Onboarding Inteligente
2. MCH-007 - Templates y Catálogos
3. MCH-010 - MCP Server ⛔ BLOQUEANTE
4. MCH-011 - WhatsApp Service ⛔ BLOQUEANTE
5. MCH-012 - Chat LLM Dueño
6. MCH-013 - Chat LLM Cliente
7. MCH-015 - Pedidos vía WhatsApp
8. MCH-016 - Entregas a Domicilio
9. MCH-022 - Modo Offline
10. MCH-026 - Multi-idioma LATAM
### Épicas Planificadas (7)
1. MCH-029 - Infraestructura SaaS
2. MCH-030 - Auth Social
3. MCH-031 - Auditoría Empresarial
4. MCH-032 - Feature Flags
5. MCH-033 - Onboarding Wizard
6. MCH-034 - Analytics
7. MCH-035 - Sistema de Reportes
---
## Progreso Real del Proyecto
```
FASE 1 - MVP CORE: ████████░░ 80% (4/5 completos, 1 parcial)
FASE 2 - INTELIGENCIA: ████░░░░░░ 40% (2/4 completos)
FASE 3 - ASISTENTE IA: ░░░░░░░░░░ 0% (0/4 completos) ⛔
FASE 4 - PEDIDOS: ██░░░░░░░░ 25% (1/4 completos)
FASE 5 - MONETIZACIÓN: ████████░░ 75% (3/4 completos)
FASE 6 - CRECIMIENTO: ███░░░░░░░ 25% (1/4 completos)
FASE 7 - EXPANSIÓN: ███░░░░░░░ 33% (1/3 completos)
FASE 8 - ENTERPRISE: ░░░░░░░░░░ 0% (0/7 planificados)
TOTAL PROYECTO: ███░░░░░░░ 40% real vs 69% documentado
```
---
**Generado por:** Validación SIMCO 4.0.1
**Última actualización:** 2026-01-17