michangarrito/orchestration/analisis/F3-PLAN-DETALLADO-DOCUMENTACION-2026-01-10.md

FASE 3: PLAN DETALLADO DE ESTANDARIZACIÓN

Documentación MiChangarrito

Versión: 1.0.0 Fecha: 2026-01-10 Ejecutado por: Agente Orquestador (PERFIL-ORQUESTADOR) Sistema: SIMCO v3.8.0 + CAPVED

---

1. RESUMEN EJECUTIVO

Este plan detalla las tareas específicas para estandarizar la documentación del proyecto MiChangarrito basado en los análisis de FASE 1 y FASE 2.

Alcance del Plan

Categoría	Cantidad	Esfuerzo Estimado
Documentos a agregar frontmatter	50	Alto
Inventarios a actualizar	5	Medio
Integraciones a crear	5	Medio
Documentos a consolidar	4 conjuntos	Bajo
Archivos a crear	2	Bajo

Objetivos

1. Alcanzar 95% de conformidad SIMCO (actualmente 75%)
2. Sincronizar 100% de inventarios con código real
3. Completar 100% de documentación de integraciones
4. Eliminar 100% de redundancias identificadas

---

2. ESTRUCTURA DEL PLAN

2.1 Bloques de Trabajo

BLOQUE A: Actualización de Inventarios (P0)
├── T-A1: DATABASE_INVENTORY.yml
├── T-A2: BACKEND_INVENTORY.yml
├── T-A3: FRONTEND_INVENTORY.yml
├── T-A4: MASTER_INVENTORY.yml
└── T-A5: DEPENDENCIAS.yml

BLOQUE B: Frontmatter en Épicas (P0)
├── T-B1: MCH-001 a MCH-010 (10 épicas)
├── T-B2: MCH-011 a MCH-020 (10 épicas)
└── T-B3: MCH-021 a MCH-028 (8 épicas)

BLOQUE C: Frontmatter en Especificaciones (P1)
├── T-C1: ARQUITECTURA-DATABASE.md
├── T-C2: ESPECIFICACION-COMPONENTES.md
├── T-C3: INTEGRACIONES-EXTERNAS.md
├── T-C4: INVESTIGACION-REFERENCIAS.md
├── T-C5: PLAN-DESARROLLO.md
└── T-C6: CALCULADORA-CAMBIO.md

BLOQUE D: Otros Documentos (P1)
├── T-D1: ADRs (4 archivos)
├── T-D2: Integraciones existentes (4 archivos)
├── T-D3: Transversal (2 archivos)
└── T-D4: Crear 90-transversal/_MAP.md

BLOQUE E: Integraciones Nuevas (P2)
├── T-E1: INT-005-clip.md
├── T-E2: INT-006-codi-banxico.md
├── T-E3: INT-007-firebase-fcm.md
├── T-E4: INT-008-google-vision.md
└── T-E5: INT-009-whisper.md

BLOQUE F: Consolidación y Limpieza (P2)
├── T-F1: Archivar documentos redundantes
├── T-F2: Crear historico/ si no existe
└── T-F3: Actualizar referencias cruzadas

---

3. BLOQUE A: ACTUALIZACIÓN DE INVENTARIOS

T-A1: DATABASE_INVENTORY.yml

Prioridad: P0 | Esfuerzo: Medio

Cambios Requeridos:

1. Agregar archivos DDL faltantes:
   • 13-referrals.sql (143 líneas)
   • 14-codi-spei.sql (168 líneas)
   • 15-invoices.sql (245 líneas)
   • 16-marketplace.sql (390 líneas)
2. Actualizar conteo total: 16 → 17 archivos DDL
3. Actualizar total líneas SQL
4. Incrementar versión a 2.2.0

Ruta: /orchestration/inventarios/DATABASE_INVENTORY.yml

T-A2: BACKEND_INVENTORY.yml

Prioridad: P0 | Esfuerzo: Medio

Cambios Requeridos:

1. Agregar módulos faltantes:
   • billing/
   • codi-spei/
   • invoices/
   • marketplace/
   • referrals/
   • widgets/
