How samer-koda/rapidticket works
RapidTicket is a LAN-only restaurant and bar POS. Staff configure a station, authenticate by PIN, manage tables and orders, send items through kitchen/bar workflows, and take payment; administrators maintain menu, stations, printers, and settings and review reports. Electron/React clients use REST and WebSocket connections to the NestJS server, backed by PostgreSQL. The README documents the client/server and printing capabilities; some server modules were not sampled, so their internal links are omitted or marked unverified.
Main entry points: api.ts REST client · App.tsx App routing · entities PostgreSQL data · orders.controller.ts Order processing
Components 30
Station client
- Electron station
client/electron/main.cjs - App routing
client/src/App.tsx - Session context
client/src/context/AuthContext.tsx - REST client
client/src/api.ts - WebSocket context
client/src/context/WsContext.tsx
POS operations
- Table view
client/src/screens/TableView.tsx - Order entry
client/src/screens/OrderScreen.tsx - Kitchen screen
client/src/screens/KitchenScreen.tsx - Bar screen
client/src/screens/BarScreen.tsx - Payment screen
client/src/screens/PaymentScreen.tsx - Station printing
client/src/print.ts
Back office
- Back office
client/src/screens/BackOffice.tsx - Station setup
client/src/screens/Setup.tsx - Admin bootstrap
client/src/screens/FirstRun.tsx - PIN login
client/src/screens/Login.tsx
Server services
- Authentication
server/src/auth/auth.service.ts - Station management
server/src/stations/stations.controller.ts - Floor plans
server/src/floor-plans/floor-plans.controller.ts - Menu management
server/src/menu/menu.controller.ts - Order processing
server/src/orders/orders.controller.ts - Payment processing
server/src/payments/payments.controller.ts - Sales reports
server/src/reports/reports.controller.ts - Settings
server/src/settings/settings.controller.ts - Printer management
server/src/printers/printers.controller.ts - Kitchen print routing
server/src/print/print.service.ts
Persistence and events
- Domain event bus
server/src/common/event-bus.service.ts - Realtime gateway
server/src/gateway/events.gateway.ts - PostgreSQL data
server/src/database/entities
Other components
- Restaurant staff
- Kitchen Ethernet printer
Connections 48
- Restaurant staff → Electron station: uses
README.md - Electron station → App routing: hosts
client/src/App.tsx - App routing → Session context: provides session
client/src/App.tsx - App routing → WebSocket context: provides events
client/src/App.tsx - App routing → Table view: renders
client/src/App.tsx - App routing → Order entry: renders
client/src/App.tsx - App routing → Kitchen screen: renders
client/src/App.tsx - App routing → Bar screen: renders
client/src/App.tsx - App routing → Payment screen: renders
client/src/App.tsx - App routing → Back office: renders
client/src/App.tsx - App routing → Station setup: renders
client/src/App.tsx - App routing → Admin bootstrap: renders
client/src/App.tsx - App routing → PIN login: renders
client/src/App.tsx - Session context → REST client: requests login
client/src/context/AuthContext.tsx - Table view → REST client: loads tables
- Order entry → REST client: manages orders
client/src/screens/OrderScreen.tsx - Payment screen → REST client: submits payment
client/src/screens/PaymentScreen.tsx - Payment screen → Station printing: prints receipt
client/src/screens/PaymentScreen.tsx - Bar screen → WebSocket context: receives events
client/src/screens/BarScreen.tsx - Bar screen → Station printing: prints chit
client/src/screens/BarScreen.tsx - App routing → Station printing: prints bar chits
client/src/App.tsx - Back office → REST client: manages operations
client/src/screens/BackOffice.tsx - Station setup → REST client: registers station
- Admin bootstrap → REST client: creates admin
- PIN login → Session context: authenticates
- REST client → Authentication: calls REST
README.md - REST client → Station management: calls REST
client/src/api.ts - REST client → Floor plans: calls REST
client/src/api.ts - REST client → Menu management: calls REST
client/src/api.ts - REST client → Order processing: calls REST
client/src/api.ts - REST client → Payment processing: calls REST
client/src/api.ts - REST client → Sales reports: calls REST
client/src/api.ts - REST client → Settings: calls REST
client/src/api.ts - REST client → Printer management: calls REST
client/src/api.ts - Authentication → PostgreSQL data: reads users/settings
server/src/auth/auth.service.ts - Station management → Authentication: resets lockout
server/src/stations/stations.controller.ts - Station management → PostgreSQL data: persists stations
- Floor plans → PostgreSQL data: reads/writes plans
- Menu management → PostgreSQL data: reads/writes menu
server/src/menu/menu.controller.ts - Order processing → PostgreSQL data: reads/writes orders
server/src/orders/orders.controller.ts - Order processing → Domain event bus: emits order events
- Payment processing → PostgreSQL data: reads/writes payments
- Payment processing → Domain event bus: emits payment events
- Sales reports → PostgreSQL data: queries sales
- Settings → PostgreSQL data: manages settings
- Printer management → PostgreSQL data: manages printers
- Kitchen print routing → PostgreSQL data: reads printer config
server/src/print/print.service.ts - Order processing → Kitchen print routing: routes kitchen items