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

```yaml
---
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

```yaml
---
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

```yaml
---
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

```yaml
---
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

```yaml
---
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

```yaml
---
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

```yaml
---
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:**
```yaml
---
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:**
```yaml
---
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)

```yaml
---
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:**
```markdown
# 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

```markdown
# 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

```bash
npm install {package}
```

## 4. Flujos Principales

### Flujo 1: {Nombre}

```typescript
// 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:**
```bash
# 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