How fuhl-sp26-sep490-g13/coffee-shop works
Coffee Shop Management is a multi-role cafe platform for customer ordering, in-store and takeaway operations, catalog administration, payments, loyalty, and workforce management. The principal customer flow is browsing products, building a cart, checking out, and tracking orders; staff and baristas handle fulfillment, while managers configure the store and oversee operations. The backend is an Express API with domain services and repositories, plus scheduled jobs and socket notifications. The README is empty and many domain files were not sampled, so undocumented links are omitted or marked unverified.
Main entry points: OrderOnlineController.js Order API · axiosClient.js API Client · ReviewController.js Reviews · app.js Express API
Components 25
Customer Commerce
- Client Routes
coffee-shop-frontend/src/routes/AppRoutes.jsx - Product Browsing
coffee-shop-frontend/src/pages/homePage/product/ProductDetailPage.jsx - Shopping Cart
coffee-shop-frontend/src/store/useCartStore.js - Online Checkout
coffee-shop-frontend/src/pages/homePage/order/CheckoutPage.jsx - Order Tracking
coffee-shop-frontend/src/pages/homePage/order/MyOrderOnlinePage.jsx - API Client
coffee-shop-frontend/src/services/axiosClient.js
Backend Domains
- Order API
coffee-shop-backend/src/controllers/OrderOnlineController.js - Order Processing
coffee-shop-backend/src/services/OrderOnlineService.js - Catalog Management
coffee-shop-backend/src/services/ProductService.js - Reviews
coffee-shop-backend/src/controllers/ReviewController.js - Review Rules
coffee-shop-backend/src/services/ReviewService.js - Review Records
coffee-shop-backend/src/repositories/ReviewRepository.js - Notifications
coffee-shop-backend/src/services/NotificationService.js
Store Operations
- Manager
- Admin Workspace
coffee-shop-frontend/src/pages/admin/AdminApp.jsx - Order Oversight
coffee-shop-frontend/src/pages/admin/AdminOrder/AdminOrders.jsx - Staff Workspace
coffee-shop-frontend/src/pages/staff/StaffApp.jsx - Barista Fulfillment
coffee-shop-frontend/src/pages/barista/BaristaOrder/BaristaOrders.jsx - Workforce Tools
coffee-shop-backend/src/services/AttendanceService.js
Platform
- Express API
coffee-shop-backend/src/app.js - MySQL Connection
coffee-shop-backend/src/config/database.js - HTTP and Sockets
coffee-shop-backend/server.js - PayOS
coffee-shop-backend/src/config/payos.js - Cloudinary
coffee-shop-backend/src/config/cloudinary.js
Other components
- Customer
Connections 25
- Customer → Client Routes: opens
coffee-shop-frontend/src/routes/AppRoutes.jsx - Client Routes → Product Browsing: routes to
coffee-shop-frontend/src/routes/AppRoutes.jsx - Product Browsing → Shopping Cart: adds items
- Shopping Cart → Online Checkout: checks out
- Online Checkout → API Client: submits order
- API Client → Order API: requests
- Order API → Order Processing: delegates
coffee-shop-backend/src/controllers/OrderOnlineController.js - Order Processing → MySQL Connection: reads and writes
- Order API → Notifications: notifies
coffee-shop-backend/src/controllers/OrderOnlineController.js - Order API → PayOS: integrates payment
- API Client → Order Tracking: loads status
- Manager → Admin Workspace: manages
- Admin Workspace → Order Oversight: includes
coffee-shop-frontend/src/routes/AppRoutes.jsx - Order Oversight → API Client: requests data
- Staff Workspace → Order API: handles orders
- Barista Fulfillment → Order API: fulfills orders
- Express API → HTTP and Sockets: served by
coffee-shop-backend/server.js - HTTP and Sockets → Express API: creates server for
coffee-shop-backend/server.js - HTTP and Sockets → PayOS: loads config
coffee-shop-backend/server.js - Express API → MySQL Connection: domain data access
- Reviews → Review Rules: calls
coffee-shop-backend/src/controllers/ReviewController.js - Review Rules → Review Records: queries
coffee-shop-backend/src/services/ReviewService.js - Reviews → Notifications: creates alerts
coffee-shop-backend/src/controllers/ReviewController.js - Reviews → Cloudinary: uploads media
coffee-shop-backend/src/controllers/ReviewController.js - Workforce Tools → MySQL Connection: persists records