# MiChangarrito - Mapa de Documentacion

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

---

## Resumen del Proyecto

| Metrica | Valor |
|---------|-------|
| Progreso MVP | 95% |
| Fases Completadas | 5.1 de 7 |
| Tareas Completadas | 37 de 39 |
| Total Epicas | 28 |
| Epicas Completadas | 22 |
| Epicas Pendientes | 6 |

---

## Estructura de Documentacion

```
docs/
├── _MAP.md                              <- ESTE ARCHIVO
├── 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 - Expansion (pendiente)
│   ├── MCH-026-multi-idioma-latam.md
│   ├── MCH-027-integracion-sat.md
│   └── MCH-028-marketplace-proveedores.md
│
├── 02-especificaciones/
│   ├── CATALOGO-PRODUCTOS.md            <- Gestion de catalogo
│   ├── TEMPLATE-PRODUCTOS.md            <- Templates de productos
│   ├── POS-BASICO.md                    <- Punto de venta
│   ├── VENTAS-DIARIAS.md                <- Registro de ventas
│   ├── CALCULADORA-CAMBIO.md            <- Logica de cambio
│   └── INTEGRACIONES-PAGOS.md           <- Mercado Pago, Clip, CoDi
│
└── 90-transversal/
    ├── arquitectura/
    │   └── ARCHITECTURE.md              <- Arquitectura del sistema
    ├── api/
    └── deployment/
        └── GUIA-DESPLIEGUE.md           <- Guia de despliegue
```

---

## 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 - Expansion LATAM (0%)
| Epica | Nombre | Archivo | Estado |
|-------|--------|---------|--------|
| 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), 7 | MCH-023 a MCH-028 |

---

## Estadisticas del Proyecto

### Base de Datos
| Metrica | Valor |
|---------|-------|
| Schemas | 9 |
| Tablas | 29 |
| Funciones | 5 |
| Triggers | 18 |
| Extensiones | 4 |

### Backend
| Metrica | Valor |
|---------|-------|
| Modulos | 12 |
| Controllers | 14 |
| Endpoints | 100+ |
| Entities | 20 |

### Frontend
| Metrica | Valor |
|---------|-------|
| Paginas | 9 |
| Componentes | 1 |
| Contexts | 1 |
| Servicios API | 6 |

### 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 15+ | Activo | Puerto 5432 |
| Redis 7 | Activo | Puerto 6379, DB 8 |
| WhatsApp Business (Meta) | Listo | Requiere cuenta Business verificada |
| Stripe | Integrado | Requiere API keys produccion |
| OpenRouter/OpenAI | Multi-tenant | Credenciales por tenant + fallback |
| MercadoPago | Pendiente | - |
| Clip | 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 - Expansion LATAM

---

**Ultima actualizacion:** 2026-01-10
**Version:** 2.0.0
**Actualizado por:** Agente Orquestador