clinica-dental/orchestration/directivas/checklists/CHECKLIST-CIERRE.md

CHECKLIST-CIERRE: Gate Final de Tarea

Version: 1.0.0 Actualizado: 2026-01-18 Alias: @CHK-CIERRE, @DEF_CHK_POST

Proposito

Gate BLOQUEANTE final antes de marcar una tarea como completada. NINGUN ITEM PUEDE QUEDAR SIN MARCAR.

---

SECCION 1: GOBERNANZA (OBLIGATORIO)

Estructura de Tarea

• Carpeta de tarea existe: orchestration/tareas/TASK-YYYY-MM-DD-NNN/
• METADATA.yml completo y correcto
• SUBTASKS.yml con summary actualizado
• LESSONS-LEARNED.yml iniciado (minimo summary)

Registro en Indices

• Entrada en orchestration/tareas/_INDEX.yml
• Status: completed
• Path correcto

---

SECCION 2: VALIDACIONES TECNICAS (OBLIGATORIO)

Build (segun dominios afectados)

• Backend: npm run build PASA
• Frontend: npm run build PASA
• Database: recreate-database.sh exitoso

Lint

• Backend: npm run lint PASA (< 5 warnings nuevos)
• Frontend: npm run lint PASA

Tests

• Backend: npm run test PASA (tests existentes)
• Frontend: npm run test PASA (si existen)
• Ningun test nuevo falla

TypeCheck

• Frontend: npm run typecheck PASA

---

SECCION 3: COHERENCIA ENTRE CAPAS (OBLIGATORIO)

DDL -> Backend

• Toda tabla nueva tiene entity correspondiente
• Campos de entity coinciden con columnas de tabla
• Tipos TypeScript compatibles con tipos PostgreSQL
• EXCEPCIONES documentadas (tablas M:N, audit, etc.)

Backend -> Frontend (si aplica)

• Endpoints nuevos documentados
• DTOs expuestos correctamente
• Frontend consume endpoints correctamente

---

SECCION 4: INVENTARIOS (OBLIGATORIO)

Actualizacion

• DATABASE_INVENTORY.yml actualizado (si cambio DDL)
• BACKEND_INVENTORY.yml actualizado (si cambio backend)
• FRONTEND_INVENTORY.yml actualizado (si cambio frontend)
• MASTER_INVENTORY.yml actualizado con totales

Cobertura

• Cobertura de inventarios = 100% (sin objetos sin documentar)

---

SECCION 5: TRAZAS (OBLIGATORIO)

Archivos de Traza

• TRAZA-TAREAS-*.md correspondiente actualizado
• Cambios documentados con fecha y descripcion

SSOT (si nueva funcionalidad)

• TRACEABILITY-MASTER.yml actualizado
• EPIC-INDEX.yml actualizado si cambio estado de epica

---

SECCION 6: PROPAGACION (EVALUACION)

Evaluacion

• Se evaluo si cambio requiere propagacion a otros proyectos
• Si SI requiere: plan de propagacion documentado
• Si NO requiere: marcado como N/A

---

SECCION 7: GIT (OBLIGATORIO)

Estado del Repositorio

• git status = "working tree clean"
• Todos los cambios commiteados
• Commit message sigue convencion: [TASK-ID] tipo: descripcion

Push (segun politica)

• Cambios pusheados a remote (si aplica)
• git log origin/main..HEAD vacio (si aplica)

---

RESUMEN DE VALIDACION

Seccion	Estado
1. Gobernanza	[ ] PASA
2. Validaciones Tecnicas	[ ] PASA
3. Coherencia Entre Capas	[ ] PASA
4. Inventarios	[ ] PASA
5. Trazas	[ ] PASA
6. Propagacion	[ ] EVALUADO
7. Git	[ ] PASA

---

CRITERIO FINAL

TAREA COMPLETADA si:

• TODAS las secciones marcadas como PASA/EVALUADO
• NINGUN item critico sin marcar
• NINGUN build/lint/test fallando

TAREA NO COMPLETADA si:

• Cualquier seccion falla
• Items pendientes sin justificacion
• Errores de build/lint/test

---

ACCION POST-CIERRE

Si PASA:

1. Marcar METADATA.yml status: completed
2. Marcar SUBTASKS.yml todas completadas
3. Actualizar _INDEX.yml con status: completed
4. Commit final con mensaje: [TASK-ID] docs: cierre de tarea

Si NO PASA:

1. Identificar items faltantes
2. Completar items
3. Re-ejecutar este checklist

---

NOTAS

Este checklist integra:

• @TRIGGER_CIERRE - Trigger de cierre obligatorio
• @TRIGGER_COHERENCIA - Coherencia entre capas
• @TRIGGER_INVENTARIOS - Inventarios sincronizados

NO se puede marcar tarea como completada sin pasar este checklist.

---

Referencias

• Trigger Cierre: orchestration/directivas/triggers/TRIGGER-CIERRE-TAREA-OBLIGATORIO.md
• Trigger Coherencia: orchestration/directivas/triggers/TRIGGER-COHERENCIA-CAPAS.md
• Trigger Inventarios: orchestration/directivas/triggers/TRIGGER-INVENTARIOS-SINCRONIZADOS.md