# hosseinjafaridev/sabzmarket architecture

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

- Interactive diagram: https://gitdiagram.com/hosseinjafaridev/sabzmarket
- Repository: https://github.com/hosseinjafaridev/sabzmarket

## Overview

SabzMarket is a Persian agricultural marketplace with seller and buyer desktop clients backed by an ASP.NET API. Its domain workflow includes account and seller/farmer profiles, product listings and categories, carts, checkout, order-detail fulfillment, and error logging. The API delegates to application services and repositories over an EF Core context; shared DTOs and view models carry data across layers. The README identifies the three-layer branch structure. Client-to-API and several unexcerpted feature links are not shown, so they are omitted or marked unverified.

Main entry points: [`SabzMarket.BLL/SellerService.cs`](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/SellerService.cs) (Seller service), [`SabzMarket.BLL/OrderService.cs`](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/OrderService.cs) (Checkout and orders), [`SabzMarket.DAL/SabzMarketDbContext.cs`](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/SabzMarketDbContext.cs) (EF data context), [`SabzMarket.BLL/FarmerService.cs`](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/FarmerService.cs) (Farmer service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Desktop clients"]
  node_seller_client["Seller desktop<br/>[Program.cs]"]
  node_buyer_client["Buyer desktop<br/>[Program.cs]"]
  node_seller_http["Seller HTTP helper"]
  node_buyer_http["Buyer HTTP helper"]
end

subgraph group_api["API presentation"]
  node_seller_api["Seller endpoints"]
  node_farmer_api["Farmer endpoints"]
  node_product_api["Product endpoints"]
  node_cart_api["Cart endpoints"]
  node_order_api["Order endpoints<br/>[OrderController.cs]"]
end

subgraph group_application["Application services"]
  node_seller_service["Seller service<br/>[SellerService.cs]"]
  node_farmer_service["Farmer service<br/>[FarmerService.cs]"]
  node_product_service["Product service<br/>[ProductService.cs]"]
  node_cart_service["Cart service<br/>[CartItemService.cs]"]
  node_order_service["Checkout and orders<br/>[OrderService.cs]"]
  node_photo_storage["Photo saving<br/>[SavePhoto.cs]"]
  node_error_service["Error logging service<br/>[ErrorService.cs]"]
end

subgraph group_data["Persistence"]
  node_seller_repo["Seller repository"]
  node_product_repo["Product repository"]
  node_order_repo["Order repository<br/>[OrderRepository.cs]"]
  node_database[("EF data context")]
  node_entity_model["Marketplace entities<br/>[Entities]"]
end

subgraph group_shared["Shared contracts"]
  node_route_catalog["API route catalog<br/>[ApiRoutes.cs]"]
  node_shared_models["DTOs and view models<br/>[Models]"]
  node_messages["Domain messages<br/>[Messages.cs]"]
end

node_seller_actor(("Seller"))
node_buyer_actor(("Buyer"))

node_seller_actor -.->|"uses"| node_seller_client
node_buyer_actor -.->|"uses"| node_buyer_client
node_seller_client -.->|"HTTP requests"| node_seller_http
node_buyer_client -.->|"HTTP requests"| node_buyer_http
node_seller_http -->|"uses routes"| node_route_catalog
node_buyer_http -->|"uses routes"| node_route_catalog
node_seller_api -->|"delegates"| node_seller_service
node_farmer_api -->|"delegates"| node_farmer_service
node_product_api -->|"delegates"| node_product_service
node_cart_api -->|"delegates"| node_cart_service
node_seller_service -->|"calls"| node_seller_repo
node_seller_service -->|"saves photos"| node_photo_storage
node_farmer_service -->|"saves photos"| node_photo_storage
node_farmer_service -->|"uses messages"| node_messages
node_product_service -->|"calls"| node_product_repo
node_product_service -->|"saves photos"| node_photo_storage
node_order_api -.->|"delegates"| node_order_service
node_order_service -->|"calls"| node_order_repo
node_order_repo -->|"queries and writes"| node_database
node_seller_repo -->|"queries and writes"| node_database
node_product_repo -->|"queries and writes"| node_database
node_database -->|"maps entities"| node_entity_model
node_order_service -->|"loads and clears cart"| node_cart_service
node_order_service -->|"logs failures"| node_error_service
node_seller_api -->|"accepts and returns"| node_shared_models
node_seller_service -->|"maps profile data"| node_shared_models

click node_seller_client "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket/Program.cs"
click node_buyer_client "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarketBuyer.UI/Program.cs"
click node_seller_http "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket/Http/HttpClientHelper.cs"
click node_buyer_http "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarketBuyer.UI/Http/HttpClientHelper.cs"
click node_route_catalog "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.Share/ApiRoutes.cs"
click node_seller_api "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/SellerController.cs"
click node_farmer_api "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/FarmerController.cs"
click node_product_api "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/ProductController.cs"
click node_cart_api "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/CartItemController.cs"
click node_order_api "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/OrderController.cs"
click node_seller_service "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/SellerService.cs"
click node_farmer_service "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/FarmerService.cs"
click node_product_service "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/ProductService.cs"
click node_cart_service "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/CartItemService.cs"
click node_order_service "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/OrderService.cs"
click node_photo_storage "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/SavePhoto.cs"
click node_seller_repo "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/SellerRepository.cs"
click node_product_repo "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/ProductRepository.cs"
click node_order_repo "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/OrderRepository.cs"
click node_database "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/SabzMarketDbContext.cs"
click node_entity_model "https://github.com/hosseinjafaridev/sabzmarket/tree/main/SabzMarket.DAL/Entities"
click node_shared_models "https://github.com/hosseinjafaridev/sabzmarket/tree/main/SabzMarket.Share/Models"
click node_messages "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.Share/Messages.cs"
click node_error_service "https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/ErrorService.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_seller_client,node_buyer_client,node_seller_http,node_buyer_http toneBlue
class node_seller_api,node_farmer_api,node_product_api,node_cart_api,node_order_api toneAmber
class node_seller_service,node_farmer_service,node_product_service,node_cart_service,node_order_service,node_photo_storage,node_error_service toneMint
class node_seller_repo,node_product_repo,node_order_repo,node_database,node_entity_model toneRose
class node_route_catalog,node_shared_models,node_messages,node_seller_actor,node_buyer_actor toneIndigo
```

## Components

### Desktop clients

- [Seller desktop](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket/Program.cs): `SabzMarket/Program.cs`
- [Buyer desktop](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarketBuyer.UI/Program.cs): `SabzMarketBuyer.UI/Program.cs`
- [Seller HTTP helper](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket/Http/HttpClientHelper.cs): `SabzMarket/Http/HttpClientHelper.cs`
- [Buyer HTTP helper](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarketBuyer.UI/Http/HttpClientHelper.cs): `SabzMarketBuyer.UI/Http/HttpClientHelper.cs`

### API presentation

- [Seller endpoints](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/SellerController.cs): `SabzMarket.API/Controllers/SellerController.cs`
- [Farmer endpoints](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/FarmerController.cs): `SabzMarket.API/Controllers/FarmerController.cs`
- [Product endpoints](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/ProductController.cs): `SabzMarket.API/Controllers/ProductController.cs`
- [Cart endpoints](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/CartItemController.cs): `SabzMarket.API/Controllers/CartItemController.cs`
- [Order endpoints](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.API/Controllers/OrderController.cs): `SabzMarket.API/Controllers/OrderController.cs`

### Application services

- [Seller service](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/SellerService.cs): `SabzMarket.BLL/SellerService.cs`
- [Farmer service](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/FarmerService.cs): `SabzMarket.BLL/FarmerService.cs`
- [Product service](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/ProductService.cs): `SabzMarket.BLL/ProductService.cs`
- [Cart service](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/CartItemService.cs): `SabzMarket.BLL/CartItemService.cs`
- [Checkout and orders](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/OrderService.cs): `SabzMarket.BLL/OrderService.cs`
- [Photo saving](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/SavePhoto.cs): `SabzMarket.BLL/SavePhoto.cs`
- [Error logging service](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.BLL/ErrorService.cs): `SabzMarket.BLL/ErrorService.cs`

### Persistence

- [Seller repository](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/SellerRepository.cs): `SabzMarket.DAL/SellerRepository.cs`
- [Product repository](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/ProductRepository.cs): `SabzMarket.DAL/ProductRepository.cs`
- [Order repository](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/OrderRepository.cs): `SabzMarket.DAL/OrderRepository.cs`
- [EF data context](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.DAL/SabzMarketDbContext.cs): `SabzMarket.DAL/SabzMarketDbContext.cs`
- [Marketplace entities](https://github.com/hosseinjafaridev/sabzmarket/tree/main/SabzMarket.DAL/Entities): `SabzMarket.DAL/Entities`

### Shared contracts

- [API route catalog](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.Share/ApiRoutes.cs): `SabzMarket.Share/ApiRoutes.cs`
- [DTOs and view models](https://github.com/hosseinjafaridev/sabzmarket/tree/main/SabzMarket.Share/Models): `SabzMarket.Share/Models`
- [Domain messages](https://github.com/hosseinjafaridev/sabzmarket/blob/main/SabzMarket.Share/Messages.cs): `SabzMarket.Share/Messages.cs`

### Other components

- **Seller**
- **Buyer**

## Connections

- Seller → Seller desktop: uses
- Buyer → Buyer desktop: uses
- Seller desktop → Seller HTTP helper: HTTP requests
- Buyer desktop → Buyer HTTP helper: HTTP requests
- Seller HTTP helper → API route catalog: uses routes (evidence: `SabzMarket/Http/HttpClientHelper.cs`)
- Buyer HTTP helper → API route catalog: uses routes (evidence: `SabzMarketBuyer.UI/Http/HttpClientHelper.cs`)
- Seller endpoints → Seller service: delegates (evidence: `SabzMarket.API/Controllers/SellerController.cs`)
- Farmer endpoints → Farmer service: delegates (evidence: `SabzMarket.API/Controllers/FarmerController.cs`)
- Product endpoints → Product service: delegates (evidence: `SabzMarket.API/Controllers/ProductController.cs`)
- Cart endpoints → Cart service: delegates (evidence: `SabzMarket.API/Controllers/CartItemController.cs`)
- Seller service → Seller repository: calls (evidence: `SabzMarket.BLL/SellerService.cs`)
- Seller service → Photo saving: saves photos (evidence: `SabzMarket.BLL/SellerService.cs`)
- Farmer service → Photo saving: saves photos (evidence: `SabzMarket.BLL/FarmerService.cs`)
- Farmer service → Domain messages: uses messages (evidence: `SabzMarket.BLL/FarmerService.cs`)
- Product service → Product repository: calls (evidence: `SabzMarket.BLL/ProductService.cs`)
- Product service → Photo saving: saves photos (evidence: `SabzMarket.BLL/ProductService.cs`)
- Order endpoints → Checkout and orders: delegates
- Checkout and orders → Order repository: calls (evidence: `SabzMarket.BLL/OrderService.cs`)
- Order repository → EF data context: queries and writes (evidence: `SabzMarket.DAL/OrderRepository.cs`)
- Seller repository → EF data context: queries and writes (evidence: `SabzMarket.DAL/SellerRepository.cs`)
- Product repository → EF data context: queries and writes (evidence: `SabzMarket.DAL/ProductRepository.cs`)
- EF data context → Marketplace entities: maps entities (evidence: `SabzMarket.DAL/SabzMarketDbContext.cs`)
- Checkout and orders → Cart service: loads and clears cart (evidence: `SabzMarket.BLL/OrderService.cs`)
- Checkout and orders → Error logging service: logs failures (evidence: `SabzMarket.BLL/OrderService.cs`)
- Seller endpoints → DTOs and view models: accepts and returns (evidence: `SabzMarket.API/Controllers/SellerController.cs`)
- Seller service → DTOs and view models: maps profile data (evidence: `SabzMarket.BLL/SellerService.cs`)
