How john-michaelg135/api-pos works
This is a multi-location POS and commerce backend: staff and customer-facing APIs support catalog and stock operations, order entry and fulfillment, payments, refunds, reporting, and integrations with CRMS and SCMS. A typical order moves from an API request through order-entry logic, inventory and payment handling, and persistence; order management handles later approval and status changes. That workflow is visible in the source index, but most controller and service implementations were not excerpted, so uncertain links are shown as dashed.
Main entry points: InventoryService.cs Stock operations · PosDbContext.cs POS database · OrderEntryService.cs Order entry · OrderManagementService.cs Order fulfillment
Components 23
API and access
- Order entry API
Api/Controllers/OrderEntryController.cs - Order management API
Api/Controllers/OrderManagementController.cs - Product catalog API
Api/Controllers/ProductCatalogController.cs - Inventory API
Api/Controllers/InventoryController.cs - User context
Api/Middlewares/CurrentUserContext.cs
Commerce operations
- Order entry
Applications/Services/OrderEntryService.cs - Order fulfillment
Applications/Services/OrderManagementService.cs - Payment gateway
Applications/Services/XenditService.cs - Refund handling
Applications/Services/RefundService.cs - Product catalog
Applications/Services/ProductCatalogService.cs
Inventory and supply
- Stock operations
Applications/Services/InventoryService.cs - SCMS integration
Infrastructures/Externals/ScmsApiClient.cs - Transfer receiving
Applications/Services/TransferReceivingService.cs
Customer and reporting
- Sales analytics
Applications/Services/AnalyticsService.cs - Owner dashboard
Applications/Services/DashboardService.cs - CRMS query API
Api/Controllers/CrmsQueryController.cs - Customer order queries
Applications/Services/CrmsQueryService.cs
Domain and persistence
- POS database
Infrastructures/Persistence/PosDbContext.cs - Order model
Domains/Entities/Order.cs - Product model
Domains/Entities/Product.cs - Stock model
Domains/Entities/Stock.cs
Other components
- POS staff
- Customer
Connections 22
- POS staff → Order entry API: submits orders
- POS staff → Order management API: manages orders
- Customer → CRMS query API: queries orders
- Order entry API → Order entry: dispatches to
- Order management API → Order fulfillment: dispatches to
Api/Controllers/OrderManagementController.cs - Product catalog API → Product catalog: dispatches to
- Inventory API → Stock operations: dispatches to
- CRMS query API → Customer order queries: dispatches to
Api/Controllers/CrmsQueryController.cs - Customer order queries → POS database: queries
Applications/Services/CrmsQueryService.cs - Order entry → POS database: reads and writes
Applications/Services/OrderEntryService.cs - Order entry → Stock operations: uses stock service
Applications/Services/OrderEntryService.cs - Order entry → Payment gateway: uses gateway
Applications/Services/OrderEntryService.cs - Order fulfillment → POS database: reads and writes
Applications/Services/OrderManagementService.cs - Order fulfillment → Stock operations: uses stock service
Applications/Services/OrderManagementService.cs - Stock operations → POS database: reads and writes
Applications/Services/InventoryService.cs - Stock operations → SCMS integration: calls client
Applications/Services/InventoryService.cs - Stock operations → Stock model: updates stock
Applications/Services/InventoryService.cs - Transfer receiving → Stock operations: receives stock
- Order entry → Order model: creates orders
Applications/Services/OrderEntryService.cs - POS database → Order model: maps entity
Infrastructures/Persistence/PosDbContext.cs - POS database → Product model: maps entity
Infrastructures/Persistence/PosDbContext.cs - User context → POS database: resolves locations
Api/Middlewares/CurrentUserContext.cs