# MiChangarrito - Mapa de Documentacion

**Proyecto:** michangarrito
**Codigo:** MCH
**Version:** 3.0.0
**Fecha:** 2026-01-13
**Estado:** MVP 95% Implementado
**Sistema:** SIMCO - NEXUS v4.0

---

## Resumen del Proyecto

| Metrica | Valor |
|---------|-------|
| Progreso MVP | 95% |
| Fases Completadas | 5.1 de 8 |
| Tareas Completadas | 37 de 39 |
| Total Epicas | 35 |
| Epicas Completadas | 22 |
| Epicas Pendientes | 13 |
| Alineacion template-saas | SAAS-008 a SAAS-017 |

---

## Estructura de Documentacion

```
docs/
├── _MAP.md                              <- ESTE ARCHIVO
│
├── _definitions/                         <- DEFINICIONES CANONICAS
│   ├── _INDEX.yml                       <- Indice de definiciones (@MCH_DEF_*)
│   ├── DATABASE-SCHEMA.md               <- Schema BD (@MCH_DEF_DB)
│   ├── ENTITIES-CATALOG.md              <- Catalogo entities (@MCH_DEF_ENTITIES)
│   ├── MODULES-CATALOG.md               <- Catalogo modulos (@MCH_DEF_MODULES)
│   └── SERVICES-CATALOG.md              <- Catalogo services (@MCH_DEF_SERVICES)
│
├── _quick/                               <- NAVEGACION RAPIDA
│   ├── QUICK-INDEX.yml                  <- Indice navegacion rapida
│   ├── QUICK-API.yml                    <- Referencia rapida API endpoints
│   ├── QUICK-DATABASE.yml               <- Referencia rapida BD
│   └── QUICK-MODULES.yml                <- Referencia rapida modulos
│
├── 00-vision-general/
│   ├── VISION-PROYECTO.md               <- Vision y propuesta de valor
│   ├── REQUERIMIENTOS-FUNCIONALES.md    <- Requisitos del sistema
│   └── ARQUITECTURA-TECNICA.md          <- Stack y arquitectura
│
├── 01-epicas/
│   ├── _MAP.md                          <- Indice de epicas
│   │
│   │   # FASE 1 - Infraestructura Base (100%)
│   ├── MCH-001-infraestructura-base.md
│   ├── MCH-002-autenticacion.md
│   ├── MCH-003-catalogo-productos.md
│   ├── MCH-004-punto-venta.md
│   ├── MCH-005-integraciones-pago.md
│   │
│   │   # FASE 2 - Inteligencia (100%)
│   ├── MCH-006-onboarding-inteligente.md
│   ├── MCH-007-templates-catalogos.md
│   ├── MCH-008-sistema-fiados.md
│   ├── MCH-009-prediccion-inventario.md
│   │
│   │   # FASE 3 - Asistente IA (100%)
│   ├── MCH-010-mcp-server.md
│   ├── MCH-011-whatsapp-service.md
│   ├── MCH-012-chat-llm-dueno.md
│   ├── MCH-013-chat-llm-cliente.md
│   │
│   │   # FASE 4 - Pedidos y Clientes (100%)
│   ├── MCH-014-gestion-clientes.md
│   ├── MCH-015-pedidos-whatsapp.md
│   ├── MCH-016-entregas-domicilio.md
│   ├── MCH-017-notificaciones.md
│   │
│   │   # FASE 5 - Monetizacion (100%)
│   ├── MCH-018-planes-suscripciones.md
│   ├── MCH-019-tienda-tokens.md
│   ├── MCH-020-pagos-suscripcion.md
│   ├── MCH-021-dashboard-web.md
│   │
│   │   # FASE 6 - Mobile y Offline (parcial)
│   ├── MCH-022-modo-offline.md          <- Completado
│   ├── MCH-023-programa-referidos.md    <- Pendiente
│   ├── MCH-024-codi-spei.md             <- Pendiente
│   ├── MCH-025-widgets-atajos.md        <- Pendiente
│   │
│   │   # FASE 7 - Infraestructura SaaS Avanzada (planificado)
│   ├── MCH-029-infraestructura-saas.md    <- Email, Storage, Redis, Webhooks
│   ├── MCH-030-auth-social.md             <- OAuth Google/Apple
│   ├── MCH-031-auditoria-empresarial.md   <- Audit logs
│   ├── MCH-032-feature-flags.md           <- Toggles por plan
│   │
│   │   # FASE 8 - Analytics, Reportes y Expansion (planificado)
│   ├── MCH-033-onboarding-wizard.md
│   ├── MCH-034-analytics.md               <- Metricas de negocio
│   ├── MCH-035-sistema-reportes.md        <- PDF/Excel/CSV
│   ├── MCH-026-multi-idioma-latam.md
│   ├── MCH-027-integracion-sat.md
│   └── MCH-028-marketplace-proveedores.md
│
├── 02-especificaciones/
│   ├── _MAP.md                          <- Indice local de especificaciones
│   ├── ARQUITECTURA-DATABASE.md         <- Schema completo BD (9 schemas, 29 tablas)
│   ├── ESPECIFICACION-COMPONENTES.md    <- Stack tecnico y modulos
│   ├── INTEGRACIONES-EXTERNAS.md        <- 9 integraciones (Stripe, WhatsApp, LLM, etc)
│   ├── INVESTIGACION-REFERENCIAS.md     <- Codigo reutilizable (POS-Micro, etc)
│   └── PLAN-DESARROLLO.md               <- Cronograma por epicas
│
└── 90-transversal/
    ├── ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md  <- Multi-tenant WhatsApp/LLM
    └── GUIA-DESPLIEGUE.md               <- Guia de despliegue Docker
```

