Skip to content
/ MiAPR Public

Esta versión esta compuesta por el módulo de captura de códigos QR que permitirá al operador de la A.P.R identificar los medidores antes de registrar la lectura.

Notifications You must be signed in to change notification settings

AkrauseF/MiAPR

Repository files navigation

MiAPR v11.0.0

Sistema que agiliza los procesos de registro de lectura y gestión de cobros del agua potable rural de Villa San Pedro, comuna de Pucón.

Descripción

Esta versión incluye los módulos de registro y edición de medidores y de clientes, generación de informes de datos de subsidiarios, registro de pagos y dashboard con alerta de orden de corte de servicios para clientes con 3 o mas meses de deudas, junto con un buscador de información relacionada con los pagos por cliente, através de filtros por fecha (mes) y nombre de clientes, todo esto correpondiente a app web.

Por otro lado en la app móvil vienen incluidos los módulos de importación y exportación de datos entre la app web y la app móvil lo que permitirá poder ejecutar el módulo de identificación de medidores por medio de la captura de código QR y registrar el número de lectura de este que representa los metros cúbicos consumidos por el cliente que tiene asociado dicho medidor. Finalmente estan implementados los módulos de cálculo de cobro en terreno e impresión de bloleta de cobro en terreno.

Para las dos aplicaciones, en esta versión se integraron los módulos de control de acceso con hashing de contraseña en base de datos y por otro lado, se implementaron las verificaciones de conexión y traspaso de datos entre aplicaciones.

En las últimas versiones de estas aplicaciones se agragaron como mejora, particularmente en la app móvil, un contador para los registros de medidores y lecturas importadas desde la app web.

Para ésta última versión, que esta enmarcada dentor de los plazos planificados del proyecto, por un lado se agregó un icono identificatico de la solucion a la applicación móvil, junto con una imagen, igual al icono, al inicio de la aplicación, especificamente en el login. Por otro lado, en la app web se implementó un interruptor que habilita y deshabilita las tranferencia de datos entre la app móvil y la app web en ambos sentidos.

El producto resultante de esta iteración consta de las siguientes funcionalidades:

Funcionalidades del release anterior

• Captura de código QR mediante cámara de dispositivo móvil.

• Interfaz de control de captura y visualización de códigos QR de la app móvil.

• Validador de códigos capturados por medio de la app móvil. Sólo se capturarán códigos que contengan números y con un largo máximo de 15 caracteres.

• Registro de medidores en app web.

• Edición de medidores en app web.

• Eliminacíon de medidores en app web.

• Importación de datos de medidores registrados en app web hacia app móvil.

• Exportación de datos de las lecturas asociadas a los medidores hacia la app web.

• Registro de lecturas asociadas a un medidor en la app móvil.

• Registro de clientes en aplicación web.

• Edición y eliminación de clientes en la app web.

• Generación de informes de clientes con subsidio la app web.

• Cálculo de cobros por metros cubicos consumidos en terreno.

• Impresión de boleta de cobro en terreno.

• Registro de pagos por consumo de agua potable en app web.

• Visualizacion de clientes con orden de corte de servicio mediante dashboard.

• Buscador de pagos y deudas de clientes.

• Visualizacion de meses con deudas por clientes.

• Control de acceso para app móvil y web con hashing de contraseñas en base de datos.

• verificación de conexión entre app móvil y web.

• Verificación de traspaso de datos entre app móvil y web.

• Contador visual en la parte superior de la lista de medidores en la app móvil.

• Contador visual en la parte superior de la lista de registros en la app móvil.

Funcionalidades añadidas del releas actual

• Habilitador y deshabilitador de transferencias de datos entres app móvil y app web en ambos sentidos.

Instrucciones de instalación de la app móvil

1.- Descargue en el dispositivo móvil el instalador de la aplicación desde el repositorio de GitHub en el siguiente link: https://github.com/AkrauseF/MiAPR/raw/main/app/entregable/release/MiAPR_11_0_0.apk

2.- Si tiene una versión anterior de esta aplicación, desintálela del dispositivo móvil.

3.- Instale la aplicación aceptando los permisos solicitados.

4.- Ejecute la aplicación.

