# PLAN REFINADO: Integracion Documentacion-Desarrollo

**Proyecto:** MiChangarrito
**Fecha:** 2026-01-10
**Fase:** FASE 4 - Refinamiento
**Estado:** LISTO PARA EJECUCION
**Version:** 2.0.0

---

## CAMBIOS RESPECTO AL PLAN ORIGINAL

| Aspecto | Plan Original | Plan Refinado |
|---------|---------------|---------------|
| Tareas | 4 principales | 7 principales + 3 post-ejecucion |
| Backups | Implicito | Explicito como T0 |
| Inventarios | No incluido | Incluido como T5-T8 |
| Epicas individuales | No incluido | Incluido como T9 |
| Validacion YAML | No incluido | Incluido en cada paso |

---

## ORDEN DE EJECUCION REFINADO

### BLOQUE 0: PREPARACION

#### T0: Crear Backups
**Prioridad:** P0 - CRITICO
**Dependencias:** Ninguna

**Acciones:**
```bash
# Crear directorio de backup
mkdir -p orchestration/analisis/backup-integracion-2026-01-10

# Copiar documentos a modificar
cp docs/02-especificaciones/ARQUITECTURA-DATABASE.md orchestration/analisis/backup-integracion-2026-01-10/
cp docs/02-especificaciones/INTEGRACIONES-EXTERNAS.md orchestration/analisis/backup-integracion-2026-01-10/
cp docs/02-especificaciones/ESPECIFICACION-COMPONENTES.md orchestration/analisis/backup-integracion-2026-01-10/
cp orchestration/CONTEXT-MAP.yml orchestration/analisis/backup-integracion-2026-01-10/
```

**Validacion:** Verificar 4 archivos en backup

---

### BLOQUE 1: DOCUMENTACION PRINCIPAL

#### T1: Actualizar ARQUITECTURA-DATABASE.md
**Prioridad:** P0 - CRITICO
**Dependencias:** T0
**Lineas a agregar:** ~400

**Sub-tareas detalladas:**

| Sub-tarea | Ubicacion | Lineas | Contenido |
|-----------|-----------|--------|-----------|
| T1.1 | Linea 13-26 | 2 | Actualizar tabla de schemas (9→11) |
| T1.2 | Despues L123 | 50 | Agregar tenant_integration_credentials |
| T1.3 | Despues L123 | 40 | Agregar tenant_whatsapp_numbers |
| T1.4 | Despues L519 | 120 | Agregar 4 tablas CoDi/SPEI |
| T1.5 | Despues L953 | 80 | Agregar 3 tablas referrals |
| T1.6 | Despues L1066 | 150 | Agregar schema billing (5 tablas) |
| T1.7 | Despues billing | 180 | Agregar schema marketplace (6 tablas) |
| T1.8 | Despues L1139 | 60 | Agregar 10 funciones |
| T1.9 | L1249-1262 | 5 | Actualizar orden de ejecucion SQL |

**Validacion post-tarea:**
- [ ] 11 schemas en tabla inicial
- [ ] 47 tablas documentadas
- [ ] 15 funciones documentadas
- [ ] Referencias internas correctas

---

#### T2: Actualizar INTEGRACIONES-EXTERNAS.md
**Prioridad:** P0 - CRITICO
**Dependencias:** T1
**Lineas a agregar:** ~150

**Sub-tareas detalladas:**

| Sub-tarea | Ubicacion | Lineas | Contenido |
|-----------|-----------|--------|-----------|
| T2.1 | Despues seccion 7 | 60 | Agregar seccion SPEI |
| T2.2 | Despues SPEI | 80 | Agregar seccion SAT/CFDI |
| T2.3 | Seccion 3 | 15 | Agregar Azure OpenAI a LLM |
| T2.4 | Actualizar indice | 2 | Agregar SPEI y SAT al indice |

**Validacion post-tarea:**
- [ ] 11 integraciones en indice
- [ ] SPEI documentado
- [ ] SAT/CFDI documentado
- [ ] LLM providers actualizado

---

#### T3: Actualizar ESPECIFICACION-COMPONENTES.md
**Prioridad:** P0 - CRITICO
**Dependencias:** T1, T2
**Lineas a agregar:** ~200

**Sub-tareas detalladas:**

