How mannyivfouy/pos_api_express works
Precision POS Backend is an Express/Mongoose REST API for point-of-sale and inventory operations. A client request enters the app, is routed to domain handlers, and—where shown—flows through controllers to services and persisted models. Sales cover pending/complete/cancelled payments, stock updates, and reporting; purchasing and the other management domains are documented capabilities, though several implementations were not excerpted. The graph preserves those domains without guessing their internal call chains; dashed links mark documented but unverified integrations.
Main entry points: routes API routes · sale.service.ts Sale processing · product.service.ts Product service · auth.middleware.ts JWT authentication
Components 25
API and access
- Express app
src/app.ts - API routes
src/routes
Identity and access
- User controller
src/controllers/user.controller.ts - User service
src/services/user.service.ts - User records
src/models/User.ts - JWT authentication
src/middlewares/auth.middleware.ts - Permission lookup
src/services/permission.service.ts - Role permissions
src/models/Role-Permission.ts - Permission records
src/models/Permission.ts
Catalog and inventory
- Product controller
src/controllers/product.controller.ts - Product service
src/services/product.service.ts - Product records
src/models/Product.ts - Category service
src/services/category.service.ts - Category records
src/models/Category.ts - Supplier management
src/services/supplier.service.ts
Sales and purchasing
- Purchase management
src/services/purchase.service.ts - Purchase records
src/models/Purchase.ts - Sales controller
src/controllers/sale.controller.ts - Sale processing
src/services/sale.service.ts - Sale records
src/models/Sale.ts - Sale items
src/models/SaleItem.ts
Payments and messaging
- Payment processing
src/services/payment.service.ts - Bakong KHQR
src/services/bakong.service.ts - Telegram notifications
src/services/telegram.service.ts
Other components
- API client
Connections 27
- API client → Express app: sends request
- Express app → API routes: mounts routes
src/app.ts - API routes → User controller: dispatches
src/routes/user.route.ts - API routes → JWT authentication: authenticates
src/routes/user.route.ts - API routes → User service: calls profile update
src/routes/user.route.ts - User controller → User service: calls
src/controllers/user.controller.ts - User service → User records: reads and writes
src/services/user.service.ts - JWT authentication → User records: loads user
src/middlewares/auth.middleware.ts - JWT authentication → Permission lookup: loads permissions
src/middlewares/auth.middleware.ts - Permission lookup → Role permissions: reads mappings
src/services/permission.service.ts - Permission lookup → Permission records: reads permissions
src/services/permission.service.ts - API routes → Product controller: dispatches
src/routes/product.route.ts - Product controller → Product service: calls
src/controllers/product.controller.ts - Product service → Product records: reads and writes
src/services/product.service.ts - Product service → Category records: checks category
src/services/product.service.ts - Product service → Supplier management: checks supplier
src/services/product.service.ts - Category service → Category records: reads and writes
src/services/category.service.ts - API routes → Sales controller: dispatches
- Sales controller → Sale processing: calls
src/controllers/sale.controller.ts - Sale processing → Sale records: reads and writes
src/services/sale.service.ts - Sale processing → Sale items: reads and writes
src/services/sale.service.ts - Sale processing → Product records: checks and reduces stock
src/services/sale.service.ts - Sale processing → Payment processing: requests and verifies payment
src/services/sale.service.ts - Sale processing → Telegram notifications: sends notification
src/services/sale.service.ts - Purchase management → Purchase records: reads and writes
src/services/purchase.service.ts - Purchase management → Product records: updates inventory
src/services/purchase.service.ts - Payment processing → Bakong KHQR: uses KHQR