---

## Progreso por Fase

### FASE 1 - Infraestructura Base (100%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-001 | Infraestructura Base | [MCH-001-infraestructura-base.md](01-epicas/MCH-001-infraestructura-base.md) | Completado |
| MCH-002 | Autenticacion | [MCH-002-autenticacion.md](01-epicas/MCH-002-autenticacion.md) | Completado |
| MCH-003 | Catalogo Productos | [MCH-003-catalogo-productos.md](01-epicas/MCH-003-catalogo-productos.md) | Completado |
| MCH-004 | Punto de Venta | [MCH-004-punto-venta.md](01-epicas/MCH-004-punto-venta.md) | Completado |
| MCH-005 | Integraciones Pago | [MCH-005-integraciones-pago.md](01-epicas/MCH-005-integraciones-pago.md) | Completado |

### FASE 2 - Inteligencia (100%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-006 | Onboarding Inteligente | [MCH-006-onboarding-inteligente.md](01-epicas/MCH-006-onboarding-inteligente.md) | Completado |
| MCH-007 | Templates Catalogos | [MCH-007-templates-catalogos.md](01-epicas/MCH-007-templates-catalogos.md) | Completado |
| MCH-008 | Sistema Fiados | [MCH-008-sistema-fiados.md](01-epicas/MCH-008-sistema-fiados.md) | Completado |
| MCH-009 | Prediccion Inventario | [MCH-009-prediccion-inventario.md](01-epicas/MCH-009-prediccion-inventario.md) | Completado |

### FASE 3 - Asistente IA (100%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-010 | MCP Server | [MCH-010-mcp-server.md](01-epicas/MCH-010-mcp-server.md) | Completado |
| MCH-011 | WhatsApp Service | [MCH-011-whatsapp-service.md](01-epicas/MCH-011-whatsapp-service.md) | Completado |
| MCH-012 | Chat LLM Dueno | [MCH-012-chat-llm-dueno.md](01-epicas/MCH-012-chat-llm-dueno.md) | Completado |
| MCH-013 | Chat LLM Cliente | [MCH-013-chat-llm-cliente.md](01-epicas/MCH-013-chat-llm-cliente.md) | Completado |

### FASE 4 - Pedidos y Clientes (100%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-014 | Gestion Clientes | [MCH-014-gestion-clientes.md](01-epicas/MCH-014-gestion-clientes.md) | Completado |
| MCH-015 | Pedidos WhatsApp | [MCH-015-pedidos-whatsapp.md](01-epicas/MCH-015-pedidos-whatsapp.md) | Completado |
| MCH-016 | Entregas Domicilio | [MCH-016-entregas-domicilio.md](01-epicas/MCH-016-entregas-domicilio.md) | Completado |
| MCH-017 | Notificaciones | [MCH-017-notificaciones.md](01-epicas/MCH-017-notificaciones.md) | Completado |

### FASE 5 - Monetizacion (100%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-018 | Planes Suscripciones | [MCH-018-planes-suscripciones.md](01-epicas/MCH-018-planes-suscripciones.md) | Completado |
| MCH-019 | Tienda Tokens | [MCH-019-tienda-tokens.md](01-epicas/MCH-019-tienda-tokens.md) | Completado |
| MCH-020 | Pagos Suscripcion | [MCH-020-pagos-suscripcion.md](01-epicas/MCH-020-pagos-suscripcion.md) | Completado |
| MCH-021 | Dashboard Web | [MCH-021-dashboard-web.md](01-epicas/MCH-021-dashboard-web.md) | Completado |

