# iamumutcan/e-commerce architecture

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

## Overview

This is an ASP.NET e-commerce application with a customer storefront, an administration area, a small Web API, shared Entity Framework models, and an optional blockchain integration. The customer workflow is to browse products, manage a basket, choose an address, create an order, and update its payment status. The graph reflects the sampled controllers and indexed references; several storefront and API controller implementations were not sampled, so their internal calls are not asserted.

Main entry points: [`E-Commerce.Core.Model/AppDbContext.cs`](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.Core.Model/AppDbContext.cs) (Entity Framework context), [`E-Commerce.UI.WEB/Areas/Admin/AdminControllerBase.cs`](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/AdminControllerBase.cs) (Admin access), [`E-Commerce.UI.WEB/Controllers/BasketController.cs`](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/BasketController.cs) (Basket management), [`E-Commerce.UI.WEB/Controllers/OrderController.cs`](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/OrderController.cs) (Checkout and orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_storefront["Storefront actions<br/>[Controllers]"]
  node_userbase["User session"]
  node_basket["Basket management"]
  node_checkout["Checkout and orders<br/>[OrderController.cs]"]
  node_testcontroller["Blockchain test action<br/>[TestController.cs]"]
end

subgraph group_admin["Administration"]
  node_adminbase["Admin access"]
  node_admincatalog["Catalog management<br/>[Controllers]"]
  node_adminusers["User management<br/>[UsersController.cs]"]
  node_adminorders["Order management"]
end

subgraph group_api["Web API"]
  node_apicontrollers["Product and category API<br/>[Controllers]"]
  node_helpcontroller["API help pages<br/>[HelpController.cs]"]
  node_helpmodels["API model descriptions"]
  node_helpapi["Help API model"]
end

subgraph group_domain["Commerce data"]
  node_dbcontext["Entity Framework context<br/>[AppDbContext.cs]"]
  node_entities[("Commerce entities<br/>[Entity]")]
end

subgraph group_integration["External integration"]
  node_blockchain["Blockchain client"]
end

node_customer(("Shopper"))
node_adminactor(("Administrator"))
node_apiuser(("API consumer"))
node_blockchainservice{{"Blockchain service"}}

node_customer -.->|"uses"| node_storefront
node_storefront -.->|"inherits"| node_userbase
node_customer -.->|"manages basket"| node_basket
node_basket -->|"uses session"| node_userbase
node_basket -->|"reads and writes"| node_dbcontext
node_customer -.->|"checks out"| node_checkout
node_checkout -->|"uses session"| node_userbase
node_checkout -->|"reads and writes"| node_dbcontext
node_adminactor -.->|"accesses"| node_adminbase
node_adminbase -.->|"guards"| node_admincatalog
node_adminbase -.->|"guards"| node_adminusers
node_adminbase -->|"guards"| node_adminorders
node_admincatalog -.->|"reads and writes"| node_dbcontext
node_adminusers -->|"reads and writes"| node_dbcontext
node_adminorders -->|"reads and writes"| node_dbcontext
node_apiuser -.->|"requests"| node_apicontrollers
node_apicontrollers -->|"reads products"| node_dbcontext
node_apiuser -.->|"requests docs"| node_helpcontroller
node_helpcontroller -->|"gets model descriptions"| node_helpmodels
node_helpcontroller -->|"gets API model"| node_helpapi
node_helpmodels -->|"describes parameters"| node_helpapi
node_testcontroller -->|"calls"| node_blockchain
node_blockchain -->|"posts requests"| node_blockchainservice
node_dbcontext -->|"maps"| node_entities

click node_storefront "https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.UI.WEB/Controllers"
click node_userbase "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/Base/UserControllerBase.cs"
click node_basket "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/BasketController.cs"
click node_checkout "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/OrderController.cs"
click node_adminbase "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/AdminControllerBase.cs"
click node_admincatalog "https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.UI.WEB/Areas/Admin/Controllers"
click node_adminusers "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/Controllers/UsersController.cs"
click node_adminorders "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs"
click node_apicontrollers "https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.API/Controllers"
click node_helpcontroller "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.API/Areas/HelpPage/Controllers/HelpController.cs"
click node_helpmodels "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.API/Areas/HelpPage/ModelDescriptions/ModelDescriptionGenerator.cs"
click node_helpapi "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.API/Areas/HelpPage/Models/HelpPageApiModel.cs"
click node_dbcontext "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.Core.Model/AppDbContext.cs"
click node_entities "https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.Core.Model/Entity"
click node_blockchain "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.DataIntegration/Blockchain/BlockchainHandler.cs"
click node_testcontroller "https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/TestController.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_storefront,node_userbase,node_basket,node_checkout,node_testcontroller toneBlue
class node_adminbase,node_admincatalog,node_adminusers,node_adminorders toneAmber
class node_apicontrollers,node_helpcontroller,node_helpmodels,node_helpapi,node_apiuser toneMint
class node_dbcontext,node_entities toneRose
class node_blockchain,node_customer,node_adminactor,node_blockchainservice toneIndigo
```

## Components

### Customer storefront

- [Storefront actions](https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.UI.WEB/Controllers): `E-Commerce.UI.WEB/Controllers`
- [User session](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/Base/UserControllerBase.cs): `E-Commerce.UI.WEB/Controllers/Base/UserControllerBase.cs`
- [Basket management](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/BasketController.cs): `E-Commerce.UI.WEB/Controllers/BasketController.cs`
- [Checkout and orders](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/OrderController.cs): `E-Commerce.UI.WEB/Controllers/OrderController.cs`
- [Blockchain test action](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Controllers/TestController.cs): `E-Commerce.UI.WEB/Controllers/TestController.cs`

### Administration

- [Admin access](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/AdminControllerBase.cs): `E-Commerce.UI.WEB/Areas/Admin/AdminControllerBase.cs`
- [Catalog management](https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.UI.WEB/Areas/Admin/Controllers): `E-Commerce.UI.WEB/Areas/Admin/Controllers`
- [User management](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/Controllers/UsersController.cs): `E-Commerce.UI.WEB/Areas/Admin/Controllers/UsersController.cs`
- [Order management](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs): `E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs`

### Web API

- [Product and category API](https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.API/Controllers): `E-Commerce.API/Controllers`
- [API help pages](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.API/Areas/HelpPage/Controllers/HelpController.cs): `E-Commerce.API/Areas/HelpPage/Controllers/HelpController.cs`
- [API model descriptions](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.API/Areas/HelpPage/ModelDescriptions/ModelDescriptionGenerator.cs): `E-Commerce.API/Areas/HelpPage/ModelDescriptions/ModelDescriptionGenerator.cs`
- [Help API model](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.API/Areas/HelpPage/Models/HelpPageApiModel.cs): `E-Commerce.API/Areas/HelpPage/Models/HelpPageApiModel.cs`

### Commerce data

- [Entity Framework context](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.Core.Model/AppDbContext.cs): `E-Commerce.Core.Model/AppDbContext.cs`
- [Commerce entities](https://github.com/iamumutcan/e-commerce/tree/master/E-Commerce.Core.Model/Entity): `E-Commerce.Core.Model/Entity`

### External integration

- [Blockchain client](https://github.com/iamumutcan/e-commerce/blob/master/E-Commerce.DataIntegration/Blockchain/BlockchainHandler.cs): `E-Commerce.DataIntegration/Blockchain/BlockchainHandler.cs`

### Other components

- **Shopper**
- **Administrator**
- **API consumer**
- **Blockchain service**

## Connections

- Shopper → Storefront actions: uses
- Storefront actions → User session: inherits (evidence: `E-Commerce.UI.WEB/Controllers/OrderController.cs`)
- Shopper → Basket management: manages basket
- Basket management → User session: uses session (evidence: `E-Commerce.UI.WEB/Controllers/BasketController.cs`)
- Basket management → Entity Framework context: reads and writes (evidence: `E-Commerce.UI.WEB/Controllers/BasketController.cs`)
- Shopper → Checkout and orders: checks out
- Checkout and orders → User session: uses session (evidence: `E-Commerce.UI.WEB/Controllers/OrderController.cs`)
- Checkout and orders → Entity Framework context: reads and writes (evidence: `E-Commerce.UI.WEB/Controllers/OrderController.cs`)
- Administrator → Admin access: accesses
- Admin access → Catalog management: guards (evidence: `E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs`)
- Admin access → User management: guards (evidence: `E-Commerce.UI.WEB/Areas/Admin/Controllers/UsersController.cs`)
- Admin access → Order management: guards (evidence: `E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs`)
- Catalog management → Entity Framework context: reads and writes (evidence: `E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs`)
- User management → Entity Framework context: reads and writes (evidence: `E-Commerce.UI.WEB/Areas/Admin/Controllers/UsersController.cs`)
- Order management → Entity Framework context: reads and writes (evidence: `E-Commerce.UI.WEB/Areas/Admin/Controllers/AdminOrdersController.cs`)
- API consumer → Product and category API: requests
- Product and category API → Entity Framework context: reads products (evidence: `E-Commerce.API/Controllers/ProductController.cs`)
- API consumer → API help pages: requests docs
- API help pages → API model descriptions: gets model descriptions (evidence: `E-Commerce.API/Areas/HelpPage/Controllers/HelpController.cs`)
- API help pages → Help API model: gets API model (evidence: `E-Commerce.API/Areas/HelpPage/Controllers/HelpController.cs`)
- API model descriptions → Help API model: describes parameters (evidence: `E-Commerce.API/Areas/HelpPage/Models/HelpPageApiModel.cs`)
- Blockchain test action → Blockchain client: calls (evidence: `E-Commerce.UI.WEB/Controllers/TestController.cs`)
- Blockchain client → Blockchain service: posts requests (evidence: `E-Commerce.DataIntegration/Blockchain/BlockchainHandler.cs`)
- Entity Framework context → Commerce entities: maps (evidence: `E-Commerce.Core.Model/AppDbContext.cs`)
