# islamsaadi/task-multi-vendor architecture

> Architecture diagram of the GitHub repository islamsaadi/task-multi-vendor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/islamsaadi/task-multi-vendor
- Repository: https://github.com/islamsaadi/task-multi-vendor
- Video tour (about a minute): https://gitdiagram.com/islamsaadi/task-multi-vendor/video

## Overview

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: [`frontend/src/api/client.ts`](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/api/client.ts) (API client), [`frontend/src/app/router.tsx`](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/app/router.tsx) (React storefront), [`backend/app/Actions/PlaceOrder.php`](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Actions/PlaceOrder.php) (Order placement), [`backend/app/Checkout/CartQuoter.php`](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Checkout/CartQuoter.php) (Quote data loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Marketplace SPA"]
  node_spa["React storefront<br/>[router.tsx]"]
  node_catalogue["Product catalogue<br/>[ProductsPage.tsx]"]
  node_cart["Cart state<br/>[cart.store.ts]"]
  node_review["Checkout review<br/>[ReviewPage.tsx]"]
  node_orders_ui["Order status<br/>[OrderPage.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
end

subgraph group_api["HTTP API"]
  node_catalog_api["Catalogue endpoint"]
  node_quote_api["Quote endpoint"]
  node_reservation_api["Reservation endpoint"]
  node_order_api["Order endpoint"]
  node_quote_resource["Quote response<br/>[QuoteResource.php]"]
end

subgraph group_pricing["Pricing and discounts"]
  node_pricing_loader["Quote data loader<br/>[CartQuoter.php]"]
  node_pricing_engine["Pricing engine<br/>[PricingEngine.php]"]
  node_offer_selector["Offer selector<br/>[OfferSelector.php]"]
  node_discount_engine["Discount engine<br/>[DiscountEngine.php]"]
  node_discount_rules["Discount rules"]
  node_money["Money arithmetic<br/>[Money.php]"]
end

subgraph group_checkout["Checkout and orders"]
  node_reserve["Stock reservation<br/>[ReserveStock.php]"]
  node_idempotency["Idempotency store"]
  node_place_order["Order placement<br/>[PlaceOrder.php]"]
  node_order_store[("Order records<br/>[Order.php]")]
  node_reservation_store[("Reservation records")]
end

subgraph group_notify["Vendor notifications"]
  node_outbox[("Transactional outbox<br/>[OutboxMessage.php]")]
  node_relay["Outbox relay<br/>[OutboxRelay.php]"]
  node_notify_job["Notification job"]
  node_notifier["Vendor notifier<br/>[VendorNotifier.php]"]
  node_log_notifier["Log notifier"]
end

node_customer(("Customer"))
node_log["Application log"]

node_customer -->|"uses"| node_spa
node_spa -.->|"navigates"| node_catalogue
node_spa -.->|"manages"| node_cart
node_spa -.->|"navigates"| node_review
node_spa -.->|"views"| node_orders_ui
node_catalogue -.->|"requests products"| node_api_client
node_review -->|"submits checkout"| node_api_client
node_orders_ui -.->|"requests orders"| node_api_client
node_api_client -.->|"HTTP requests"| node_catalog_api
node_api_client -.->|"HTTP requests"| node_quote_api
node_api_client -.->|"HTTP requests"| node_reservation_api
node_api_client -.->|"HTTP requests"| node_order_api
node_quote_api -->|"quotes cart"| node_pricing_loader
node_pricing_loader -.->|"calculates quote"| node_pricing_engine
node_pricing_engine -->|"selects offers"| node_offer_selector
node_pricing_engine -->|"evaluates discounts"| node_discount_engine
node_discount_engine -.->|"applies rules"| node_discount_rules
node_discount_engine -->|"allocates amounts"| node_money
node_quote_api -->|"serializes quote"| node_quote_resource
node_reservation_api -->|"holds stock"| node_reserve
node_reserve -->|"re-quotes cart"| node_pricing_loader
node_reserve -.->|"writes holds"| node_reservation_store
node_order_api -->|"claims and caches"| node_idempotency
node_order_api -->|"places order"| node_place_order
node_place_order -->|"re-quotes cart"| node_pricing_loader
node_place_order -.->|"writes order"| node_order_store
node_place_order -.->|"checks holds"| node_reservation_store
node_place_order -->|"writes notification obligation"| node_outbox
node_relay -->|"dispatches"| node_notify_job
node_notify_job -.->|"notifies vendor"| node_notifier
node_notifier -.->|"binds implementation"| node_log_notifier
node_log_notifier -->|"writes notification"| node_log

click node_spa "https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/app/router.tsx"
click node_catalogue "https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/products/ProductsPage.tsx"
click node_cart "https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/cart/cart.store.ts"
click node_review "https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/checkout/ReviewPage.tsx"
click node_orders_ui "https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/orders/OrderPage.tsx"
click node_api_client "https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/api/client.ts"
click node_catalog_api "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/ProductController.php"
click node_quote_api "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/QuoteController.php"
click node_reservation_api "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/ReservationController.php"
click node_order_api "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/OrderController.php"
click node_quote_resource "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Resources/QuoteResource.php"
click node_pricing_loader "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Checkout/CartQuoter.php"
click node_pricing_engine "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Pricing/PricingEngine.php"
click node_offer_selector "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Pricing/OfferSelector.php"
click node_discount_engine "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Discounts/DiscountEngine.php"
click node_discount_rules "https://github.com/islamsaadi/task-multi-vendor/tree/main/backend/app/Discounts/Rules"
click node_money "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Support/Money.php"
click node_reserve "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Actions/ReserveStock.php"
click node_idempotency "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Checkout/IdempotencyStore.php"
click node_place_order "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Actions/PlaceOrder.php"
click node_order_store "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Models/Order.php"
click node_reservation_store "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Models/StockReservation.php"
click node_outbox "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Models/OutboxMessage.php"
click node_relay "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Console/Commands/OutboxRelay.php"
click node_notify_job "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Jobs/NotifyVendorJob.php"
click node_notifier "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Notifiers/VendorNotifier.php"
click node_log_notifier "https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Notifiers/LogVendorNotifier.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_spa,node_catalogue,node_cart,node_review,node_orders_ui,node_api_client toneBlue
class node_catalog_api,node_quote_api,node_reservation_api,node_order_api,node_quote_resource toneAmber
class node_pricing_loader,node_pricing_engine,node_offer_selector,node_discount_engine,node_discount_rules,node_money toneMint
class node_reserve,node_idempotency,node_place_order,node_order_store,node_reservation_store toneRose
class node_outbox,node_relay,node_notify_job,node_notifier,node_log_notifier,node_customer,node_log toneIndigo
```

## Components

### Marketplace SPA

- [React storefront](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/app/router.tsx): `frontend/src/app/router.tsx`
- [Product catalogue](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/products/ProductsPage.tsx): `frontend/src/features/products/ProductsPage.tsx`
- [Cart state](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/cart/cart.store.ts): `frontend/src/features/cart/cart.store.ts`
- [Checkout review](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/checkout/ReviewPage.tsx): `frontend/src/features/checkout/ReviewPage.tsx`
- [Order status](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/features/orders/OrderPage.tsx): `frontend/src/features/orders/OrderPage.tsx`
- [API client](https://github.com/islamsaadi/task-multi-vendor/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### HTTP API

- [Catalogue endpoint](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/ProductController.php): `backend/app/Http/Controllers/Api/ProductController.php`
- [Quote endpoint](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/QuoteController.php): `backend/app/Http/Controllers/Api/QuoteController.php`
- [Reservation endpoint](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/ReservationController.php): `backend/app/Http/Controllers/Api/ReservationController.php`
- [Order endpoint](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Controllers/Api/OrderController.php): `backend/app/Http/Controllers/Api/OrderController.php`
- [Quote response](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Http/Resources/QuoteResource.php): `backend/app/Http/Resources/QuoteResource.php`

### Pricing and discounts

- [Quote data loader](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Checkout/CartQuoter.php): `backend/app/Checkout/CartQuoter.php`
- [Pricing engine](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Pricing/PricingEngine.php): `backend/app/Pricing/PricingEngine.php`
- [Offer selector](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Pricing/OfferSelector.php): `backend/app/Pricing/OfferSelector.php`
- [Discount engine](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Discounts/DiscountEngine.php): `backend/app/Discounts/DiscountEngine.php`
- [Discount rules](https://github.com/islamsaadi/task-multi-vendor/tree/main/backend/app/Discounts/Rules): `backend/app/Discounts/Rules`
- [Money arithmetic](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Support/Money.php): `backend/app/Support/Money.php`

### Checkout and orders

- [Stock reservation](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Actions/ReserveStock.php): `backend/app/Actions/ReserveStock.php`
- [Idempotency store](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Checkout/IdempotencyStore.php): `backend/app/Checkout/IdempotencyStore.php`
- [Order placement](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Actions/PlaceOrder.php): `backend/app/Actions/PlaceOrder.php`
- [Order records](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Models/Order.php): `backend/app/Models/Order.php`
- [Reservation records](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Models/StockReservation.php): `backend/app/Models/StockReservation.php`

### Vendor notifications

- [Transactional outbox](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Models/OutboxMessage.php): `backend/app/Models/OutboxMessage.php`
- [Outbox relay](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Console/Commands/OutboxRelay.php): `backend/app/Console/Commands/OutboxRelay.php`
- [Notification job](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Jobs/NotifyVendorJob.php): `backend/app/Jobs/NotifyVendorJob.php`
- [Vendor notifier](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Notifiers/VendorNotifier.php): `backend/app/Notifiers/VendorNotifier.php`
- [Log notifier](https://github.com/islamsaadi/task-multi-vendor/blob/main/backend/app/Notifiers/LogVendorNotifier.php): `backend/app/Notifiers/LogVendorNotifier.php`

### Other components

- **Customer**
- **Application log**

## Connections

- 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 (evidence: `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 (evidence: `backend/app/Http/Controllers/Api/QuoteController.php`)
- Quote data loader → Pricing engine: calculates quote
- Pricing engine → Offer selector: selects offers (evidence: `backend/app/Pricing/PricingEngine.php`)
- Pricing engine → Discount engine: evaluates discounts (evidence: `backend/app/Pricing/PricingEngine.php`)
- Discount engine → Discount rules: applies rules
- Discount engine → Money arithmetic: allocates amounts (evidence: `backend/app/Discounts/DiscountEngine.php`)
- Quote endpoint → Quote response: serializes quote (evidence: `backend/app/Http/Controllers/Api/QuoteController.php`)
- Reservation endpoint → Stock reservation: holds stock (evidence: `backend/app/Http/Controllers/Api/ReservationController.php`)
- Stock reservation → Quote data loader: re-quotes cart (evidence: `backend/app/Actions/ReserveStock.php`)
- Stock reservation → Reservation records: writes holds (evidence: `backend/app/Actions/ReserveStock.php`)
- Order endpoint → Idempotency store: claims and caches (evidence: `backend/app/Http/Controllers/Api/OrderController.php`)
- Order endpoint → Order placement: places order (evidence: `backend/app/Http/Controllers/Api/OrderController.php`)
- Order placement → Quote data loader: re-quotes cart (evidence: `backend/app/Actions/PlaceOrder.php`)
- Order placement → Order records: writes order (evidence: `backend/app/Actions/PlaceOrder.php`)
- Order placement → Reservation records: checks holds (evidence: `backend/app/Actions/PlaceOrder.php`)
- Order placement → Transactional outbox: writes notification obligation (evidence: `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
