workspace-v1/orchestration/checklists/CHECKLIST-SINCRONIZACION-BD.md

CHECKLIST: Sincronización Base de Datos

Versión: 1.0.0 Alias: @CHK_SYNC_BD Referencia: SIMCO-SINCRONIZACION-BD.md Items Totales: 70 Fecha: 2026-01-10

---

Instrucciones de Uso

1. Ejecutar después de CUALQUIER cambio en DDL
2. Marcar cada item conforme se valida [x]
3. Si un item no aplica, marcar [N/A] con razón
4. NO omitir la ejecución de recreación (paso 3)
5. Guardar checklist completado como evidencia

---

1. PRE-SINCRONIZACIÓN (10 items)

Objetivo: Preparar ambiente para sincronización

• 1.1 Backup de BD realizado (si tiene datos importantes)
• 1.2 Estado inicial de BD documentado
• 1.3 Lista de cambios DDL a sincronizar preparada
• 1.4 Objetos dependientes identificados (tablas, views, funciones)
• 1.5 No hay transacciones pendientes en BD
• 1.6 Scripts actuales revisados
• 1.7 Permisos de ejecución de scripts verificados
• 1.8 Versión actual de schemas documentada
• 1.9 Changelog de BD revisado
• 1.10 Ambiente de trabajo confirmado (dev/staging)

Cambios DDL a sincronizar:

[Listar aquí los cambios específicos]
-
-

---

2. SINCRONIZACIÓN DDL → SCRIPTS (15 items)

Objetivo: Actualizar scripts de creación de BD

Archivos DDL

• 2.1 Archivo DDL actualizado/creado en ubicación correcta
• 2.2 Sintaxis SQL válida
• 2.3 Schema especificado en objetos

Scripts Principales

• 2.4 create-database.sh actualizado
• 2.5 recreate-database.sh actualizado
• 2.6 drop-database.sh actualizado (si existe)

Orden de Ejecución

• 2.7 Extensiones declaradas primero
• 2.8 Schemas creados en orden correcto
• 2.9 Tablas sin FK creadas antes que tablas con FK
• 2.10 Dependencias entre tablas respetadas
• 2.11 Constraints agregados después de tablas

Objetos Adicionales

• 2.12 Índices incluidos en scripts
• 2.13 Funciones incluidas en scripts
• 2.14 Triggers incluidos en scripts
• 2.15 RLS policies incluidas en scripts

Scripts modificados:

[Listar scripts modificados]
-
-

---

3. EJECUCIÓN DE RECREACIÓN (10 items)

Objetivo: Validar que scripts funcionan correctamente

Pre-Ejecución

• 3.1 Variables de entorno configuradas
• 3.2 Conexiones a BD cerradas

Ejecución

• 3.3 Ejecutar recreate-database.sh
• 3.4 Sin errores de sintaxis SQL
• 3.5 Sin errores de dependencias

Post-Ejecución

• 3.6 Todos los schemas creados
• 3.7 Todas las tablas creadas
• 3.8 Todos los constraints activos
• 3.9 Todos los índices creados
• 3.10 Seeds ejecutados (si aplica)

Resultado de recreación:

[Pegar output relevante o confirmar éxito]

---

4. SINCRONIZACIÓN DDL → BACKEND (15 items)

Objetivo: Actualizar código backend para reflejar cambios DDL

Entities

• 4.1 Entity creada/actualizada para tabla modificada
• 4.2 Decoradores @Column correctos
• 4.3 Tipos TypeScript correctos vs tipos SQL
• 4.4 Relaciones (@ManyToOne, @OneToMany, etc.) actualizadas
• 4.5 Decoradores de validación actualizados

DTOs

• 4.6 CreateDTO actualizado
• 4.7 UpdateDTO actualizado
• 4.8 ResponseDTO actualizado
• 4.9 Validadores (class-validator) actualizados

Servicios y Repositorios

• 4.10 Repository actualizado si nuevos métodos necesarios
• 4.11 Service actualizado si lógica de negocio afectada
• 4.12 Controller actualizado si endpoints afectados

Tests

• 4.13 Tests de entity actualizados
• 4.14 Tests de service actualizados
• 4.15 Tests e2e actualizados

Archivos backend modificados:

[Listar archivos]
-
-

---

5. SINCRONIZACIÓN DDL → FRONTEND (10 items)

Objetivo: Actualizar código frontend para reflejar cambios de API

Nota: Solo aplica si los cambios de BD afectan la API

Types

• 5.1 Types/interfaces actualizados
• 5.2 DTOs frontend actualizados (si los hay)

Componentes

• 5.3 Formularios actualizados (nuevos campos)
• 5.4 Validaciones frontend actualizadas
• 5.5 Componentes de visualización actualizados

Estado y Queries

• 5.6 Queries/mutations actualizados
• 5.7 Estado (store) actualizado si aplica

Tests

• 5.8 Tests frontend actualizados
• 5.9 Mocks actualizados
• 5.10 Fixtures actualizados

Archivos frontend modificados:

[Listar archivos o marcar N/A si no aplica]
-
-

---

6. ACTUALIZACIÓN DE INVENTARIOS (10 items)

Objetivo: Mantener inventarios como SSOT

DATABASE_INVENTORY.yml

• 6.1 Schemas actualizados (count, lista)
• 6.2 Tablas actualizadas (nuevas, modificadas)
• 6.3 Conteo de columnas actualizado
• 6.4 Funciones documentadas
• 6.5 Triggers documentados
• 6.6 Views documentadas

BACKEND_INVENTORY.yml

• 6.7 Entities listadas/actualizadas
• 6.8 Endpoints actualizados

MASTER_INVENTORY.yml

• 6.9 Resumen de BD actualizado
• 6.10 Fecha de actualización cambiada

Inventarios modificados:

[Confirmar actualización]
- [ ] DATABASE_INVENTORY.yml
- [ ] BACKEND_INVENTORY.yml
- [ ] MASTER_INVENTORY.yml

---

RESUMEN DE EJECUCIÓN

Sección	Items	Completados	N/A	Pendientes
1. Pre-Sincronización	10
2. DDL → Scripts	15
3. Ejecución Recreación	10
4. DDL → Backend	15
5. DDL → Frontend	10
6. Inventarios	10
TOTAL	70

---

RESULTADO

Campo	Valor
Fecha de ejecución	{YYYY-MM-DD}
Ejecutado por	{nombre/agente}
Proyecto	{nombre del proyecto}
Cambio DDL	{descripción breve del cambio}
Resultado	{EXITOSO / CON ERRORES / REQUIERE REVISIÓN}

Resumen de Cambios DDL

[Describir cambios realizados]

Errores Encontrados

[Listar errores y cómo se resolvieron]

Validaciones Adicionales Realizadas

[Otras validaciones realizadas]

---

Referencia: @SYNC_BD