85 lines
2.8 KiB
Markdown
85 lines
2.8 KiB
Markdown
# DH V2 · Datos de desarrollo y limpieza controlada
|
|
|
|
## Objetivo
|
|
|
|
Durante el desarrollo se necesita poder probar el sistema con datos representativos sin confundirlos con el futuro padrón real. D5.3.2 incorpora un caso demostrativo identificado de forma inequívoca y un limpiador seguro.
|
|
|
|
## Caso demostrativo
|
|
|
|
El seed usa el Informe Técnico Nº 124/2026 exclusivamente como referencia de nomenclatura y estructura:
|
|
|
|
```text
|
|
[PRUEBA] Atamisqui Área
|
|
└── [PRUEBA] Planta de Entrega 3 PB Planta
|
|
├── [PRUEBA] Tanque TK-57 Tanque · 480 m³
|
|
└── [PRUEBA] Tanque TK-58 Tanque · 320 m³
|
|
|
|
[PRUEBA] Petróleos Sudamericanos Energy S.A. Empresa/Operadora
|
|
↕ relación operativa
|
|
[PRUEBA] Atamisqui
|
|
```
|
|
|
|
Todos los activos creados por el seed tienen:
|
|
|
|
- código `DEV-DEMO-*`;
|
|
- nombre visible con prefijo `[PRUEBA]`;
|
|
- procedencia `PROVIDED_DOCUMENT`;
|
|
- referencia `DH-DEV-DEMO:ITN124/2026`;
|
|
- estado de información `DRAFT`;
|
|
- nota expresa de que no son carga maestra real ni validación de vigencia.
|
|
|
|
## Crear o reconstruir el ejemplo
|
|
|
|
Primero debe haberse completado el catálogo técnico desde `Maestro > Tipos y atributos`.
|
|
|
|
```bash
|
|
cd /var/www/dhv2.korexlabs.com
|
|
bash scripts/dev-seed-mendoza-demo.sh
|
|
```
|
|
|
|
El seed rechaza una segunda ejecución mientras existan registros `DEV-DEMO`.
|
|
|
|
## Simular limpieza
|
|
|
|
Este comando es el recomendado durante el desarrollo. **No elimina nada.**
|
|
|
|
```bash
|
|
cd /var/www/dhv2.korexlabs.com
|
|
bash scripts/dev-clean-demo.sh
|
|
```
|
|
|
|
Informa cuántos activos, visitas, actas y relevamientos quedarían afectados.
|
|
|
|
## Limpieza real
|
|
|
|
Sólo usar cuando se quiera reconstruir el demo o preparar una futura entrega limpia:
|
|
|
|
```bash
|
|
cd /var/www/dhv2.korexlabs.com
|
|
bash scripts/dev-clean-demo.sh --apply DH-DEV-DEMO
|
|
```
|
|
|
|
Antes de borrar, el script crea obligatoriamente un `pg_dump` en `/root/DH_V2_BACKUPS/DEV_CLEAN_PRE_*`.
|
|
|
|
## Protección contra mezcla PRUEBA / REAL
|
|
|
|
El script aborta si detecta que un activo no marcado como demo depende física u operativamente de un activo demo, o si una visita, acta, hallazgo o relevamiento mezcla activos demo con activos no demo. Nunca amplía silenciosamente el conjunto a borrar.
|
|
|
|
## Qué se elimina
|
|
|
|
Se eliminan los activos `DEV-DEMO` y, cuando son exclusivamente de prueba, sus relaciones, relevamientos, visitas, actas, hallazgos, comunicaciones, evidencias, firmas, versiones y eventos de auditoría asociados. También se retiran los archivos físicos vinculados.
|
|
|
|
## Qué se conserva
|
|
|
|
Se conservan expresamente:
|
|
|
|
- tipos de activo;
|
|
- atributos y reglas padre/hijo;
|
|
- relaciones/configuración estructural que no sean del demo;
|
|
- usuarios;
|
|
- roles y permisos;
|
|
- catálogo/modelos de hallazgo;
|
|
- configuración general del sistema.
|
|
|
|
La limpieza de desarrollo no equivale a “vaciar la base”.
|