dh-inspeccion-v2/docs/PHASE_D5_3_1.md

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.