chore: import DH V2 D5.6.4 production baseline

2026-09-05 10:12:35 -03:00
commit 82213e72f5
757 changed files with 84218 additions and 0 deletions
@@ -0,0 +1,60 @@
+# 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.