# thanhthuan173/ordersystem architecture

> Architecture diagram of the GitHub repository thanhthuan173/ordersystem, 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/thanhthuan173/ordersystem
- Repository: https://github.com/thanhthuan173/ordersystem

## Overview

This repository implements an order-processing application with a client and separate Orders, Inventory, and Payments services. The main domain workflow is order creation, stock reservation, payment processing, and order status updates via events; the services also expose queries and inventory adjustment. Shared event contracts and Pulsar messaging support cross-service coordination. Several consumer, publisher, and client integration details are unsampled, so those links are shown only as unverified where useful.

Main entry points: [`src/Messaging`](https://github.com/thanhthuan173/ordersystem/tree/main/src/Messaging) (Pulsar messaging), [`src/Orders/Services/OrderService.cs`](https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Services/OrderService.cs) (Order workflow), [`src/Inventory/Services/InventoryService.cs`](https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Services/InventoryService.cs) (Stock and reservations), [`src/Payments/Services/PaymentService.cs`](https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Services/PaymentService.cs) (Payment processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_client_ui["Order UI"]
  node_dashboard["Dashboard<br/>[Dashboard.razor.cs]"]
  node_orders_api["Orders API client<br/>[OrdersApiClient.cs]"]
  node_inventory_api["Inventory API client"]
end

subgraph group_orders["Order Service"]
  node_orders_controller["Orders endpoints"]
  node_order_service["Order workflow<br/>[OrderService.cs]"]
  node_orders_db[("Order state store<br/>[OrdersDbContext.cs]")]
  node_orders_consumers["Order event consumers"]
end

subgraph group_inventory["Inventory Service"]
  node_inventory_controller["Inventory endpoints"]
  node_inventory_service["Stock and reservations"]
  node_inventory_db[("Inventory state store")]
  node_inventory_consumers["Inventory event consumers"]
end

subgraph group_payments["Payments Service"]
  node_payment_controller["Payment endpoints"]
  node_payment_service["Payment processing<br/>[PaymentService.cs]"]
  node_payments_db[("Payment state store")]
  node_payment_consumers["Payment event consumer"]
end

subgraph group_messaging["Events and Messaging"]
  node_event_contracts["Domain event contracts"]
  node_pulsar["Pulsar messaging"]
end

node_shopper(("Shopper"))
node_broker(("Pulsar broker"))

node_shopper -.->|"places order"| node_client_ui
node_client_ui -.->|"submits order"| node_orders_api
node_dashboard -.->|"loads order data"| node_orders_api
node_dashboard -.->|"loads stock data"| node_inventory_api
node_orders_api -.->|"calls API"| node_orders_controller
node_inventory_api -.->|"calls API"| node_inventory_controller
node_orders_controller -->|"delegates"| node_order_service
node_order_service -->|"reads and writes"| node_orders_db
node_order_service -->|"creates and handles"| node_event_contracts
node_orders_consumers -->|"delegates events"| node_order_service
node_inventory_controller -->|"delegates"| node_inventory_service
node_inventory_service -->|"reads and writes"| node_inventory_db
node_inventory_service -->|"handles and creates"| node_event_contracts
node_inventory_consumers -->|"delegates events"| node_inventory_service
node_payment_controller -->|"delegates"| node_payment_service
node_payment_service -->|"reads and writes"| node_payments_db
node_payment_service -->|"handles and creates"| node_event_contracts
node_payment_consumers -.->|"delegates events"| node_payment_service
node_orders_consumers -.->|"receives events"| node_pulsar
node_inventory_consumers -.->|"receives events"| node_pulsar
node_payment_consumers -.->|"receives events"| node_pulsar
node_pulsar -.->|"exchanges messages"| node_broker
node_pulsar -.->|"dispatches events"| node_orders_consumers
node_pulsar -.->|"dispatches events"| node_inventory_consumers
node_pulsar -.->|"dispatches events"| node_payment_consumers

click node_client_ui "https://github.com/thanhthuan173/ordersystem/blob/main/client/Pages/PlaceOrder.razor.cs"
click node_dashboard "https://github.com/thanhthuan173/ordersystem/blob/main/client/Pages/Dashboard.razor.cs"
click node_orders_api "https://github.com/thanhthuan173/ordersystem/blob/main/client/Services/OrdersApiClient.cs"
click node_inventory_api "https://github.com/thanhthuan173/ordersystem/blob/main/client/Services/InventoryApiClient.cs"
click node_orders_controller "https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Controllers/OrdersController.cs"
click node_order_service "https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Services/OrderService.cs"
click node_orders_db "https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Data/OrdersDbContext.cs"
click node_orders_consumers "https://github.com/thanhthuan173/ordersystem/tree/main/src/Orders/Messaging"
click node_inventory_controller "https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Controllers/InventoryController.cs"
click node_inventory_service "https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Services/InventoryService.cs"
click node_inventory_db "https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Data/InventoryDbContext.cs"
click node_inventory_consumers "https://github.com/thanhthuan173/ordersystem/tree/main/src/Inventory/Messaging"
click node_payment_controller "https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Controllers/PaymentsController.cs"
click node_payment_service "https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Services/PaymentService.cs"
click node_payments_db "https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Data/PaymentsDbContext.cs"
click node_payment_consumers "https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Messaging/ReservationSucceededConsumer.cs"
click node_event_contracts "https://github.com/thanhthuan173/ordersystem/tree/main/src/Contracts/Events"
click node_pulsar "https://github.com/thanhthuan173/ordersystem/tree/main/src/Messaging"

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_client_ui,node_dashboard,node_orders_api,node_inventory_api toneBlue
class node_orders_controller,node_order_service,node_orders_db,node_orders_consumers toneAmber
class node_inventory_controller,node_inventory_service,node_inventory_db,node_inventory_consumers toneMint
class node_payment_controller,node_payment_service,node_payments_db,node_payment_consumers toneRose
class node_event_contracts,node_pulsar,node_shopper,node_broker toneIndigo
```

## Components

### Client

- [Order UI](https://github.com/thanhthuan173/ordersystem/blob/main/client/Pages/PlaceOrder.razor.cs): `client/Pages/PlaceOrder.razor.cs`
- [Dashboard](https://github.com/thanhthuan173/ordersystem/blob/main/client/Pages/Dashboard.razor.cs): `client/Pages/Dashboard.razor.cs`
- [Orders API client](https://github.com/thanhthuan173/ordersystem/blob/main/client/Services/OrdersApiClient.cs): `client/Services/OrdersApiClient.cs`
- [Inventory API client](https://github.com/thanhthuan173/ordersystem/blob/main/client/Services/InventoryApiClient.cs): `client/Services/InventoryApiClient.cs`

### Order Service

- [Orders endpoints](https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Controllers/OrdersController.cs): `src/Orders/Controllers/OrdersController.cs`
- [Order workflow](https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Services/OrderService.cs): `src/Orders/Services/OrderService.cs`
- [Order state store](https://github.com/thanhthuan173/ordersystem/blob/main/src/Orders/Data/OrdersDbContext.cs): `src/Orders/Data/OrdersDbContext.cs`
- [Order event consumers](https://github.com/thanhthuan173/ordersystem/tree/main/src/Orders/Messaging): `src/Orders/Messaging`

### Inventory Service

- [Inventory endpoints](https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Controllers/InventoryController.cs): `src/Inventory/Controllers/InventoryController.cs`
- [Stock and reservations](https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Services/InventoryService.cs): `src/Inventory/Services/InventoryService.cs`
- [Inventory state store](https://github.com/thanhthuan173/ordersystem/blob/main/src/Inventory/Data/InventoryDbContext.cs): `src/Inventory/Data/InventoryDbContext.cs`
- [Inventory event consumers](https://github.com/thanhthuan173/ordersystem/tree/main/src/Inventory/Messaging): `src/Inventory/Messaging`

### Payments Service

- [Payment endpoints](https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Controllers/PaymentsController.cs): `src/Payments/Controllers/PaymentsController.cs`
- [Payment processing](https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Services/PaymentService.cs): `src/Payments/Services/PaymentService.cs`
- [Payment state store](https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Data/PaymentsDbContext.cs): `src/Payments/Data/PaymentsDbContext.cs`
- [Payment event consumer](https://github.com/thanhthuan173/ordersystem/blob/main/src/Payments/Messaging/ReservationSucceededConsumer.cs): `src/Payments/Messaging/ReservationSucceededConsumer.cs`

### Events and Messaging

- [Domain event contracts](https://github.com/thanhthuan173/ordersystem/tree/main/src/Contracts/Events): `src/Contracts/Events`
- [Pulsar messaging](https://github.com/thanhthuan173/ordersystem/tree/main/src/Messaging): `src/Messaging`

### Other components

- **Shopper**
- **Pulsar broker**

## Connections

- Shopper → Order UI: places order
- Order UI → Orders API client: submits order
- Dashboard → Orders API client: loads order data
- Dashboard → Inventory API client: loads stock data
- Orders API client → Orders endpoints: calls API
- Inventory API client → Inventory endpoints: calls API
- Orders endpoints → Order workflow: delegates (evidence: `src/Orders/Controllers/OrdersController.cs`)
- Order workflow → Order state store: reads and writes (evidence: `src/Orders/Services/OrderService.cs`)
- Order workflow → Domain event contracts: creates and handles (evidence: `src/Orders/Services/OrderService.cs`)
- Order event consumers → Order workflow: delegates events (evidence: `src/Orders/Messaging/ReservationFailedConsumer.cs`)
- Inventory endpoints → Stock and reservations: delegates (evidence: `src/Inventory/Controllers/InventoryController.cs`)
- Stock and reservations → Inventory state store: reads and writes (evidence: `src/Inventory/Services/InventoryService.cs`)
- Stock and reservations → Domain event contracts: handles and creates (evidence: `src/Inventory/Services/InventoryService.cs`)
- Inventory event consumers → Stock and reservations: delegates events (evidence: `src/Inventory/Messaging/OrderPlacedConsumer.cs`)
- Payment endpoints → Payment processing: delegates (evidence: `src/Payments/Controllers/PaymentsController.cs`)
- Payment processing → Payment state store: reads and writes (evidence: `src/Payments/Services/PaymentService.cs`)
- Payment processing → Domain event contracts: handles and creates (evidence: `src/Payments/Services/PaymentService.cs`)
- Payment event consumer → Payment processing: delegates events
- Order event consumers → Pulsar messaging: receives events
- Inventory event consumers → Pulsar messaging: receives events
- Payment event consumer → Pulsar messaging: receives events
- Pulsar messaging → Pulsar broker: exchanges messages
- Pulsar messaging → Order event consumers: dispatches events
- Pulsar messaging → Inventory event consumers: dispatches events
- Pulsar messaging → Payment event consumer: dispatches events
