# kirolloushany03/minicommerce architecture

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

- Interactive diagram: https://gitdiagram.com/kirolloushany03/minicommerce
- Repository: https://github.com/kirolloushany03/minicommerce

## Overview

MiniCommerce is a three-service e-commerce application. Users and products are created through their APIs; an order request is handled by Order Service, which fetches current product and user data, checks affordability, stores a pending order, and publishes an order event. User and Product services consume that event to deduct wallet funds and inventory. README documents these saga capabilities; consumer implementation details beyond the indexed references were not sampled.

Main entry points: [`MiniCommerce.OrderService/Services/Foundations/OrderService.cs`](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Services/Foundations/OrderService.cs) (Order Workflow), [`MiniCommerce.ProductService/Services/Foundations/ProductService.cs`](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Services/Foundations/ProductService.cs) (Product Management), [`MiniCommerce.UserService/Services/Foundations/UserService.cs`](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Services/Foundations/UserService.cs) (Wallet Management), [`MiniCommerce.Shared/Brokers/Events/KafkaEventPublisher.cs`](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.Shared/Brokers/Events/KafkaEventPublisher.cs) (Kafka Publisher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_order["Order Service"]
  node_order_api["Order API"]
  node_orders["Order Workflow<br/>[OrderService.cs]"]
  node_order_store[("Order Storage")]
  node_order_model["Order State<br/>[Order.cs]"]
end

subgraph group_product["Product Service"]
  node_product_api["Product API"]
  node_products["Product Management<br/>[ProductService.cs]"]
  node_product_store[("Product Storage")]
  node_product_model["Inventory &amp; Price<br/>[Product.cs]"]
  node_product_consumer["Stock Consumer"]
end

subgraph group_user["User Service"]
  node_user_api["User API"]
  node_users["Wallet Management<br/>[UserService.cs]"]
  node_user_store[("User Storage")]
  node_user_model["User &amp; Balance<br/>[User.cs]"]
  node_user_consumer["Balance Consumer"]
end

subgraph group_messaging["Shared Events"]
  node_publisher["Kafka Publisher"]
  node_event_contract["Order Event<br/>[OrderEvents.cs]"]
end

node_shopper(("API Client"))
node_kafka["Kafka"]

node_shopper -->|"submits order"| node_order_api
node_shopper -->|"manages products"| node_product_api
node_shopper -->|"manages users"| node_user_api
node_order_api -->|"invokes"| node_orders
node_product_api -->|"invokes"| node_products
node_user_api -->|"invokes"| node_users
node_orders -->|"fetches price"| node_products
node_orders -->|"checks balance"| node_users
node_orders -->|"stores order"| node_order_store
node_orders -->|"publishes event"| node_publisher
node_orders -->|"sets pending state"| node_order_model
node_products -->|"reads and writes"| node_product_store
node_users -->|"reads and writes"| node_user_store
node_product_consumer -->|"updates stock"| node_products
node_user_consumer -->|"deducts balance"| node_users
node_publisher -->|"publishes type"| node_event_contract
node_publisher -->|"sends event"| node_kafka
node_kafka -->|"delivers order event"| node_product_consumer
node_kafka -->|"delivers order event"| node_user_consumer
node_order_store -->|"persists"| node_order_model
node_product_store -->|"persists"| node_product_model
node_user_store -->|"persists"| node_user_model

click node_order_api "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Controllers/ControllersExtensions.OrderController.Helper.cs"
click node_orders "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Services/Foundations/OrderService.cs"
click node_order_store "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Brokers/Storages/StorageBroker.Order.cs"
click node_order_model "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Models/Order.cs"
click node_product_api "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Controllers/ControllersExtensions.ProductController.Helper.cs"
click node_products "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Services/Foundations/ProductService.cs"
click node_product_store "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Brokers/Storages/StorageBroker.Product.cs"
click node_product_model "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Models/Product.cs"
click node_product_consumer "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Services/Hosted/OrderEventConsumer.cs"
click node_user_api "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Controllers/ControllersExtensions.UserController.Helper.cs"
click node_users "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Services/Foundations/UserService.cs"
click node_user_store "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Brokers/Storages/StorageBroker.User.cs"
click node_user_model "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Models/User.cs"
click node_user_consumer "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Services/Hosted/OrderEventConsumer.cs"
click node_publisher "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.Shared/Brokers/Events/KafkaEventPublisher.cs"
click node_event_contract "https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.Shared/Events/OrderEvents.cs"

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_order_api,node_orders,node_order_store,node_order_model,node_shopper toneBlue
class node_product_api,node_products,node_product_store,node_product_model,node_product_consumer toneAmber
class node_user_api,node_users,node_user_store,node_user_model,node_user_consumer toneMint
class node_publisher,node_event_contract toneRose
class node_kafka toneIndigo
```

## Components

### Order Service

- [Order API](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Controllers/ControllersExtensions.OrderController.Helper.cs): `MiniCommerce.OrderService/Controllers/ControllersExtensions.OrderController.Helper.cs`
- [Order Workflow](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Services/Foundations/OrderService.cs): `MiniCommerce.OrderService/Services/Foundations/OrderService.cs`
- [Order Storage](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Brokers/Storages/StorageBroker.Order.cs): `MiniCommerce.OrderService/Brokers/Storages/StorageBroker.Order.cs`
- [Order State](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.OrderService/Models/Order.cs): `MiniCommerce.OrderService/Models/Order.cs`

### Product Service

- [Product API](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Controllers/ControllersExtensions.ProductController.Helper.cs): `MiniCommerce.ProductService/Controllers/ControllersExtensions.ProductController.Helper.cs`
- [Product Management](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Services/Foundations/ProductService.cs): `MiniCommerce.ProductService/Services/Foundations/ProductService.cs`
- [Product Storage](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Brokers/Storages/StorageBroker.Product.cs): `MiniCommerce.ProductService/Brokers/Storages/StorageBroker.Product.cs`
- [Inventory & Price](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Models/Product.cs): `MiniCommerce.ProductService/Models/Product.cs`
- [Stock Consumer](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.ProductService/Services/Hosted/OrderEventConsumer.cs): `MiniCommerce.ProductService/Services/Hosted/OrderEventConsumer.cs`

### User Service

- [User API](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Controllers/ControllersExtensions.UserController.Helper.cs): `MiniCommerce.UserService/Controllers/ControllersExtensions.UserController.Helper.cs`
- [Wallet Management](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Services/Foundations/UserService.cs): `MiniCommerce.UserService/Services/Foundations/UserService.cs`
- [User Storage](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Brokers/Storages/StorageBroker.User.cs): `MiniCommerce.UserService/Brokers/Storages/StorageBroker.User.cs`
- [User & Balance](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Models/User.cs): `MiniCommerce.UserService/Models/User.cs`
- [Balance Consumer](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.UserService/Services/Hosted/OrderEventConsumer.cs): `MiniCommerce.UserService/Services/Hosted/OrderEventConsumer.cs`

### Shared Events

- [Kafka Publisher](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.Shared/Brokers/Events/KafkaEventPublisher.cs): `MiniCommerce.Shared/Brokers/Events/KafkaEventPublisher.cs`
- [Order Event](https://github.com/kirolloushany03/minicommerce/blob/master/MiniCommerce.Shared/Events/OrderEvents.cs): `MiniCommerce.Shared/Events/OrderEvents.cs`

### Other components

- **API Client**
- **Kafka**

## Connections

- API Client → Order API: submits order
- API Client → Product API: manages products
- API Client → User API: manages users
- Order API → Order Workflow: invokes (evidence: `MiniCommerce.OrderService/Controllers/ControllersExtensions.OrderController.Helper.cs`)
- Product API → Product Management: invokes (evidence: `MiniCommerce.ProductService/Controllers/ControllersExtensions.ProductController.Helper.cs`)
- User API → Wallet Management: invokes (evidence: `MiniCommerce.UserService/Controllers/ControllersExtensions.UserController.Helper.cs`)
- Order Workflow → Product Management: fetches price (evidence: `MiniCommerce.OrderService/Services/Foundations/OrderService.cs`)
- Order Workflow → Wallet Management: checks balance (evidence: `MiniCommerce.OrderService/Services/Foundations/OrderService.cs`)
- Order Workflow → Order Storage: stores order (evidence: `MiniCommerce.OrderService/Services/Foundations/OrderService.cs`)
- Order Workflow → Kafka Publisher: publishes event (evidence: `MiniCommerce.OrderService/Services/Foundations/OrderService.cs`)
- Order Workflow → Order State: sets pending state (evidence: `MiniCommerce.OrderService/Services/Foundations/OrderService.cs`)
- Product Management → Product Storage: reads and writes (evidence: `MiniCommerce.ProductService/Services/Foundations/ProductService.cs`)
- Wallet Management → User Storage: reads and writes (evidence: `MiniCommerce.UserService/Services/Foundations/UserService.cs`)
- Stock Consumer → Product Management: updates stock (evidence: `MiniCommerce.ProductService/Services/Hosted/OrderEventConsumer.cs`)
- Balance Consumer → Wallet Management: deducts balance (evidence: `MiniCommerce.UserService/Services/Hosted/OrderEventConsumer.cs`)
- Kafka Publisher → Order Event: publishes type
- Kafka Publisher → Kafka: sends event
- Kafka → Stock Consumer: delivers order event
- Kafka → Balance Consumer: delivers order event
- Order Storage → Order State: persists (evidence: `MiniCommerce.OrderService/Brokers/Storages/StorageBroker.Order.cs`)
- Product Storage → Inventory & Price: persists (evidence: `MiniCommerce.ProductService/Brokers/Storages/StorageBroker.Product.cs`)
- User Storage → User & Balance: persists (evidence: `MiniCommerce.UserService/Brokers/Storages/StorageBroker.User.cs`)
