How amroabujabal/cosc310-snackoverflow works
SnackOverflow is a FastAPI food-delivery backend. Restaurant browsing and management flow through HTTP routes into domain services and JSON repositories; authenticated cart requests additionally validate customers and current menu availability before returning cart totals. The README also documents menu availability controls and restaurant/menu management UI. Cart, menu, restaurant, and customer data are JSON-backed. Relationships are included where shown by excerpts, the source index, or README; unsampled details are not inferred.
Main entry points: config.py Data settings · main.py FastAPI app · menus.py Menu routes · cart_service.py Cart service
Components 29
API and interfaces
- FastAPI app
app/main.py - Restaurant routes
app/routes/restaurants.py - Menu routes
app/routes/menus.py - Cart routes
app/routes/cart.py - Browsing UI
app/frontend/app.js - Management UI
app/frontend/management.js
Catalog and cart
- Restaurant service
app/services/restaurant_services.py - Menu service
app/services/menu_services.py - Cart service
app/services/cart_service.py - Domain errors
app/services/exceptions.py - Restaurant contracts
app/models/restaurant_requests.py - Menu item contracts
app/models/menu_item_requests.py - Menu models
app/models/menu.py - Menu item model
app/models/menu_item.py - Restaurant model
app/models/restaurant.py - Cart models
app/models/cart.py
Customer identity
- Authentication
app/dependencies/auth.py - Token security
app/core/security.py - Customer model
app/models/customer.py
JSON persistence
- Customer repository
app/repositories/customer_repository.py - Restaurant repository
app/repositories/restaurant_repository.py - Menu repository
app/repositories/menu_repository.py - Cart repository
app/repositories/cart_repository.py - Data settings
app/core/config.py - Customers JSON
data/customers.json - Restaurants JSON
data/restaurants.json - Menus JSON
data/menus.json - Carts JSON
data/carts.json
Other components
- API client
Connections 28
- API client → FastAPI app: sends requests
README.md - FastAPI app → Restaurant routes: registers router
app/main.py - FastAPI app → Menu routes: registers router
app/main.py - FastAPI app → Cart routes: registers router
app/main.py - Restaurant routes → Restaurant service: calls
app/routes/restaurants.py - Menu routes → Menu service: calls
app/routes/menus.py - Cart routes → Cart service: calls
app/routes/cart.py - Cart routes → Authentication: authenticates with
app/routes/cart.py - Restaurant service → Restaurant repository: reads and writes
app/services/restaurant_services.py - Menu service → Menu repository: reads and writes
app/services/menu_services.py - Menu service → Restaurant repository: checks restaurant
app/services/menu_services.py - Cart service → Cart repository: transacts cart
app/services/cart_service.py - Cart service → Customer repository: checks customer
app/services/cart_service.py - Cart service → Menu service: validates items
app/services/cart_service.py - Authentication → Customer repository: loads customer
app/dependencies/auth.py - Authentication → Token security: validates token
app/dependencies/auth.py - Restaurant repository → Restaurants JSON: reads and writes
app/repositories/restaurant_repository.py - Menu repository → Menus JSON: reads and writes
app/repositories/menu_repository.py - Cart repository → Carts JSON: reads and writes
app/repositories/cart_repository.py - Customer repository → Customers JSON: reads and writes
app/repositories/customer_repository.py - Restaurant repository → Data settings: gets data path
app/repositories/restaurant_repository.py - Menu repository → Data settings: gets data path
app/repositories/menu_repository.py - Cart repository → Data settings: gets data path
app/repositories/cart_repository.py - Customer repository → Data settings: gets data path
app/repositories/customer_repository.py - Token security → Data settings: uses token settings
app/core/security.py - Restaurant routes → Management UI: serves management API
README.md - Menu routes → Management UI: serves management API
README.md - Menu routes → Browsing UI: serves browsing API
README.md