| Sub-tarea | Ubicacion | Lineas | Contenido |
|-----------|-----------|--------|-----------|
| T3.1 | Tabla modulos | 10 | Agregar 9 modulos backend |
| T3.2 | Despues modulos | 150 | Agregar endpoints por modulo |
| T3.3 | Tabla paginas | 6 | Agregar 5 paginas frontend |
| T3.4 | Tabla componentes | 5 | Actualizar versiones |
| T3.5 | Tabla modulos | -1 | Remover UsersModule |

**Validacion post-tarea:**
- [ ] 17 modulos en tabla
- [ ] 11 paginas en tabla
- [ ] Versiones actualizadas (React 19, Vite 7.2)
- [ ] UsersModule removido

---

#### T4: Actualizar CONTEXT-MAP.yml
**Prioridad:** P1 - ALTO
**Dependencias:** T1, T2, T3
**Lineas a modificar:** ~30

**Sub-tareas detalladas:**

| Sub-tarea | Epica | Cambio |
|-----------|-------|--------|
| T4.1 | MCH-023 | estado: pendiente → completado |
| T4.2 | MCH-024 | estado: pendiente → completado |
| T4.3 | MCH-025 | estado: pendiente → completado |
| T4.4 | MCH-027 | estado: pendiente → completado |
| T4.5 | MCH-028 | estado: pendiente → completado |

**Validacion post-tarea:**
- [ ] YAML valido (parser test)
- [ ] 5 epicas actualizadas
- [ ] Referencias correctas

---

### BLOQUE 2: SINCRONIZACION DE INVENTARIOS

#### T5: Actualizar DATABASE_INVENTORY.yml
**Prioridad:** P1 - ALTO
**Dependencias:** T1

**Cambios:**
- Agregar schemas: billing, marketplace
- Agregar 20 tablas nuevas
- Actualizar conteos

---

#### T6: Actualizar BACKEND_INVENTORY.yml
**Prioridad:** P1 - ALTO
**Dependencias:** T3

**Cambios:**
- Agregar 9 modulos nuevos
- Agregar ~70 endpoints
- Actualizar conteos

---

#### T7: Actualizar FRONTEND_INVENTORY.yml
**Prioridad:** P1 - ALTO
**Dependencias:** T3

**Cambios:**
- Agregar 5 paginas nuevas
- Actualizar conteos

---

#### T8: Actualizar MASTER_INVENTORY.yml
**Prioridad:** P1 - ALTO
**Dependencias:** T5, T6, T7

**Cambios:**
- Consolidar todos los cambios
- Actualizar metricas globales

---

### BLOQUE 3: VERIFICACION DE EPICAS

#### T9: Verificar Epicas Individuales
**Prioridad:** P2 - MEDIO
**Dependencias:** T4

**Archivos a verificar:**

| Archivo | Verificar |
|---------|-----------|
| docs/01-epicas/MCH-023-programa-referidos.md | Estado consistente |
| docs/01-epicas/MCH-024-codi-spei.md | Estado consistente |
| docs/01-epicas/MCH-025-facturacion-electronica.md | Estado consistente |
| docs/01-epicas/MCH-027-integracion-sat.md | Estado consistente |
| docs/01-epicas/MCH-028-marketplace-proveedores.md | Estado consistente |

---

### BLOQUE 4: VALIDACION FINAL

#### T10: Validacion de Coherencia
**Prioridad:** P0 - CRITICO
**Dependencias:** Todas las anteriores

**Checklist:**
- [ ] 11 schemas en ARQUITECTURA-DATABASE = 11 en inventario
- [ ] 17 modulos en ESPECIFICACION = 17 en inventario
- [ ] 11 paginas en ESPECIFICACION = 11 en inventario
- [ ] 11 integraciones documentadas
- [ ] 28 epicas con estados correctos
- [ ] Sin referencias rotas
- [ ] YAML sin errores de sintaxis

---

## CRONOGRAMA DE EJECUCION