### FASE 6 - Mobile y Offline (25%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-022 | Modo Offline | [MCH-022-modo-offline.md](01-epicas/MCH-022-modo-offline.md) | Completado |
| MCH-023 | Programa Referidos | [MCH-023-programa-referidos.md](01-epicas/MCH-023-programa-referidos.md) | Pendiente |
| MCH-024 | CoDi/SPEI | [MCH-024-codi-spei.md](01-epicas/MCH-024-codi-spei.md) | Pendiente |
| MCH-025 | Widgets Atajos | [MCH-025-widgets-atajos.md](01-epicas/MCH-025-widgets-atajos.md) | Pendiente |

### FASE 7 - Infraestructura SaaS Avanzada (0%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-029 | Infraestructura SaaS | [MCH-029-infraestructura-saas.md](01-epicas/MCH-029-infraestructura-saas.md) | Planificado |
| MCH-030 | Auth Social | [MCH-030-auth-social.md](01-epicas/MCH-030-auth-social.md) | Planificado |
| MCH-031 | Auditoria Empresarial | [MCH-031-auditoria-empresarial.md](01-epicas/MCH-031-auditoria-empresarial.md) | Planificado |
| MCH-032 | Feature Flags | [MCH-032-feature-flags.md](01-epicas/MCH-032-feature-flags.md) | Planificado |

### FASE 8 - Analytics, Reportes y Expansion (0%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| MCH-033 | Onboarding Wizard | [MCH-033-onboarding-wizard.md](01-epicas/MCH-033-onboarding-wizard.md) | Planificado |
| MCH-034 | Analytics y Metricas | [MCH-034-analytics.md](01-epicas/MCH-034-analytics.md) | Planificado |
| MCH-035 | Sistema de Reportes | [MCH-035-sistema-reportes.md](01-epicas/MCH-035-sistema-reportes.md) | Planificado |
| MCH-026 | Multi-idioma LATAM | [MCH-026-multi-idioma-latam.md](01-epicas/MCH-026-multi-idioma-latam.md) | Pendiente |
| MCH-027 | Integracion SAT | [MCH-027-integracion-sat.md](01-epicas/MCH-027-integracion-sat.md) | Pendiente |
| MCH-028 | Marketplace Proveedores | [MCH-028-marketplace-proveedores.md](01-epicas/MCH-028-marketplace-proveedores.md) | Pendiente |

---

## Archivos de Inventario

| Archivo | Proposito | Ubicacion |
|---------|-----------|-----------|
| MASTER_INVENTORY.yml | Inventario consolidado | orchestration/inventarios/ |
| DATABASE_INVENTORY.yml | Esquemas y tablas | orchestration/inventarios/ |
| BACKEND_INVENTORY.yml | Modulos y endpoints | orchestration/inventarios/ |
| FRONTEND_INVENTORY.yml | Paginas y componentes | orchestration/inventarios/ |

---

## Navegacion Rapida

### Por Componente
| Componente | Tecnologia | Puerto | Documentacion |
|------------|------------|--------|---------------|
| Backend | NestJS 10.3.0 | 3141 | orchestration/inventarios/BACKEND_INVENTORY.yml |
| Frontend | React 19.2.0 + Vite 7.2.4 | 3140 | orchestration/inventarios/FRONTEND_INVENTORY.yml |
| Mobile | React Native + Expo | 8081 | apps/mobile/README.md |
| MCP Server | TypeScript + MCP SDK | 3142 | apps/mcp-server/README.md |
| WhatsApp Service | NestJS + Meta Cloud API | 3143 | apps/whatsapp-service/README.md |
| Database | PostgreSQL 16+ | 5432 | orchestration/inventarios/DATABASE_INVENTORY.yml |

### Por Estado
| Estado | Fases | Epicas |
|--------|-------|--------|
| Completado | 1, 2, 3, 4, 5 | MCH-001 a MCH-022 |
| Pendiente | 6 (parcial) | MCH-023 a MCH-025 |
| Planificado | 7, 8 | MCH-029 a MCH-035, MCH-026 a MCH-028 |

---

## Estadisticas del Proyecto

### Base de Datos
| Metrica | Valor |
|---------|-------|
| Schemas | 12 |
| Tablas | ~49 |
| Funciones | 15 |
| Triggers | 20+ |
| Extensiones | 4 |

### Backend
| Metrica | Valor |
|---------|-------|
| Modulos | 18 |
| Controllers | 18 |
| Endpoints | 120+ |
| Entities | 25 |

### Frontend
| Metrica | Valor |
|---------|-------|
| Paginas | 12 |
| Componentes | 8+ |
| Contexts | 2 |
| Servicios API | 8 |

