michangarrito/orchestration/_archive/analisis/PLAN-REFINADO-INTEGRACION-2026-01-10.md

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:

# 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:

# 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