rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
631250df84
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

237 lines
13 KiB
Markdown
Raw Blame History

# 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)
Reference in New Issue View Git Blame Copy Permalink