# junn-noob/nexus-retail architecture

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

- Interactive diagram: https://gitdiagram.com/junn-noob/nexus-retail
- Repository: https://github.com/junn-noob/nexus-retail

## Overview

NexusRetail is a multi-project retail application. The clearest user workflow is browsing a paged product catalogue in the MVC web app: its controllers call the Core API, which queries the retail context and returns product DTOs for display or comparison. The shared model also represents sales and purchasing invoices, staff, customers, suppliers, product classifications, and chatbot recommendation logs, but their runtime workflows are not demonstrated in the excerpts. Gateway and Identity projects exist; their integration with the shown workflow is unclear.

Main entry points: [`src/NexusRetail.Core.Api/Data/RetailDbContext.cs`](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Data/RetailDbContext.cs) (Retail context), [`src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Controllers/SanPhamController.cs) (Product endpoints), [`src/NexusRetail.Shared/Entities/SanPham.cs`](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/SanPham.cs) (Product entity), [`src/NexusRetail.WebMvc/Controllers/ProductsController.cs`](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Controllers/ProductsController.cs) (Product actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_home["Catalogue pages<br/>[HomeController.cs]"]
  node_product_web["Product actions"]
  node_brand_widget["Brand selector"]
  node_brand_view["Brand view<br/>[Default.cshtml]"]
  node_product_views["Product partials<br/>[Products]"]
end

subgraph group_api["Core API"]
  node_product_api["Product endpoints"]
  node_brand_api["Brand endpoints"]
  node_dbcontext["Retail context<br/>[RetailDbContext.cs]"]
end

subgraph group_data["Retail data model"]
  node_product_dto["Product DTO<br/>[SanPhamDto.cs]"]
  node_paged_dto["Paged result<br/>[PagedResultDto.cs]"]
  node_product_input["Product input DTOs<br/>[SanPham]"]
  node_product["Product entity<br/>[SanPham.cs]"]
  node_product_views_entity["Product views"]
  node_invoice_views["Sales invoice view"]
  node_sales["Sales invoices<br/>[HoaDonBan.cs]"]
  node_sales_lines["Sales lines<br/>[ChiTietHdb.cs]"]
  node_purchases["Purchase invoices<br/>[HoaDonNhap.cs]"]
  node_purchase_lines["Purchase lines<br/>[ChiTietHdn.cs]"]
  node_customer["Customers<br/>[KhachHang.cs]"]
  node_supplier["Suppliers<br/>[NhaCungCap.cs]"]
  node_staff["Staff and region<br/>[NhanVien.cs]"]
  node_region["Regions<br/>[Que.cs]"]
  node_classifications["Product classifications<br/>[Entities]"]
  node_chatlog["Recommendation logs<br/>[ChatbotTuVanLog.cs]"]
end

subgraph group_services["Platform services"]
  node_gateway["Gateway<br/>[Program.cs]"]
  node_identity["Identity API<br/>[Program.cs]"]
end

node_shopper(("Shopper"))
node_database[("Retail database")]

node_shopper -->|"browses"| node_home
node_shopper -->|"compares"| node_product_web
node_home -->|"requests products"| node_product_api
node_product_web -->|"requests details"| node_product_api
node_product_web -->|"renders partials"| node_product_views
node_brand_widget -.->|"renders"| node_brand_view
node_brand_api -->|"uses context"| node_dbcontext
node_product_api -->|"queries and saves"| node_dbcontext
node_product_api -->|"projects results"| node_product_dto
node_product_api -->|"returns pages"| node_paged_dto
node_product_api -->|"accepts input"| node_product_input
node_product_api -->|"creates and updates"| node_product
node_home -->|"deserializes"| node_product_dto
node_home -->|"deserializes"| node_paged_dto
node_product_web -->|"deserializes"| node_product_dto
node_product_web -->|"deserializes"| node_paged_dto
node_dbcontext -->|"maps entity"| node_product
node_dbcontext -->|"maps view"| node_product_views_entity
node_dbcontext -->|"maps view"| node_invoice_views
node_dbcontext -->|"maps entity"| node_sales
node_dbcontext -->|"maps entity"| node_sales_lines
node_dbcontext -->|"maps entity"| node_purchases
node_dbcontext -->|"maps entity"| node_purchase_lines
node_dbcontext -->|"maps entity"| node_customer
node_dbcontext -->|"maps entity"| node_supplier
node_dbcontext -->|"maps entity"| node_staff
node_dbcontext -->|"maps entity"| node_region
node_dbcontext -->|"maps entities"| node_classifications
node_dbcontext -->|"maps entity"| node_chatlog
node_dbcontext -.->|"persists data"| node_database
node_sales -->|"has lines"| node_sales_lines
node_sales_lines -->|"references"| node_product
node_sales -->|"references"| node_customer
node_sales -->|"references"| node_staff
node_purchases -->|"has lines"| node_purchase_lines
node_purchase_lines -->|"references"| node_product
node_purchases -->|"references"| node_supplier
node_purchases -->|"references"| node_staff
node_staff -->|"references"| node_region
node_product -->|"references"| node_classifications
node_chatlog -->|"references suggestion"| node_product

click node_home "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Controllers/HomeController.cs"
click node_product_web "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Controllers/ProductsController.cs"
click node_brand_widget "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/ViewComponents/NhanHieuViewComponent.cs"
click node_brand_view "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Views/Shared/Components/NhanHieu/Default.cshtml"
click node_product_views "https://github.com/junn-noob/nexus-retail/tree/main/src/NexusRetail.WebMvc/Views/Products"
click node_product_api "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Controllers/SanPhamController.cs"
click node_brand_api "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Controllers/NhanHieuController.cs"
click node_dbcontext "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Data/RetailDbContext.cs"
click node_product_dto "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/DTOs/SanPham/SanPhamDto.cs"
click node_paged_dto "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/DTOs/Common/PagedResultDto.cs"
click node_product_input "https://github.com/junn-noob/nexus-retail/tree/main/src/NexusRetail.Shared/DTOs/SanPham"
click node_product "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/SanPham.cs"
click node_product_views_entity "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/VwDanhSachSanPham.cs"
click node_invoice_views "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/VwChiTietHoaDonBan.cs"
click node_sales "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/HoaDonBan.cs"
click node_sales_lines "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/ChiTietHdb.cs"
click node_purchases "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/HoaDonNhap.cs"
click node_purchase_lines "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/ChiTietHdn.cs"
click node_customer "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/KhachHang.cs"
click node_supplier "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/NhaCungCap.cs"
click node_staff "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/NhanVien.cs"
click node_region "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/Que.cs"
click node_classifications "https://github.com/junn-noob/nexus-retail/tree/main/src/NexusRetail.Shared/Entities"
click node_chatlog "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/ChatbotTuVanLog.cs"
click node_gateway "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Gateway/Program.cs"
click node_identity "https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Identity.Api/Program.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_product_web,node_brand_widget,node_brand_view,node_product_views toneBlue
class node_product_api,node_brand_api,node_dbcontext,node_database toneAmber
class node_product_dto,node_paged_dto,node_product_input,node_product,node_product_views_entity,node_invoice_views,node_sales,node_sales_lines,node_purchases,node_purchase_lines,node_customer,node_supplier,node_staff,node_region,node_classifications,node_chatlog toneMint
class node_gateway,node_identity toneRose
class node_shopper toneIndigo
```

## Components

### Web experience

- [Catalogue pages](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Controllers/HomeController.cs): `src/NexusRetail.WebMvc/Controllers/HomeController.cs`
- [Product actions](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Controllers/ProductsController.cs): `src/NexusRetail.WebMvc/Controllers/ProductsController.cs`
- [Brand selector](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/ViewComponents/NhanHieuViewComponent.cs): `src/NexusRetail.WebMvc/ViewComponents/NhanHieuViewComponent.cs`
- [Brand view](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.WebMvc/Views/Shared/Components/NhanHieu/Default.cshtml): `src/NexusRetail.WebMvc/Views/Shared/Components/NhanHieu/Default.cshtml`
- [Product partials](https://github.com/junn-noob/nexus-retail/tree/main/src/NexusRetail.WebMvc/Views/Products): `src/NexusRetail.WebMvc/Views/Products`

### Core API

- [Product endpoints](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Controllers/SanPhamController.cs): `src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`
- [Brand endpoints](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Controllers/NhanHieuController.cs): `src/NexusRetail.Core.Api/Controllers/NhanHieuController.cs`
- [Retail context](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Core.Api/Data/RetailDbContext.cs): `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`

### Retail data model

- [Product DTO](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/DTOs/SanPham/SanPhamDto.cs): `src/NexusRetail.Shared/DTOs/SanPham/SanPhamDto.cs`
- [Paged result](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/DTOs/Common/PagedResultDto.cs): `src/NexusRetail.Shared/DTOs/Common/PagedResultDto.cs`
- [Product input DTOs](https://github.com/junn-noob/nexus-retail/tree/main/src/NexusRetail.Shared/DTOs/SanPham): `src/NexusRetail.Shared/DTOs/SanPham`
- [Product entity](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/SanPham.cs): `src/NexusRetail.Shared/Entities/SanPham.cs`
- [Product views](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/VwDanhSachSanPham.cs): `src/NexusRetail.Shared/Entities/VwDanhSachSanPham.cs`
- [Sales invoice view](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/VwChiTietHoaDonBan.cs): `src/NexusRetail.Shared/Entities/VwChiTietHoaDonBan.cs`
- [Sales invoices](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/HoaDonBan.cs): `src/NexusRetail.Shared/Entities/HoaDonBan.cs`
- [Sales lines](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/ChiTietHdb.cs): `src/NexusRetail.Shared/Entities/ChiTietHdb.cs`
- [Purchase invoices](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/HoaDonNhap.cs): `src/NexusRetail.Shared/Entities/HoaDonNhap.cs`
- [Purchase lines](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/ChiTietHdn.cs): `src/NexusRetail.Shared/Entities/ChiTietHdn.cs`
- [Customers](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/KhachHang.cs): `src/NexusRetail.Shared/Entities/KhachHang.cs`
- [Suppliers](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/NhaCungCap.cs): `src/NexusRetail.Shared/Entities/NhaCungCap.cs`
- [Staff and region](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/NhanVien.cs): `src/NexusRetail.Shared/Entities/NhanVien.cs`
- [Regions](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/Que.cs): `src/NexusRetail.Shared/Entities/Que.cs`
- [Product classifications](https://github.com/junn-noob/nexus-retail/tree/main/src/NexusRetail.Shared/Entities): `src/NexusRetail.Shared/Entities`
- [Recommendation logs](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Shared/Entities/ChatbotTuVanLog.cs): `src/NexusRetail.Shared/Entities/ChatbotTuVanLog.cs`

### Platform services

- [Gateway](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Gateway/Program.cs): `src/NexusRetail.Gateway/Program.cs`
- [Identity API](https://github.com/junn-noob/nexus-retail/blob/main/src/NexusRetail.Identity.Api/Program.cs): `src/NexusRetail.Identity.Api/Program.cs`

### Other components

- **Shopper**
- **Retail database**

## Connections

- Shopper → Catalogue pages: browses (evidence: `src/NexusRetail.WebMvc/Controllers/HomeController.cs`)
- Shopper → Product actions: compares (evidence: `src/NexusRetail.WebMvc/Controllers/ProductsController.cs`)
- Catalogue pages → Product endpoints: requests products (evidence: `src/NexusRetail.WebMvc/Controllers/HomeController.cs`)
- Product actions → Product endpoints: requests details (evidence: `src/NexusRetail.WebMvc/Controllers/ProductsController.cs`)
- Product actions → Product partials: renders partials (evidence: `src/NexusRetail.WebMvc/Controllers/ProductsController.cs`)
- Brand selector → Brand view: renders
- Brand endpoints → Retail context: uses context (evidence: `src/NexusRetail.Core.Api/Controllers/NhanHieuController.cs`)
- Product endpoints → Retail context: queries and saves (evidence: `src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`)
- Product endpoints → Product DTO: projects results (evidence: `src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`)
- Product endpoints → Paged result: returns pages (evidence: `src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`)
- Product endpoints → Product input DTOs: accepts input (evidence: `src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`)
- Product endpoints → Product entity: creates and updates (evidence: `src/NexusRetail.Core.Api/Controllers/SanPhamController.cs`)
- Catalogue pages → Product DTO: deserializes (evidence: `src/NexusRetail.WebMvc/Controllers/HomeController.cs`)
- Catalogue pages → Paged result: deserializes (evidence: `src/NexusRetail.WebMvc/Controllers/HomeController.cs`)
- Product actions → Product DTO: deserializes (evidence: `src/NexusRetail.WebMvc/Controllers/ProductsController.cs`)
- Product actions → Paged result: deserializes (evidence: `src/NexusRetail.WebMvc/Controllers/ProductsController.cs`)
- Retail context → Product entity: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Product views: maps view (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Sales invoice view: maps view (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Sales invoices: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Sales lines: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Purchase invoices: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Purchase lines: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Customers: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Suppliers: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Staff and region: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Regions: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Product classifications: maps entities (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Recommendation logs: maps entity (evidence: `src/NexusRetail.Core.Api/Data/RetailDbContext.cs`)
- Retail context → Retail database: persists data
- Sales invoices → Sales lines: has lines (evidence: `src/NexusRetail.Shared/Entities/HoaDonBan.cs`)
- Sales lines → Product entity: references (evidence: `src/NexusRetail.Shared/Entities/ChiTietHdb.cs`)
- Sales invoices → Customers: references (evidence: `src/NexusRetail.Shared/Entities/HoaDonBan.cs`)
- Sales invoices → Staff and region: references (evidence: `src/NexusRetail.Shared/Entities/HoaDonBan.cs`)
- Purchase invoices → Purchase lines: has lines (evidence: `src/NexusRetail.Shared/Entities/HoaDonNhap.cs`)
- Purchase lines → Product entity: references (evidence: `src/NexusRetail.Shared/Entities/ChiTietHdn.cs`)
- Purchase invoices → Suppliers: references (evidence: `src/NexusRetail.Shared/Entities/HoaDonNhap.cs`)
- Purchase invoices → Staff and region: references (evidence: `src/NexusRetail.Shared/Entities/HoaDonNhap.cs`)
- Staff and region → Regions: references (evidence: `src/NexusRetail.Shared/Entities/NhanVien.cs`)
- Product entity → Product classifications: references (evidence: `src/NexusRetail.Shared/Entities/SanPham.cs`)
- Recommendation logs → Product entity: references suggestion (evidence: `src/NexusRetail.Shared/Entities/ChatbotTuVanLog.cs`)