2. Actualizar total módulos: 12 → 18
3. Actualizar conteo de endpoints
4. Incrementar versión a 2.2.0

Ruta: /orchestration/inventarios/BACKEND_INVENTORY.yml

T-A3: FRONTEND_INVENTORY.yml

Prioridad: P0 | Esfuerzo: Bajo

Cambios Requeridos:

1. Agregar páginas faltantes:
   • Invoices.tsx (24.6 KB)
   • Marketplace.tsx (26.2 KB)
   • Referrals.tsx (10.2 KB)
2. Actualizar total páginas: 11 → 12 (o 14)
3. Incrementar versión a 2.2.0

Ruta: /orchestration/inventarios/FRONTEND_INVENTORY.yml

T-A4: MASTER_INVENTORY.yml

Prioridad: P0 | Esfuerzo: Bajo

Cambios Requeridos:

1. Sincronizar métricas con inventarios actualizados
2. Actualizar conteos de módulos, páginas, tablas
3. Incrementar versión a 2.2.0

Ruta: /orchestration/inventarios/MASTER_INVENTORY.yml

T-A5: DEPENDENCIAS.yml

Prioridad: P1 | Esfuerzo: Bajo

Cambios Requeridos:

1. Actualizar versión de 1.0.0 a 2.1.0
2. Sincronizar versiones de dependencias:
   • Axios: unificar a ^1.13.2
   • TypeScript: unificar a ~5.9.3

Ruta: /orchestration/inventarios/DEPENDENCIAS.yml

---

4. BLOQUE B: FRONTMATTER EN ÉPICAS

Plantilla Base para Épicas

---
id: EPIC-MCH-XXX
type: Epic
title: "{Título de la épica}"
code: MCH-XXX
status: Published|Draft
phase: {1-7}
priority: P0|P1|P2|P3
created_at: YYYY-MM-DD
updated_at: 2026-01-10
dependencies:
  blocks: []
  depends_on: []
---

T-B1: Épicas MCH-001 a MCH-010

Archivo	ID	Estado	Fase	Prioridad
MCH-001-infraestructura-base.md	EPIC-MCH-001	Published	1	P0
MCH-002-autenticacion.md	EPIC-MCH-002	Published	1	P0
MCH-003-catalogo-productos.md	EPIC-MCH-003	Published	1	P0
MCH-004-punto-venta.md	EPIC-MCH-004	Published	1	P0
MCH-005-integraciones-pago.md	EPIC-MCH-005	Published	1	P0
MCH-006-onboarding-inteligente.md	EPIC-MCH-006	Published	2	P1
MCH-007-templates-catalogos.md	EPIC-MCH-007	Published	2	P1
MCH-008-sistema-fiados.md	EPIC-MCH-008	Published	2	P1
MCH-009-prediccion-inventario.md	EPIC-MCH-009	Published	2	P1
MCH-010-mcp-server.md	EPIC-MCH-010	Published	3	P0

T-B2: Épicas MCH-011 a MCH-020

Archivo	ID	Estado	Fase	Prioridad
MCH-011-whatsapp-service.md	EPIC-MCH-011	Published	3	P0
MCH-012-chat-llm-dueno.md	EPIC-MCH-012	Draft	3	P1
MCH-013-chat-llm-cliente.md	EPIC-MCH-013	Draft	3	P1
MCH-014-gestion-clientes.md	EPIC-MCH-014	Published	4	P1
MCH-015-pedidos-whatsapp.md	EPIC-MCH-015	Draft	4	P1
MCH-016-entregas-domicilio.md	EPIC-MCH-016	Draft	4	P2
MCH-017-notificaciones.md	EPIC-MCH-017	Draft	4	P1
MCH-018-planes-suscripciones.md	EPIC-MCH-018	Published	5	P0
MCH-019-tienda-tokens.md	EPIC-MCH-019	Draft	5	P1
MCH-020-pagos-suscripcion.md	EPIC-MCH-020	Published	5	P0

T-B3: Épicas MCH-021 a MCH-028

