Skip to content

Instantly share code, notes, and snippets.

@kevinah95
Last active November 12, 2025 16:09
Show Gist options
  • Select an option

  • Save kevinah95/d7d144c683997bf42b9c291f137e4266 to your computer and use it in GitHub Desktop.

Select an option

Save kevinah95/d7d144c683997bf42b9c291f137e4266 to your computer and use it in GitHub Desktop.
This is an example of README for BISOFT-38 course created originally by Sebastián Quirós, Fabián Retana and Enzo Quartino

Agua CR 🇨🇷

Made in Costa Rica Kotlin Version
Kotlin Version

Aplicación móvil para la distribución informada y segura de agua potable en Costa Rica.

logo

📌 Descripción

Agua CR es una aplicación móvil desarrollada como solución a la creciente crisis de acceso al agua potable en Costa Rica. Su objetivo es brindar a las comunidades afectadas por sequías o desabastecimiento una plataforma centralizada, actualizada y confiable para conocer los horarios y ubicaciones de distribución de agua mediante camiones cisterna.

La aplicación está diseñada para ser intuitiva, accesible y gratuita para los usuarios finales, permitiendo además que distribuidores (públicos y privados) informen y gestionen sus puntos de entrega.

🧩 Problemática

Según los últimos informes del Estado de la Nación:

  • La cobertura de agua potable en Costa Rica cayó del 95.7% en 2021 al 89.9% en 2022.
  • Más de 105.000 personas dependen de camiones cisterna para acceder al agua.
  • En 2023, se reportaron 6.279 cortes de agua fuera del GAM, un 35.9% más que el año anterior.
  • Dentro del GAM, los cortes aumentaron un 750% en los últimos 8 años.

Actualmente, no existe una fuente única y clara que informe a la población sobre la distribución de agua, lo que incrementa la incertidumbre y vulnerabilidad de las comunidades.

🎯 Objetivo

Brindar una herramienta digital que permita a la población:

  • Consultar en tiempo real los eventos de distribución de agua.
  • Recibir notificaciones oportunas según su ubicación.
  • Contactar directamente a distribuidores autorizados.
  • Acceder a noticias e información útil sobre la crisis hídrica.

🛠️ Funcionalidades

👥 Usuarios

  • Consulta abierta sin registro.
  • Visualización y filtrado de eventos de distribución.
  • Suscripción a notificaciones personalizadas.
  • Acceso a muro informativo con noticias relevantes.

🚚 Distribuidores

  • Registro mediante formulario con documentación validada.
  • Publicación y edición de eventos de distribución.
  • Gestión de usuarios asociados a su organización.

🛡️ Administradores

  • Gestión de usuarios y distribuidores.
  • Validación automática de documentos con OCR.
  • Moderación de contenido y calidad de datos.
  • Agregado manual o automático de noticias vía web scraping.

⚙️ Setup del Proyecto

Para configurar el entorno de desarrollo y ejecutar el proyecto, por favor sigue las instrucciones detalladas en nuestra guía de configuración:

➡️ Guía de Configuración (SETUP.md)

🔒 Autenticación

  • Solo distribuidores y administradores requieren registro.
  • Usuarios finales pueden acceder libremente a la información pública.

🧪 Metodología

Este proyecto se desarrolla bajo la metodología ágil Scrum, permitiendo flexibilidad y entregas iterativas frecuentes. Se utiliza Planning Poker para la estimación de esfuerzo y planificación.


¡Agua CR 🇨🇷 es una herramienta para la esperanza y la organización comunitaria!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment