How jadeed01/kupa---food-order-app works
Kupa is a food-ordering product with a React customer app and Django REST backend. The customer journey spans account access, menu discovery, address selection, cart management, checkout, and order history; the backend provides account, menu, and order capabilities. Frontend state contexts and the API client form a useful internal layer between screens and the service. The README is empty, and several screens and backend routes were not sampled, so some cross-application links remain unverified rather than asserted as direct calls.
Main entry points: App.jsx App routing · urls.py Django API · api.js API client · Location.jsx Address screen
Components 22
Customer app
- App routing
kupa-frontend/src/App.jsx - Account screens
kupa-frontend/src/pages - Menu browsing
kupa-frontend/src/pages/Menu.jsx - Address screen
kupa-frontend/src/pages/Location.jsx - Cart checkout
kupa-frontend/src/pages/Cart.jsx - Order history
kupa-frontend/src/pages/Orders.jsx
Client state and API
- Auth state
kupa-frontend/src/context/AuthContext.jsx - Menu state
kupa-frontend/src/context/MenuContext.jsx - Address state
kupa-frontend/src/context/AddressContext.jsx - Cart state
kupa-frontend/src/context/CartContext.jsx - API client
kupa-frontend/src/lib/api.js
Accounts
- Account endpoints
kupa-backend/accounts/views.py - Users and OTPs
kupa-backend/accounts/models.py - Role permissions
kupa-backend/accounts/permissions.py
Menu and orders
- Menu endpoints
kupa-backend/menu/views.py - Menu catalog
kupa-backend/menu/models.py - Order endpoints
kupa-backend/orders/views.py - Orders and carts
kupa-backend/orders/models.py - Order serialization
kupa-backend/orders/serializers.py
Other components
- Customer
- Django API
kupa-backend/config/urls.py - Geocoding service
Connections 28
- Customer → App routing: uses
kupa-frontend/src/App.jsx - App routing → Account screens: routes to
kupa-frontend/src/App.jsx - App routing → Menu browsing: routes to
kupa-frontend/src/App.jsx - App routing → Address screen: routes to
kupa-frontend/src/App.jsx - App routing → Cart checkout: routes to
kupa-frontend/src/App.jsx - App routing → Order history: routes to
kupa-frontend/src/App.jsx - App routing → Auth state: provides
kupa-frontend/src/main.jsx - App routing → Menu state: provides
kupa-frontend/src/main.jsx - App routing → Address state: provides
kupa-frontend/src/main.jsx - App routing → Cart state: provides
kupa-frontend/src/main.jsx - Auth state → API client: calls
kupa-frontend/src/context/AuthContext.jsx - Address state → API client: calls
kupa-frontend/src/context/AddressContext.jsx - Cart state → API client: calls
kupa-frontend/src/context/CartContext.jsx - Cart checkout → Cart state: reads and updates
kupa-frontend/src/pages/Cart.jsx - Address screen → Address state: manages addresses
kupa-frontend/src/pages/Location.jsx - Address screen → Geocoding service: searches
kupa-frontend/src/pages/Location.jsx - API client → Django API: HTTP requests
- Django API → Account endpoints: dispatches
- Django API → Menu endpoints: dispatches
- Django API → Order endpoints: dispatches
- Account endpoints → Users and OTPs: reads and writes
kupa-backend/accounts/views.py - Account endpoints → Role permissions: uses
- Menu endpoints → Menu catalog: queries
kupa-backend/menu/views.py - Menu endpoints → Role permissions: checks access
kupa-backend/menu/views.py - Order endpoints → Orders and carts: reads and writes
kupa-backend/orders/views.py - Order endpoints → Order serialization: serializes
kupa-backend/orders/views.py - Order serialization → Orders and carts: serializes
kupa-backend/orders/serializers.py - Order serialization → Menu catalog: uses food data
kupa-backend/orders/serializers.py