How felix202422/hotel_management_system works
Fizzo Hotels is a full-stack hotel reservation and operations system: visitors browse rooms or book, guests self-serve, and staff manage reservations and hotel operations through role-specific workspaces. The frontend routes users to those experiences and its shared API client communicates with a Spring Boot backend; reservation logic validates availability, prices stays, and persists reservation and room changes. The README also documents finance, housekeeping, maintenance, reports, notifications, and audit capabilities. Some subsystems are represented at directory level because their implementation was not sampled; links are limited to documented or indexed relationships.
Main entry points: repository JPA repositories · axios.js API client · App.jsx Route application · controller REST controllers
Components 17
Web experiences
- Route application
frontend/src/App.jsx - Visitor site
frontend/src/pages/visitor - Guest portal
frontend/src/pages/guest - Role workspaces
frontend/src/pages - API client
frontend/src/api/axios.js
Hotel API
- REST controllers
backend/src/main/java/com/fizzohotels/controller - JWT security
backend/src/main/java/com/fizzohotels/security
Hotel operations
- Reservation workflow
backend/src/main/java/com/fizzohotels/service/ReservationService.java - Room management
backend/src/main/java/com/fizzohotels/service/RoomService.java - Dashboard analytics
backend/src/main/java/com/fizzohotels/service/DashboardService.java - Reports
backend/src/main/java/com/fizzohotels/controller/ReportController.java - Hotel operations
backend/src/main/java/com/fizzohotels
Persistence
- JPA repositories
backend/src/main/java/com/fizzohotels/repository - PostgreSQL
Other components
- Visitor
- Guest
- Hotel staff
Connections 18
- Visitor → Visitor site: browses
README.md - Guest → Guest portal: books and tracks
README.md - Hotel staff → Role workspaces: manages hotel
README.md - Route application → Visitor site: routes to
frontend/src/App.jsx - Route application → Guest portal: routes to
frontend/src/App.jsx - Route application → Role workspaces: routes to
frontend/src/App.jsx - Visitor site → API client: requests data
- Guest portal → API client: requests data
- Role workspaces → API client: requests data
frontend/src/pages/housekeeping/HousekeepingTasks.jsx - API client → REST controllers: HTTP API
README.md - REST controllers → Reservation workflow: delegates reservations
backend/src/main/java/com/fizzohotels/controller/ReservationController.java - Reservation workflow → JPA repositories: reads and writes
backend/src/main/java/com/fizzohotels/service/ReservationService.java - Room management → JPA repositories: uses room data
backend/src/main/java/com/fizzohotels/service/RoomService.java - Dashboard analytics → JPA repositories: aggregates data
backend/src/main/java/com/fizzohotels/service/DashboardService.java - Reports → JPA repositories: queries reports
backend/src/main/java/com/fizzohotels/controller/ReportController.java - JWT security → JPA repositories: loads accounts
backend/src/main/java/com/fizzohotels/security/CustomUserDetailsService.java - REST controllers → Hotel operations: exposes capabilities
backend/src/main/java/com/fizzohotels/controller/ReportController.java - JPA repositories → PostgreSQL: persists entities