How jennettej/reservations works
This is a command-line hotel reservation system for clerk, management, and housekeeping workflows. Users can book, list, search, edit, and close reservations; management also has history and reporting features, while housekeeping views occupancy and updates room cleanliness. Reservation records and archived history are stored as JSON, with room status in a text file. The excerpts show the main dispatch and several service calls; some menu routes and storage references are known only from the source index, so uncertain links are omitted.
Main entry points: main.py Role menus · edit.py Booking and editing · data.py Current reservations · miller.py Reservation closing
Components 15
User workflows
- Role menus
main.py
Reservation services
- Booking and editing
edit.py - Reservation search
ReservationSearch.py - Reservation closing
miller.py - Date availability
garris.py - Date conversion
miller.py - Reservation reports
perf_report.py
Persistence
- History service
reservation_history.py - Current reservations
data.py - Reservation records
reservations.json - Archived records
reservation_history.json
Hotel operations
- Room status and occupancy
main.py - Room status file
room_status.txt - Alternate booking flow
availability.py
Other components
- Hotel staff
Connections 24
- Hotel staff → Role menus: uses
main.py - Role menus → Booking and editing: dispatches booking
main.py - Role menus → Reservation search: dispatches search
main.py - Role menus → Reservation closing: dispatches closing
main.py - Role menus → Reservation reports: dispatches reports
main.py - Role menus → Room status and occupancy: offers housekeeping
main.py - Role menus → History service: views history
main.py - Booking and editing → Current reservations: loads and saves
edit.py - Booking and editing → Date availability: validates dates
edit.py - Booking and editing → Date conversion: formats dates
edit.py - Reservation search → Current reservations: loads records
ReservationSearch.py - Reservation search → Booking and editing: displays results
ReservationSearch.py - Reservation closing → History service: archives reservation
miller.py - Reservation closing → Current reservations: loads and saves
miller.py - Reservation closing → Booking and editing: displays records
miller.py - Date availability → Date conversion: parses dates
garris.py - Reservation reports → Current reservations: loads records
perf_report.py - Reservation reports → Date conversion: parses dates
perf_report.py - Reservation reports → Booking and editing: displays entries
perf_report.py - Current reservations → Reservation records: reads and writes
data.py - History service → Archived records: reads and writes
reservation_history.py - Room status and occupancy → Date availability: checks occupancy
main.py - Room status and occupancy → Room status file: reads and updates
main.py - Alternate booking flow → Date conversion: converts dates
availability.py