How sakouksa/khposcommerce works
KHPosCommerce is an omnichannel retail platform combining an admin dashboard and web POS, a customer storefront, a Laravel API, and a documented Flutter mobile POS. The main workflow is staff or customers using a client to reach the API for commerce operations and receive results; the README documents that client/API relationship. Backend review excerpts show customer review submission and a separate admin review-management path, including the service/repository layer. Flutter implementation files and most commerce handlers were not sampled, so those relationships reflect README-documented capabilities rather than inspected calls.
Main entry points: BaseApiController.php Laravel API · src/App.tsx Admin dashboard · app/App.tsx Storefront · ProductReview.php Review records
Components 22
Commerce clients
- Admin dashboard
apps/adminkhposcommerce/src/App.tsx - Admin routes
apps/adminkhposcommerce/src/routes/AppRoutes.tsx - Access guard
apps/adminkhposcommerce/src/routes/guards/ProtectedRoute.tsx - Storefront
apps/storefrontkhposcommerce/src/app/App.tsx - Store routes
apps/storefrontkhposcommerce/src/app/router/routes.tsx - Mobile POS
appkhposcommerce
Retail operations
- Web POS
apps/adminkhposcommerce/src/pages/pos/POSPage.tsx - Product catalog
backendkhposcommerce/app/Models/Product/Product.php - Inventory operations
apps/adminkhposcommerce/src/pages/inventory/InventoryPage.tsx - Orders
backendkhposcommerce/app/Models/Order/Order.php - Customer records
backendkhposcommerce/app/Models/Customer/Customer.php - Promotions and CMS
apps/adminkhposcommerce/src/pages/marketing/PromotionsPage.tsx - Customer reviews
backendkhposcommerce/app/Http/Controllers/Api/V1/Customer/ReviewController.php - Review administration
backendkhposcommerce/app/Http/Controllers/Api/V1/Admin/Order/ReviewController.php
API and domain
- Review service
backendkhposcommerce/app/Services/Review/ProductReviewService.php - Review repository
backendkhposcommerce/app/Repositories/Review/ProductReviewRepository.php - Review records
backendkhposcommerce/app/Models/Review/ProductReview.php - Laravel API
backendkhposcommerce/app/Http/Controllers/Api/BaseApiController.php
Shared platform
- Authentication service
backendkhposcommerce/app/Services/Auth/AuthService.php - Commerce database
backendkhposcommerce/config/database.php
Other components
- Retail staff
- Online shoppers
Connections 23
- Retail staff → Admin dashboard: uses
- Admin dashboard → Admin routes: loads routes
apps/adminkhposcommerce/src/App.tsx - Admin routes → Access guard: protects routes
apps/adminkhposcommerce/src/routes/AppRoutes.tsx - Retail staff → Web POS: uses
- Online shoppers → Storefront: browses
- Storefront → Store routes: loads routes
- Retail staff → Mobile POS: uses
- Admin dashboard → Laravel API: requests commerce data
- Storefront → Laravel API: requests commerce data
- Mobile POS → Laravel API: uses API
- Laravel API → Product catalog: serves catalog
- Laravel API → Inventory operations: serves stock operations
- Laravel API → Orders: handles orders
- Laravel API → Customer records: handles customers
- Laravel API → Promotions and CMS: serves promotions
- Laravel API → Authentication service: authenticates requests
- Customer reviews → Review records: creates review
backendkhposcommerce/app/Http/Controllers/Api/V1/Customer/ReviewController.php - Review administration → Review records: manages reviews
backendkhposcommerce/app/Http/Controllers/Api/V1/Admin/Order/ReviewController.php - Review administration → Review service: delegates CRUD
- Review service → Review repository: delegates persistence
backendkhposcommerce/app/Services/Review/ProductReviewService.php - Review repository → Review records: queries model
backendkhposcommerce/app/Repositories/Review/ProductReviewRepository.php - Customer reviews → Laravel API: returns response
backendkhposcommerce/app/Http/Controllers/Api/V1/Customer/ReviewController.php - Laravel API → Commerce database: uses configured store