michangarrito/docs/01-epicas/_MAP.md
rckrdmrd bf1595c168 chore(MCH-016): Complete Sprint 4 - Entregas a Domicilio
Backend:
- Implement delivery module with zones and tracking
- Add DeliveryZone entity (radius/polygon types)
- Add Delivery entity with full status machine
- Implement coverage check with Haversine formula

WhatsApp Service:
- Add delivery API integration methods
- Support coverage check and delivery creation

Database:
- Add delivery schema with zones, deliveries, status_history, drivers tables
- Create triggers for updated_at and status history logging

Documentation:
- Mark MCH-016 as Completado
- Update _MAP.md progress to 60%

Sprint 4 Complete: MCH-015, MCH-016, MCH-017

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 03:43:09 -06:00

13 KiB

MiChangarrito - Mapa de Épicas

Visión General de Fases

┌─────────────────────────────────────────────────────────────────────────────────┐
│                           ROADMAP MICHANGARRITO                                 │
├─────────────────────────────────────────────────────────────────────────────────┤
│                                                                                 │
│  FASE 1: MVP CORE                    FASE 2: INTELIGENCIA                      │
│  ──────────────                      ────────────────────                      │
│  MCH-001: Infraestructura Base       MCH-006: Onboarding Inteligente           │
│  MCH-002: Autenticación              MCH-007: Templates y Catálogos            │
│  MCH-003: Catálogo de Productos      MCH-008: Sistema de Fiados                │
│  MCH-004: Punto de Venta Básico      MCH-009: Predicción de Inventario         │
│  MCH-005: Integraciones de Pago                                                │
│                                                                                 │
│  FASE 3: ASISTENTE IA                FASE 4: PEDIDOS Y CLIENTES                │
│  ────────────────────                ──────────────────────────                │
│  MCH-010: MCP Server                 MCH-014: Gestión de Clientes              │
│  MCH-011: WhatsApp Service           MCH-015: Pedidos vía WhatsApp             │
│  MCH-012: Chat LLM Dueño             MCH-016: Entregas a Domicilio             │
│  MCH-013: Chat LLM Cliente           MCH-017: Notificaciones                   │
│                                                                                 │
│  FASE 5: MONETIZACIÓN                FASE 6: CRECIMIENTO                       │
│  ────────────────────                ──────────────────────                    │
│  MCH-018: Planes y Suscripciones     MCH-022: Modo Offline                     │
│  MCH-019: Tienda de Tokens           MCH-023: Programa Referidos               │
│  MCH-020: Pagos (Stripe/OXXO/IAP)    MCH-024: CoDi y SPEI                      │
│  MCH-021: Dashboard Web              MCH-025: Widgets y Atajos                 │
│                                                                                 │
│  FASE 7: EXPANSIÓN (Futuro)                                                    │
│  ──────────────────────────                                                    │
│  MCH-026: Multi-idioma LATAM                                                   │
│  MCH-027: Integración SAT                                                      │
│  MCH-028: Marketplace Proveedores                                              │
│                                                                                 │
└─────────────────────────────────────────────────────────────────────────────────┘

Detalle de Épicas

FASE 1: MVP CORE

ID Épica Descripción Prioridad
MCH-001 Infraestructura Base Setup proyecto, DB, CI/CD P0
MCH-002 Autenticación Login OTP, JWT, PIN, biométrico P0
MCH-003 Catálogo de Productos CRUD productos, categorías, códigos P0
MCH-004 Punto de Venta Básico Registro ventas, carrito, ticket P0
MCH-005 Integraciones de Pago Mercado Pago, Clip, efectivo P0

FASE 2: INTELIGENCIA

ID Épica Descripción Prioridad
MCH-006 Onboarding Inteligente Setup vía WhatsApp, fotos, audio P1
MCH-007 Templates y Catálogos Proveedores comunes, giros P1
MCH-008 Sistema de Fiados Crédito a clientes, recordatorios P1
MCH-009 Predicción Inventario Alertas, sugerencias de compra P1

FASE 3: ASISTENTE IA

ID Épica Descripción Prioridad
MCH-010 MCP Server Gateway LLM agnóstico, tools P0
MCH-011 WhatsApp Service Meta API, webhooks, multi-número P0
MCH-012 Chat LLM Dueño Consultas, gestión, reportes P1
MCH-013 Chat LLM Cliente Pedidos, consultas, precios P1

FASE 4: PEDIDOS Y CLIENTES

ID Épica Descripción Prioridad
MCH-014 Gestión de Clientes CRUD, historial, comunicación P1
MCH-015 Pedidos vía WhatsApp Recepción, procesamiento, cobro P1
MCH-016 Entregas a Domicilio Zonas, costos, tracking P2
MCH-017 Notificaciones Push, WhatsApp, configuración P1

FASE 5: MONETIZACIÓN

ID Épica Descripción Prioridad
MCH-018 Planes y Suscripciones Changarrito, Tiendita P0
MCH-019 Tienda de Tokens Paquetes, saldo, consumo P1
MCH-020 Pagos Suscripción Stripe, OXXO, In-App Purchase P0
MCH-021 Dashboard Web Reportes, gráficas, config P1

FASE 6: CRECIMIENTO

ID Épica Descripción Prioridad
MCH-022 Modo Offline SQLite, sync, conflictos P1
MCH-023 Programa Referidos Códigos, tracking, beneficios P2
MCH-024 CoDi y SPEI QR de cobro, CLABE virtual P2
MCH-025 Widgets y Atajos Android widgets, quick actions P2