4.- Credenciales de acceso para la app móvil: usuario: admin ; contraseña: 123.

Instrucciones de instalación de la app web

1.- Descargue los archivos comprimidos desde el siguinte link: https://github.com/AkrauseF/MiAPR/archive/refs/tags/v11.0.0.zip

2.- Descomprima el archivo MiAPR-11.0.0.zip y monte los archivos y directorios contenidos en la carpeta "appWeb" en una carpeta llamada "Apr" en su servidor web.

3.- En el directorio "modelo", dentro del directorio "appWeb", se encontrará un archivo llamado "conexiondb.php" en el cual debe reemplazar los datos de acceso a su servicio de base de datos mysql.

4.- Cree una nueva base de datos utilizando el mismo nombre que configuró en el archivo "conexiondb.php" ($baseDatos).

5.- En el directorio "bbdd" se encuentra el archivo llamado "miaprdb.sql", el cual debe ser importado desde la base de datos creada anteriormente (MySQL PHPMyAdmin).

6.- Por medio de un navegador, en la barra de direcciones digite la direccion de su servidor web donde montó el sitio.

7.- Credenciales de acceso para la app web: usuario: sec ; contraseña: 123.

NOTA:

Los servicios utilizados para la ejecución del servidor fueron: Apache 2.4.46, PHP 7.2.33 y MariaDB 10.4.14. Todos contenidos en el paquete de software Xampp 7.2.33.

Instrucciones de uso de la app móvil

Acceso a la aplicación:

1.- Ejecute la aplicación móvil.

2.- Ingrese usuario y contraseña en el formulario de acceso y presione el botón "Enviar".

Desplazamiento entre funcionalidades:

1.- Una vez ingresado a la app móvil medianre el login, podrá derigirse a cada una de las funcionalidades a travéz de la lista de botones que ofrece el meú principal.

2.- Para regreasar a una vista anterior, puede utilizar el botón "back" que se representa como una flecha hacia atrás, ubicado en la parte superior izquierda de la app.

3.- Para volver al menú principal, idependiente de la vista en que se encuentre, presione el botón "home" que se representa como una casa ubicada en la parte superior derecha de la app.

4.- Para salir de la app móvil y volve al control de acceso, presione el botón de "logout" ubicado en la parte superior derecha de la app, representado con una flecha dentro de un cuadrado.

Importar medidores:

1.- Presione el botón "IMPORTAR".

1.- Se trapasarán los datos desde el servidor web hacia la app movil, una vez terminado aparecerá si el traspaso fue exitoso, si no es así, informará error de conexión.

2.- Una vez finalizado el procesos de importación resgrese al menú anterior y presione el botón "LISTA MEDIDORES" para verificar los datos de los medidores importados, donde en la parte superior podrá ver la cantidad de medidores importados.

Capturar un número de medidor:

1.- Presione el botón “CAPTURAR QR”.

2.- Apunte la cámara hacia el código QR que desea capturar.

3.- Visualice en el dispositivo móvil el código capturado, el error en caso de que el código no sea válido y el número de lectura del mes anterior asociado al medidor en cuestión.

4.- Ingrese una lectura que sea mayor o igual anterior.

5.- Para verificar los registros de lecturas ingresados, en el menú principal presione el boton "LISTA DE REGISTROS", donde en la parte superior podrá ver la cantidad de medidores importados.

Imprimir boleta de cobro:

1.- Una vez registrado el número de lectura de un medidor en particular, aparacerá un panatalla donde podrá ver el estado de conexion de la impresora, una previsualización de la boleta de cobro a imprimir con los datos del cliente, su consumo y cobro.

2.- Presione el botón imprimir documento para imprimir la boleta de cobro, en caso de que la impresora se encuentre desconectada o apagada, presione el botón "conectar con impresora" y luego, cuando el estado de la impresora cambie a impresora conectada, vuelva a presionar el botón "imprimir documento".

Exportar datos hacia la app web:

1.- Una vez registrado la totalidad de lecturas correspondiente a los medidores importados, conecte el dispositivo móvil a la red donde se encuentra el equipo que contiene la app web.

2.Presione el botón “EXPORTAR” y espere la confirmación de que los tados fueron exportados correctamente.

