How vattey12dec/room-rental-tracker works
Room Rental Tracker is a local command-line app for managing rental records, room availability, move-outs, and advance rent payments. The user workflow begins in the main menu, passes through a feature-specific menu and RentalManager rules, and persists changes as JSON; reports and availability are calculated from current records. Rental holds the record model and date/payment rules, while file_handler handles JSON loading and saving. Menu-to-manager calls are shown where excerpts support them; the summary menu’s internal calls were not sampled, so that connection is marked unverified.
Main entry points: main.py Main menu · rental_manager.py Rental manager · common.py Menu helpers · file_handler.py JSON handler
Components 16
CLI navigation
- Main menu
main.py
Rental workflows
- Menu helpers
menus/common.py - Add / view
menus/rental_menu.py - Search rentals
menus/search_menu.py - Update rental
menus/update_menu.py - Move-out
menus/move_out_menu.py - Room availability
menus/room_menu.py - Rent payments
menus/payment_menu.py - Rental summary
menus/summary_menu.py - Delete record
menus/delete_menu.py
Rental domain
- Rental manager
services/rental_manager.py - Rental rules
rental.py
JSON persistence
- JSON handler
utils/file_handler.py - Rental records
data/rentals.json - Registered rooms
data/rooms.json
Other components
- Rental owner
Connections 31
- Rental owner → Main menu: uses
README.md - Main menu → Add / view: dispatches
main.py - Main menu → Search rentals: dispatches
main.py - Main menu → Update rental: dispatches
main.py - Main menu → Move-out: dispatches
main.py - Main menu → Room availability: dispatches
main.py - Main menu → Rent payments: dispatches
main.py - Main menu → Rental summary: dispatches
main.py - Main menu → Delete record: dispatches
main.py - Main menu → Rental manager: creates
main.py - Add / view → Menu helpers: uses
menus/rental_menu.py - Search rentals → Menu helpers: uses
menus/search_menu.py - Update rental → Menu helpers: uses
menus/update_menu.py - Move-out → Menu helpers: uses
menus/move_out_menu.py - Room availability → Menu helpers: uses
menus/room_menu.py - Rent payments → Menu helpers: uses
menus/payment_menu.py - Delete record → Menu helpers: uses
menus/delete_menu.py - Menu helpers → Rental rules: uses dates
menus/common.py - Add / view → Rental manager: adds / lists
menus/rental_menu.py - Search rentals → Rental manager: searches
menus/search_menu.py - Update rental → Rental manager: updates
menus/update_menu.py - Move-out → Rental manager: ends rental
menus/move_out_menu.py - Room availability → Rental manager: reads availability
menus/room_menu.py - Rent payments → Rental manager: records payment
menus/payment_menu.py - Delete record → Rental manager: deletes
menus/delete_menu.py - Rental summary → Rental manager: requests summary
- Rental manager → Rental rules: validates records
services/rental_manager.py - Rental manager → JSON handler: loads / saves
services/rental_manager.py - JSON handler → Rental rules: serializes
utils/file_handler.py - JSON handler → Rental records: reads / writes
utils/file_handler.py - JSON handler → Registered rooms: reads
utils/file_handler.py