How 25ag1a6767-cyber/collegebites works
CollegeBites is a multi-location college-canteen ordering and operations platform with web and mobile clients backed by a FastAPI service. Customers browse menus, place orders, pay online or at a counter, and receive pickup tokens; staff prepare, display, and verify orders for handover. The README documents the end-to-end stages and capabilities, while sampled backend routes show selected service delegation. Several frontend and backend subsystems are present in the tree but were not sampled, so their internal links are omitted where direct evidence is unavailable.
Main entry points: database.py Relational Database · order_service.py Order Processing · routes.py Order Routes · payment_service.py Payment Service
Components 24
Customer Clients
- Web App
frontend/src/App.tsx - Mobile App
mobile/app/index.tsx - Web API Client
frontend/src/api/client.ts - Mobile API Client
mobile/src/api/client.ts
Ordering and Payment
- Menu Management
backend/app/services/menu_service.py - Menu Routes
backend/app/api/menus/routes.py - Order Processing
backend/app/services/order_service.py - Order Routes
backend/app/api/orders/routes.py - Payment Routes
backend/app/api/payments/routes.py - Payment Service
backend/app/services/payment_service.py - Payment Gateways
backend/app/integrations/stripe_client.py - Pickup Token and QR
backend/app/services/token_service.py - Receipt Printing
backend/app/services/receipt_service.py
Canteen Operations
- Kitchen Display
backend/app/services/kitchen_service.py - Live Token Board
backend/app/services/queue_service.py - Pickup Verification
backend/app/services/pickup_service.py - Inventory Management
backend/app/services/inventory_service.py - Administration
backend/app/api/admin/routes.py - Realtime Updates
backend/app/services/realtime_service.py - Notifications
backend/app/services/notification_service.py - Reports
backend/app/services/report_service.py
Backend Platform
- Relational Database
backend/app/core/database.py - Authentication and Permissions
backend/app/core/permissions.py
Other components
- Customer or Guest
Connections 28
- Customer or Guest → Web App: uses
- Customer or Guest → Mobile App: uses
- Web App → Web API Client: requests
- Mobile App → Mobile API Client: requests
mobile/app/index.tsx - Web API Client → Order Routes: sends requests
- Mobile API Client → Order Routes: sends requests
- Menu Routes → Menu Management: delegates to
backend/app/api/menus/routes.py - Menu Management → Relational Database: reads and writes
- Order Routes → Order Processing: delegates to
- Order Processing → Relational Database: reads and writes
- Order Routes → Payment Routes: initiates payment
- Payment Routes → Payment Service: delegates to
backend/app/api/payments/routes.py - Payment Service → Payment Gateways: verifies payment
- Payment Gateways → Payment Service: processes payment
- Payment Service → Pickup Token and QR: issues token
- Pickup Token and QR → Receipt Printing: includes in receipt
- Order Processing → Kitchen Display: routes order
- Kitchen Display → Live Token Board: publishes token
- Live Token Board → Pickup Verification: presents for handover
- Pickup Verification → Order Processing: completes order
- Inventory Management → Relational Database: reads and writes
- Administration → Relational Database: checks health
backend/app/api/admin/routes.py - Realtime Updates → Live Token Board: updates live
- Notifications → Customer or Guest: notifies
- Reports → Administration: provides reports
- Authentication and Permissions → Relational Database: loads roles
backend/app/core/permissions.py - Menu Routes → Authentication and Permissions: checks access
backend/app/api/menus/routes.py - Payment Routes → Authentication and Permissions: checks access
backend/app/api/payments/routes.py