# 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”.