https://github.com/mateo-404/barberia
💈 Sistema Open Source para gestionar reservas de barberías. Incluye reservas en línea, recordatorios automáticos por WhatsApp y un panel administrativo con estadísticas. Diseño responsivo y seguro. ¡Contribuye con una Pull Request!
https://github.com/mateo-404/barberia
backend barber barberia barbershop java open-source opensource project proyecto spring
Last synced: about 2 months ago
JSON representation
💈 Sistema Open Source para gestionar reservas de barberías. Incluye reservas en línea, recordatorios automáticos por WhatsApp y un panel administrativo con estadísticas. Diseño responsivo y seguro. ¡Contribuye con una Pull Request!
- Host: GitHub
- URL: https://github.com/mateo-404/barberia
- Owner: Mateo-404
- License: gpl-3.0
- Created: 2024-11-24T06:16:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-24T04:17:52.000Z (over 1 year ago)
- Last Synced: 2025-02-02T14:12:12.013Z (over 1 year ago)
- Topics: backend, barber, barberia, barbershop, java, open-source, opensource, project, proyecto, spring
- Language: Java
- Homepage:
- Size: 146 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Sistema de Gestión de Barbería
---
## Tabla de Contenidos
1. [Definición del Alcance](#definición-del-alcance)
2. [Breve Descripción del Problema](#breve-descripción-del-problema)
3. [Qué Tiene que Hacer el Sistema](#qué-tiene-que-hacer-el-sistema)
4. [Funciones del Sistema](#funciones-del-sistema)
5. [Requerimientos](#requerimientos)
- [Requerimientos del Usuario](#requerimientos-del-usuario)
- [Requerimientos de Sistema](#requerimientos-de-sistema)
- [Requerimientos No Funcionales](#requerimientos-no-funcionales)
6. [Casos de Uso](#casos-de-uso)
- [Usuario](#usuario)
- [Administrador](#administrador)
- [Sistema](#sistema)
7. [Pruebas de Requerimientos](#pruebas-de-requerimientos-del-sistema)
8. [Diagramas](#diagramas)
9. [Demo en linea](#demo-en-línea)
10. [Capturas de Pantalla](#capturas-de-pantalla)
11. [Organización del Proyecto](#organización-del-proyecto)
---
## Definición del Alcance
Se desarrollará un sistema para gestionar reservas en una barbería. Permitirá optimizar la experiencia del cliente y la administración del negocio, resolviendo problemas actuales como confusiones en las reservas y falta de estadísticas claras.
El sistema está orientado a pequeñas barberías, pero su estructura permite escalar a otros rubros. El proyecto se desarrolla como parte de la Práctica Profesional Supervisada de la Tecnicatura Universitaria en Programación (UTN - Rafaela).
---
## Breve Descripción del Problema
La barbería enfrenta dificultades con la gestión manual de las reservas, lo que genera superposición de horarios, frustración entre clientes y pérdida de ingresos. El objetivo es implementar un sistema automatizado que simplifique estos procesos.
---
## Qué Tiene que Hacer el Sistema
- Reservas en línea con selección de servicios, fechas y horarios.
- Gestión de datos de clientes.
- Panel de control para el administrador con calendario visual, estadísticas y reportes.
---
## Funciones del Sistema
1. Reserva de turnos en línea.
2. Selección de tipo de servicio.
3. Selección de fecha y hora con disponibilidad en tiempo real.
4. Recopilación segura de datos del cliente.
5. Panel administrativo para gestionar turnos y reportes.
---
## Requerimientos
### Requerimientos del Usuario
1. **Reserva de turnos**: Selección de servicio, fecha y hora.
2. **Gestión de servicios**: Visualización de opciones con descripciones y precios.
### Requerimientos de Sistema
- **Usuario**: Selección de servicio, calendario interactivo, formulario de datos.
- **Administrador**: Panel de control para gestionar reservas, modificar o cancelar citas, y acceder a estadísticas.
- **Sistema**: Recopilación de datos para reportes.
### Requerimientos No Funcionales
- **Compatibilidad y diseño responsivo**: Uso óptimo en cualquier dispositivo.
- **Seguridad**: Encriptación de datos para proteger la privacidad del usuario.
---
## Casos de Uso
### Usuario
1. Selección de servicio.
2. Selección de fecha y hora en un calendario interactivo.
3. Registro de datos personales en un formulario.
### Administrador
1. **Gestión de reservas**: Modificar o cancelar citas a través del panel.
2. **Reportes**: Visualización de estadísticas y gráficos de ganancias, servicios más solicitados, y clientes frecuentes.
### Sistema
1. Generación de reportes.
2. Sincronización de datos en tiempo real.
---
## Pruebas de Requerimientos del Sistema
### Caso de Prueba 1: Selección de Servicio
- **ID**: CP-001
- **Descripción**: Verificar que el usuario pueda seleccionar un tipo de servicio.
- **Prioridad**: Alta
- **Resultados Esperados**: El servicio seleccionado se almacena correctamente.
### Caso de Prueba 2: Selección de Fecha y Hora
- **ID**: CP-002
- **Descripción**: Validar la selección de fechas y horarios disponibles.
- **Prioridad**: Media
- **Resultados Esperados**: Fecha y hora seleccionadas correctamente.
### Caso de Prueba 3: Registro de Datos del Cliente
- **ID**: CP-003
- **Descripción**: Comprobar que los datos del cliente se registren con éxito.
- **Prioridad**: Alta
- **Resultados Esperados**: Los datos se almacenan correctamente.
---
## Diagramas
### Diagrama de Casos de Uso
### Diagrama de Clases
---
## Demo en Línea
El sistema se encuentra hosteado y disponible de forma pública para pruebas:
🔗 **Frontend (Cliente):** [https://mateo-404.github.io/Barberia/](https://mateo-404.github.io/Barberia/)
🔗 **Frontend (Administrador):** [https://mateo-404.github.io/Barberia/admin/login.html](https://mateo-404.github.io/Barberia/admin/login.html) *(El usuario es *admin@admin.com* y la contraseña *admin*)*
👉 Nota: el despliegue se realiza directamente desde las ramas:
- `frontend` → para GitHub Pages.
- `backend` → para Railway u otro servicio de hosting del API.
---
## Capturas de Pantalla
### 1. Reserva de Turno (Cliente)
### 2. Panel de Administración
### 3. Estadísticas
---
## Organización del Proyecto
- **Repositorio en GitHub:** [Barberia](https://github.com/Mateo-404/Barberia)
- **Tablero de Tareas:** [GitHub Projects](https://github.com/users/Mateo-404/projects/9)