Objetivo del Proyecto
Desarrollar una herramienta integral e interactiva para automatizar el seguimiento, análisis y control de cumplimiento normativo (D.S. 001-2022-MINEM-EM) referente a las pruebas de hermeticidad de tanques y tuberías enterradas que almacenan combustibles líquidos a nivel nacional. La solución está diseñada para transformar datos operativos crudos en información estratégica, facilitando la toma de decisiones regulatorias por parte de OSINERGMIN.
Arquitectura y Funcionamiento
El aplicativo fue construido utilizando Python y Marimo (framework para cuadernos interactivos reactivos). Su estructura funcional se divide en las siguientes etapas clave:
- Ingesta y Extracción de Datos: Scraping web automatizado mediante
requestsypandas.read_htmlpara obtener el registro actualizado de hidrocarburos de la plataforma pública de OSINERGMIN. - Procesamiento y Limpieza: Integración de múltiples fuentes de datos (información de registro web, matrices de tanques y bases de datos de pruebas de hermeticidad). Se implementaron funciones complejas de limpieza para eliminar duplicados, priorizar registros recientes y categorizar agentes según su ubicación geográfica a nivel nacional.
- Motor de Reglas de Negocio: Lógica programada para determinar plazos de vencimiento según la región, clasificar el estado de los tanques ("PRE EXISTENTE", "NUEVO", "NO APLICA") y evaluar de forma automática la completitud del registro de información y los resultados de las pruebas de hermeticidad (Sin fuga / Con fuga).
- Generación de Documentos (Automatización): Integración con
docxtplpara la creación masiva y automática de oficios (.docx) dirigidos a agentes no conformes. Los documentos son comprimidos mediantezipfiley servidos para su descarga directa.
Visualización de Datos y Análisis
Para la exploración visual de la información se empleó Altair, permitiendo renderizar gráficos declarativos e interactivos altamente optimizados:
Mapas de Calor (Heatmaps)
Distribución de tanques (herméticos vs no herméticos) relacionando edad y capacidad de almacenamiento, agrupados en intervalos regulares calculados dinámicamente con NumPy.
Análisis Regional
Gráficos de barras apiladas que muestran el estado de cumplimiento (Completo, Incompleto, Nulo) filtrado por Oficina Regional y fechas límite.
Análisis Correlacional
Gráficos de dispersión (scatter plots) interactivos con tooltips ricos en información para evaluar la relación entre la antigüedad de los tanques y su capacidad total.
Exportación Ágil
Módulos de exportación de DataFrames filtrados hacia formato Excel para trabajo operativo y seguimiento detallado de agentes críticos.