Hermeticidad de Tanques de CL y OPDH - Reporte Dinámico

Descripción

Este proyecto es una aplicación interactiva desarrollada con Marimo y Altair en Python, diseñada para generar un reporte dinámico y visual sobre la inspección periódica de hermeticidad de tanques enterrados que almacenan Combustibles Líquidos (CL) y Otros Productos Derivados de los Hidrocarburos (OPDH) a nivel nacional. La norma aplicada corresponde al Decreto Supremo N° 001-2022-MINEM-EM y sus resoluciones complementarias.

Nota: La aplicación se enfoca exclusivamente en los tanques ubicados en estaciones de servicio.

Funcionalidades

• Carga de datos desde fuentes oficiales:
  • Base de datos de componentes de tanques (DATA TANQUES.xlsx).
  • Base de datos de pruebas de hermeticidad (DATA PRUEBAS.xlsx).
  • Descarga de registros de agentes habilitados mediante la plataforma PVO de OSINERGMIN.
• Limpieza y consolidación de la información:
  • Depuración de duplicados y registros incompletos.
  • Asignación de regiones según departamento, provincia y distrito.
  • Cálculo de fecha límite de inspección, edad y estado del tanque.
• Generación de matriz completa con detalles de cada compartimiento y prueba.
• Indicadores resumidos por Oficina Regional:
  • Cumplimiento de registro de información (completo, incompleto, nulo).
  • Cumplimiento de pruebas de hermeticidad (completo, incompleto, nulo).
• Análisis interactivo:
  • Filtros por región, estado de registro y hermeticidad.
  • Exportación de tablas y gráficos a archivos Excel.
• Visualizaciones con Altair para:
  • Estado de cumplimiento por oficina regional.
  • Componentes que acreditaron fugas.

Tecnologías y Dependencias

• Python 3.8+
• Marimo (App framework)
• pandas
• Altair
• requests
• openpyxl

pip install marimo pandas altair requests openpyxl

Estructura de Archivos

├── app.py                # Código principal de la aplicación
├── DATA TANQUES.xlsx     # Datos de fabricación e instalación de tanques
├── DATA PRUEBAS.xlsx     # Datos de pruebas de hermeticidad
├── CRONOGRAMA.png        # Imagen con cronograma de inspecciones
├── requirements.txt      # Lista de dependencias (opcional)
└── README.md             # Documentación del proyecto

Uso

1. Colocar los archivos de datos (DATA TANQUES.xlsx, DATA PRUEBAS.xlsx) en el mismo directorio que app.py.
2. Ejecutar la aplicación:

   python app.py

3. Abrir el navegador en la dirección proporcionada por Marimo (por defecto http://localhost:8000).
4. Interactuar con los controles para filtrar resultados y generar reportes.

Exportación de Resultados

• Matriz general: Botón para descargar MATRIZ.xlsx con todos los registros consolidados.
• Análisis regional: Opciones para filtrar agentes según estado y región, con descarga de Excel.
• Análisis crítico: Identificación de componentes con fugas y exportación de archivos.

Contribuciones

Las contribuciones son bienvenidas. Por favor, abra un issue o envíe un pull request con mejoras, correcciones o nuevas funcionalidades.

Licencia

Este proyecto está bajo la licencia MIT. Consulte el archivo LICENSE para más información.