michangarrito/docs/01-epicas/_MAP.md
rckrdmrd 5a49ad0185 [INTEGRATION] feat: Integrate template-saas scopes and database objects
## Documentation
- Align MCH-029 to MCH-032 with template-saas modules (SAAS-008 to SAAS-015)
- Create MCH-034 (Analytics) and MCH-035 (Reports) from SAAS-016/017
- Update PLAN-DESARROLLO.md with Phase 7 and 8
- Update _MAP.md indexes (35 total epics)

## Database (5 new schemas, 14 tables)
- Add storage schema: buckets, files, signed_urls
- Add webhooks schema: endpoints, deliveries
- Add audit schema: logs, retention_policies
- Add features schema: flags, tenant_flags (14 seeds)
- Add analytics schema: metrics, events, reports, report_schedules
- Add auth.oauth_connections for MCH-030
- Add timestamptz_to_date() IMMUTABLE function
- Update EXPECTED_SCHEMAS in recreate-database.sh

## Analysis Reports
- ANALISIS-INTEGRACION-TEMPLATE-SAAS-2026-01-13.md
- VALIDACION-COHERENCIA-2026-01-13.md
- GAP-ANALYSIS-BD-2026-01-13.md
- REPORTE-EJECUCION-2026-01-13.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 07:10:55 -06:00

203 lines
12 KiB
Markdown

# 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 │
└─────────────────────────────────────────────────────────────────────────┘
```
---
**Versión**: 4.0.0
**Última actualización**: 2026-01-13
**Total Épicas**: 35 (MCH-001 a MCH-035)
**Alineacion**: template-saas v1.0.0 (SAAS-015, SAAS-016, SAAS-017)