Tutorial del Sistema de Gestión de Agua

Aprende a usar todas las funciones del sistema paso a paso

Instalación del Sistema

1 Requisitos del Sistema

PHP 7.0 o superior
MySQL 5.6 o superior
Servidor web (Apache, Nginx)
Extensiones PHP: PDO, MySQL, GD

2 Instalación Automática

Sube todos los archivos a tu servidor web y accede a:

http://tudominio.com/aguatera/install.php

Sigue el asistente de instalación paso a paso.

3 Instalación Manual

  1. Crear base de datos MySQL: aguatera
  2. Ejecutar el script SQL: database/aguatera.sql
  3. Configurar conexión en: includes/database.php
  4. Dar permisos a carpeta: uploads/medidores/
Siguiente: Inicio de Sesión

Inicio de Sesión

1 Credenciales de Acceso

Acceso Inicial

URL del Sistema: http://tudominio.com/aguatera/
Usuario Administrador: junta
Contraseña: saneamiento

2 Pantalla de Login

Al acceder al sistema, verás la siguiente pantalla:

Simulación de Login

3 Roles de Usuario

Administrador

Acceso completo a todos los módulos, creación de usuarios, configuración del sistema.

Recolector

Solo puede tomar lecturas de medidores, usar GPS y subir fotos.

Anterior Siguiente: Módulo Recolector

Módulo Recolector

1 Dashboard del Recolector

Al iniciar sesión como recolector, verás un dashboard con:

  • Estadísticas de lecturas del día
  • Botón para "Tomar Nueva Lectura"
  • Historial de últimas lecturas

2 Tomar Lectura del Medidor

Proceso paso a paso:

  1. Hacer clic en "Nueva Lectura"
  2. Ingresar número de medidor
  3. Ingresar lectura actual (sin decimales)
  4. Tomar foto del medidor (opcional)
  5. El sistema captura automáticamente la ubicación GPS
  6. Hacer clic en "Registrar Lectura"

Pregunta de Práctica

¿Qué datos son obligatorios para registrar una lectura?

Número de medidor y lectura actual
Solo la foto del medidor
Nombre del cliente y teléfono
Dirección exacta del cliente

3 Características del Módulo

Geolocalización

Captura automática de coordenadas GPS sin intervención del usuario.

Captura de Fotos

Tomar fotos del medidor directamente desde el navegador.

Historial

Ver las últimas 10 lecturas realizadas por el recolector.

Anterior Siguiente: Módulo Administrador

Módulo Administrador

1 Funciones Principales

Gestión de Clientes

Crear, editar, eliminar clientes y ver su estado de cuenta.

Gestión de Recolectores

Administrar usuarios recolectores con sus datos personales.

Gestión de Zonas

Crear y administrar zonas geográficas para organización.

Configuración

Establecer precio del agua por m³ (en Guaraníes).

2 Gestión de Pagos

Desde el módulo de clientes, puedes:

  1. Ver estado de cuenta de cada cliente
  2. Registrar pagos completos o parciales
  3. Ver historial de pagos
  4. Gestionar morosidad

Simulación de Cálculo

Introduce datos para calcular consumo y monto:

3 Sistema de Alertas

El sistema muestra alertas visuales automáticas:

  • AMARILLO PARPADEANTE: 2 meses de mora - "ENTRANDO EN ESTADO DE CORTE"
  • ROJO PARPADEANTE: 3 meses de mora - "CLIENTE EN CORTE"
  • VERDE: Al día - "AL DÍA"
Anterior Siguiente: Dashboard

Dashboard y Reportes

1 Métricas Principales

El dashboard muestra en tiempo real:

Total de Clientes

Número total de clientes activos en el sistema.

Recolectores Activos

Cantidad de recolectores disponibles.

Zonas

Número de zonas configuradas.

Consumo del Mes

Total de metros cúbicos consumidos en el mes actual.

2 Gráficos de Recaudación

El sistema genera gráficos comparativos:

  • Recaudación mensual del año en curso
  • Comparativa mes a mes
  • Tendencias de consumo

3 Exportación de Reportes

Puedes exportar toda la información a Excel:

  1. Ir a "Reportes" en el menú administrador
  2. Hacer clic en "Exportar a Excel"
  3. Se descargará un archivo .xls con todos los datos
  4. Incluye: cliente, zona, consumo, monto, pagos y saldo

Pregunta de Práctica

¿Qué información incluye el reporte exportado a Excel?

Solo nombres de clientes
Cliente, zona, consumo, monto, pagos y saldo
Solo montos totales
Solo datos de contacto

4 Acciones Rápidas

Desde el dashboard puedes acceder rápidamente a:

Anterior Siguiente: Preguntas Frecuentes

Preguntas Frecuentes

1 Solución de Problemas

¿Qué hago si no puedo acceder al sistema?

Verifica que:

  1. La base de datos esté creada y configurada
  2. Las credenciales en includes/database.php sean correctas
  3. El servidor web esté funcionando
  4. PHP esté correctamente instalado
¿Cómo restablezco la contraseña de un usuario?

Como administrador:

  1. Ir a "Recolectores"
  2. Hacer clic en "Editar" del usuario
  3. Ingresar nueva contraseña
  4. Guardar cambios
¿Por qué no funciona el GPS en el módulo recolector?

El GPS requiere HTTPS en navegadores modernos:

  • Usa un certificado SSL en tu servidor
  • Asegúrate de que el navegador tenga permisos de ubicación
  • Verifica que el dispositivo tenga GPS activado
¿Cómo cambio el precio del agua?

Como administrador:

  1. Ir a "Configuración"
  2. Modificar el campo "Precio del Agua por m³"
  3. Hacer clic en "Actualizar Configuración"
  4. El nuevo precio se aplica a lecturas futuras
¿Puedo eliminar un cliente que ya tiene lecturas registradas?

No, por integridad de datos. Pero puedes:

  • Marcarlo como "Inactivo" en lugar de eliminar
  • Este cliente ya no aparecerá en listados activos
  • Sus datos históricos se conservan para reportes

2 Contacto y Soporte

Información de Soporte

Para problemas técnicos o preguntas adicionales:

  • Base de datos: Verificar configuración en includes/database.php
  • Permisos: Carpeta uploads/medidores/ debe tener permisos de escritura
  • PHP: Verificar que las extensiones PDO y MySQL estén habilitadas
  • GPS: Requiere HTTPS para funcionar en navegadores modernos

3 Tutorial Completado

¡Felicidades!

Has completado el tutorial del Sistema de Gestión de Agua.

Estás listo para comenzar a usar todas las funcionalidades del sistema.

Repasar Tutorial
Anterior