# soul-asjad/grocery-ecommerce-site architecture

> Architecture diagram of the GitHub repository soul-asjad/grocery-ecommerce-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/soul-asjad/grocery-ecommerce-site
- Repository: https://github.com/soul-asjad/grocery-ecommerce-site

## Overview

Grocery is an ASP.NET MVC online grocery store. The main customer journey spans product discovery, cart management, checkout, and order viewing; the repository also includes account, category/product administration, contact, and chat capabilities. The sampled controllers and SOURCE INDEX show database access and the chat controller’s Groq API call. The excerpts do not establish controller-to-controller transitions, so those are not drawn; actor entry points and the database connection are shown as unverified.

Main entry points: [`Grocery/Models/GroceryDBContext.cs`](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Models/GroceryDBContext.cs) (EF data context), [`Grocery/Controllers/ChatController.cs`](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ChatController.cs) (Store assistant), [`Grocery/Controllers/ProductsController.cs`](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ProductsController.cs) (Product catalog), [`Grocery/Controllers/OrderController.cs`](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/OrderController.cs) (Order management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_home["Home browsing<br/>[HomeController.cs]"]
  node_products["Product catalog"]
  node_product_api["Products API"]
  node_categories["Categories"]
  node_chat["Store assistant<br/>[ChatController.cs]"]
end

subgraph group_commerce["Cart and Orders"]
  node_cart["Shopping cart<br/>[CartController.cs]"]
  node_checkout["Checkout"]
  node_orders["Order management<br/>[OrderController.cs]"]
end

subgraph group_operations["Accounts and Admin"]
  node_accounts["User accounts<br/>[UserController.cs]"]
  node_admin["Store administration<br/>[AdminController.cs]"]
  node_contact["Contact messages"]
end

subgraph group_data["Data and Services"]
  node_db_context["EF data context"]
  node_domain_models["Commerce entities"]
  node_admin_service["Admin data service<br/>[AdminService.cs]"]
end

node_customer(("Customer"))
node_admin_user(("Admin user"))
node_database[("Application database")]
node_groq["Groq chat API"]

node_customer -.->|"browses"| node_home
node_customer -.->|"views products"| node_products
node_customer -.->|"requests products"| node_product_api
node_customer -.->|"manages cart"| node_cart
node_customer -.->|"checks out"| node_checkout
node_customer -.->|"views orders"| node_orders
node_customer -.->|"manages account"| node_accounts
node_customer -.->|"sends message"| node_contact
node_customer -.->|"asks assistant"| node_chat
node_admin_user -.->|"administers store"| node_admin
node_admin_user -.->|"manages categories"| node_categories
node_admin_user -.->|"manages catalog"| node_products
node_admin_user -.->|"manages orders"| node_orders
node_admin_user -.->|"reviews messages"| node_contact
node_home -->|"queries"| node_db_context
node_products -->|"queries and updates"| node_db_context
node_categories -->|"queries and updates"| node_db_context
node_product_api -->|"queries"| node_db_context
node_cart -->|"reads and updates"| node_db_context
node_checkout -->|"reads and writes"| node_db_context
node_orders -->|"reads and updates"| node_db_context
node_accounts -->|"reads and writes"| node_db_context
node_admin -->|"queries"| node_db_context
node_contact -->|"reads and writes"| node_db_context
node_chat -->|"searches products"| node_db_context
node_chat -->|"sends chat request"| node_groq
node_admin_service -->|"queries products and categories"| node_db_context
node_db_context -->|"maps entities"| node_domain_models
node_db_context -.->|"persists data"| node_database

click node_home "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/HomeController.cs"
click node_products "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ProductsController.cs"
click node_product_api "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ProductsApiController.cs"
click node_categories "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/CategoriesController.cs"
click node_chat "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ChatController.cs"
click node_cart "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/CartController.cs"
click node_checkout "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/CheckoutController.cs"
click node_orders "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/OrderController.cs"
click node_accounts "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/UserController.cs"
click node_admin "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/AdminController.cs"
click node_contact "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ContactController.cs"
click node_db_context "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Models/GroceryDBContext.cs"
click node_domain_models "https://github.com/soul-asjad/grocery-ecommerce-site/tree/main/Grocery/Models"
click node_admin_service "https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Models/AdminService.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_home,node_products,node_product_api,node_categories,node_chat,node_admin_user toneBlue
class node_cart,node_checkout,node_orders,node_database toneAmber
class node_accounts,node_admin,node_contact,node_groq toneMint
class node_db_context,node_domain_models,node_admin_service toneRose
class node_customer toneIndigo
```

## Components

### Storefront

- [Home browsing](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/HomeController.cs): `Grocery/Controllers/HomeController.cs`
- [Product catalog](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ProductsController.cs): `Grocery/Controllers/ProductsController.cs`
- [Products API](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ProductsApiController.cs): `Grocery/Controllers/ProductsApiController.cs`
- [Categories](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/CategoriesController.cs): `Grocery/Controllers/CategoriesController.cs`
- [Store assistant](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ChatController.cs): `Grocery/Controllers/ChatController.cs`

### Cart and Orders

- [Shopping cart](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/CartController.cs): `Grocery/Controllers/CartController.cs`
- [Checkout](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/CheckoutController.cs): `Grocery/Controllers/CheckoutController.cs`
- [Order management](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/OrderController.cs): `Grocery/Controllers/OrderController.cs`

### Accounts and Admin

- [User accounts](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/UserController.cs): `Grocery/Controllers/UserController.cs`
- [Store administration](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/AdminController.cs): `Grocery/Controllers/AdminController.cs`
- [Contact messages](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Controllers/ContactController.cs): `Grocery/Controllers/ContactController.cs`

### Data and Services

- [EF data context](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Models/GroceryDBContext.cs): `Grocery/Models/GroceryDBContext.cs`
- [Commerce entities](https://github.com/soul-asjad/grocery-ecommerce-site/tree/main/Grocery/Models): `Grocery/Models`
- [Admin data service](https://github.com/soul-asjad/grocery-ecommerce-site/blob/main/Grocery/Models/AdminService.cs): `Grocery/Models/AdminService.cs`

### Other components

- **Customer**
- **Admin user**
- **Application database**
- **Groq chat API**

## Connections

- Customer → Home browsing: browses
- Customer → Product catalog: views products
- Customer → Products API: requests products
- Customer → Shopping cart: manages cart
- Customer → Checkout: checks out
- Customer → Order management: views orders
- Customer → User accounts: manages account
- Customer → Contact messages: sends message
- Customer → Store assistant: asks assistant
- Admin user → Store administration: administers store
- Admin user → Categories: manages categories
- Admin user → Product catalog: manages catalog
- Admin user → Order management: manages orders
- Admin user → Contact messages: reviews messages
- Home browsing → EF data context: queries (evidence: `Grocery/Controllers/HomeController.cs`)
- Product catalog → EF data context: queries and updates (evidence: `Grocery/Controllers/ProductsController.cs`)
- Categories → EF data context: queries and updates (evidence: `Grocery/Controllers/CategoriesController.cs`)
- Products API → EF data context: queries (evidence: `Grocery/Controllers/ProductsApiController.cs`)
- Shopping cart → EF data context: reads and updates (evidence: `Grocery/Controllers/CartController.cs`)
- Checkout → EF data context: reads and writes (evidence: `Grocery/Controllers/CheckoutController.cs`)
- Order management → EF data context: reads and updates (evidence: `Grocery/Controllers/OrderController.cs`)
- User accounts → EF data context: reads and writes (evidence: `Grocery/Controllers/UserController.cs`)
- Store administration → EF data context: queries (evidence: `Grocery/Controllers/AdminController.cs`)
- Contact messages → EF data context: reads and writes (evidence: `Grocery/Controllers/ContactController.cs`)
- Store assistant → EF data context: searches products (evidence: `Grocery/Controllers/ChatController.cs`)
- Store assistant → Groq chat API: sends chat request (evidence: `Grocery/Controllers/ChatController.cs`)
- Admin data service → EF data context: queries products and categories (evidence: `Grocery/Models/AdminService.cs`)
- EF data context → Commerce entities: maps entities (evidence: `Grocery/Models/GroceryDBContext.cs`)
- EF data context → Application database: persists data
