How ahmaddaghlas55/supermarketsys works
This is a supermarket point-of-sale and back-office application: browser pages support checkout and store administration, while a Go HTTP server exposes authenticated APIs. The clearest shown workflow is checkout: staff scan and select products, assemble a cart, optionally assign a customer, then submit a sale through the API. The repository also contains distinct catalog, purchasing, cash/operations, promotions, reporting, and audit areas. Source excerpts establish only some backend wiring, so unsampled relationships are not asserted.
Main entry points: main.go HTTP server · checkout.js Checkout page · api.js API client · cash-register.js Cash register page
Components 31
Browser app
- Checkout page
internal/web/frontend/js/pages/checkout.js - Cart line
internal/web/frontend/js/components/CartLine.js - Customer picker
internal/web/frontend/js/components/CustomerPicker.js - Weight picker
internal/web/frontend/js/components/WeightPicker.js - Barcode listener
internal/web/frontend/js/core/barcodeListener.js - API client
internal/web/frontend/js/core/api.js - Browser auth
internal/web/frontend/js/core/auth.js - Cash register page
internal/web/frontend/js/pages/cash-register.js - Products page
internal/web/frontend/js/pages/products.js
HTTP server
- Embedded frontend
internal/web/embed.go - HTTP server
cmd/server/main.go - Auth middleware
internal/middleware/auth.go - Auth handlers
internal/handlers/auth.go - Inventory handlers
internal/handlers/inventory.go - Operations handlers
internal/handlers/operations.go - Purchasing handlers
internal/handlers/purchasing.go - Promotion handlers
internal/handlers/promotions.go - Report handlers
internal/handlers/reports.go - Audit handlers
internal/handlers/audit.go
Business services
- Authentication service
internal/services/auth.go - Catalog service
internal/services/catalog.go - Operations service
internal/services/operations.go - Purchasing service
internal/services/purchasing.go - Promotion service
internal/services/promotions.go - Reporting service
internal/services/reports.go - Audit service
internal/services/audit.go - Domain models
internal/models
Persistence
- SQL repositories
internal/repository - SQLite database
Other components
- Staff user
- Administrator
Connections 28
- Staff user → Checkout page: uses
- Checkout page → Cart line: renders
internal/web/frontend/js/pages/checkout.js - Checkout page → Customer picker: opens
internal/web/frontend/js/pages/checkout.js - Checkout page → Weight picker: uses
internal/web/frontend/js/pages/checkout.js - Checkout page → Barcode listener: starts
internal/web/frontend/js/pages/checkout.js - Checkout page → API client: requests
internal/web/frontend/js/pages/checkout.js - Products page → API client: requests
internal/web/frontend/js/pages/products.js - Cash register page → API client: requests
internal/web/frontend/js/pages/cash-register.js - API client → Browser auth: reads token
internal/web/frontend/js/core/api.js - Checkout page → Browser auth: checks access
internal/web/frontend/js/pages/checkout.js - Staff user → Cash register page: uses
- Administrator → Products page: uses
- HTTP server → Embedded frontend: serves assets
cmd/server/main.go - HTTP server → Auth handlers: routes auth
cmd/server/main.go - HTTP server → Inventory handlers: routes catalog
cmd/server/main.go - HTTP server → Operations handlers: routes operations
cmd/server/main.go - HTTP server → Auth middleware: protects routes
cmd/server/main.go - HTTP server → Promotion handlers: constructs handler
cmd/server/main.go - Auth handlers → Authentication service: calls
internal/handlers/auth.go - HTTP server → Authentication service: constructs
cmd/server/main.go - Purchasing handlers → Purchasing service: uses
- Promotion handlers → Promotion service: uses
- Report handlers → Reporting service: uses
- Audit handlers → Audit service: uses
- Inventory handlers → Catalog service: uses
- Operations handlers → Operations service: uses
- HTTP server → SQLite database: opens
cmd/server/main.go - HTTP server → SQL repositories: constructs repositories