How jomo424947-arch/orderfast works
OrderFAST is a campus kiosk ordering platform, with student ordering and kiosk order handling as its central workflow. The repository includes a broad Next.js frontend and a Fastify API with domain services, PostgreSQL persistence, and Supabase authentication. The README describes the web frontend as the current phase and its services as mock-backed; backend capabilities are represented from the API tree and sampled route/service references. Some frontend and worker wiring is unsampled, so uncertain relationships are omitted.
Main entry points: schema.ts PostgreSQL data · app.ts API route registration · app Web application · notification.service.ts Notifications
Components 23
Web Experience
- Web application
apps/web/app - Web services
apps/web/lib/services - Client state
apps/web/stores
Identity & Access
- Auth routes
apps/api/src/modules/auth/auth.routes.ts - Auth service
apps/api/src/modules/auth/auth.service.ts - Auth middleware
apps/api/src/shared/middleware/auth.ts - Supabase Auth
apps/api/src/shared/supabase/index.ts
Campus Commerce
- Kiosk routes
apps/api/src/modules/kiosks/kiosk.routes.ts - Kiosk service
apps/api/src/modules/kiosks/kiosk.service.ts - Catalog routes
apps/api/src/modules/catalog/catalog.routes.ts - Catalog service
apps/api/src/modules/catalog/catalog.service.ts - Order routes
apps/api/src/modules/orders/order.routes.ts - Order service
apps/api/src/modules/orders/order.service.ts - Service fees
apps/api/src/modules/orders/service-fee.service.ts
Engagement & Support
- League service
apps/api/src/modules/league/league.service.ts - Notifications
apps/api/src/modules/notifications/notification.service.ts - Marketing campaigns
apps/api/src/modules/notifications/marketing.service.ts - Support
apps/api/src/modules/support/support.service.ts
API & Persistence
- PostgreSQL data
apps/api/src/db/schema.ts - API route registration
apps/api/src/app.ts
Other components
- Student
- Kiosk staff
- Administrator
Connections 29
- Student → Web application: uses
README.md - Kiosk staff → Web application: uses
README.md - Administrator → Web application: uses
README.md - Web application → Web services: uses
- Web services → Client state: updates
- API route registration → Auth routes: registers
apps/api/src/app.ts - API route registration → Kiosk routes: registers
apps/api/src/app.ts - API route registration → Catalog routes: registers
apps/api/src/app.ts - API route registration → Order routes: registers
apps/api/src/app.ts - API route registration → Notifications: registers routes
- Auth routes → Auth service: calls
apps/api/src/modules/auth/auth.routes.ts - Auth service → Supabase Auth: authenticates
apps/api/src/modules/auth/auth.service.ts - Auth routes → Auth middleware: guards
apps/api/src/modules/auth/auth.routes.ts - Kiosk routes → Kiosk service: calls
apps/api/src/modules/kiosks/kiosk.routes.ts - Catalog routes → Catalog service: calls
apps/api/src/modules/catalog/catalog.routes.ts - Order routes → Order service: calls
apps/api/src/modules/orders/order.routes.ts - Catalog service → PostgreSQL data: reads/writes
apps/api/src/modules/catalog/catalog.service.ts - Kiosk service → PostgreSQL data: reads/writes
apps/api/src/modules/kiosks/kiosk.service.ts - Auth service → PostgreSQL data: reads/writes
apps/api/src/modules/auth/auth.service.ts - Auth middleware → Supabase Auth: verifies tokens
apps/api/src/shared/middleware/auth.ts - Order routes → Auth middleware: guards
apps/api/src/modules/orders/order.routes.ts - Order service → PostgreSQL data: reads/writes
- Service fees → PostgreSQL data: reads/writes
- League service → PostgreSQL data: reads/writes
apps/api/src/modules/league/league.service.ts - League service → Notifications: sends push
apps/api/src/modules/league/league.service.ts - Marketing campaigns → PostgreSQL data: reads/writes
apps/api/src/modules/notifications/marketing.service.ts - Marketing campaigns → Notifications: sends push
apps/api/src/modules/notifications/marketing.service.ts - Notifications → PostgreSQL data: reads/writes
apps/api/src/modules/notifications/notification.service.ts - Support → PostgreSQL data: persists