| name | cobertura-contexto |
| description | Carga el contexto estable del proyecto Cobertura Automática MSP: arquitectura, rutas oficiales, reglas de integridad, módulos principales y criterios que nunca deben romperse. Úsalo antes de analizar bugs, cambios, autonomía, sync, cuarentena u Oracle. |
Cobertura Automática MSP — Contexto estable
Propósito
El sistema genera PDFs de cobertura MSP desde Oracle, guarda los PDFs en una ruta fija, actualiza Oracle solo cuando el PDF existe y sincroniza los PDFs generados hacia el repositorio oficial.
Rutas oficiales
- Proyecto:
/data_nuevo/cobertura_integrada
- Salida oficial de PDFs:
/data_nuevo/coberturas
- Repositorio oficial destino:
/data_nuevo/repo_grande/data/datos
- Logs:
/data_nuevo/cobertura_integrada/logs
- Configuración:
/data_nuevo/cobertura_integrada/config
Reglas que nunca deben romperse
- No actualizar
DIG_COBERTURA='S' si el PDF no existe físicamente.
- No sobrescribir PDFs existentes en el repositorio oficial.
- No permitir que
/data_nuevo/coberturas sea editable desde pantalla.
- No ejecutar dos procesos de generación al mismo tiempo.
- No matar procesos activos desde la UI.
- No liberar locks sin verificar si hay proceso activo.
- No convertir la cuarentena en un proceso manual de clics.
- No usar
202604 como producción si fue mes de prueba.
- Producción real inicia desde
202605, salvo nueva instrucción formal.
Módulos importantes
app.py: entrada Streamlit.src/pages/dashboard.py: dashboard y panel de operación.src/cobertura_pdf.py: generación principal por lotes.src/cobertura_runner.py: lock global.src/quarantine.py: cuarentena persistente.src/auto_resume_state.py: estado del worker.src/operator_tools.py: herramientas seguras para operador.scripts/resume_coberturas_auto.py: worker automático.scripts/sync_coberturas_repo.py: sync al repo.scripts/coberturactl: comando operativo.scripts/run_streamlit.sh: arranque Streamlit.scripts/run_resume_coberturas.sh: arranque worker.
Flujo oficial
- Consulta Oracle:
FE_PLA_ANIOMES >= mes, DIG_COBERTURA='N', DIG_PLANILLADO='S'
- Genera PDFs con Node.js + Playwright.
- Guarda en
/data_nuevo/coberturas/{TRAMITE}/.
- Actualiza Oracle solo si el PDF existe.
- Sincroniza al repositorio oficial sin sobrescribir.
- Registra logs, errores, manifiestos, cuarentena y sync.
Formato de toda respuesta técnica
Toda propuesta técnica debe incluir:
- Impacto y riesgos.
- Preparación con backups.
- Implementación paso a paso.
- Pruebas de verificación y regresión.
- Plan de reversión.