### Mobile
| Metrica | Valor |
|---------|-------|
| Pantallas | 10 |
| Estado | Completado |
| Modo Offline | Si |

---

## Referencias

### Documentacion Principal
- [VISION-PROYECTO.md](00-vision-general/VISION-PROYECTO.md) - Vision estrategica
- [REQUERIMIENTOS-FUNCIONALES.md](00-vision-general/REQUERIMIENTOS-FUNCIONALES.md) - Requisitos del sistema
- [ARQUITECTURA-TECNICA.md](00-vision-general/ARQUITECTURA-TECNICA.md) - Stack tecnico

### Orchestration
- [CONTEXTO-PROYECTO.md](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md) - Contexto del proyecto
- [PROXIMA-ACCION.md](../orchestration/PROXIMA-ACCION.md) - Siguiente accion
- [PROJECT-STATUS.md](../orchestration/PROJECT-STATUS.md) - Estado del proyecto
- [PLAN-IMPLEMENTACION.md](../orchestration/PLAN-IMPLEMENTACION.md) - Plan de implementacion

### Guias
- [GUIA-DESPLIEGUE.md](90-transversal/GUIA-DESPLIEGUE.md) - Despliegue a produccion

---

## Integraciones Externas

| Servicio | Estado | Notas |
|----------|--------|-------|
| PostgreSQL 16+ | Activo | Puerto 5432 |
| Redis 7 | Activo | Puerto 6379, DB 8 |
| WhatsApp Business (Meta) | Implementado (95%) | Requiere cuenta Business verificada |
| Stripe | Implementado (100%) | Requiere API keys produccion |
| OpenRouter/OpenAI | Implementado (90%) | Multi-tenant con fallback |
| SAT CFDI 4.0 | Modelo Base (5%) | Requiere PAC |
| SPEI/STP | Mock (40%) | Requiere STP.mx |
| CoDi | Mock (40%) | Requiere Banxico |
| MercadoPago | Solo Docs (0%) | Pendiente |
| Clip | Solo Docs (0%) | Pendiente |

---

## Proximas Acciones

### Prioridad P0 (Critica)
- Desplegar en servidor produccion con Docker
- Configurar dominio y SSL
- Obtener cuenta Meta Business
- Configurar Stripe produccion

### Prioridad P1 (Alta)
- Configurar LLM API key
- Pruebas E2E completas
- Completar documentacion SIMCO

### Prioridad P2 (Media)
- Implementar FASE 6 restante (MCH-023, MCH-024, MCH-025)
- FASE 7 - Infraestructura SaaS Avanzada (MCH-029 a MCH-032)
- FASE 8 - Analytics y Reportes (MCH-034, MCH-035)

---

---

## Definiciones y Referencias

### Aliases del Proyecto

| Alias | Archivo | Descripcion |
|-------|---------|-------------|
| @MCH_DEF_DB | `_definitions/DATABASE-SCHEMA.md` | Schema canonico de BD |
| @MCH_DEF_ENTITIES | `_definitions/ENTITIES-CATALOG.md` | Catalogo de entities |
| @MCH_DEF_MODULES | `_definitions/MODULES-CATALOG.md` | Catalogo de modulos |
| @MCH_DEF_SERVICES | `_definitions/SERVICES-CATALOG.md` | Catalogo de services |
| @MCH_QUICK_INDEX | `_quick/QUICK-INDEX.yml` | Indice navegacion rapida |
| @MCH_QUICK_API | `_quick/QUICK-API.yml` | Referencia rapida API |
| @MCH_QUICK_DB | `_quick/QUICK-DATABASE.yml` | Referencia rapida BD |
| @MCH_QUICK_MODULES | `_quick/QUICK-MODULES.yml` | Referencia rapida modulos |

### Referencias a Workspace

| Alias | Uso |
|-------|-----|
| @WS_DEF_CCA | Protocolo CCA |
| @WS_DEF_VAL_BE | Validacion Backend |
| @WS_DEF_VAL_FE | Validacion Frontend |
| @WS_DEF_VAL_DDL | Validacion DDL |

### Archivos de Orchestration

| Archivo | Proposito |
|---------|-----------|
| `orchestration/_refs/WS-REFERENCES.yml` | Referencias a workspace |
| `orchestration/DEPENDENCY-GRAPH.yml` | Grafo de dependencias |
| `orchestration/TRACEABILITY.yml` | Trazabilidad modulos-objetos |

---

**Ultima actualizacion:** 2026-01-16
**Version:** 3.1.0
**Alineacion:** Integracion template-saas (SAAS-008 a SAAS-017)
**Cambios:** Agregada estructura _definitions/ y _quick/, orchestration DEPENDENCY-GRAPH y TRACEABILITY