rckrdmrd/michangarrito
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
5a49ad0185
michangarrito/docs/_MAP.md
rckrdmrd 5a49ad0185 [INTEGRATION] feat: Integrate template-saas scopes and database objects 
## Documentation
- Align MCH-029 to MCH-032 with template-saas modules (SAAS-008 to SAAS-015)
- Create MCH-034 (Analytics) and MCH-035 (Reports) from SAAS-016/017
- Update PLAN-DESARROLLO.md with Phase 7 and 8
- Update _MAP.md indexes (35 total epics)

## Database (5 new schemas, 14 tables)
- Add storage schema: buckets, files, signed_urls
- Add webhooks schema: endpoints, deliveries
- Add audit schema: logs, retention_policies
- Add features schema: flags, tenant_flags (14 seeds)
- Add analytics schema: metrics, events, reports, report_schedules
- Add auth.oauth_connections for MCH-030
- Add timestamptz_to_date() IMMUTABLE function
- Update EXPECTED_SCHEMAS in recreate-database.sh

## Analysis Reports
- ANALISIS-INTEGRACION-TEMPLATE-SAAS-2026-01-13.md
- VALIDACION-COHERENCIA-2026-01-13.md
- GAP-ANALYSIS-BD-2026-01-13.md
- REPORTE-EJECUCION-2026-01-13.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 07:10:55 -06:00

303 lines
13 KiB
Markdown
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
├── 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)
---
**Ultima actualizacion:** 2026-01-13
**Version:** 3.0.0
**Alineacion:** Integracion template-saas (SAAS-008 a SAAS-017)
**Cambios:** +2 epicas nuevas (MCH-034, MCH-035), 4 epicas alineadas (MCH-029 a MCH-032)
Reference in New Issue View Git Blame Copy Permalink