rckrdmrd 67f5bb830d [INTEGRATION] F4: Crear _definitions/ y _quick/ (independiente, 18 módulos)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-16 04:14:27 -06:00

15 KiB

Raw Blame History

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	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 - Infraestructura SaaS Avanzada (0%)

Epica	Nombre	Archivo	Estado
MCH-029	Infraestructura SaaS	MCH-029-infraestructura-saas.md	Planificado
MCH-030	Auth Social	MCH-030-auth-social.md	Planificado
MCH-031	Auditoria Empresarial	MCH-031-auditoria-empresarial.md	Planificado
MCH-032	Feature Flags	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	Planificado
MCH-034	Analytics y Metricas	MCH-034-analytics.md	Planificado
MCH-035	Sistema de Reportes	MCH-035-sistema-reportes.md	Planificado
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)	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 - Vision estrategica
REQUERIMIENTOS-FUNCIONALES.md - Requisitos del sistema
ARQUITECTURA-TECNICA.md - Stack tecnico

Orchestration

CONTEXTO-PROYECTO.md - Contexto del proyecto
PROXIMA-ACCION.md - Siguiente accion
PROJECT-STATUS.md - Estado del proyecto
PLAN-IMPLEMENTACION.md - Plan de implementacion

Guias

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

15 KiB Raw Blame History