dh-inspeccion-v2/docs/PHASE_D5_3_7_2.md

Fase D5.3.7.2 — Plan relacional normalizado

Versión: 0.19.3-7.2

Objetivo

Evitar que una importación replique como texto datos maestros que se repiten en cientos de filas. El perfil territorial de Mendoza pasa de una lectura por fila a un plan compuesto por entidades únicas y relaciones explícitas.

Modelo aplicado a Tablas de yacimiento.xlsx

Cada fila fuente conserva su trazabilidad, pero el plan deduplica y separa:

• Departamentos: catálogo normalizado administrative_departments; un Departamento se crea una sola vez.
• Organizaciones / Operadoras: activos de rol COMPANY, con clave canónica que normaliza siglas con puntos (E.M.E.S.A. → emesa, S.R.L. → srl) sin fusionar nombres jurídicos semánticamente distintos.
• Áreas: una entidad por Área.
• Yacimientos: una entidad contextual por Área + Yacimiento; el nombre de Yacimiento no es clave global.
• Área ↔ Departamento: relación histórica explícita en area_department_relations.
• Área ↔ Operadora: relación histórica existente area_company_relations, rol OPERATOR.
• Tipo de derecho: se normaliza al enum jurídico ya existente (EXPLOITATION_CONCESSION, EXPLORATION_PERMIT, TRANSPORT_CONCESSION, OTHER), sin duplicar un catálogo paralelo.
• Derecho / concesión: entidad jurídica area_legal_rights, inicialmente PENDING cuando la fuente sólo informa tipo y Área pero no instrumento o vigencia.
• Derecho ↔ Organización: relación area_legal_right_organizations con rol OPERATOR. No se infiere titularidad, participación ni tenencia.

Sin Empresa Operadora sigue representando ausencia explícita y nunca se convierte en una Organización.

Referencia sobre el archivo real

Sobre un Maestro vacío, el archivo de 230 filas produce conceptualmente:

• 7 Departamentos únicos;
• 12 Organizaciones reales (13 valores fuente menos Sin Empresa Operadora);
• 64 Áreas;
• 64 relaciones Área ↔ Departamento;
• 230 pares contextuales Área + Yacimiento;
• 47 relaciones Área ↔ Operadora;
• 64 derechos normalizados por Área + tipo;
• 47 relaciones Derecho ↔ Organización.

Total de referencia: 535 operaciones de plan, antes de descontar coincidencias que ya existan en el Maestro.

El archivo contiene 26 filas con Sin Empresa Operadora; esas filas no generan una empresa ficticia.

Vista del plan

El frontend agrupa las operaciones en:

1. Territorio.
2. Organizaciones.
3. Marco jurídico.
4. Inventario técnico.

Cada clase de entidad muestra Crear / Coincidir / Revisar / Ignorar / Total y dispone de Ver detalle, paginado, para revisar las entidades únicas y sus filas fuente antes de aplicar.

Seguridad

• El plan se calcula antes de escribir el Maestro.
• Las revisiones bloquean la aplicación.
• La aplicación sigue siendo transaccional y validada por hash.
• Los objetos relacionales se revalidan antes de aplicar.
• El rollback es lógico: finaliza relaciones, revoca derechos creados por el lote, inactiva Departamentos creados por el lote y no ejecuta DELETE FROM assets.
• El usuario debe validar visualmente el plan real antes de pulsar APLICAR.