rckrdmrd
928eb795e6
- 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>
280 lines
11 KiB
Markdown
280 lines
11 KiB
Markdown
# 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](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 | 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 - 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
|