111 lines
3.4 KiB
Markdown
111 lines
3.4 KiB
Markdown
# DH V2 · Fase D5.3.5 — Centro de Importaciones y escalabilidad
|
|
|
|
Versión: `0.19.3-5`
|
|
|
|
## Objetivo
|
|
|
|
D5.3.5 parte de D5.3.4 ya desplegada y adapta el Maestro a volúmenes y formatos reales recibidos por la Dirección de Hidrocarburos.
|
|
|
|
La fase tiene dos objetivos:
|
|
|
|
1. evitar que el Asset Center intente cargar árboles completos de miles de activos;
|
|
2. incorporar un Centro de Importaciones que permita analizar XLSX/CSV de forma trazable antes de decidir qué registros se incorporan al Maestro.
|
|
|
|
## Regla de seguridad de esta fase
|
|
|
|
**D5.3.5 NO crea ni modifica activos desde una importación.**
|
|
|
|
Un archivo subido:
|
|
|
|
1. se conserva con SHA-256;
|
|
2. se registra como documento fuente;
|
|
3. se inspecciona y detecta el formato;
|
|
4. se normalizan las filas en una capa de staging;
|
|
5. se detectan advertencias y conflictos;
|
|
6. se muestra una vista previa en el dashboard.
|
|
|
|
La aplicación efectiva al Maestro queda deliberadamente fuera de esta fase.
|
|
|
|
## Perfiles iniciales
|
|
|
|
### `MENDOZA_INVENTORY_V1`
|
|
|
|
Reconoce el esquema general utilizado en inventarios de instalaciones con campos equivalentes a:
|
|
|
|
- Item;
|
|
- Área / Yacimiento;
|
|
- Instalación;
|
|
- Sub instalación;
|
|
- Equipo;
|
|
- Denominación;
|
|
- Ubicación;
|
|
- N° ID / Inventario;
|
|
- Cantidad;
|
|
- Especificaciones técnicas;
|
|
- Estado.
|
|
|
|
El análisis conserva el valor original y propone, cuando es seguro, normalizaciones auxiliares para:
|
|
|
|
- familia técnica;
|
|
- clase/tipo de fuente;
|
|
- fabricante/modelo;
|
|
- estado operativo sugerido;
|
|
- condición sugerida.
|
|
|
|
Los valores ambiguos (`SI/NO`, `S/N`, `Bueno`, etc.) no se transforman automáticamente en un estado operativo definitivo.
|
|
|
|
### `MENDOZA_YACIMIENTOS_V1`
|
|
|
|
Reconoce tablas de referencia con Yacimiento, Área, Departamento, tipo de derecho y Operadora.
|
|
|
|
## Conflictos detectables
|
|
|
|
Entre otros:
|
|
|
|
- campos estructurales faltantes;
|
|
- cantidad inválida;
|
|
- cantidad agrupada mayor a uno;
|
|
- estado fuente que requiere mapeo;
|
|
- ID de inventario repetido;
|
|
- mismo ID de inventario en ubicaciones diferentes;
|
|
- formato no reconocido.
|
|
|
|
La repetición de un ID no se interpreta automáticamente como duplicado real, traslado o error: se deriva a revisión.
|
|
|
|
## Persistencia
|
|
|
|
Se incorporan:
|
|
|
|
- `asset_import_batches`;
|
|
- `asset_import_rows`;
|
|
- permisos `asset_imports.read` y `asset_imports.manage`;
|
|
- índices trigram para búsqueda del Maestro.
|
|
|
|
Los lotes no tienen DELETE para el rol de ejecución de la aplicación. Cancelar un lote cambia su estado y conserva evidencia y archivo para auditoría.
|
|
|
|
## Asset Center escalable
|
|
|
|
D5.3.4 incluía un árbol completo con límite de seguridad. D5.3.5 mantiene ese endpoint por compatibilidad, pero el dashboard utiliza ahora `GET /assets/tree-children`.
|
|
|
|
La jerarquía:
|
|
|
|
- carga sólo el primer nivel;
|
|
- consulta hijos al expandir;
|
|
- limita cada nivel a 200 filas;
|
|
- usa filtros y búsqueda del servidor;
|
|
- no intenta renderizar miles de nodos simultáneamente.
|
|
|
|
La búsqueda del Maestro se amplía a datos relevantes como identificadores externos y ciertos atributos configurables (fabricante, modelo, número de serie y ubicación fuente).
|
|
|
|
## Fuera de alcance
|
|
|
|
D5.3.5 no:
|
|
|
|
- crea activos desde filas de importación;
|
|
- decide automáticamente jerarquías ambiguas por empresa;
|
|
- crea 70+ tipos de activo a partir de denominaciones crudas;
|
|
- modifica hallazgos/checklists;
|
|
- reemplaza el valor original de una fuente.
|
|
|
|
Estos puntos se resolverán progresivamente con perfiles específicos y taxonomía normalizada antes de D5.4.
|