48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# D5.3.8 — Estructura local de inventario según la fuente
|
|
|
|
Versión: `0.19.3-8`.
|
|
|
|
## Motivo
|
|
|
|
Los inventarios reales muestran que, después del contexto territorial Área/Yacimiento, cada operadora puede usar su propia nomenclatura para instalaciones, sectores, baterías, plantas, SET, PTC, PTA y otros agrupadores. Esa terminología no debe convertirse automáticamente en una jerarquía universal de DH.
|
|
|
|
D5.3.8 preserva la estructura local declarada por la fuente y separa **identidad/nomenclatura de origen** de una futura **clasificación normalizada por DH**.
|
|
|
|
## Modelo
|
|
|
|
Se incorpora el tipo provisional `estructura_local` / **Estructura local (fuente)**. Es un activo estructural GENERIC y en DRAFT que puede colgar de Área, Yacimiento o Locación y actuar como padre de activos técnicos compatibles.
|
|
|
|
Sus atributos conservan:
|
|
|
|
- nivel informado por la fuente;
|
|
- clasificación local informada;
|
|
- ruta/nomenclatura de origen.
|
|
|
|
La identidad nunca es global por nombre: se concilia dentro del contexto Área/Yacimiento + Operadora + padre.
|
|
|
|
## Importador de inventarios
|
|
|
|
Para PSEnergy y perfiles equivalentes:
|
|
|
|
- si la ubicación contiene una instancia local concreta (`BATATA01`, `PTCVIZ01`, etc.), se conserva esa denominación;
|
|
- si sólo existen categorías locales (`ENERGIA / SET`, `YACIMIENTO / BATERIA`), se conserva el grupo provisional sin afirmar que sea una instalación física universal;
|
|
- `pozo`, `ducto` y `colector` continúan anclándose directamente al contexto territorial para evitar inferir una jerarquía física incorrecta;
|
|
- ya no se generan nombres `[A VALIDAR]` para inventar instalaciones;
|
|
- la clasificación posterior puede cambiar sin perder el literal ni la ruta original.
|
|
|
|
## Ambigüedad territorial
|
|
|
|
Si un nombre como Atamisqui puede corresponder a más de un Área/Yacimiento válido, el plan genera **una sola decisión raíz por contexto**, no decenas de conflictos derivados.
|
|
|
|
La UI muestra las alternativas con su Área padre. La selección se guarda únicamente para ese lote. Al regenerar el plan se recalculan automáticamente estructura local, padres y activos dependientes.
|
|
|
|
Así, “falta instalación” o “padre sin resolver” dejan de presentarse como decisiones independientes cuando son sólo consecuencia de un Área/Yacimiento todavía ambiguo.
|
|
|
|
## Seguridad
|
|
|
|
La fase mantiene plan previo, huella de Maestro, protección contra plan obsoleto, aplicación transaccional, idempotencia, procedencia, reversión lógica y reglas de contexto operativo.
|
|
|
|
Agrega una migración para `LOCAL_STRUCTURE`, el tipo `estructura_local`, sus atributos y reglas de padres.
|
|
|
|
Antes de tocar producción el deploy crea el backup fuerte **INVENTARIO A REVISAR**.
|