Files
dh-inspeccion-v2/docs/PHASE_D5_3_1.md
T

61 lines
1.6 KiB
Markdown

# Fase D5.3.1 — Configuración inicial del Maestro
Versión de paquete: `0.19.3-1`
Fase visible: `D5.3.1`
> Se usa `0.19.3-1` porque `0.19.3.1` no es una versión SemVer válida para los
> paquetes npm. Funcionalmente corresponde a la corrección D5.3.1.
## Objetivo
Evitar que una instalación nueva de DH comience con un Maestro totalmente vacío y
obligue a recrear manualmente la taxonomía hidrocarburífera básica.
## Configuración inicial
Desde `Maestro → Tipos y atributos`, cuando no existe ningún tipo, un administrador
puede ejecutar **Instalar configuración base**.
La operación se ejecuta en una sola transacción y crea:
- Área / Concesión (`AREA`);
- Empresa / Operadora (`COMPANY`);
- Yacimiento;
- Instalación de superficie;
- Estación;
- Subestación;
- Pozo;
- Equipo;
- Ducto / Cañería.
También crea sus reglas padre/hijo y atributos opcionales iniciales.
## Seguridad
- requiere `asset_types.manage`;
- sólo puede ejecutarse con `asset_types = 0`;
- bloquea intentos concurrentes;
- no reemplaza ni modifica configuraciones existentes;
- no crea datos operativos reales;
- registra `ASSET_MASTER_BOOTSTRAPPED` en auditoría.
## Fuente de dominio
La taxonomía se alineó con la terminología que usa la Dirección de Hidrocarburos de
Mendoza y con la estructura funcional acordada para DH. Ver:
`docs/DATA_REFERENCE_MENDOZA_HYDROCARBONS.md`.
## Alcance excluido
D5.3.1 no importa automáticamente:
- operadoras actuales;
- concesiones o áreas actuales;
- yacimientos;
- pozos;
- instalaciones;
- métricas públicas de inspección.
Esos datos necesitan una fuente versionada/importable y trazabilidad de vigencia.