How seven742/restaurant-qr-ordering works
This is a Next.js QR-based restaurant ordering system. Customers scan a table QR code, browse the menu, build a cart, submit an order, and view order status/history; staff and admins manage orders, menu, tables, settings, and analytics. The sampled ordering client and order API show the principal flow, including server-side price lookup and transactional persistence. The README documents broader admin capabilities; some of their page and route implementations were not sampled, so those links are documented rather than inferred from unseen calls.
Main entry points: OrderClient.js Menu ordering · admin Admin dashboard · route.js Order API · auth.js Session and roles
Components 30
Customer ordering
- Menu ordering
app/order/OrderClient.js - Cart checkout
components/customer/Cart.js - Order confirmation
components/customer/OrderConfirmation.js - Order history
components/customer/OrderHistory.js
Restaurant operations
- Admin dashboard
app/admin - Menu management
app/admin/menu/page.js - Order management
app/admin/orders/page.js - Table management
app/admin/tables/page.js - Restaurant settings
app/admin/settings/page.js
API endpoints
- Analytics API
app/api/admin/dashboard/route.js - Order API
app/api/orders/route.js - Order status API
app/api/orders/[id]/status/route.js - Product API
app/api/products/route.js - Category API
app/api/categories/route.js - Table API
app/api/tables/route.js - Settings API
app/api/settings/route.js - Image upload API
app/api/upload/route.js - Authentication API
app/api/auth/login/route.js
Shared services
- Cart state
lib/cart.js - Translations
lib/i18n.js - Browser API client
lib/client.js - Session and roles
lib/auth.js - JWT handling
lib/jwt.js - Request validation
lib/validate.js - API responses
lib/api.js - Order item loading
lib/orders.js
Persistence
- MySQL database
lib/db.js
Other components
- QR customer
- Admin and staff
- Cloudinary
Connections 37
- QR customer → Menu ordering: scans QR
- Menu ordering → Browser API client: loads menu data
app/order/OrderClient.js - Menu ordering → Cart checkout: opens checkout
app/order/OrderClient.js - Menu ordering → Cart state: uses cart state
app/order/OrderClient.js - Menu ordering → Translations: translates UI
app/order/OrderClient.js - Cart checkout → Cart state: reads and clears
components/customer/Cart.js - Cart checkout → Browser API client: submits order
components/customer/Cart.js - Browser API client → Order API: posts order
- Cart checkout → Order confirmation: sets placed order
components/customer/Cart.js - Menu ordering → Order history: shows history
app/order/OrderClient.js - Admin and staff → Admin dashboard: manages restaurant
- Admin dashboard → Menu management: routes to menu
- Admin dashboard → Order management: routes to orders
- Admin dashboard → Table management: routes to tables
- Admin dashboard → Restaurant settings: routes to settings
- Menu management → Product API: manages products
- Menu management → Category API: manages categories
- Menu management → Image upload API: uploads images
- Order management → Order API: views orders
- Order management → Order status API: updates status
- Table management → Table API: manages tables
- Restaurant settings → Settings API: configures restaurant
- Admin dashboard → Analytics API: loads analytics
- Order API → MySQL database: queries and writes
app/api/orders/route.js - Order API → Request validation: validates input
app/api/orders/route.js - Order API → Session and roles: checks staff role
app/api/orders/route.js - Order API → Order item loading: attaches items
app/api/orders/route.js - Product API → MySQL database: queries and writes
app/api/products/route.js - Product API → Session and roles: checks admin role
app/api/products/route.js - Product API → Request validation: validates input
app/api/products/route.js - Table API → MySQL database: queries and writes
app/api/tables/route.js - Table API → Session and roles: checks staff role
app/api/tables/route.js - Authentication API → Session and roles: sets session
app/api/auth/login/route.js - Session and roles → JWT handling: signs and verifies
lib/auth.js - Analytics API → MySQL database: reads metrics
app/api/admin/dashboard/route.js - Analytics API → Session and roles: checks role
app/api/admin/dashboard/route.js - Image upload API → Cloudinary: stores images