3a8a459d91
## Directivas SIMCO v3.7.0 - Estandarizacion de Documentacion (7) - SIMCO-DOCUMENTACION-PROYECTO.md - SIMCO-NOMENCLATURA.md - SIMCO-ESTRUCTURA-DOCS.md - SIMCO-INVENTARIOS.md - SIMCO-TESTING.md - SIMCO-MIGRACIONES-BD.md - SIMCO-INTEGRACIONES-EXTERNAS.md ## Directivas SIMCO v3.8.0 - Mantenimiento de Documentacion (2) - SIMCO-MANTENIMIENTO-DOCUMENTACION.md - SIMCO-SINCRONIZACION-BD.md ## Templates (4) - TEMPLATE-INVENTARIO-PROYECTO.md - TEMPLATE-INTEGRACION-EXTERNA.md - TEMPLATE-MODULO-ESTANDAR.md - TEMPLATE-DEPRECACION.md ## Checklists (6) - CHECKLIST-DOCUMENTACION-PROYECTO.md - CHECKLIST-INVENTARIOS.md - CHECKLIST-NOMENCLATURA.md - CHECKLIST-MANTENIMIENTO-DOCS.md - CHECKLIST-SINCRONIZACION-BD.md - _MAP.md ## Perfil de Agente (1) - PERFIL-DOCUMENTATION-MAINTAINER.md ## Indices - INDICE-DIRECTIVAS-WORKSPACE.yml actualizado a v3.8.0 ## Submodulos actualizados (14) - gamilit, erp-core, michangarrito, template-saas - erp-suite, erp-construccion, erp-clinicas - erp-mecanicas-diesel, erp-retail, erp-vidrio-templado - trading-platform, betting-analytics - inmobiliaria-analytics, platform_marketing_content Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
250 lines
6.0 KiB
Markdown
250 lines
6.0 KiB
Markdown
# 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
|