How rishabhjune-22/roombooking_backend works
This Django application manages hostel-room bookings, from account approval and booking requests through administrative decisions and ongoing booking management. Its principal workflow is exposed through account and booking API views, backed by role checks, serializers, and relational models; a separate web view serves shared booking and charge-sheet information. Booking expiry and Google Sheets calendar synchronization are additional operational capabilities. The excerpts and source index establish several module relationships, but the README is empty and URL routing and most UI behavior were not sampled, so those connections are not asserted as verified.
Main entry points: models.py Booking records · google_sheet_sync.py Calendar sync · accounts/views.py Account API · bookings/views.py Booking API
Components 18
Accounts and access
- Account API
accounts/views.py - Roles and permissions
accounts/roles.py - Profiles and notices
accounts/models.py - Notification service
accounts/notification_service.py
Booking workflow
- Booking API
bookings/views.py - Booking records
bookings/models.py - Booking serializers
bookings/serializers.py - Request idempotency
bookings/idempotency.py - Booking signals
bookings/signals.py
Hostel inventory
- Room inventory
hostels/models.py - Hostel API
hostels/views.py
Web views
- Shared booking views
webapp/views.py - Browser application
webapp/static/webapp/app.js
Background integrations
- Booking expiry
bookings/services/expiry_service.py - Calendar sync
bookings/services/google_sheet_sync.py - Sync task
bookings/tasks.py
Other components
- User
- Google Sheets
Connections 27
- User → Account API: uses
- User → Booking API: requests
- User → Hostel API: browses
- User → Shared booking views: views
- Account API → Profiles and notices: uses
accounts/views.py - Account API → Roles and permissions: checks
accounts/views.py - Account API → Notification service: notifies
accounts/views.py - Account API → Booking records: accesses
accounts/views.py - Roles and permissions → Profiles and notices: reads
accounts/roles.py - Notification service → Profiles and notices: creates notices
accounts/notification_service.py - Booking API → Booking records: manages
bookings/views.py - Booking API → Booking serializers: validates
bookings/views.py - Booking API → Roles and permissions: checks
bookings/views.py - Booking API → Request idempotency: records requests
bookings/views.py - Booking records → Room inventory: references rooms
bookings/models.py - Hostel API → Room inventory: accesses
hostels/views.py - Shared booking views → Booking records: queries
webapp/views.py - Shared booking views → Room inventory: queries
webapp/views.py - Booking signals → Booking records: handles events
bookings/signals.py - Booking signals → Notification service: notifies
bookings/signals.py - Booking signals → Calendar sync: requests sync
bookings/signals.py - Booking expiry → Booking records: expires records
bookings/services/expiry_service.py - Booking expiry → Calendar sync: requests sync
bookings/services/expiry_service.py - Sync task → Calendar sync: runs
bookings/tasks.py - Calendar sync → Booking records: reads bookings
bookings/services/google_sheet_sync.py - Calendar sync → Room inventory: reads rooms
bookings/services/google_sheet_sync.py - Calendar sync → Google Sheets: updates calendar
bookings/services/google_sheet_sync.py