Instrucciones de uso de la app web

Acceso a la aplicación:

1.- Ingrese a la página principal del sitio web.

2.- Ingrese usuario y contraseña en el formulario de acceso y presione el botón "Entrar".

Registro de Secretarios:

1.- Ingrese a la aplicación web y en el menú presione el botón secretarios, luego presione el botón registrar.

2.- Ingrese los datos del secretario en el formulario y presione enviar, esto redireccionará hacia la página de secretarios registrados.

3.- Si presiona el botón eliminar se borrará el registro del secretario seleccionado.

4.- Si presiona el botón editar, la página redireccionará hacia el formulario de edición de secretarios, donde podrá modificar los datos del secretario seleccionado. Al presionar el botón editar se redireccionará hacia la página de secretarios registrados, donde podrá observar los cambios realizados.

Registro de medidores:

1.- Ingrese a su navegador web y escriba la raíz de la dirección donde se encuentra montado el sitio web y agregue /regMedidores.php.

2.- Ingrese el código de identificación del medidor y su marca, luego presione enviar, esto redireccionará hacia la página de medidores registrados.

3.- Cada registro de medidores tendrá un botón para eliminar o editar los datos de este.

4.- Si presiona el botón eliminar se borrará el registro del medidor seleccionado.

5.- Si presiona el botón editar, la página redireccionará hacia el formulario de edición de medidores, donde podrá modificar los datos del medidor seleccionado. Al presionar el botón editar se redireccionará hacia la página de medidores registrados, donde podrá observar los cambios realizados.

Registro de clientes:

1.- Ingrese a su navegador web y escriba la raíz de la dirección donde se encuentra montado el sitio web.

2.- Presione el botón "Clientes" del menú en la parte superior y luego en el botón "registrar" en la parte superior izquierda de la tabla.

3.- Ingrese los datos del cliente en el formulario, en el campo de "Medidor" seleccione un medidor de la lista de medidores disponibles y en el campo "Decreto" seleccione un decreto si es que corresponde, luego presione enviar, esto redireccionará hacia la página de clientes registrados.

4.- Para volver a registrar otro cliente presione el botón "Registrar".

5.- Si presiona el botón eliminar se borrará el registro del medidor seleccionado.

6.- Si presiona el botón editar, la página redireccionará hacia el formulario de edición de medidores, donde podrá modificar los datos del medidor seleccionado. Al presionar el botón editar se redireccionará hacia la página de medidores registrados, donde podrá observar los cambios realizados.

Generación de informe de subsidiarios.

1.- Ingrese a su navegador web y escriba la raíz de la dirección donde se encuentra montado el sitio web.

2.- Presione el botón "informe subsidiario" del menú en la parte superior.

3.- Presiones el botón generar informe en la parte inferior de la tabla.

Registro de pago por consumo de agua potable.

1.- Presione el botón "Pagos" del menu en la parte superior.

2.- Ingrese en el campo "Rut" el rut del cliente para el cual se quiere ingresar un pago.

3.- En el campo "Monto a Pagar" ingrese el monto que se desea pagar y presione el botón "Pagar".

Visualizador de clientes con orden de corte de servicio.

1.- Para visualizar el dasboard presione el botón "Inicio" del menu en la parte superior.

Buscador de pagos y deudas por clientes.

1.- Presione el botón "Buscador de Pagos" en el menú.

2.- Seleccione un mes en el campo "Fecha".

Visualizador de meses con deuda por cliente.

1.- Presione el botón "Pagos" en el menú.

2.- Ingrese en el campo "Rut" el rut del cliente para el cual se quiere buscar la información.

3.- En la parte inferiror de la página se pude ver los meses con deudas del cliente en cuestión.

Habilitador o deshabilitador de transferencias de datos.

1.- Para habilitar la transferencia de datos presione el botón "Inicio" del menú.

2.- Luego presione el interruptor, el cual cambiará de color. Si está de color celeste, la transferencia de datos está habilitada, por el contrario, estará bloqueada.

About

Esta versión esta compuesta por el módulo de captura de códigos QR que permitirá al operador de la A.P.R identificar los medidores antes de registrar la lectura.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published