How nuimanlp/srisurart-pos-flutter works
Srisurart Autopart POS is a Thai-first, offline-capable point-of-sale client backed by a multi-tenant NestJS API. The principal workflow is counter staff ringing up a sale, with stock and payment-related business rules enforced transactionally; supporting workflows cover catalogue and purchasing, returns and quotes, customer/mechanic accounts, shifts, reporting, and owner review. The README documents the Flutter-to-API architecture and backend services. Flutter implementation files and most backend domain implementations were not sampled, so their internal calls are not inferred here.
Main entry points: src NestJS API · sales.controller.ts Sales checkout · idempotency.service.ts Idempotent writes · tenant.guard.ts Tenant authentication
Components 25
POS client
- Flutter POS
frontend
API access
- NestJS API
server/src - Tenant authentication
server/src/common/guards/tenant.guard.ts
Sales and stock
- Sales checkout
server/src/sales/sales.controller.ts - Sale processing
server/src/sales/sales.service.ts - Sale queries
server/src/sales/sale-reads.service.ts - Returns
server/src/returns - Quotes
server/src/quotes/quotes.controller.ts - Products and stock
server/src/products - Purchase orders
server/src/purchasing - Customers
server/src/customers - Mechanic credit
server/src/mechanics - Parked sales
server/src/parked-sales
Shop operations
- Cash drawer shifts
server/src/shifts/shifts.controller.ts - Owner review
server/src/review-items/review-items.controller.ts - Reports
server/src/reports - Settings and bootstrap
server/src/settings - Sync and backup
server/src/sync
Platform services
- Idempotent writes
server/src/idempotency/idempotency.service.ts - Device enrollment
server/src/devices - Tenant transactions
server/src/common/database/tenant.service.ts - PostgreSQL tenant store
- Redis services
- Background jobs
server/src/queue
Other components
- Counter staff
Connections 30
- Counter staff → Flutter POS: uses
README.md - Flutter POS → NestJS API: calls HTTPS API
README.md - NestJS API → Tenant authentication: guards tenant routes
server/src/review-items/review-items.controller.ts - Tenant authentication → Redis services: caches tenant status
server/src/common/guards/tenant.guard.ts - Tenant authentication → Tenant transactions: establishes tenant scope
- Sales checkout → Sale processing: creates sale
server/src/sales/sales.controller.ts - Sales checkout → Sale queries: queries sales
server/src/sales/sales.controller.ts - Sales checkout → Quotes: sells quote
server/src/sales/sales.controller.ts - Sales checkout → Idempotent writes: runs idempotently
server/src/sales/sales.controller.ts - Quotes → Idempotent writes: runs idempotently
server/src/quotes/quotes.controller.ts - Owner review → Idempotent writes: runs idempotently
server/src/review-items/review-items.controller.ts - Cash drawer shifts → Idempotent writes: runs idempotently
server/src/shifts/shifts.controller.ts - Idempotent writes → Tenant transactions: uses transaction context
server/src/idempotency/idempotency.service.ts - Tenant transactions → PostgreSQL tenant store: runs tenant transactions
README.md - Idempotent writes → Redis services: uses cache accelerator
server/src/idempotency/idempotency.service.ts - Sales checkout → Products and stock: sale affects stock
- Purchase orders → Products and stock: receives stock
README.md - Returns → Sales checkout: refunds sales
README.md - Mechanic credit → Sales checkout: tracks credit sales
- NestJS API → Background jobs: dispatches jobs
server/src/quotes/quotes.controller.ts - Background jobs → PostgreSQL tenant store: processes tenant work
- NestJS API → PostgreSQL tenant store: persists API data
README.md - NestJS API → Device enrollment: serves enrollment
README.md - NestJS API → Customers: serves customer routes
README.md - NestJS API → Parked sales: serves parked sales
README.md - NestJS API → Reports: serves reports
README.md - NestJS API → Settings and bootstrap: serves settings
README.md - NestJS API → Sync and backup: serves sync and backup
README.md - NestJS API → Cash drawer shifts: serves shifts
README.md - NestJS API → Owner review: serves owner review
README.md