How eirandrie/kubo_reservationmanagementsystem works
KUBO is a beach-resort reservation-management system: staff and administrators use a role-protected React app to manage guests, reservations, room assignments, charges, payments, and operations; an Express API serves those workflows over PostgreSQL. The graph separates frontend workflows, backend domain modules, and shared infrastructure. README capabilities are retained, but the excerpts do not show all route wiring or frontend-to-API calls, so those links are omitted rather than inferred.
Main entry points: App.tsx React app routes · connectDB.ts PostgreSQL · reservation.controllers.ts Reservations · http.ts HTTP validation
Components 26
Staff application
- React app routes
frontend/src/App.tsx - Sign-in
frontend/src/features/auth/services/auth.service.ts - Guest screens
frontend/src/features/guest/services/guest.service.ts - Reservation screens
frontend/src/features/reservation/services/reservation.service.ts - Front desk
frontend/src/features/check-in-out/services/check-in-out.service.ts - Kubo screens
frontend/src/features/kubo/services/kubo.service.ts - Payment screens
frontend/src/features/payment/services/payment.service.ts - Daily reports
frontend/src/features/reports/services/report.service.ts - Audit screens
frontend/src/features/audit-logs/services/audit-log.service.ts
Reservation operations
- Reservations
backend/src/modules/reservation/reservation.controllers.ts - Room assignments
backend/src/modules/reserved-room_kubo/reserved-room_kubo.controllers.ts
People and inventory
- Guest records
backend/src/modules/guest/guest.controllers.ts - Employees and roles
backend/src/modules/employee/employee.controllers.ts - Kubo inventory
backend/src/modules/room_kubo/kubo.controllers.ts - Kubo types
backend/src/modules/room_kubo-type/kubo-type.controllers.ts
Charges and reporting
- Additional charges
backend/src/modules/additional-charges/additional-charges.controllers.ts - Payments and refunds
backend/src/modules/payment/payment.controllers.ts - Operational reports
backend/src/modules/report/report.controllers.ts - Audit log
backend/src/modules/audit-logs/audit-logs.controllers.ts
API and infrastructure
- Authentication and access
backend/src/modules/auth/auth.services.ts - Express API server
backend/src/server.ts - PostgreSQL
backend/src/config/connectDB.ts - HTTP validation
backend/src/utils/http.ts - Application logging
backend/src/utils/logger.ts - Pagination utility
backend/src/utils/pagination.ts
Other components
- Staff user
Connections 22
- Staff user → React app routes: uses
README.md - React app routes → Sign-in: routes to
frontend/src/App.tsx - React app routes → Guest screens: routes to
frontend/src/App.tsx - React app routes → Reservation screens: routes to
frontend/src/App.tsx - React app routes → Front desk: routes to
frontend/src/App.tsx - React app routes → Kubo screens: routes to
frontend/src/App.tsx - React app routes → Payment screens: routes to
frontend/src/App.tsx - React app routes → Daily reports: routes to
frontend/src/App.tsx - React app routes → Audit screens: routes to
frontend/src/App.tsx - Reservations → Room assignments: assigns kubos
- Express API server → PostgreSQL: connects
README.md - Reservations → HTTP validation: validates requests
backend/src/modules/reservation/reservation.controllers.ts - Additional charges → HTTP validation: uses errors
backend/src/modules/additional-charges/additional-charges.controllers.ts - Payments and refunds → HTTP validation: uses errors
backend/src/modules/payment/payment.controllers.ts - Reservations → PostgreSQL: persists data
- Guest records → PostgreSQL: persists data
- Kubo inventory → PostgreSQL: persists data
- Payments and refunds → PostgreSQL: persists data
- Authentication and access → Audit log: records events
backend/src/modules/auth/auth.services.ts - Reservations → Pagination utility: paginates results
- Guest records → Pagination utility: paginates results
- Application logging → PostgreSQL
backend/src/config/connectDB.ts