How ecarlsson-r/commercesystem-api works
CommerceSystem-API is a Laravel commerce and ERP backend. Clients enter through API routes and use storefront discovery, cart/order flows, or clerk-facing sales and inventory operations; these feed branch-scoped stock and transaction records, with reporting and event-driven notifications/KPI tracking alongside the main workflow. AI assistance and recommendations are a separate capability. Several subsystems are represented from the README and file tree where source was not sampled; their internal call details are therefore not inferred.
Main entry points: api.php API routes · OrderController.php Order lifecycle · StockService.php Stock ledger service · Stock.php Branch stock and logs
Components 22
API and identity
- API routes
routes/api.php - Authentication and access
app/Http/Controllers/AuthController.php
Commerce workflows
- Product discovery
app/Http/Controllers/ProductController.php - Cart and wishlist
app/Http/Controllers/CartController.php - Order lifecycle
app/Http/Controllers/OrderController.php - POS sales
app/Http/Controllers/SaleController.php - Product catalog data
app/Models/Product.php - Orders and sales data
app/Models/Order.php - Visual previews
app/Http/Controllers/PreviewController.php
Inventory operations
- Purchasing and returns
app/Http/Controllers/PurchaseController.php - Branch transfers
app/Http/Controllers/StockTransferController.php - Stock ledger service
app/Services/StockService.php - Branch stock and logs
app/Models/Stock.php
AI and insights
- AI endpoints
app/Http/Controllers/AIController.php - AI orchestration
app/Services/LaravelAiKitService.php - Operational reports
app/Http/Controllers/ReportController.php
Events and notifications
- Domain events
app/Events/OrderCreated.php - Event registration
app/Providers/EventServiceProvider.php - Metrics and notifications
app/Listeners/RecordOrderConversion.php - Realtime and push delivery
app/Notifications/OrderNotification.php
Other components
- Store and POS clients
- Google AI services
Connections 31
- Store and POS clients → API routes: request
README.md - API routes → Authentication and access: routes to
routes/api.php - API routes → Product discovery: routes to
routes/api.php - API routes → Cart and wishlist: routes to
routes/api.php - API routes → Order lifecycle: routes to
routes/api.php - API routes → POS sales: routes to
routes/api.php - API routes → Purchasing and returns: routes to
routes/api.php - API routes → Branch transfers: routes to
routes/api.php - API routes → Operational reports: routes to
routes/api.php - API routes → AI endpoints: routes to
routes/api.php - API routes → Visual previews: routes to
routes/api.php - Product discovery → Product catalog data: queries
app/Http/Controllers/ProductController.php - Product discovery → Branch stock and logs: queries
app/Http/Controllers/ProductController.php - Order lifecycle → Orders and sales data: creates and updates
app/Http/Controllers/OrderController.php - Order lifecycle → Branch stock and logs: checks stock
app/Http/Controllers/OrderController.php - Order lifecycle → Stock ledger service: uses
app/Http/Controllers/OrderController.php - Order lifecycle → Domain events: dispatches
app/Http/Controllers/OrderController.php - POS sales → Stock ledger service: uses
app/Http/Controllers/SaleController.php - POS sales → Domain events: dispatches
app/Http/Controllers/SaleController.php - Stock ledger service → Branch stock and logs: updates
app/Services/StockService.php - Purchasing and returns → Stock ledger service: uses
- Branch transfers → Stock ledger service: uses
- AI endpoints → AI orchestration: delegates to
app/Http/Controllers/AIController.php - AI orchestration → Google AI services: calls models
README.md - AI orchestration → Product catalog data: queries recommendations
app/Services/LaravelAiKitService.php - AI orchestration → Branch stock and logs: uses inventory data
app/Services/LaravelAiKitService.php - Operational reports → Orders and sales data: aggregates sales
app/Http/Controllers/ReportController.php - Operational reports → Branch stock and logs: reads audit data
app/Http/Controllers/ReportController.php - Event registration → Domain events: registers listeners
app/Providers/EventServiceProvider.php - Event registration → Metrics and notifications: registers
app/Providers/EventServiceProvider.php - Metrics and notifications → Realtime and push delivery: sends notifications