```
BLOQUE 0: Preparacion
└── T0: Backups ────────────────────────── [5 min]

BLOQUE 1: Documentacion Principal (en paralelo no recomendado)
├── T1: ARQUITECTURA-DATABASE.md ───────── [30 min]
├── T2: INTEGRACIONES-EXTERNAS.md ──────── [15 min]
├── T3: ESPECIFICACION-COMPONENTES.md ──── [20 min]
└── T4: CONTEXT-MAP.yml ────────────────── [10 min]

BLOQUE 2: Inventarios (en paralelo posible)
├── T5: DATABASE_INVENTORY.yml ─────────── [10 min]
├── T6: BACKEND_INVENTORY.yml ──────────── [10 min]
├── T7: FRONTEND_INVENTORY.yml ─────────── [5 min]
└── T8: MASTER_INVENTORY.yml ───────────── [5 min]

BLOQUE 3: Epicas
└── T9: Verificacion ───────────────────── [10 min]

BLOQUE 4: Validacion
└── T10: Validacion final ──────────────── [15 min]
```

---

## METRICAS DE EXITO

### Cobertura Documentacion

| Metrica | Antes | Despues | Exito |
|---------|-------|---------|-------|
| Schemas documentados | 9 | 11 | 100% |
| Tablas documentadas | 27 | 47 | 100% |
| Funciones documentadas | 5 | 15 | 100% |
| Modulos documentados | 9 | 17 | 100% |
| Endpoints documentados | ~50 | ~120 | 100% |
| Paginas documentadas | 7 | 11 | 100% |
| Integraciones documentadas | 9 | 11 | 100% |
| Epicas correctamente marcadas | 22 | 27 | 100% |

### Calidad

| Metrica | Umbral | Medicion |
|---------|--------|----------|
| Referencias rotas | 0 | Validar links |
| Errores YAML | 0 | Parser test |
| Inconsistencias | 0 | Cross-check |

---

## PUNTOS DE CONTROL (CHECKPOINTS)

### CP1: Despues de T1
- Validar ARQUITECTURA-DATABASE.md
- Verificar 11 schemas
- Verificar estructura markdown

### CP2: Despues de T4
- Validar todos los documentos principales
- Verificar YAML syntax
- Verificar referencias cruzadas

### CP3: Despues de T8
- Validar inventarios sincronizados
- Verificar conteos

### CP4: Final (T10)
- Validacion completa
- Crear reporte de ejecucion

---

## PLAN DE ROLLBACK

### Si falla cualquier tarea:
1. Detener ejecucion
2. Restaurar desde backup (T0)
3. Analizar fallo
4. Corregir plan
5. Reintentar

### Comandos de rollback:
```bash
# Restaurar todos los archivos
cp orchestration/analisis/backup-integracion-2026-01-10/ARQUITECTURA-DATABASE.md docs/02-especificaciones/
cp orchestration/analisis/backup-integracion-2026-01-10/INTEGRACIONES-EXTERNAS.md docs/02-especificaciones/
cp orchestration/analisis/backup-integracion-2026-01-10/ESPECIFICACION-COMPONENTES.md docs/02-especificaciones/
cp orchestration/analisis/backup-integracion-2026-01-10/CONTEXT-MAP.yml orchestration/
```

---

## RESUMEN DE TAREAS

| ID | Tarea | Prioridad | Dependencias | Estimado |
|----|-------|-----------|--------------|----------|
| T0 | Backups | P0 | - | 5 min |
| T1 | ARQUITECTURA-DATABASE.md | P0 | T0 | 30 min |
| T2 | INTEGRACIONES-EXTERNAS.md | P0 | T1 | 15 min |
| T3 | ESPECIFICACION-COMPONENTES.md | P0 | T1,T2 | 20 min |
| T4 | CONTEXT-MAP.yml | P1 | T1-T3 | 10 min |
| T5 | DATABASE_INVENTORY.yml | P1 | T1 | 10 min |
| T6 | BACKEND_INVENTORY.yml | P1 | T3 | 10 min |
| T7 | FRONTEND_INVENTORY.yml | P1 | T3 | 5 min |
| T8 | MASTER_INVENTORY.yml | P1 | T5-T7 | 5 min |
| T9 | Verificar Epicas | P2 | T4 | 10 min |
| T10 | Validacion Final | P0 | Todas | 15 min |

**Total estimado:** ~2 horas

---

## ESTADO

**Plan Refinado:** APROBADO
**Listo para:** FASE 5 - Ejecucion

---

**Ultima actualizacion:** 2026-01-10
**Version:** 2.0.0