{"id":22567758,"url":"https://github.com/mateo-404/barberia","last_synced_at":"2026-05-01T15:37:04.183Z","repository":{"id":264421755,"uuid":"893328717","full_name":"Mateo-404/Barberia","owner":"Mateo-404","description":"💈 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!","archived":false,"fork":false,"pushed_at":"2024-12-24T04:17:52.000Z","size":150,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T14:12:12.013Z","etag":null,"topics":["backend","barber","barberia","barbershop","java","open-source","opensource","project","proyecto","spring"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mateo-404.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-24T06:16:18.000Z","updated_at":"2024-12-24T04:17:56.000Z","dependencies_parsed_at":"2024-12-24T05:21:13.097Z","dependency_job_id":"d9537e0e-ebe4-4b01-acf4-8e3c357394a4","html_url":"https://github.com/Mateo-404/Barberia","commit_stats":null,"previous_names":["mateo-404/barberia"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mateo-404%2FBarberia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mateo-404%2FBarberia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mateo-404%2FBarberia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mateo-404%2FBarberia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mateo-404","download_url":"https://codeload.github.com/Mateo-404/Barberia/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246040886,"owners_count":20714079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","barber","barberia","barbershop","java","open-source","opensource","project","proyecto","spring"],"created_at":"2024-12-08T00:09:03.533Z","updated_at":"2026-05-01T15:37:04.174Z","avatar_url":"https://github.com/Mateo-404.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sistema de Gestión de Barbería\n\n---\n\n## Tabla de Contenidos\n\n1. [Definición del Alcance](#definición-del-alcance)\n2. [Breve Descripción del Problema](#breve-descripción-del-problema)\n3. [Qué Tiene que Hacer el Sistema](#qué-tiene-que-hacer-el-sistema)\n4. [Funciones del Sistema](#funciones-del-sistema)\n5. [Requerimientos](#requerimientos)\n   - [Requerimientos del Usuario](#requerimientos-del-usuario)\n   - [Requerimientos de Sistema](#requerimientos-de-sistema)\n   - [Requerimientos No Funcionales](#requerimientos-no-funcionales)\n6. [Casos de Uso](#casos-de-uso)\n   - [Usuario](#usuario)\n   - [Administrador](#administrador)\n   - [Sistema](#sistema)\n7. [Pruebas de Requerimientos](#pruebas-de-requerimientos-del-sistema)\n8. [Diagramas](#diagramas)\n9. [Demo en linea](#demo-en-línea)\n10. [Capturas de Pantalla](#capturas-de-pantalla)\n11. [Organización del Proyecto](#organización-del-proyecto)\n\n---\n\n## Definición del Alcance\nSe 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.\n\nEl 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).\n\n---\n\n## Breve Descripción del Problema\nLa 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.\n\n---\n\n## Qué Tiene que Hacer el Sistema\n- Reservas en línea con selección de servicios, fechas y horarios.\n- Gestión de datos de clientes.\n- Panel de control para el administrador con calendario visual, estadísticas y reportes.\n\n---\n\n## Funciones del Sistema\n1. Reserva de turnos en línea.\n2. Selección de tipo de servicio.\n3. Selección de fecha y hora con disponibilidad en tiempo real.\n4. Recopilación segura de datos del cliente.\n5. Panel administrativo para gestionar turnos y reportes.\n\n---\n\n## Requerimientos\n\n### Requerimientos del Usuario\n1. **Reserva de turnos**: Selección de servicio, fecha y hora.\n2. **Gestión de servicios**: Visualización de opciones con descripciones y precios.\n\n### Requerimientos de Sistema\n- **Usuario**: Selección de servicio, calendario interactivo, formulario de datos.\n- **Administrador**: Panel de control para gestionar reservas, modificar o cancelar citas, y acceder a estadísticas.\n- **Sistema**: Recopilación de datos para reportes.\n\n### Requerimientos No Funcionales\n- **Compatibilidad y diseño responsivo**: Uso óptimo en cualquier dispositivo.\n- **Seguridad**: Encriptación de datos para proteger la privacidad del usuario.\n\n---\n\n## Casos de Uso\n\n### Usuario\n1. Selección de servicio.\n2. Selección de fecha y hora en un calendario interactivo.\n3. Registro de datos personales en un formulario.\n\n### Administrador\n1. **Gestión de reservas**: Modificar o cancelar citas a través del panel.\n2. **Reportes**: Visualización de estadísticas y gráficos de ganancias, servicios más solicitados, y clientes frecuentes.\n\n### Sistema\n1. Generación de reportes.\n2. Sincronización de datos en tiempo real.\n\n---\n\n## Pruebas de Requerimientos del Sistema\n\n### Caso de Prueba 1: Selección de Servicio\n- **ID**: CP-001\n- **Descripción**: Verificar que el usuario pueda seleccionar un tipo de servicio.\n- **Prioridad**: Alta\n- **Resultados Esperados**: El servicio seleccionado se almacena correctamente.\n\n### Caso de Prueba 2: Selección de Fecha y Hora\n- **ID**: CP-002\n- **Descripción**: Validar la selección de fechas y horarios disponibles.\n- **Prioridad**: Media\n- **Resultados Esperados**: Fecha y hora seleccionadas correctamente.\n\n### Caso de Prueba 3: Registro de Datos del Cliente\n- **ID**: CP-003\n- **Descripción**: Comprobar que los datos del cliente se registren con éxito.\n- **Prioridad**: Alta\n- **Resultados Esperados**: Los datos se almacenan correctamente.\n\n---\n\n## Diagramas\n### Diagrama de Casos de Uso\n![](public/Diagrama_Barberia-Casos%20de%20Uso.jpg)\n### Diagrama de Clases\n![](public/Diagrama_Barberia-Clases.jpg)\n\n---\n\n## Demo en Línea\nEl sistema se encuentra hosteado y disponible de forma pública para pruebas:\n\n🔗 **Frontend (Cliente):** [https://mateo-404.github.io/Barberia/](https://mateo-404.github.io/Barberia/)  \n🔗 **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*)*  \n\n👉 Nota: el despliegue se realiza directamente desde las ramas:  \n- `frontend` → para GitHub Pages.  \n- `backend` → para Railway u otro servicio de hosting del API.  \n\n---\n\n## Capturas de Pantalla\n\n### 1. Reserva de Turno (Cliente)\n![Reserva de turno](public/screenshots/reserva_turno.png)\n\n### 2. Panel de Administración\n![Panel de administración](public/screenshots/panel_admin.png)\n\n### 3. Estadísticas\n![Estadísticas](public/screenshots/estadisticas.png)\n\n---\n\n## Organización del Proyecto\n\n- **Repositorio en GitHub:** [Barberia](https://github.com/Mateo-404/Barberia)  \n- **Tablero de Tareas:** [GitHub Projects](https://github.com/users/Mateo-404/projects/9)  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateo-404%2Fbarberia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmateo-404%2Fbarberia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateo-404%2Fbarberia/lists"}