How joysters-project/hardware-pos-system works
Hardware Point-of-Sale is a role-based retail and business-management application. Users sign in and enter role-specific workspaces; cashier activity centers on sales, receipts, and returns, while managers and administrators also use inventory, procurement, reporting, and business operations. The backend exposes API routes through Express controllers, with Sequelize models providing persistent state and services supporting workflows such as procurement, alerts, email, and PDFs. Major README capabilities are represented, but several subsystem links are omitted where their source wiring was not shown.
Main entry points: App.jsx Routes and entry · models/index.js Sequelize models · RR_purchaseOrderController.js Procurement services · server/index.js Express API
Components 24
Web application
- Routes and entry
client/src/App.jsx - Authentication state
client/src/context/AuthContext.jsx - Role dashboards
client/src/components/DashboardLayout.jsx - HTTP client
client/src/api/axios.js
Retail operations
- POS billing
client/src/components/billingSystem.jsx - Products and inventory
client/src/pages/Products.jsx - Customer returns
client/src/pages/returns - Customers and cheques
client/src/pages/CustomerChequeExchange.jsx
Business management
- Procurement workflows
client/src/pages/procurement - Supplier management
client/src/pages/suppliers - HR and payroll
client/src/pages - Projects
client/src/pages/Projects.jsx - Assets and expenses
client/src/pages - Reports and analytics
client/src/pages/ReportsPage.jsx
API and persistence
- Express API
server/index.js - API routes
server/routes - Domain controllers
server/controllers - Sequelize models
server/models/index.js
Workflow services
- Procurement services
server/controllers/RR_purchaseOrderController.js - Alerts and automation
server/services/alertService.js - Activity audit
server/services/auditService.js - Email notifications
server/services/emailService.js - PDF generation
server/services/pdfService.js
Other components
- Store staff
Connections 18
- Store staff → Routes and entry: uses
README.md - Routes and entry → Authentication state: reads auth state
client/src/App.jsx - Routes and entry → Role dashboards: routes into
client/src/App.jsx - Routes and entry → POS billing: routes to
client/src/App.jsx - Routes and entry → Customer returns: routes to
client/src/App.jsx - Routes and entry → Reports and analytics: routes to
client/src/App.jsx - HTTP client → Express API: sends requests
- Express API → API routes: mounts routes
server/index.js - API routes → Domain controllers: dispatches to
server/routes/productRoutes.js - API routes → Sequelize models: queries products
server/routes/productRoutes.js - Domain controllers → Sequelize models: reads and writes
server/controllers/chequeExchangeController.js - Procurement services → Sequelize models: uses models
server/controllers/RR_purchaseOrderController.js - Procurement services → Email notifications: sends notices
server/controllers/RR_purchaseOrderController.js - Procurement services → Activity audit: records activity
server/controllers/RR_purchaseOrderController.js - Email notifications → PDF generation: uses PDF service
server/services/emailService.js - Email notifications → Sequelize models: logs email
server/services/emailService.js - Alerts and automation → Sequelize models: uses models
- Express API → Alerts and automation: schedules expiry checks
server/index.js