workspace/projects/gamilit/orchestration/reportes/coherencia-2025-12-15/FASE-4-TEMPLATE-VALIDACION.md

FASE 4: VALIDACIÓN DE PLANEACIÓN

Checklist de Validación de Dependencias

Fecha: 2025-12-15 Estado: PENDIENTE (esperando Fase 3) Responsable: Architecture-Analyst

---

1. OBJETIVO

Validar que el plan de correcciones de Fase 3:

• Sea completo (no falten correcciones para discrepancias identificadas)
• Tenga orden correcto (respete dependencias)
• No deje objetos huérfanos o inconsistentes
• Incluya todos los archivos impactados

---

2. CHECKLIST DE COMPLETITUD

2.1 Todas las Discrepancias Tienen Corrección

Discrepancia ID	Severidad	Tiene Corrección	ID Corrección
Se pobla de Fase 2

• Todas las discrepancias P0 tienen corrección asignada
• Todas las discrepancias P1 tienen corrección asignada
• Discrepancias P2/P3 evaluadas (opcional corregir)

2.2 Grafo de Dependencias Sin Ciclos

[Verificar que no existan ciclos]
Ejemplo de ciclo inválido:
CORR-001 → CORR-002 → CORR-003 → CORR-001 (CICLO!)

• Grafo es un DAG (Directed Acyclic Graph)
• Orden topológico posible

2.3 Impacto en Archivos Relacionados

Para cada corrección, verificar:

Corrección	Archivo Principal	Archivos Relacionados	Todos Incluidos
De Fase 3

• Si se modifica DDL, Entity correspondiente verificada
• Si se modifica ENUM DDL, Backend y Frontend ENUMs verificados
• Si se modifica Entity, DTOs relacionados verificados
• Si se modifica Type Frontend, Components que lo usan verificados

---

3. VALIDACIÓN DE SEEDS

3.1 Seeds Afectados por Correcciones

Corrección	Seed Dev	Seed Prod	Requiere Update
De Fase 3

• Seeds usan valores válidos de ENUMs actualizados
• Seeds no referencian FKs que serán eliminados
• Seeds dev y prod están sincronizados

3.2 Orden de Carga de Seeds

• Orden de seeds respeta FKs
• No hay seeds huérfanos post-corrección

---

4. VALIDACIÓN DE SCRIPTS

4.1 Scripts de Base de Datos

Script	Incluye Cambios DDL	Incluye Cambios Seeds
create-database.sh
drop-and-recreate-database.sh

• Scripts incluyen todos los archivos DDL modificados
• Orden de ejecución de scripts es correcto

4.2 Scripts de Migración (si aplica)

• Migración creada si se modifica tabla existente con datos
• Rollback de migración definido

---

5. VALIDACIÓN CROSS-PROYECTO

5.1 Dependencias con Otros Proyectos

Proyecto	Tiene Dependencia	Requiere Cambio
core/orchestration
core/catalog
trading-platform
erp-suite

• Proyectos dependientes identificados
• Cambios necesarios en proyectos dependientes documentados

5.2 Módulos Compartidos

• core/catalog no requiere actualización (o actualizado)
• Directivas SIMCO no afectadas

---

6. VALIDACIÓN DE TIPOS END-TO-END

6.1 Flujo Completo de Datos

Para cada objeto modificado, verificar flujo:

DDL → Entity → Service → Controller → DTO → API → Frontend Type → Component

Objeto	DDL	Entity	Service	Controller	DTO	Frontend
Achievement
UserStats

• Tipos son compatibles en cada transición
• No hay pérdida de datos en conversiones

---

7. RESULTADO DE VALIDACIÓN

7.1 Resumen

Criterio	Estado	Notas
Completitud de correcciones
Orden de dependencias
Archivos relacionados
Seeds actualizados
Scripts actualizados
Cross-proyecto
Tipos end-to-end

7.2 Gaps Identificados

Gap ID	Descripción	Acción Requerida
Si hay

7.3 Aprobación

• Plan de correcciones APROBADO para ejecución
• Gaps identificados agregados al plan
• Orden de ejecución confirmado

---

8. CORRECCIONES ADICIONALES (si se identifican gaps)

Se agregan correcciones adicionales identificadas durante validación

---

Estado: TEMPLATE LISTO Siguiente: Ejecutar validación con resultados de Fase 3