michangarrito/orchestration/directivas/checklists/CHECKLIST-FASE-E.md

CHECKLIST-FASE-E: Gate de Ejecucion

Version: 1.0.0 Actualizado: 2026-01-18 Alias: @CHK-EJECUCION

Proposito

Validar ejecucion por checkpoints. Cada checkpoint es un gate de validacion.

---

Checkpoint CP1: Post-Database

Ejecutar despues de cambios en DDL

Validaciones

• DDL ejecuta sin errores de sintaxis
• ./scripts/recreate-database.sh exitoso
• Tablas creadas/modificadas verificadas
• Enums definidos correctamente
• Foreign keys validas
• Indexes creados si aplica

Comandos de Validacion

cd apps/database
./scripts/recreate-database.sh
# Verificar output sin errores

Criterios de Paso CP1

• Sin errores de ejecucion DDL
• Estructura de BD consistente

---

Checkpoint CP2: Post-Backend

Ejecutar despues de cambios en Backend

Validaciones

• npm run build - PASA
• npm run lint - PASA (o warnings aceptables)
• npm run test - PASA (si existen tests)
• Entity alineada con DDL (campos, tipos)
• DTO definidos correctamente
• Service implementado
• Controller endpoints funcionan

Comandos de Validacion

cd apps/backend
npm run build
npm run lint
npm run test

Criterios de Paso CP2

• Build exitoso
• Lint pasa (< 5 warnings nuevos)
• Tests existentes pasan
• No hay errores de TypeScript

---

Checkpoint CP3: Post-Frontend

Ejecutar despues de cambios en Frontend

Validaciones

• npm run build - PASA
• npm run typecheck - PASA
• Componentes renderizan sin errores
• Integracion con API funciona
• Tipos alineados con backend DTOs

Comandos de Validacion

cd apps/frontend
npm run build
npm run typecheck

Criterios de Paso CP3

• Build exitoso
• Typecheck pasa
• Sin errores de consola en runtime

---

Checkpoint CP4: Coherencia Entre Capas

Ejecutar al final de ejecucion

Validaciones

• Entity alineada con DDL:

  • Todos los campos de tabla tienen propiedad en entity
  • Tipos TypeScript compatibles con tipos PostgreSQL
  • Relaciones correctamente definidas

• DTO alineado con Entity:

  • DTOs exponen campos necesarios
  • Transformaciones correctas
  • Validaciones implementadas

• Frontend consume correctamente:

  • Endpoints correctos
  • Tipos de respuesta alineados
  • Manejo de errores

Matriz de Coherencia

DDL	Backend Entity	Backend DTO	Frontend
[ ] Tabla	[ ] Entity	[ ] DTO	[ ] API call

Criterios de Paso CP4

• Sin gaps de coherencia criticos
• Documentacion de gaps menores si existen

---

Checklist General de Ejecucion

Durante Ejecucion

• Seguir orden de SUBTASKS.yml
• Marcar subtareas completadas conforme avanzan
• No saltarse checkpoints
• Documentar decisiones tomadas

Manejo de Errores

• Si falla un checkpoint: detener y resolver
• No avanzar con errores pendientes
• Documentar errores encontrados y resoluciones

Control de Cambios

• Commits atomicos por subtarea
• Mensajes de commit descriptivos
• No mezclar cambios no relacionados

---

Criterios de Paso Fase E

PASA si:

• CP1 pasa (si hubo cambios DB)
• CP2 pasa (si hubo cambios BE)
• CP3 pasa (si hubo cambios FE)
• CP4 pasa
• Todas las subtareas de E marcadas como completadas

NO PASA si:

• Cualquier checkpoint falla
• Build/lint/test fallan
• Gaps de coherencia criticos

---

Siguiente Fase

Si PASA: Continuar a Fase D: Documentacion Si NO PASA: Resolver errores y re-ejecutar checkpoint

---

Referencias

• Trigger Coherencia: orchestration/directivas/triggers/TRIGGER-COHERENCIA-CAPAS.md
• Inventarios: orchestration/inventarios/