How santhanakumar-p/store-order-inventory works
Store Order Inventory is a Laravel retail counter app. A cashier uses the counter or JSON APIs to find customers and products, submit an order, and view order history; the server validates inputs, calculates authoritative prices and tax, locks and decrements stock, stores line-item snapshots, and sends a confirmation. The README also documents low-stock reporting and API docs. The graph covers the sampled request and order path; links for unsampled counter, email-queue, and docs internals are limited to documented behavior.
Main entry points: OrderController.php Order endpoints · OrderService.php Order processing · api.php API routes · CustomerController.php Customer search
Components 21
User interfaces
- Counter page
resources/views/counter.blade.php - API routes
routes/api.php - API documentation
API handling
- Customer search
app/Http/Controllers/Api/CustomerController.php - Product listing
app/Http/Controllers/Api/ProductController.php - Order endpoints
app/Http/Controllers/Api/OrderController.php - Customer validation
app/Http/Requests/SearchCustomerRequest.php - Order validation
app/Http/Requests/StoreOrderRequest.php - History validation
app/Http/Requests/IndexOrdersRequest.php - Customer JSON
app/Http/Resources/CustomerResource.php - Product JSON
app/Http/Resources/ProductResource.php - Order JSON
app/Http/Resources/OrderResource.php - Line item JSON
app/Http/Resources/OrderItemResource.php
Retail domain
- Order processing
app/Services/OrderService.php
Order state
- Customer records
app/Models/Customer.php - Product inventory
app/Models/Product.php - Orders
app/Models/Order.php - Order items
app/Models/OrderItem.php
Notifications
- Confirmation mail
app/Mail/OrderConfirmation.php - Queued email
Other components
- Cashier
Connections 27
- Cashier → Counter page: uses
README.md - Cashier → API routes: requests
README.md - API routes → Customer search: routes
routes/api.php - API routes → Product listing: routes
routes/api.php - API routes → Order endpoints: routes
routes/api.php - Customer search → Customer validation: validates with
app/Http/Controllers/Api/CustomerController.php - Customer search → Customer records: queries
app/Http/Controllers/Api/CustomerController.php - Customer search → Customer JSON: serializes
app/Http/Controllers/Api/CustomerController.php - Product listing → Product inventory: queries
app/Http/Controllers/Api/ProductController.php - Product listing → Product JSON: serializes
app/Http/Controllers/Api/ProductController.php - Order endpoints → History validation: validates with
app/Http/Controllers/Api/OrderController.php - Order endpoints → Customer records: finds customer
app/Http/Controllers/Api/OrderController.php - Order endpoints → Orders: loads history
app/Http/Controllers/Api/OrderController.php - Order endpoints → Order validation: validates with
app/Http/Controllers/Api/OrderController.php - Order endpoints → Order processing: creates order
app/Http/Controllers/Api/OrderController.php - Order endpoints → Order JSON: serializes
app/Http/Controllers/Api/OrderController.php - Order JSON → Line item JSON: renders items
app/Http/Resources/OrderResource.php - Order processing → Customer records: finds or creates
app/Services/OrderService.php - Order processing → Product inventory: locks and decrements
app/Services/OrderService.php - Order processing → Orders: creates order
app/Services/OrderService.php - Order processing → Order items: creates snapshots
app/Services/OrderService.php - Order processing → Confirmation mail: sends
app/Services/OrderService.php - Orders → Customer records: belongs to
app/Models/Order.php - Orders → Order items: has items
app/Models/Order.php - Order items → Product inventory: references
app/Models/OrderItem.php - Confirmation mail → Queued email: queued per README
README.md - Cashier → API documentation: opens
README.md