How islamsaadi/task-multi-vendor works
This is a multi-vendor marketplace checkout: customers browse products, receive a server-calculated quote using the lowest eligible vendor offer and stacked discounts, reserve stock, then place an order split into vendor sub-orders. The order transaction records an outbox obligation; a scheduled relay dispatches notification jobs, which use a swappable notifier. The SPA presents catalogue, cart, review, and order status. Arrows cite README or indexed source evidence; unsampled features and integrations are included only where documented, with no inferred call links.
Main entry points: client.ts API client · router.tsx React storefront · PlaceOrder.php Order placement · CartQuoter.php Quote data loader
Components 29
Marketplace SPA
- React storefront
frontend/src/app/router.tsx - Product catalogue
frontend/src/features/products/ProductsPage.tsx - Cart state
frontend/src/features/cart/cart.store.ts - Checkout review
frontend/src/features/checkout/ReviewPage.tsx - Order status
frontend/src/features/orders/OrderPage.tsx - API client
frontend/src/api/client.ts
HTTP API
- Catalogue endpoint
backend/app/Http/Controllers/Api/ProductController.php - Quote endpoint
backend/app/Http/Controllers/Api/QuoteController.php - Reservation endpoint
backend/app/Http/Controllers/Api/ReservationController.php - Order endpoint
backend/app/Http/Controllers/Api/OrderController.php - Quote response
backend/app/Http/Resources/QuoteResource.php
Pricing and discounts
- Quote data loader
backend/app/Checkout/CartQuoter.php - Pricing engine
backend/app/Pricing/PricingEngine.php - Offer selector
backend/app/Pricing/OfferSelector.php - Discount engine
backend/app/Discounts/DiscountEngine.php - Discount rules
backend/app/Discounts/Rules - Money arithmetic
backend/app/Support/Money.php
Checkout and orders
- Stock reservation
backend/app/Actions/ReserveStock.php - Idempotency store
backend/app/Checkout/IdempotencyStore.php - Order placement
backend/app/Actions/PlaceOrder.php - Order records
backend/app/Models/Order.php - Reservation records
backend/app/Models/StockReservation.php
Vendor notifications
- Transactional outbox
backend/app/Models/OutboxMessage.php - Outbox relay
backend/app/Console/Commands/OutboxRelay.php - Notification job
backend/app/Jobs/NotifyVendorJob.php - Vendor notifier
backend/app/Notifiers/VendorNotifier.php - Log notifier
backend/app/Notifiers/LogVendorNotifier.php
Other components
- Customer
- Application log
Connections 32
- Customer → React storefront: uses
- React storefront → Product catalogue: navigates
- React storefront → Cart state: manages
- React storefront → Checkout review: navigates
- React storefront → Order status: views
- Product catalogue → API client: requests products
- Checkout review → API client: submits checkout
frontend/src/features/checkout/ReviewPage.tsx - Order status → API client: requests orders
- API client → Catalogue endpoint: HTTP requests
- API client → Quote endpoint: HTTP requests
- API client → Reservation endpoint: HTTP requests
- API client → Order endpoint: HTTP requests
- Quote endpoint → Quote data loader: quotes cart
backend/app/Http/Controllers/Api/QuoteController.php - Quote data loader → Pricing engine: calculates quote
- Pricing engine → Offer selector: selects offers
backend/app/Pricing/PricingEngine.php - Pricing engine → Discount engine: evaluates discounts
backend/app/Pricing/PricingEngine.php - Discount engine → Discount rules: applies rules
- Discount engine → Money arithmetic: allocates amounts
backend/app/Discounts/DiscountEngine.php - Quote endpoint → Quote response: serializes quote
backend/app/Http/Controllers/Api/QuoteController.php - Reservation endpoint → Stock reservation: holds stock
backend/app/Http/Controllers/Api/ReservationController.php - Stock reservation → Quote data loader: re-quotes cart
backend/app/Actions/ReserveStock.php - Stock reservation → Reservation records: writes holds
backend/app/Actions/ReserveStock.php - Order endpoint → Idempotency store: claims and caches
backend/app/Http/Controllers/Api/OrderController.php - Order endpoint → Order placement: places order
backend/app/Http/Controllers/Api/OrderController.php - Order placement → Quote data loader: re-quotes cart
backend/app/Actions/PlaceOrder.php - Order placement → Order records: writes order
backend/app/Actions/PlaceOrder.php - Order placement → Reservation records: checks holds
backend/app/Actions/PlaceOrder.php - Order placement → Transactional outbox: writes notification obligation
backend/app/Actions/PlaceOrder.php - Outbox relay → Notification job: dispatches
- Notification job → Vendor notifier: notifies vendor
- Vendor notifier → Log notifier: binds implementation
- Log notifier → Application log: writes notification