homepool
Aplicación web auto-alojada para seguimiento de mantenimiento de piscinas y spas, integrada nativamente con Home Assistant. Utiliza Next.js y FastAPI sobre PostgreSQL, soporta PWA y gestión multi-instalación con control total de datos locales.
Ficha actualizada 22 sept 2026, 15:21 · upstream 22 sept 2026, 9:13 · release v1.15.10
Qué es homepool
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
homepool es una aplicación web diseñada para el seguimiento del mantenimiento de piscinas y spas, construida específicamente para entornos auto-alojados y usuarios de Home Assistant. El sistema permite registrar mediciones del agua (pH, cloro, bromo, salinidad, etc.), aplicar tratamientos químicos desde un catálogo personalizado y gestionar tareas de mantenimiento programables. La arquitectura se basa en una pila tecnológica moderna con Next.js para el frontend y FastAPI con Python para el backend, almacenando todos los datos persistentemente en PostgreSQL.
La aplicación destaca por su integración profunda con Home Assistant, exponiendo sensores nativos para cada parámetro químico del agua y proporcionando tarjetas Lovelace personalizadas instalables vía HACS. Esto permite visualizar la química del agua directamente en el dashboard de automatización doméstica sin necesidad de servicios externos. El sistema soporta múltiples instalaciones (piscinas o spas) con rangos ideales configurables por tipo de desinfectante, incluyendo perfiles específicos para generadores de sal.
El enfoque de diseño prioriza la privacidad y el control del usuario sobre sus datos, evitando cualquier dependencia de servicios en la nube. La interfaz es completamente responsiva y soporta instalación como PWA para uso móvil, con navegación inferior y modales tipo hoja desplegable. El sistema incluye funcionalidades avanzadas como simuladores de dosificación, recomendaciones automáticas cuando los parámetros salen de rango, y gestión de permisos para compartir acceso a piscinas específicas entre usuarios.
- Registro manual de mediciones del agua mediante tiras reactivas AquaChek o entrada digital con validación de rangos
- Gestión de tratamientos químicos con catálogo personalizado por instalación, incluyendo marcas y unidades de medida
- Seguimiento de tareas de mantenimiento programables (limpieza de filtro, cambio de agua) con recordatorios visuales
- Integración con Home Assistant para monitoreo en tiempo real del dashboard doméstico mediante sensores nativos
- Compartir acceso a piscinas específicas entre usuarios con roles definidos (lectura o lectura/escritura)
- Simulación de dosificación química y recomendaciones automáticas basadas en parámetros fuera de rango
- Integración nativa completa con Home Assistant expone sensores para cada parámetro químico del agua
- Soporte multi-instalación con rangos ideales configurables por tipo de desinfectante (cloro, bromo, sal)
- Capacidad PWA instalable en móviles sin pasar por tiendas de aplicaciones oficiales
- Persistencia de datos local en PostgreSQL sin dependencia de servicios externos o nube
- Interfaz responsiva con temas oscuros/claros automáticos y navegación inferior optimizada para móvil
- Validación de datos en tiempo real con simulador de dosificación y estimación de ingredientes activos
- Requiere despliegue mediante Docker Compose, excluyendo usuarios sin experiencia en contenedores
- No soporta bases de datos alternativas a PostgreSQL para persistencia de datos
- La integración con Home Assistant requiere configuración manual del API key y URL base correcta incluyendo el path /api
- No incluye soporte nativo para autenticación OAuth externa ni sincronización bidireccional automática con sensores IoT externos sin mapeo manual
- El sistema no soporta despliegue en entornos serverless o funciones como servicio (FaaS)
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar usando Docker Compose con la imagen oficial de GitHub Container Registry. Fijar una versión específica en HOMEPOOL_TAG para evitar roturas por actualizaciones automáticas. Configurar variables de entorno para credenciales y asegurar que el puerto 8090 esté disponible o redirigido correctamente. El despliegue debe realizarse en un servidor con al menos 2 núcleos CPU y 2GB RAM según especificaciones técnicas. Para integración Home Assistant, incluir el path /api en la URL base si se utiliza proxy inverso.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.