michangarrito/docs/_MAP.md
rckrdmrd 928eb795e6 [SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios apps
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8
- Cambios en backend y frontend

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 08:53:05 -06:00

11 KiB

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/
│   ├── _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 Completado
MCH-002 Autenticacion MCH-002-autenticacion.md Completado
MCH-003 Catalogo Productos MCH-003-catalogo-productos.md Completado
MCH-004 Punto de Venta MCH-004-punto-venta.md Completado
MCH-005 Integraciones Pago MCH-005-integraciones-pago.md Completado

FASE 2 - Inteligencia (100%)

Epica Nombre Archivo Estado
MCH-006 Onboarding Inteligente MCH-006-onboarding-inteligente.md Completado
MCH-007 Templates Catalogos MCH-007-templates-catalogos.md Completado
MCH-008 Sistema Fiados MCH-008-sistema-fiados.md Completado
MCH-009 Prediccion Inventario MCH-009-prediccion-inventario.md Completado

FASE 3 - Asistente IA (100%)

Epica Nombre Archivo Estado
MCH-010 MCP Server MCH-010-mcp-server.md Completado
MCH-011 WhatsApp Service MCH-011-whatsapp-service.md Completado
MCH-012 Chat LLM Dueno MCH-012-chat-llm-dueno.md Completado
MCH-013 Chat LLM Cliente 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 Completado
MCH-015 Pedidos WhatsApp MCH-015-pedidos-whatsapp.md Completado
MCH-016 Entregas Domicilio MCH-016-entregas-domicilio.md Completado
MCH-017 Notificaciones MCH-017-notificaciones.md Completado

FASE 5 - Monetizacion (100%)

Epica Nombre Archivo Estado
MCH-018 Planes Suscripciones MCH-018-planes-suscripciones.md Completado
MCH-019 Tienda Tokens MCH-019-tienda-tokens.md Completado
MCH-020 Pagos Suscripcion MCH-020-pagos-suscripcion.md Completado
MCH-021 Dashboard Web 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 Completado
MCH-023 Programa Referidos MCH-023-programa-referidos.md Pendiente
MCH-024 CoDi/SPEI MCH-024-codi-spei.md Pendiente
MCH-025 Widgets Atajos 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 Pendiente
MCH-027 Integracion SAT MCH-027-integracion-sat.md Pendiente
MCH-028 Marketplace Proveedores 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 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

Orchestration

Guias


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 - Expansion LATAM

Ultima actualizacion: 2026-01-10 Version: 3.0.0 Actualizado por: Reestructuracion Documental Completa Cambios: Estadisticas corregidas, integraciones actualizadas, 12 schemas, 18 modulos, 12 paginas