How kolomfolox-lab/waitly_source works
Waitly is a multi-tenant restaurant-management SaaS with separate owner/admin, staff POS, guest, kiosk, and public-marketing frontends backed by a Django API. A representative guest journey loads a restaurant/table menu, submits an order, and follows its status while staff and kitchen workflows process it. The README also documents bookings, subscriptions, analytics, multilingual menus, AI, and notifications. The map combines those documented capabilities with sampled frontend/API evidence; backend implementation beyond the listed API modules is not visible in the supplied tree or excerpts.
Main entry points: pos_views.py Order workflow · src/App.tsx Guest app · src/App.tsx Owner workspace · auth_views.py Authentication
Components 22
Restaurant clients
- Owner workspace
Waitly-Frontend/src/App.tsx - Admin workspace
admin_panel_react/src/App.tsx
Platform API
- Order workflow
waitly_backend/api_v1/pos_views.py - Bookings
waitly_backend/api_v1/booking_views.py - Analytics
waitly_backend/apps/analytics
Restaurant operations
- Staff POS
waitly-pos/src/main.tsx - Kitchen workflow
waitly_backend/api_v1/kitchen_views.py - Inventory
waitly_backend/apps/inventory
Guest engagement
- Guest app
waitly-guest/src/App.tsx - Kiosk ordering
kiosk/src/App.tsx - Guest menu
waitly_backend/api_v1/guest_views.py - Review analysis
Shared platform
- Subscriptions
- Authentication
waitly_backend/api_v1/auth_views.py - Notifications
- PostgreSQL
- WebSocket updates
Other components
- Telegram
- Restaurant guest
- Restaurant staff
- Restaurant owner
- Mobile client
Connections 32
- Restaurant guest → Guest app: uses
- Restaurant guest → Kiosk ordering: orders via
- Guest app → Guest menu: loads menu
- Kiosk ordering → Guest menu: fetches menu
- Guest app → Order workflow: submits orders
- Kiosk ordering → Order workflow: submits orders
- Restaurant staff → Staff POS: uses
- Staff POS → Order workflow: manages checks
- Order workflow → Kitchen workflow: dispatches orders
- Kitchen workflow → Inventory: deducts stock
- Guest app → Bookings: manages bookings
- Bookings → Telegram: sends reminders
- Restaurant owner → Owner workspace: manages restaurant
- Restaurant owner → Admin workspace: manages restaurant
- Owner workspace → Analytics: views performance
- Admin workspace → Analytics: views performance
- Owner workspace → Subscriptions: manages license
- Guest app → Review analysis: submits feedback
- Review analysis → Telegram: AI integration
- Owner workspace → Authentication: authenticates
- Admin workspace → Authentication: authenticates
- Staff POS → Authentication: authenticates
- Authentication → PostgreSQL: reads and writes
- Guest menu → PostgreSQL: reads menu data
- Order workflow → PostgreSQL: stores orders
- Bookings → PostgreSQL: stores bookings
- Inventory → PostgreSQL: stores stock
- Analytics → PostgreSQL: reads metrics
- Order workflow → WebSocket updates: publishes status
- WebSocket updates → Mobile client: streams updates
- WebSocket updates → Restaurant guest: streams updates
- Notifications → Mobile client: push notifications