How absarahmedbhutta/venueos works
VenueOS is a multi-concept hospitality operations platform. Staff authenticate into departmental groups, use a role-aware React workspace, and perform café, restaurant, hotel, event, and shared-management tasks through a REST client to Django. Django’s domain views operate on persistent domain models; shared core services provide authentication, dashboard, staff, inventory, and finance capabilities. The README documents major product features, while some backend routes and frontend interactions are unsampled, so those links are shown only where the excerpts or index support them.
Main entry points: api.js REST client · App.jsx Role-based workspace · urls.py Django REST API · DashboardView.jsx Executive dashboard
Components 23
Web workspace
- Role-based workspace
frontend/src/App.jsx - Login and signup
frontend/src/components/AuthModal.jsx - Executive dashboard
frontend/src/components/DashboardView.jsx - Café POS and KDS
frontend/src/components/CafeView.jsx - Restaurant floor and KDS
frontend/src/components/RestaurantView.jsx - Hotel PMS
frontend/src/components/HotelView.jsx - Event planning
frontend/src/components/EventsView.jsx - Inventory procurement
frontend/src/components/InventoryProcurementTab.jsx - Staff shifts
frontend/src/components/StaffShiftsTab.jsx - REST client
frontend/src/api.js
Shared operations
- Identity and analytics
backend/core/views.py
Hospitality operations
- Django REST API
backend/config/urls.py - Café operations
backend/cafe/views.py - Restaurant operations
backend/restaurant/views.py - Hotel operations
backend/hotel/views.py - Reservation services
backend/hotel/services.py - Event operations
backend/events/views.py
Domain records
- Venue and shared records
backend/core/models.py - Café catalog and orders
backend/cafe/models.py - Floor and service records
backend/restaurant/models.py - Rooms and folios
backend/hotel/models.py - Halls and BEO records
backend/events/models.py
Other components
- Hospitality staff
Connections 28
- Hospitality staff → Login and signup: signs in
- Hospitality staff → Role-based workspace: uses workspace
- Login and signup → REST client: calls auth endpoints
frontend/src/components/AuthModal.jsx - Role-based workspace → Executive dashboard: routes roles
frontend/src/App.jsx - Role-based workspace → Café POS and KDS: routes roles
frontend/src/App.jsx - Role-based workspace → Restaurant floor and KDS: routes roles
frontend/src/App.jsx - Role-based workspace → Hotel PMS: routes roles
frontend/src/App.jsx - Role-based workspace → Event planning: routes roles
frontend/src/App.jsx - Executive dashboard → REST client: requests data
frontend/src/components/DashboardView.jsx - Café POS and KDS → REST client: requests data
frontend/src/components/CafeView.jsx - Restaurant floor and KDS → REST client: requests data
frontend/src/components/RestaurantView.jsx - Hotel PMS → REST client: requests data
frontend/src/components/HotelView.jsx - Event planning → REST client: requests data
frontend/src/components/EventsView.jsx - Executive dashboard → Inventory procurement: renders tab
frontend/src/components/DashboardView.jsx - Executive dashboard → Staff shifts: renders tab
frontend/src/components/DashboardView.jsx - REST client → Django REST API: sends REST requests
frontend/src/api.js - Django REST API → Identity and analytics: routes requests
- Django REST API → Café operations: routes requests
- Django REST API → Restaurant operations: routes requests
- Django REST API → Hotel operations: routes requests
- Django REST API → Event operations: routes requests
- Identity and analytics → Venue and shared records: reads and writes
backend/core/views.py - Café operations → Café catalog and orders: reads and writes
backend/cafe/views.py - Restaurant operations → Floor and service records: reads and writes
backend/restaurant/views.py - Hotel operations → Rooms and folios: reads and writes
backend/hotel/views.py - Hotel operations → Reservation services: calls booking logic
backend/hotel/views.py - Reservation services → Rooms and folios: checks reservations
backend/hotel/services.py - Event operations → Halls and BEO records: reads and writes
backend/events/views.py