dh-inspeccion-v2/docs/PHASE_D5_3_9.md

D5.3.9 — Revisión obligatoria clara

Versión: 0.19.3-9.

Motivo

D5.3.8 corrigió el modelo conceptual del inventario: la ambigüedad territorial se resuelve como una causa raíz y la nomenclatura propia de cada operadora se preserva como estructura local. Sin embargo, la interfaz todavía mostraba las decisiones humanas y sus consecuencias técnicas en una misma lista, lo que podía hacer pensar que cada instalación, padre o equipo debía resolverse manualmente.

D5.3.9 separa explícitamente lo que una persona debe decidir de lo que el sistema recalcula automáticamente.

Cambios

1. Decisiones humanas vs. dependencias automáticas

El resumen del plan incorpora dos contadores adicionales:

• directReviewItems: decisiones que requieren intervención humana;
• dependencyReviewItems: elementos bloqueados únicamente porque dependen de una decisión raíz.

El plan continúa bloqueado mientras exista cualquier REVIEW, por lo que no se debilita ninguna protección de aplicación.

2. Nueva pantalla de revisión obligatoria

La UI muestra tres pasos claros:

1. resolver decisiones humanas;
2. recalcular dependencias;
3. confirmar la importación.

Las decisiones reales aparecen como tarjetas de acción. Las dependencias se muestran en un bloque secundario desplegable y se etiquetan expresamente como automáticas.

Cada tarjeta explica:

• qué informa el archivo;
• por qué el sistema no decide solo;
• qué debe decidir la persona.

3. Contexto territorial con regeneración automática

Cuando el usuario elige un Área/Yacimiento entre alternativas seguras:

1. la elección queda guardada sólo para ese lote;
2. el sistema regenera inmediatamente el plan;
3. se recalculan estructura local, padres y activos dependientes;
4. la persona no tiene que recordar un segundo botón de “Regenerar plan”.

La elección territorial sigue validándose en backend contra las alternativas seguras detectadas.

4. Seguridad preservada

No se agregan migraciones en D5.3.9.

Se mantienen:

• huella del Maestro y bloqueo de planes obsoletos;
• plan previo a cualquier escritura;
• aplicación transaccional;
• idempotencia;
• procedencia;
• reversión lógica;
• validación de contexto operativo;
• backup fuerte INVENTARIO A REVISAR creado antes de D5.3.8.

El deploy D5.3.9 crea además un backup PRE liviano de código + DB antes de reemplazar producción.