Sistema integral para la gestión de flota, registro de horómetros y cálculo de KPIs (Disponibilidad Mecánica) en tiempo real para proyectos mineros.
Este proyecto utiliza una arquitectura moderna de 3 capas:
- Frontend: Streamlit (Interfaz Web interactiva).
- Backend: FastAPI (API REST de alto rendimiento).
- Base de Datos: PostgreSQL (Contenerizada en Docker).
- Orquestación: Docker Compose & Batch Scripts (Automatización en Windows).
Para ejecutar este sistema, asegúrate de tener instalado en tu equipo:
- Docker Desktop (Debe estar corriendo con el ícono de la ballena 🐳).
- Python (Versión 3.9 o superior).
Si acabas de clonar o descargar este repositorio, prepara el entorno ejecutando el script automático:
- Busca el archivo
INSTALAR_PRIMERO.bat. - Dale Doble Clic.
- Espera a que termine la descarga de librerías y aparezca el mensaje "INSTALACION COMPLETA".
Nota: Esto crea un entorno virtual (
venv) localmente en tu máquina, asegurando que no haya conflictos de dependencias.
Para empezar a trabajar:
- Asegúrate de que Docker Desktop esté abierto.
- Ejecuta el archivo:
INICIAR_SISTEMA.bat
- Se abrirán las consolas del servidor y automáticamente se lanzará el navegador con el Dashboard.
⚠️ Importante: Puedes minimizar las ventanas negras de comando, pero NO las cierres mientras estés usando el sistema.
Para apagar correctamente la base de datos y liberar recursos:
- Cierra la pestaña del navegador.
- Ejecuta el archivo:
APAGAR_SISTEMA.bat
- El script se encargará de detener los contenedores de Docker y cerrar los procesos de Python.
| Problema | Solución |
|---|---|
| Error "Daemon not running" | Docker está cerrado. Abre Docker Desktop y espera a que inicie. |
| Pantalla en blanco | Presiona F5 en el navegador para recargar la interfaz. |
| No se guardan los datos | Verifica que no haya errores rojos en el formulario de Streamlit. |
Desarrollado para Goolpro / Proyecto Minero RDM - 2026