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,67 @@
+# Investigación de inventarios reales — criterio de importación DH
+
+## Material analizado durante desarrollo
+
+Se utilizaron inventarios reales recibidos por la Dirección, entre ellos archivos de Petróleos Sudamericanos Energy, EMESA, Petroquímica Comodoro Rivadavia, GyG Oil Service, Cerro Los Leones y una tabla Área/Yacimiento, además de material PDF de Phoenix y otras presentaciones.
+
+El objetivo de la investigación no es considerar esos archivos como padrón vigente automático, sino utilizarlos para diseñar un modelo/importador que no pierda información ni invente correspondencias.
+
+## Resultados de prueba del perfil genérico D5.3.5
+
+Los números siguientes describen el resultado del **analizador**, no registros importados al Maestro:
+
+| Fuente de desarrollo | Filas analizadas | Listas | Advertencias | Conflictos |
+|---|---:|---:|---:|---:|
+| PSEnergy inventario MZA | 8.320 | 8.318 | 2 | 0 |
+| Tabla Área/Yacimiento | 230 | 230 | 0 | 0 |
+| EMESA Loma de la Mina | 85 | 71 | 1 | 13 |
+| PCR Áreas Malargüe | 105 | 63 | 1 | 41 |
+| PCR Llancanelo | 84 | 16 | 2 | 66 |
+| PCR Sosneado | 85 | 60 | 0 | 25 |
+| GyG | 85 | 0 | 0 | 85 |
+| Cerro Los Leones | 85 | 0 | 0 | 85 |
+
+Que un archivo tenga conflictos **no significa que sus datos sean incorrectos**. Significa que el perfil genérico no debe adivinar cómo interpretar secciones desplazadas, encabezados secundarios o usos particulares de las columnas.
+
+## Decisiones derivadas
+
+### 1. No existe una única semántica universal para las columnas
+
+Las planillas comparten un formato visual, pero cada operadora utiliza `Instalación`, `Sub instalación`, `Equipo`, `Denominación` y `Ubicación` de manera diferente.
+
+Por eso D5.3.5 detecta y muestra, pero la aplicación futura deberá disponer de perfiles/mapeos específicos cuando corresponda.
+
+### 2. El ID de inventario no es clave global
+
+Un identificador externo debe conservar namespace/contexto de fuente. Un mismo texto puede repetirse en áreas, instalaciones o registros distintos.
+
+### 3. Cantidad mayor a uno requiere revisión
+
+Una fila con cantidad 2 no habilita al sistema a inventar dos identidades físicas. Se marca como registro agrupado hasta individualización o confirmación.
+
+### 4. Estado fuente se conserva literalmente
+
+Se observaron distintas convenciones: `EN SERVICIO`, `F/Servicio`, `S`, `F/S`, `SI`, `NO`, `Bueno`, etc.
+
+DH conserva el valor fuente y sólo genera una sugerencia cuando la equivalencia es inequívoca.
+
+### 5. Familia normalizada y clasificación fuente deben coexistir
+
+Ejemplos como `Clase: BBA; Tipo: CEN`, AIB, PCP, motores, válvulas y otras denominaciones demuestran que no conviene convertir toda clasificación de origen en un tipo de activo del Maestro.
+
+La evolución prevista es:
+
+- familia técnica DH;
+- subtipo DH;
+- clase/tipo original de la fuente;
+- fabricante/modelo/especificación original.
+
+### 6. El Asset Center debe usar carga por demanda
+
+Una sola fuente de desarrollo supera las ocho mil filas. El árbol completo de D5.3.4 no es una estrategia sostenible, por lo que D5.3.5 usa expansión lazy server-side.
+
+## Principio de implementación
+
+**Ante una ambigüedad, DH debe mostrarla y pedir revisión; no debe inferir silenciosamente.**
+
+Esto es especialmente importante porque los datos se usarán después para planificación, checklist, hallazgos, evidencias e informes oficiales.