Archivo	ID	Estado	Fase	Prioridad
MCH-021-dashboard-web.md	EPIC-MCH-021	Published	5	P1
MCH-022-modo-offline.md	EPIC-MCH-022	Published	6	P1
MCH-023-programa-referidos.md	EPIC-MCH-023	Published	6	P2
MCH-024-codi-spei.md	EPIC-MCH-024	Published	6	P2
MCH-025-widgets-atajos.md	EPIC-MCH-025	Draft	6	P2
MCH-026-multi-idioma-latam.md	EPIC-MCH-026	Published	7	P3
MCH-027-integracion-sat.md	EPIC-MCH-027	Published	7	P3
MCH-028-marketplace-proveedores.md	EPIC-MCH-028	Published	7	P3

---

5. BLOQUE C: FRONTMATTER EN ESPECIFICACIONES

T-C1: ARQUITECTURA-DATABASE.md

---
id: SPEC-MCH-ARCH-DB-001
title: Arquitectura de Base de Datos MiChangarrito
type: Specification
status: Published
version: 2.2.0
created_date: 2026-01-04
updated_date: 2026-01-10
tags: [database, architecture, postgresql, multi-tenant, rls]
---

T-C2: ESPECIFICACION-COMPONENTES.md

---
id: SPEC-MCH-COMPONENTES-001
title: Especificación de Componentes MiChangarrito
type: Specification
status: Published
version: 2.0.0
created_date: 2026-01-04
updated_date: 2026-01-10
tags: [architecture, components, backend, frontend, mobile]
---

T-C3: INTEGRACIONES-EXTERNAS.md

---
id: SPEC-MCH-INTEGRACIONES-001
title: Integraciones Externas MiChangarrito
type: Specification
status: Published
version: 2.0.0
created_date: 2025-12-15
updated_date: 2026-01-10
tags: [integrations, payments, messaging, llm, external-apis]
---

T-C4: INVESTIGACION-REFERENCIAS.md

---
id: SPEC-MCH-INVESTIGACION-001
title: Investigación de Referencias y Reutilización de Código
type: Investigation
status: NeedsUpdate
version: 1.0.0
created_date: 2026-01-04
updated_date: 2026-01-04
tags: [research, architecture, reusability, erp-suite]
---

Acción Adicional: Actualizar contenido con 18 módulos

T-C5: PLAN-DESARROLLO.md

---
id: PLAN-MCH-DESARROLLO-001
title: Plan de Desarrollo MiChangarrito
type: Development Plan
status: NeedsUpdate
version: 1.0.0
created_date: 2026-01-04
updated_date: 2026-01-04
tags: [development, roadmap, phases, timeline]
---

Acción Adicional: Actualizar con 18 módulos y testing strategy

T-C6: CALCULADORA-CAMBIO.md

---
id: SPEC-MCH-CALCULADORA-CAMBIO-001
title: Especificación - Calculadora de Cambio MXN
type: Specification
status: Published
version: 1.0.0
created_date: 2026-01-10
updated_date: 2026-01-10
tags: [specification, pos, cash, mexico, algorithm]
---

---

6. BLOQUE D: OTROS DOCUMENTOS

T-D1: ADRs (4 archivos)

Plantilla:

---
id: ADR-MCH-NNNN
title: "{Título del ADR}"
type: ADR
status: Accepted
date: YYYY-MM-DD
---

Archivo	ID
ADR-0001-multi-tenant-architecture.md	ADR-MCH-0001
ADR-0002-whatsapp-first-approach.md	ADR-MCH-0002
ADR-0003-llm-agnostic-strategy.md	ADR-MCH-0003

T-D2: Integraciones Existentes (4 archivos)

Plantilla:

---
id: INT-MCH-NNN
title: "{Nombre de integración}"
type: Integration
status: Published|Draft
provider: "{Proveedor}"
priority: P0|P1|P2
implementation_status: "{porcentaje}"
---

Archivo	ID	Provider	Status
INT-001-whatsapp-meta.md	INT-MCH-001	Meta	95%
INT-002-stripe.md	INT-MCH-002	Stripe	100%
INT-003-openrouter.md	INT-MCH-003	OpenRouter	90%
INT-004-mercadopago.md	INT-MCH-004	MercadoPago	0%