FASE 7: EXPANSIÓN

ID Épica Descripción Prioridad
MCH-026 Multi-idioma LATAM i18n, localización P3
MCH-027 Integración SAT Facturación simplificada P3
MCH-028 Marketplace Proveedores Conexión con distribuidores P3
MCH-029 Infraestructura SaaS Avanzada Email, Storage, Redis, Webhooks, Rate Limiting P0
MCH-030 Auth Social (OAuth 2.0) Login con Google/Apple P1
MCH-031 Auditoria Empresarial Audit logs, retencion, compliance P1
MCH-032 Feature Flags por Plan Toggles por plan/tenant P1

FASE 8: ANALYTICS, REPORTES Y MEJORAS UX

ID Épica Descripción Prioridad
MCH-033 Onboarding Wizard Guia interactiva de setup P2
MCH-034 Analytics y Metricas Metricas de ventas, clientes, fiados, inventario P1
MCH-035 Sistema de Reportes Exportacion PDF, Excel, CSV de reportes P2

Índice de Archivos de Épicas

docs/01-epicas/
├── _MAP.md                           # Este archivo
├── MCH-001-infraestructura-base.md
├── MCH-002-autenticacion.md
├── MCH-003-catalogo-productos.md
├── MCH-004-punto-venta.md
├── MCH-005-integraciones-pago.md
├── MCH-006-onboarding-inteligente.md
├── MCH-007-templates-catalogos.md
├── MCH-008-sistema-fiados.md
├── MCH-009-prediccion-inventario.md
├── MCH-010-mcp-server.md
├── MCH-011-whatsapp-service.md
├── MCH-012-chat-llm-dueno.md
├── MCH-013-chat-llm-cliente.md
├── MCH-014-gestion-clientes.md
├── MCH-015-pedidos-whatsapp.md
├── MCH-016-entregas-domicilio.md
├── MCH-017-notificaciones.md
├── MCH-018-planes-suscripciones.md
├── MCH-019-tienda-tokens.md
├── MCH-020-pagos-suscripcion.md
├── MCH-021-dashboard-web.md
├── MCH-022-modo-offline.md
├── MCH-023-programa-referidos.md
├── MCH-024-codi-spei.md
├── MCH-025-widgets-atajos.md
├── MCH-026-multi-idioma-latam.md
├── MCH-027-integracion-sat.md
├── MCH-028-marketplace-proveedores.md
├── MCH-029-infraestructura-saas.md
├── MCH-030-auth-social.md
├── MCH-031-auditoria-empresarial.md
├── MCH-032-feature-flags.md
├── MCH-033-onboarding-wizard.md
├── MCH-034-analytics.md
└── MCH-035-sistema-reportes.md

Dependencias entre Épicas

MCH-001 ─────┬────────────────────────────────────────────────────────────┐
             │                                                            │
             ▼                                                            │
MCH-002 ─────┬─────► MCH-003 ─────► MCH-004 ─────► MCH-005               │
             │           │              │              │                  │
             │           ▼              │              │                  │
             │      MCH-007             │              │                  │
             │           │              │              │                  │
             │           ▼              ▼              ▼                  │
             │      MCH-006 ◄───── MCH-008 ◄───── MCH-014                │
             │                         │              │                  │
             ▼                         ▼              ▼                  │
MCH-010 ─────┬─────► MCH-011 ─────► MCH-012 ─────► MCH-013               │
             │           │              │              │                  │
             │           │              │              ▼                  │
             │           │              │         MCH-015 ────► MCH-016  │
             │           │              │                                 │
             │           ▼              ▼                                 │
             │      MCH-017        MCH-009                                │
             │                                                            │
             ▼                                                            │
MCH-018 ─────┬─────► MCH-019 ─────► MCH-020                              │
             │                          │                                 │
             ▼                          ▼                                 │
        MCH-021                    MCH-022                                │
             │                          │                                 │
             └──────────────────────────┴─────► MCH-023 ────► MCH-024    │
                                                    │                     │
                                                    ▼                     │
                                               MCH-025                    │
                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

Estado Real del Proyecto (Validado 2026-01-18)

Resumen de Estados

Estado Cantidad Porcentaje
Completado 21 60%
⚠️ Parcial/Mock 4 11%
Pendiente 3 9%
📋 Planificado 7 20%

Bloqueadores Críticos

Épica Bloquea Estado
MCH-010 (MCP Server) MCH-012, MCH-013 COMPLETADO (Sprint 1)
MCH-011 (WhatsApp) MCH-012, MCH-013, MCH-015, MCH-017 COMPLETADO (Sprint 1)

Implementaciones Mock (Requieren Integración Real)

Épica Integración Faltante
MCH-024 (CoDi/SPEI) Banxico, STP/Arcus
MCH-027 (SAT) PAC (Facturapi)

Documentos de Referencia

  • Estado Real Detallado: docs/_definitions/ESTADO-REAL-EPICAS.md
  • Roadmap Corregido: docs/_definitions/ROADMAP-CORREGIDO.md
  • Análisis de Coherencia: docs/_definitions/ANALISIS-DOCUMENTACION-VS-CODIGO.md

Versión: 4.5.1 Última actualización: 2026-01-18 Total Épicas: 35 (MCH-001 a MCH-035) Progreso Real: 60% (Sprint 4 COMPLETADO - Pedidos, Entregas, Notificaciones) Alineacion: template-saas v1.0.0 (SAAS-015, SAAS-016, SAAS-017)