Files
dh-inspeccion-v2/docs/PHASE_D5_3_9.md

65 lines
2.4 KiB
Markdown

# 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.