How adefilippo83/fooddesk works
FoodDesk is a venue-local ordering and service system. Staff or guests create orders; the server records them, handles payment where applicable, and exposes order progress to the kitchen and customer. Staff can manage the menu and users, while managers review reports and configure documents. The README documents printing, live updates, online payments, and reporting; several route implementations were not sampled, so those capability links rely on the README rather than inspected route code.
Main entry points: app.ts API server · schema.ts SQLite database · App.tsx Web app · lifecycle.ts Payment lifecycle
Components 32
Web experience
- Web app
web/src/App.tsx - Staff ordering
web/src/pages/NewOrder.tsx - Guest ordering
web/src/pages/CustomerOrder.tsx - Order status
web/src/pages/CustomerStatus.tsx - Kitchen display
web/src/pages/Kitchen.tsx - Order management
web/src/pages/Orders.tsx - Menu management
web/src/pages/AdminMenu.tsx - Reports UI
web/src/pages/Reports.tsx - Settings UI
web/src/pages/Settings.tsx - API client
web/src/api.ts
Ordering and service
- Order handling
server/src/routes/orders.ts - Public ordering
server/src/routes/public.ts - Order placement
server/src/lib/placeOrder.ts - Payment lifecycle
server/src/payments/lifecycle.ts - Payment providers
server/src/payments/provider.ts - Kitchen operations
server/src/routes/kitchen.ts - Live order events
server/src/lib/sse.ts - Service-day rules
server/src/lib/serviceDay.ts
Venue operations
- Reporting
server/src/routes/reports.ts - Menu service
server/src/routes/menu.ts - Staff management
server/src/routes/users.ts - Venue settings
server/src/routes/settings.ts - Ticket printing
server/src/print/service.ts - PDF rendering
server/src/print/pdf.ts
Server foundation
- API server
server/src/app.ts - Authentication
server/src/routes/auth.ts - SQLite database
server/src/db/schema.ts
Other components
- Waiter
- Guest
- Manager
- Kitchen staff
- CUPS printer
Connections 43
- Waiter → Staff ordering: places orders
README.md - Guest → Guest ordering: self-orders
README.md - Manager → Web app: manages venue
README.md - Kitchen staff → Kitchen display: prepares dishes
README.md - Web app → Staff ordering: routes to
web/src/App.tsx - Web app → Guest ordering: routes to
web/src/App.tsx - Web app → Order status: routes to
web/src/App.tsx - Web app → Kitchen display: routes to
web/src/App.tsx - Staff ordering → API client: requests API
web/src/pages/NewOrder.tsx - Order management → API client: requests API
web/src/pages/Orders.tsx - Menu management → API client: requests API
web/src/pages/AdminMenu.tsx - Settings UI → API client: requests API
web/src/pages/Settings.tsx - API client → API server: calls API
- API server → Authentication: registers
server/src/app.ts - API server → Order handling: registers
server/src/app.ts - API server → Public ordering: registers
server/src/app.ts - API server → Kitchen operations: registers
server/src/app.ts - API server → Menu service: registers
server/src/app.ts - API server → Reporting: registers
server/src/app.ts - API server → Venue settings: registers
server/src/app.ts - API server → Staff management: registers
server/src/app.ts - Authentication → SQLite database: reads/writes
server/src/routes/auth.ts - Order handling → Order placement: uses
server/src/routes/orders.ts - Order handling → Payment lifecycle: uses
server/src/routes/orders.ts - Public ordering → Order placement: uses
server/src/routes/public.ts - Public ordering → Payment lifecycle: uses
server/src/routes/public.ts - Payment lifecycle → Payment providers: verifies/refunds
server/src/payments/lifecycle.ts - Payment lifecycle → Ticket printing: prints ticket
server/src/payments/lifecycle.ts - Payment lifecycle → SQLite database: updates orders
server/src/payments/lifecycle.ts - Order handling → Service-day rules: uses day rules
server/src/routes/orders.ts - API server → Live order events: opens stream
server/src/app.ts - Ticket printing → PDF rendering: renders ticket
server/src/print/service.ts - Ticket printing → CUPS printer: sends ticket
server/src/print/service.ts - Ticket printing → SQLite database: records print state
server/src/print/service.ts - Reporting → SQLite database: reads report data
- Menu service → SQLite database: manages menu
- Staff management → SQLite database: manages staff
- Venue settings → SQLite database: stores settings
- Guest → Order status: tracks order
README.md - Kitchen display → Live order events: receives live updates
- Manager → Reports UI: reviews totals
README.md - Manager → Menu management: edits menu
README.md - Manager → Settings UI: configures venue
README.md