T-D3: Transversal (2 archivos)

---
id: TRANS-MCH-NNN
title: "{Título}"
type: Transversal
status: Published
---

Archivo	ID
ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md	TRANS-MCH-001
GUIA-DESPLIEGUE.md	TRANS-MCH-002

T-D4: Crear 90-transversal/_MAP.md

Contenido:

# Documentación Transversal - MiChangarrito

**Versión:** 1.0.0
**Actualizado:** 2026-01-10

---

## Documentos en esta Carpeta

| # | Documento | Descripción | Estado |
|---|-----------|-------------|--------|
| 1 | ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md | Multi-tenancy WhatsApp/LLM | Publicado |
| 2 | GUIA-DESPLIEGUE.md | Guía de despliegue Docker | Publicado |

---

## Referencias

- [Volver a docs/](../_MAP.md)
- [Especificaciones](../02-especificaciones/_MAP.md)
- [Integraciones](../02-integraciones/_MAP.md)

---

7. BLOQUE E: INTEGRACIONES NUEVAS

Plantilla para Nuevas Integraciones

# INT-XXX: {Nombre Integración}

---
id: INT-MCH-XXX
title: Integración {Nombre}
type: Integration
status: Draft
provider: "{Proveedor}"
priority: P1|P2
implementation_status: "0%"
created_date: 2026-01-10
updated_date: 2026-01-10
---

## 1. Resumen

| Campo | Valor |
|-------|-------|
| **Proveedor** | {Nombre} |
| **Tipo** | {Pagos/Comunicación/IA/etc} |
| **Prioridad** | P1|P2 |
| **Estado** | Solo Documentación |
| **Documentación Oficial** | {URL} |

## 2. Propósito

{Descripción del propósito de la integración}

## 3. Configuración

### Variables de Entorno

```env
{PROVIDER}_API_KEY=
{PROVIDER}_SECRET=

SDK/Librería

npm install {package}

4. Flujos Principales

Flujo 1: {Nombre}

// Código de ejemplo

5. Webhooks

{Descripción de webhooks si aplica}

6. Costos/Comisiones

Concepto	Costo
{item}	{valor}

7. Referencias

• Documentación: {URL}
• SDK: {URL}

---

Última actualización: 2026-01-10

### T-E1 a T-E5: Crear Archivos

| Tarea | Archivo | Proveedor | Prioridad |
|-------|---------|-----------|-----------|
| T-E1 | INT-005-clip.md | Clip | P2 |
| T-E2 | INT-006-codi-banxico.md | Banxico | P1 |
| T-E3 | INT-007-firebase-fcm.md | Google | P1 |
| T-E4 | INT-008-google-vision.md | Google | P2 |
| T-E5 | INT-009-whisper.md | OpenAI | P2 |

---

## 8. BLOQUE F: CONSOLIDACIÓN Y LIMPIEZA

### T-F1: Archivar Documentos Redundantes

**Crear directorio si no existe:**
```bash
mkdir -p orchestration/analisis/historico/2026-01-10/

Mover archivos:

# Conjunto 3: Corrección Integración
mv PLAN-CORRECCION-INTEGRACION-2026-01-10.md historico/2026-01-10/

# Conjunto 4: Fase 1 (después de consolidar)
mv FASE-1-ANALISIS-PLANEACION-INICIAL-2026-01-10.md historico/2026-01-10/

T-F2: Actualizar Referencias Cruzadas

Archivos a actualizar:

1. PLAN-MAESTRO-PURGA-DOCUMENTAL-2026-01-10.md - Actualizar referencias
2. PLAN-REFINADO-INTEGRACION-2026-01-10.md - Es la versión actual
3. CONSOLIDADO-FASE1-ANALISIS-INICIAL-2026-01-10.md - Documento principal

T-F3: Verificar Integridad

Checklist de verificación:

• Todos los archivos movidos a historico/
• Referencias actualizadas
• Sin links rotos
• _MAP.md de analisis/ actualizado si existe

---

