How paoloprandonitechnology/cassa-smart works
Cassa Smart is an offline, LAN-hosted order-management system for a festival. The main workflow runs from a mixed cashier cart through department-split orders and per-department numbering to KDS status updates, public display, and customer-facing screens. Admin also manages products, departments, users, settings, reporting, and printing; a separate update portal supports maintenance. The README documents the workflow and capabilities; several backend routes and integrations were not sampled, so uncertain implementation links are omitted or marked unverified.
Main entry points: api.ts HTTP API · orders.service.ts Order lifecycle · socket.ts Realtime events · routes.ts Update routes
Components 22
Service stations
- Cashier
server/public/cassa/app.js - Department KDS
server/public/kds/app.js - Preparations KDS
server/public/kds-preparazione/app.js - Public display
server/public/display/app.js - Customer screen
server/public/schermo-cliente/app.js - Login and home
server/public/home/app.js
Order operations
- HTTP API
server/src/routes/api.ts - Order lifecycle
server/src/modules/orders/orders.service.ts - Products and stock
server/src/modules/products/products.repository.ts - Departments
server/src/modules/departments/departments.service.ts - Realtime events
server/src/realtime/socket.ts
Administration
- Admin console
server/public/admin/app.js - Configuration
server/src/modules/configuration/configuration.service.ts - Authentication and permissions
server/src/modules/auth/auth.service.ts - Audit log
server/src/modules/audit/audit.service.ts - Printing
server/src/modules/printers/print-escpos.service.ts
Platform services
- Thermal printers
- SQLite database
server/src/db/database.ts - Update portal
server/public/update/app.js - Update service
server/src/modules/update/update.service.ts - Update routes
server/src/update-ui/routes.ts - System time
server/src/modules/time/system-time.service.ts
Connections 21
- Cashier → HTTP API: submits cart
- HTTP API → Order lifecycle: routes orders
- Order lifecycle → SQLite database: persists orders
server/src/modules/orders/orders.service.ts - Order lifecycle → Departments: splits by department
server/src/modules/orders/orders.service.ts - Order lifecycle → Products and stock: validates stock
server/src/modules/orders/orders.service.ts - Order lifecycle → Department KDS: updates queues
- Department KDS → HTTP API: changes status
- Order lifecycle → Realtime events: publishes updates
- Realtime events → Public display: refreshes display
- Realtime events → Customer screen: updates screen
- Preparations KDS → HTTP API: views preparations
- Login and home → Authentication and permissions: authenticates user
- Admin console → HTTP API: manages service
- HTTP API → Configuration: routes configuration
- Configuration → SQLite database: reads and writes
server/src/modules/configuration/configuration.service.ts - HTTP API → Printing: routes print jobs
- Printing → Thermal printers: sends ESC/POS
- Update portal → Update routes: calls portal API
- Update routes → Update service: requests update status
server/src/update-ui/routes.ts - Update routes → Audit log: records actions
server/src/update-ui/routes.ts - System time → SQLite database: reads and writes settings
server/src/modules/time/system-time.service.ts