Este sistema web está diseñado para la gestión integral de cobros de agua potable para la Junta de Agua de Santa Rosa. La aplicación permite administrar clientes, facturas, mediciones de consumo, sucursales y usuarios del sistema, ofreciendo una solución completa para la administración del servicio de agua potable. Proyecto
- Creación y visualización de facturas
- Búsqueda por cédula/RUC del cliente
- Filtrado por fechas de emisión
- Impresión de tickets de factura
- Paginación para manejo eficiente de grandes volúmenes de datos
- Registro de clientes con validación de cédula/RUC ecuatoriano
- Búsqueda rápida por número de identificación
- Almacenamiento de datos completos (razón social, nombre comercial, dirección, teléfono, email)
- Registro de lecturas de medidores
- Cálculo automático de consumo
- Historial de mediciones por cliente
- Registro y gestión de múltiples sucursales
- Asignación de facturas a sucursales específicas
- Control de acceso basado en roles
- Perfiles de usuario personalizables
- Autenticación segura
- Frontend: React 19 con TypeScript
- Estilizado: Tailwind CSS y DaisyUI
- Construcción: Vite
- Enrutamiento: React Router v7
- Peticiones HTTP: Axios
- Iconos: Heroicons y React Icons
src/
├── assets/ # Recursos estáticos (imágenes, iconos)
├── auth/ # Autenticación y autorización
├── Clientes/ # Módulo de gestión de clientes
├── core/ # Componentes y utilidades principales
├── facturacion/ # Módulo de facturación
├── medicion/ # Módulo de mediciones
├── profile/ # Gestión de perfil de usuario
├── shared/ # Componentes y utilidades compartidas
└── sucursales/ # Gestión de sucursales
# Instalar dependencias
npm install
# Ejecutar en modo desarrollo
npm run dev
# Compilar para producción
npm run build
# Previsualizar la versión de producción
npm run preview- La API devuelve datos con nombres de campos en MAYÚSCULAS (ID, IDENTIFICACION, etc.)
- La API espera recibir datos con nombres de campos en minúsculas (identificacion, razonSocial, etc.)
- Ruta base de la API: "/apiV2"
- Búsqueda de clientes por cédula: "/apiV2/clientes/buscarCedula?cedula=valor"
- Node.js 18 o superior
- Conexión a internet para acceso a la API
- Navegador web moderno (Chrome, Firefox, Edge, Safari)
Este proyecto fue desarrollado como parte de un proyecto de vinculación con la comunidad de Santa Rosa para mejorar la gestión administrativa de su Junta de Agua Potable.