# hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core architecture

> Architecture diagram of the GitHub repository hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core
- Repository: https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core

## Overview

BestStoreAPI is an ASP.NET Core e-commerce API. Its user-facing workflows cover account registration and access, product discovery and administration, cart handling, order creation and status management, and customer contact submissions. Controllers handle HTTP requests and use DTOs, shared order rules, and an EF Core context for persistence. The README provides no capability detail; the graph therefore relies on the sampled controller code and source index. Several controller and model relationships are evidenced only by index references, so unsampled behavior is not expanded.

Main entry points: [`Services/ApplicationDbContext.cs`](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Services/ApplicationDbContext.cs) (EF Context), [`Controllers/OrdersController.cs`](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/OrdersController.cs) (Orders API), [`Controllers/CartController.cs`](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/CartController.cs) (Cart API), [`Models/Prodect.cs`](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Prodect.cs) (Product Entity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_account["Account API"]
  node_user_api["User API<br/>[UserController.cs]"]
  node_products_api["Products API"]
  node_cart_api["Cart API<br/>[CartController.cs]"]
  node_orders_api["Orders API"]
  node_contacts_api["Contacts API"]
end

subgraph group_contracts["API Contracts"]
  node_user_dto["User DTOs<br/>[UserDTO.cs]"]
  node_profile_dto["Profile DTO<br/>[UserProfileDTO.cs]"]
  node_product_dto["Product DTO<br/>[ProductsDTO.cs]"]
  node_cart_dto["Cart DTOs<br/>[CartDto.cs]"]
  node_cartitem_dto["Cart Item DTO<br/>[CartitemDto.cs]"]
  node_order_dto["Order DTO<br/>[OrderDto.cs]"]
  node_contact_dto["Contact DTO<br/>[ContactDto.cs]"]
end

subgraph group_domain["Commerce Domain"]
  node_user_model["User Entity<br/>[User.cs]"]
  node_product_model["Product Entity<br/>[Prodect.cs]"]
  node_order_model["Order Entity<br/>[Order.cs]"]
  node_order_item["Order Item<br/>[OrderItem.cs]"]
  node_contact_model["Contact Entity<br/>[Contact.cs]"]
  node_subject_model["Contact Subject<br/>[Subject.cs]"]
  node_order_rules["Order Rules<br/>[OrderHelper.cs]"]
end

subgraph group_persistence["Persistence"]
  node_db[("EF Context")]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_account
node_client -.->|"sends requests"| node_user_api
node_client -->|"sends requests"| node_products_api
node_client -.->|"sends requests"| node_cart_api
node_client -->|"sends requests"| node_orders_api
node_client -->|"sends requests"| node_contacts_api
node_account -->|"reads"| node_user_dto
node_account -->|"returns"| node_profile_dto
node_account -->|"creates and verifies"| node_user_model
node_account -->|"queries and saves"| node_db
node_user_api -->|"uses"| node_profile_dto
node_user_api -->|"queries and saves"| node_db
node_products_api -->|"reads"| node_product_dto
node_products_api -->|"queries and mutates"| node_product_model
node_products_api -->|"queries and saves"| node_db
node_cart_api -->|"uses"| node_cart_dto
node_cart_api -->|"uses"| node_cartitem_dto
node_cart_api -->|"reads"| node_product_model
node_cart_api -->|"uses"| node_order_rules
node_cart_api -->|"queries and saves"| node_db
node_orders_api -->|"reads"| node_order_dto
node_orders_api -->|"validates and parses"| node_order_rules
node_orders_api -->|"loads user"| node_user_model
node_orders_api -->|"loads products"| node_product_model
node_orders_api -->|"creates and updates"| node_order_model
node_orders_api -->|"creates"| node_order_item
node_orders_api -->|"queries and saves"| node_db
node_contacts_api -->|"reads"| node_contact_dto
node_contacts_api -->|"creates and updates"| node_contact_model
node_contacts_api -->|"loads subject"| node_subject_model
node_contacts_api -->|"queries and saves"| node_db
node_db -->|"maps"| node_user_model
node_db -->|"maps"| node_product_model
node_db -->|"maps"| node_order_model
node_db -->|"maps"| node_order_item
node_db -->|"maps"| node_contact_model
node_db -->|"maps"| node_subject_model
node_cart_dto -->|"contains"| node_cartitem_dto
node_cartitem_dto -->|"references"| node_product_model
node_contact_model -->|"references"| node_subject_model
node_order_model -->|"references"| node_user_model
node_order_model -->|"contains"| node_order_item
node_order_item -->|"references"| node_product_model

click node_account "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/AccountController.cs"
click node_user_api "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/UserController.cs"
click node_products_api "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/ProductsController.cs"
click node_cart_api "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/CartController.cs"
click node_orders_api "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/OrdersController.cs"
click node_contacts_api "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/ContactsController.cs"
click node_user_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/UserDTO.cs"
click node_profile_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/UserProfileDTO.cs"
click node_product_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/ProductsDTO.cs"
click node_cart_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/CartDto.cs"
click node_cartitem_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/CartitemDto.cs"
click node_order_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/OrderDto.cs"
click node_contact_dto "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/ContactDto.cs"
click node_user_model "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/User.cs"
click node_product_model "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Prodect.cs"
click node_order_model "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Order.cs"
click node_order_item "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/OrderItem.cs"
click node_contact_model "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Contact.cs"
click node_subject_model "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Subject.cs"
click node_order_rules "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Services/OrderHelper.cs"
click node_db "https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Services/ApplicationDbContext.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_account,node_user_api,node_products_api,node_cart_api,node_orders_api,node_contacts_api,node_client toneBlue
class node_user_dto,node_profile_dto,node_product_dto,node_cart_dto,node_cartitem_dto,node_order_dto,node_contact_dto toneAmber
class node_user_model,node_product_model,node_order_model,node_order_item,node_contact_model,node_subject_model,node_order_rules toneMint
class node_db toneRose
```

## Components

### HTTP API

- [Account API](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/AccountController.cs): `Controllers/AccountController.cs`
- [User API](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/UserController.cs): `Controllers/UserController.cs`
- [Products API](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/ProductsController.cs): `Controllers/ProductsController.cs`
- [Cart API](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/CartController.cs): `Controllers/CartController.cs`
- [Orders API](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/OrdersController.cs): `Controllers/OrdersController.cs`
- [Contacts API](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Controllers/ContactsController.cs): `Controllers/ContactsController.cs`

### API Contracts

- [User DTOs](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/UserDTO.cs): `Dtos/UserDTO.cs`
- [Profile DTO](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/UserProfileDTO.cs): `Dtos/UserProfileDTO.cs`
- [Product DTO](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/ProductsDTO.cs): `Dtos/ProductsDTO.cs`
- [Cart DTOs](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/CartDto.cs): `Dtos/CartDto.cs`
- [Cart Item DTO](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/CartitemDto.cs): `Dtos/CartitemDto.cs`
- [Order DTO](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/OrderDto.cs): `Dtos/OrderDto.cs`
- [Contact DTO](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Dtos/ContactDto.cs): `Dtos/ContactDto.cs`

### Commerce Domain

- [User Entity](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/User.cs): `Models/User.cs`
- [Product Entity](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Prodect.cs): `Models/Prodect.cs`
- [Order Entity](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Order.cs): `Models/Order.cs`
- [Order Item](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/OrderItem.cs): `Models/OrderItem.cs`
- [Contact Entity](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Contact.cs): `Models/Contact.cs`
- [Contact Subject](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Models/Subject.cs): `Models/Subject.cs`
- [Order Rules](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Services/OrderHelper.cs): `Services/OrderHelper.cs`

### Persistence

- [EF Context](https://github.com/hayderdev23/build-secure-web-api-for-e-commerce-using-asp.net-core/blob/main/Services/ApplicationDbContext.cs): `Services/ApplicationDbContext.cs`

### Other components

- **API Client**

## Connections

- API Client → Account API: sends requests (evidence: `Controllers/AccountController.cs`)
- API Client → User API: sends requests
- API Client → Products API: sends requests (evidence: `Controllers/ProductsController.cs`)
- API Client → Cart API: sends requests
- API Client → Orders API: sends requests (evidence: `Controllers/OrdersController.cs`)
- API Client → Contacts API: sends requests (evidence: `Controllers/ContactsController.cs`)
- Account API → User DTOs: reads (evidence: `Controllers/AccountController.cs`)
- Account API → Profile DTO: returns (evidence: `Controllers/AccountController.cs`)
- Account API → User Entity: creates and verifies (evidence: `Controllers/AccountController.cs`)
- Account API → EF Context: queries and saves (evidence: `Controllers/AccountController.cs`)
- User API → Profile DTO: uses (evidence: `Controllers/UserController.cs`)
- User API → EF Context: queries and saves (evidence: `Controllers/UserController.cs`)
- Products API → Product DTO: reads (evidence: `Controllers/ProductsController.cs`)
- Products API → Product Entity: queries and mutates (evidence: `Controllers/ProductsController.cs`)
- Products API → EF Context: queries and saves (evidence: `Controllers/ProductsController.cs`)
- Cart API → Cart DTOs: uses (evidence: `Controllers/CartController.cs`)
- Cart API → Cart Item DTO: uses (evidence: `Controllers/CartController.cs`)
- Cart API → Product Entity: reads (evidence: `Controllers/CartController.cs`)
- Cart API → Order Rules: uses (evidence: `Controllers/CartController.cs`)
- Cart API → EF Context: queries and saves (evidence: `Controllers/CartController.cs`)
- Orders API → Order DTO: reads (evidence: `Controllers/OrdersController.cs`)
- Orders API → Order Rules: validates and parses (evidence: `Controllers/OrdersController.cs`)
- Orders API → User Entity: loads user (evidence: `Controllers/OrdersController.cs`)
- Orders API → Product Entity: loads products (evidence: `Controllers/OrdersController.cs`)
- Orders API → Order Entity: creates and updates (evidence: `Controllers/OrdersController.cs`)
- Orders API → Order Item: creates (evidence: `Controllers/OrdersController.cs`)
- Orders API → EF Context: queries and saves (evidence: `Controllers/OrdersController.cs`)
- Contacts API → Contact DTO: reads (evidence: `Controllers/ContactsController.cs`)
- Contacts API → Contact Entity: creates and updates (evidence: `Controllers/ContactsController.cs`)
- Contacts API → Contact Subject: loads subject (evidence: `Controllers/ContactsController.cs`)
- Contacts API → EF Context: queries and saves (evidence: `Controllers/ContactsController.cs`)
- EF Context → User Entity: maps (evidence: `Services/ApplicationDbContext.cs`)
- EF Context → Product Entity: maps (evidence: `Services/ApplicationDbContext.cs`)
- EF Context → Order Entity: maps (evidence: `Services/ApplicationDbContext.cs`)
- EF Context → Order Item: maps (evidence: `Services/ApplicationDbContext.cs`)
- EF Context → Contact Entity: maps (evidence: `Services/ApplicationDbContext.cs`)
- EF Context → Contact Subject: maps (evidence: `Services/ApplicationDbContext.cs`)
- Cart DTOs → Cart Item DTO: contains (evidence: `Dtos/CartDto.cs`)
- Cart Item DTO → Product Entity: references (evidence: `Dtos/CartitemDto.cs`)
- Contact Entity → Contact Subject: references (evidence: `Models/Contact.cs`)
- Order Entity → User Entity: references (evidence: `Models/Order.cs`)
- Order Entity → Order Item: contains (evidence: `Models/Order.cs`)
- Order Item → Product Entity: references (evidence: `Models/OrderItem.cs`)
