# yorn-samnang/e-shop architecture

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

## Overview

This repository is a full-stack commerce system: a customer storefront and staff dashboard use a Django backend for accounts, catalog, banners, cart, and orders. The main customer journey spans browsing products, managing a cart, and placing and reviewing orders; staff separately manage products, banners, orders, and users. Sampled sources show selected API calls and the admin image-upload authorization flow. Several listed capabilities were not sampled, so their detailed runtime connections are not asserted here.

Main entry points: [`AdminDashboard/src/app/api/blob/route.ts`](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/api/blob/route.ts) (Upload Endpoint), [`AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx`](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx) (Product Editor), [`AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx`](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx) (Banner Editor), [`Backend/src/products/views.py`](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/products/views.py) (Products API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer Storefront"]
  node_storefront["Storefront Pages<br/>[page.tsx]"]
  node_product_browse["Product Browsing<br/>[page.tsx]"]
  node_product_detail["Product Detail<br/>[page.tsx]"]
  node_cart["Cart<br/>[page.tsx]"]
  node_auth_pages["Sign In &amp; Register<br/>[page.tsx]"]
  node_auth_context["Authentication State<br/>[AuthContext.tsx]"]
  node_orders["Order History<br/>[page.tsx]"]
  node_order_hook["Order Operations<br/>[useOrders.ts]"]
end

subgraph group_admin["Staff Dashboard"]
  node_admin_products["Product Management<br/>[page.tsx]"]
  node_admin_product_form["Product Editor"]
  node_admin_product_detail["Product Details<br/>[page.tsx]"]
  node_admin_banners["Banner Management<br/>[page.tsx]"]
  node_admin_banner_form["Banner Editor"]
  node_admin_dashboard["Sales Dashboard<br/>[page.tsx]"]
  node_admin_orders["Order Management<br/>[page.tsx]"]
  node_admin_users["User Management<br/>[page.tsx]"]
  node_admin_client["Admin API Client<br/>[axios.ts]"]
  node_product_image_upload["Product Image Upload"]
  node_banner_image_upload["Banner Image Upload"]
end

subgraph group_backend["Commerce Backend"]
  node_backend_accounts["Accounts API<br/>[views.py]"]
  node_account_serializers["Account Serialization<br/>[serializers.py]"]
  node_backend_products["Products API<br/>[views.py]"]
  node_backend_banners["Banners API<br/>[views.py]"]
  node_backend_cart["Cart API<br/>[views.py]"]
  node_backend_orders["Orders API<br/>[views.py]"]
  node_django_auth["Staff Profile Check<br/>[views.py]"]
end

subgraph group_media["Image Upload"]
  node_image_route["Upload Endpoint<br/>[route.ts]"]
end

node_shopper(("Customer"))
node_blob_service[("Vercel Blob")]

node_shopper -.->|"browses"| node_storefront
node_order_hook -->|"checks authentication"| node_auth_context
node_order_hook -->|"requests orders"| node_backend_orders
node_admin_products -->|"opens editor"| node_admin_product_form
node_admin_products -->|"deletes products"| node_backend_products
node_admin_product_detail -->|"loads product"| node_backend_products
node_admin_banners -->|"opens editor"| node_admin_banner_form
node_admin_banner_form -->|"creates banner"| node_backend_banners
node_admin_product_form -->|"creates product"| node_backend_products
node_backend_accounts -->|"serializes accounts"| node_account_serializers
node_admin_product_form -.->|"uploads image"| node_image_route
node_admin_banner_form -.->|"uploads image"| node_image_route
node_image_route -->|"validates staff"| node_django_auth
node_image_route -->|"stores image"| node_blob_service

click node_storefront "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/page.tsx"
click node_product_browse "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/products/page.tsx"
click node_product_detail "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/products/%5Bid%5D/page.tsx"
click node_cart "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/cart/page.tsx"
click node_auth_pages "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/auth/login/page.tsx"
click node_auth_context "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/context/AuthContext.tsx"
click node_orders "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/orders/page.tsx"
click node_order_hook "https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/hooks/useOrders.ts"
click node_admin_products "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/page.tsx"
click node_admin_product_form "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx"
click node_admin_product_detail "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/%5Bid%5D/page.tsx"
click node_admin_banners "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/page.tsx"
click node_admin_banner_form "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx"
click node_admin_dashboard "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/dashboard/page.tsx"
click node_admin_orders "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/orders/page.tsx"
click node_admin_users "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/users/page.tsx"
click node_backend_accounts "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/accounts/views.py"
click node_account_serializers "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/accounts/serializers.py"
click node_backend_products "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/products/views.py"
click node_backend_banners "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/banners/views.py"
click node_backend_cart "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/cart/views.py"
click node_backend_orders "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/orders/views.py"
click node_admin_client "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/lib/axios.ts"
click node_image_route "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/api/blob/route.ts"
click node_product_image_upload "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx"
click node_banner_image_upload "https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx"
click node_django_auth "https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/accounts/views.py"

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_product_browse,node_product_detail,node_cart,node_auth_pages,node_auth_context,node_orders,node_order_hook toneBlue
class node_admin_products,node_admin_product_form,node_admin_product_detail,node_admin_banners,node_admin_banner_form,node_admin_dashboard,node_admin_orders,node_admin_users,node_admin_client,node_product_image_upload,node_banner_image_upload,node_blob_service toneAmber
class node_backend_accounts,node_account_serializers,node_backend_products,node_backend_banners,node_backend_cart,node_backend_orders,node_django_auth toneMint
class node_image_route toneRose
class node_shopper toneIndigo
```

## Components

### Customer Storefront

- [Storefront Pages](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/page.tsx): `Ecommerce/src/app/page.tsx`
- [Product Browsing](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/products/page.tsx): `Ecommerce/src/app/products/page.tsx`
- [Product Detail](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/products/%5Bid%5D/page.tsx): `Ecommerce/src/app/products/[id]/page.tsx`
- [Cart](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/cart/page.tsx): `Ecommerce/src/app/cart/page.tsx`
- [Sign In & Register](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/auth/login/page.tsx): `Ecommerce/src/app/auth/login/page.tsx`
- [Authentication State](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/context/AuthContext.tsx): `Ecommerce/src/context/AuthContext.tsx`
- [Order History](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/app/orders/page.tsx): `Ecommerce/src/app/orders/page.tsx`
- [Order Operations](https://github.com/yorn-samnang/e-shop/blob/main/Ecommerce/src/hooks/useOrders.ts): `Ecommerce/src/hooks/useOrders.ts`

### Staff Dashboard

- [Product Management](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/page.tsx): `AdminDashboard/src/app/(app)/products/page.tsx`
- [Product Editor](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx): `AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx`
- [Product Details](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/%5Bid%5D/page.tsx): `AdminDashboard/src/app/(app)/products/[id]/page.tsx`
- [Banner Management](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/page.tsx): `AdminDashboard/src/app/(app)/banners/page.tsx`
- [Banner Editor](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx): `AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx`
- [Sales Dashboard](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/dashboard/page.tsx): `AdminDashboard/src/app/(app)/dashboard/page.tsx`
- [Order Management](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/orders/page.tsx): `AdminDashboard/src/app/(app)/orders/page.tsx`
- [User Management](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/users/page.tsx): `AdminDashboard/src/app/(app)/users/page.tsx`
- [Admin API Client](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/lib/axios.ts): `AdminDashboard/src/lib/axios.ts`
- [Product Image Upload](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx): `AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx`
- [Banner Image Upload](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx): `AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx`

### Commerce Backend

- [Accounts API](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/accounts/views.py): `Backend/src/accounts/views.py`
- [Account Serialization](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/accounts/serializers.py): `Backend/src/accounts/serializers.py`
- [Products API](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/products/views.py): `Backend/src/products/views.py`
- [Banners API](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/banners/views.py): `Backend/src/banners/views.py`
- [Cart API](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/cart/views.py): `Backend/src/cart/views.py`
- [Orders API](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/orders/views.py): `Backend/src/orders/views.py`
- [Staff Profile Check](https://github.com/yorn-samnang/e-shop/blob/main/Backend/src/accounts/views.py): `Backend/src/accounts/views.py`

### Image Upload

- [Upload Endpoint](https://github.com/yorn-samnang/e-shop/blob/main/AdminDashboard/src/app/api/blob/route.ts): `AdminDashboard/src/app/api/blob/route.ts`

### Other components

- **Customer**
- **Vercel Blob**

## Connections

- Customer → Storefront Pages: browses
- Order Operations → Authentication State: checks authentication (evidence: `Ecommerce/src/hooks/useOrders.ts`)
- Order Operations → Orders API: requests orders (evidence: `Ecommerce/src/hooks/useOrders.ts`)
- Product Management → Product Editor: opens editor (evidence: `AdminDashboard/src/app/(app)/products/page.tsx`)
- Product Management → Products API: deletes products (evidence: `AdminDashboard/src/app/(app)/products/page.tsx`)
- Product Details → Products API: loads product (evidence: `AdminDashboard/src/app/(app)/products/[id]/page.tsx`)
- Banner Management → Banner Editor: opens editor (evidence: `AdminDashboard/src/app/(app)/banners/page.tsx`)
- Banner Editor → Banners API: creates banner (evidence: `AdminDashboard/src/app/(app)/banners/components/AddBannerDialog.tsx`)
- Product Editor → Products API: creates product (evidence: `AdminDashboard/src/app/(app)/products/components/AddProductDialog.tsx`)
- Accounts API → Account Serialization: serializes accounts (evidence: `Backend/src/accounts/views.py`)
- Product Editor → Upload Endpoint: uploads image
- Banner Editor → Upload Endpoint: uploads image
- Upload Endpoint → Staff Profile Check: validates staff (evidence: `AdminDashboard/src/app/api/blob/route.ts`)
- Upload Endpoint → Vercel Blob: stores image (evidence: `AdminDashboard/src/app/api/blob/route.ts`)
