How fuadvk824/bk_pos works
This is a multi-store point-of-sale and inventory application, with a Laravel backend and React/Inertia web interface plus API endpoints. The main workflow is cashiering: users browse store-specific products, assemble a sale with customer and payment details, and the server records transaction items, adjusts stock, and updates customer points. Separate transaction screens support history, reporting, and backorder stock mutations. The tree also shows product, customer, store, user, location, and account-security features. Source excerpts are partial and the README is empty, so some subsystem wiring is intentionally omitted.
Main entry points: web.php Web routes · api.php API routes · Web/CashierController.php Web cashier · Api/CashierController.php API cashier
Components 26
Web POS
- Web routes
routes/web.php - Cashier screen
resources/js/pages/cashier/index.tsx - Product screens
resources/js/pages/product/index.tsx - Transaction screens
resources/js/pages/transaction/index.tsx - Reports
resources/js/pages/report/index.tsx - Web cashier
app/Http/Controllers/Web/CashierController.php - Web products
app/Http/Controllers/Web/ProductController.php - Web transactions
app/Http/Controllers/Web/TransactionController.php
API
- API routes
routes/api.php - API cashier
app/Http/Controllers/Api/CashierController.php - API products
app/Http/Controllers/Api/ProductController.php - API auth
app/Http/Controllers/Api/AuthController.php - API customers
app/Http/Controllers/Api/CustomerController.php - API transactions
app/Http/Controllers/Api/TransactionController.php - API administration
app/Http/Controllers/Api/UserController.php
Sales and inventory
- Product catalog
app/Models/Product.php - Store stock and pricing
app/Models/ProductStore.php - Sales and payments
app/Models/Transaction.php - Customer and points
app/Models/Customer.php - Stock mutation history
app/Models/StockMutationHistory.php
Accounts
- Account settings
resources/js/pages/settings/profile.tsx - Profile and security
app/Http/Controllers/Settings/ProfileController.php - User and access
app/Models/User.php - BMP identity service
app/Services/BmpAuthService.php
Other components
- Cashier or manager
- BMP service
Connections 38
- Cashier or manager → Cashier screen: uses
- Cashier screen → Web routes: submits sale
- Web routes → Web cashier: dispatches
- Web cashier → Product catalog: reads products
- Web cashier → Store stock and pricing: checks and decrements
- Web cashier → Customer and points: finds and updates
- Web cashier → Sales and payments: records sale
- Cashier or manager → Product screens: browses
- Product screens → Web routes: requests products
- Web routes → Web products: dispatches
- Web products → Product catalog: reads catalog
- Web products → Store stock and pricing: reads store data
- Cashier or manager → Transaction screens: reviews sales
- Transaction screens → Web routes: requests transactions
- Web routes → Web transactions: dispatches
- Web transactions → Sales and payments: reads and deletes
- Web transactions → Store stock and pricing: transfers stock
- Web transactions → Stock mutation history: records mutations
- Cashier or manager → Reports: views reports
- Reports → Web routes: requests reports
- Web routes → API routes: routes API requests
- API routes → API cashier: dispatches
- API routes → API products: dispatches
- API routes → API auth: dispatches
- API routes → API customers: dispatches
- API routes → API transactions: dispatches
- API routes → API administration: dispatches
- API cashier → Product catalog: reads products
- API cashier → Store stock and pricing: checks stock
- API cashier → Customer and points: finds and updates
- API cashier → Sales and payments: records sale
- API products → Product catalog: queries products
- API products → Store stock and pricing: reads store stock
- Account settings → Web routes: requests settings
- Web routes → Profile and security: dispatches
- Profile and security → User and access: updates profile
- API auth → BMP identity service: verifies credentials
- BMP identity service → BMP service: sends request