9. CRONOGRAMA DE EJECUCIÓN

Sprint de Estandarización

DÍA 1: BLOQUE A (Inventarios) - 4 horas
├── T-A1: DATABASE_INVENTORY.yml (1h)
├── T-A2: BACKEND_INVENTORY.yml (1h)
├── T-A3: FRONTEND_INVENTORY.yml (30min)
├── T-A4: MASTER_INVENTORY.yml (30min)
└── T-A5: DEPENDENCIAS.yml (30min)

DÍA 1-2: BLOQUE B (Épicas) - 3 horas
├── T-B1: MCH-001 a MCH-010 (1h)
├── T-B2: MCH-011 a MCH-020 (1h)
└── T-B3: MCH-021 a MCH-028 (1h)

DÍA 2: BLOQUE C (Especificaciones) - 2 horas
├── T-C1 a T-C6: 6 especificaciones (2h)

DÍA 2-3: BLOQUE D (Otros) - 2 horas
├── T-D1: ADRs (30min)
├── T-D2: Integraciones (30min)
├── T-D3: Transversal (30min)
└── T-D4: _MAP.md (30min)

DÍA 3: BLOQUE E (Nuevas Integraciones) - 3 horas
├── T-E1 a T-E5: 5 integraciones (3h)

DÍA 3: BLOQUE F (Consolidación) - 1 hora
├── T-F1: Archivar (30min)
├── T-F2: Referencias (15min)
└── T-F3: Verificar (15min)

Total Estimado: ~15 horas de trabajo

---

10. MÉTRICAS DE ÉXITO

Antes vs Después

Métrica	Antes	Después	Meta
Conformidad SIMCO	75%	95%	✅
Documentos con frontmatter	3 (5.5%)	53 (100%)	✅
Inventarios sincronizados	76.9%	100%	✅
Integraciones documentadas	44% (4/9)	100% (9/9)	✅
Redundancias	~6 conjuntos	0	✅
_MAP.md completos	83% (5/6)	100% (6/6)	✅

Checklist de Completitud

BLOQUE A:

• DATABASE_INVENTORY.yml actualizado
• BACKEND_INVENTORY.yml actualizado
• FRONTEND_INVENTORY.yml actualizado
• MASTER_INVENTORY.yml sincronizado
• DEPENDENCIAS.yml v2.1.0

BLOQUE B:

• 28 épicas con frontmatter

BLOQUE C:

• 6 especificaciones con frontmatter
• INVESTIGACION-REFERENCIAS actualizado
• PLAN-DESARROLLO actualizado

BLOQUE D:

• 4 ADRs con frontmatter
• 4 integraciones con frontmatter
• 2 transversal con frontmatter
• 90-transversal/_MAP.md creado

BLOQUE E:

• INT-005-clip.md creado
• INT-006-codi-banxico.md creado
• INT-007-firebase-fcm.md creado
• INT-008-google-vision.md creado
• INT-009-whisper.md creado

BLOQUE F:

• Archivos redundantes movidos a historico/
• Referencias actualizadas
• Integridad verificada

---

11. RIESGOS Y MITIGACIONES

Riesgo	Probabilidad	Impacto	Mitigación
Referencias rotas después de consolidación	Media	Alto	Verificar todas las referencias antes de mover
Frontmatter inconsistente	Baja	Medio	Usar plantillas estandarizadas
Inventarios con datos incorrectos	Media	Alto	Verificar contra código fuente
Tiempo excede estimación	Media	Medio	Priorizar P0 primero, P2 puede esperar

---

12. PRÓXIMOS PASOS

Después de completar este plan:

1. FASE 4: Validar plan contra análisis de FASE 2
2. FASE 5: Analizar dependencias entre archivos modificados
3. FASE 6: Refinar plan si se detectan problemas
4. FASE 7: Ejecutar plan por bloques
5. FASE 8: Validar ejecución completa

---

Documento generado: 2026-01-10 Agente: Orquestador (PERFIL-ORQUESTADOR) Sistema: SIMCO v3.8.0 + CAPVED Próxima Fase: F4 - Validación del Plan