# minhdeptraiso1/shopgiay architecture

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

- Interactive diagram: https://gitdiagram.com/minhdeptraiso1/shopgiay
- Repository: https://github.com/minhdeptraiso1/shopgiay

## Overview

This is a Django API and Vue storefront for sneaker commerce, with customer accounts, product discovery, cart and checkout, order management, engagement, and exchanges. The customer path runs from storefront browsing through cart and order placement to order follow-up; administrators also manage catalog, inventory, orders, recommendations, and engagement. The graph includes documented backend domain stages and sampled frontend auth/HTTP layers. README content was empty, and several API views and frontend pages were not sampled, so uncertain endpoint wiring is omitted.

Main entry points: [`Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts`](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts) (Auth flows), [`Base_Dijango_vue_js/Base_dijango/apps/orders/services.py`](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/services.py) (Cart and checkout), [`Base_Dijango_vue_js/frontend/src/lib/http/client.ts`](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/lib/http/client.ts) (HTTP clients), [`Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py`](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py) (Customer engagement)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Vue storefront"]
  node_app["Storefront app<br/>[App.vue]"]
  node_auth_ui["Auth flows<br/>[useAuth.ts]"]
  node_auth_state["Auth state<br/>[auth.ts]"]
  node_auth_refresh["Session refresh<br/>[refresh.ts]"]
  node_http["HTTP clients<br/>[client.ts]"]
  node_catalog_ui["Product browsing<br/>[ProductsPage.vue]"]
  node_cart_ui["Cart<br/>[cart.ts]"]
  node_orders_ui["Order experience<br/>[OrdersPage.vue]"]
end

subgraph group_identity["Accounts"]
  node_accounts_api["Account API<br/>[views.py]"]
  node_account_services["Account services<br/>[services.py]"]
  node_user_models[("Users and addresses<br/>[models.py]")]
  node_user_manager["User creation<br/>[managers.py]"]
end

subgraph group_commerce["Catalog and orders"]
  node_catalog_api["Catalog API<br/>[views.py]"]
  node_catalog_services["Catalog operations<br/>[services.py]"]
  node_catalog_models[("Products and stock<br/>[models.py]")]
  node_order_api["Order API<br/>[views.py]"]
  node_order_services["Cart and checkout<br/>[services.py]"]
  node_order_models[("Carts and orders<br/>[models.py]")]
end

subgraph group_customer["Engagement and exchanges"]
  node_engagement_services["Customer engagement<br/>[services.py]"]
  node_engagement_models[("Engagement records<br/>[models.py]")]
  node_exchange_services["Exchange workflow<br/>[services.py]"]
  node_exchange_models[("Exchange records<br/>[models.py]")]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))

node_shopper -.->|"uses"| node_app
node_admin -.->|"uses"| node_app
node_app -.->|"hosts"| node_auth_ui
node_auth_ui -->|"updates"| node_auth_state
node_auth_ui -->|"refreshes session"| node_auth_refresh
node_auth_refresh -->|"updates"| node_auth_state
node_auth_ui -.->|"sends requests"| node_http
node_catalog_ui -.->|"sends requests"| node_http
node_cart_ui -.->|"sends requests"| node_http
node_orders_ui -.->|"sends requests"| node_http
node_http -->|"refreshes on 401"| node_auth_refresh
node_auth_ui -.->|"calls API"| node_accounts_api
node_catalog_ui -.->|"calls API"| node_catalog_api
node_cart_ui -.->|"calls API"| node_order_api
node_orders_ui -.->|"calls API"| node_order_api
node_accounts_api -.->|"delegates to"| node_account_services
node_account_services -->|"updates"| node_user_models
node_user_manager -->|"creates users"| node_user_models
node_catalog_api -.->|"delegates to"| node_catalog_services
node_catalog_services -->|"updates"| node_catalog_models
node_order_api -.->|"delegates to"| node_order_services
node_order_services -->|"updates"| node_order_models
node_order_services -->|"checks stock"| node_catalog_models
node_order_services -->|"checks address"| node_user_models
node_engagement_services -->|"records activity"| node_engagement_models
node_engagement_services -->|"references products"| node_catalog_models
node_engagement_services -->|"checks eligibility"| node_order_models
node_order_services -->|"uses voucher services"| node_engagement_services
node_exchange_services -->|"updates"| node_exchange_models
node_exchange_services -->|"checks order"| node_order_models
node_exchange_services -->|"reserves stock"| node_catalog_models

click node_app "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/app/App.vue"
click node_auth_ui "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts"
click node_auth_state "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/stores/auth.ts"
click node_auth_refresh "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/composables/refresh.ts"
click node_http "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/lib/http/client.ts"
click node_catalog_ui "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/catalog/pages/ProductsPage.vue"
click node_cart_ui "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/cart/stores/cart.ts"
click node_orders_ui "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/orders/pages/OrdersPage.vue"
click node_accounts_api "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/api/views.py"
click node_account_services "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/services.py"
click node_user_models "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/models.py"
click node_user_manager "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/managers.py"
click node_catalog_api "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/catalog/api/views.py"
click node_catalog_services "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/catalog/services.py"
click node_catalog_models "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/catalog/models.py"
click node_order_api "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/api/views.py"
click node_order_services "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/services.py"
click node_order_models "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/models.py"
click node_engagement_services "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py"
click node_engagement_models "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/engagement/models.py"
click node_exchange_services "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/exchanges/services.py"
click node_exchange_models "https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/exchanges/models.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_app,node_auth_ui,node_auth_state,node_auth_refresh,node_http,node_catalog_ui,node_cart_ui,node_orders_ui toneBlue
class node_accounts_api,node_account_services,node_user_models,node_user_manager toneAmber
class node_catalog_api,node_catalog_services,node_catalog_models,node_order_api,node_order_services,node_order_models toneMint
class node_engagement_services,node_engagement_models,node_exchange_services,node_exchange_models toneRose
class node_shopper,node_admin toneIndigo
```

## Components

### Vue storefront

- [Storefront app](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/app/App.vue): `Base_Dijango_vue_js/frontend/src/app/App.vue`
- [Auth flows](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts): `Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts`
- [Auth state](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/stores/auth.ts): `Base_Dijango_vue_js/frontend/src/modules/auth/stores/auth.ts`
- [Session refresh](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/auth/composables/refresh.ts): `Base_Dijango_vue_js/frontend/src/modules/auth/composables/refresh.ts`
- [HTTP clients](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/lib/http/client.ts): `Base_Dijango_vue_js/frontend/src/lib/http/client.ts`
- [Product browsing](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/catalog/pages/ProductsPage.vue): `Base_Dijango_vue_js/frontend/src/modules/catalog/pages/ProductsPage.vue`
- [Cart](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/cart/stores/cart.ts): `Base_Dijango_vue_js/frontend/src/modules/cart/stores/cart.ts`
- [Order experience](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/frontend/src/modules/orders/pages/OrdersPage.vue): `Base_Dijango_vue_js/frontend/src/modules/orders/pages/OrdersPage.vue`

### Accounts

- [Account API](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/api/views.py): `Base_Dijango_vue_js/Base_dijango/apps/accounts/api/views.py`
- [Account services](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/services.py): `Base_Dijango_vue_js/Base_dijango/apps/accounts/services.py`
- [Users and addresses](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/models.py): `Base_Dijango_vue_js/Base_dijango/apps/accounts/models.py`
- [User creation](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/accounts/managers.py): `Base_Dijango_vue_js/Base_dijango/apps/accounts/managers.py`

### Catalog and orders

- [Catalog API](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/catalog/api/views.py): `Base_Dijango_vue_js/Base_dijango/apps/catalog/api/views.py`
- [Catalog operations](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/catalog/services.py): `Base_Dijango_vue_js/Base_dijango/apps/catalog/services.py`
- [Products and stock](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/catalog/models.py): `Base_Dijango_vue_js/Base_dijango/apps/catalog/models.py`
- [Order API](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/api/views.py): `Base_Dijango_vue_js/Base_dijango/apps/orders/api/views.py`
- [Cart and checkout](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/services.py): `Base_Dijango_vue_js/Base_dijango/apps/orders/services.py`
- [Carts and orders](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/orders/models.py): `Base_Dijango_vue_js/Base_dijango/apps/orders/models.py`

### Engagement and exchanges

- [Customer engagement](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py): `Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py`
- [Engagement records](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/engagement/models.py): `Base_Dijango_vue_js/Base_dijango/apps/engagement/models.py`
- [Exchange workflow](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/exchanges/services.py): `Base_Dijango_vue_js/Base_dijango/apps/exchanges/services.py`
- [Exchange records](https://github.com/minhdeptraiso1/shopgiay/blob/dev/Base_Dijango_vue_js/Base_dijango/apps/exchanges/models.py): `Base_Dijango_vue_js/Base_dijango/apps/exchanges/models.py`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Storefront app: uses
- Administrator → Storefront app: uses
- Storefront app → Auth flows: hosts
- Auth flows → Auth state: updates (evidence: `Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts`)
- Auth flows → Session refresh: refreshes session (evidence: `Base_Dijango_vue_js/frontend/src/modules/auth/composables/useAuth.ts`)
- Session refresh → Auth state: updates (evidence: `Base_Dijango_vue_js/frontend/src/modules/auth/composables/refresh.ts`)
- Auth flows → HTTP clients: sends requests
- Product browsing → HTTP clients: sends requests
- Cart → HTTP clients: sends requests
- Order experience → HTTP clients: sends requests
- HTTP clients → Session refresh: refreshes on 401 (evidence: `Base_Dijango_vue_js/frontend/src/lib/http/client.ts`)
- Auth flows → Account API: calls API
- Product browsing → Catalog API: calls API
- Cart → Order API: calls API
- Order experience → Order API: calls API
- Account API → Account services: delegates to
- Account services → Users and addresses: updates (evidence: `Base_Dijango_vue_js/Base_dijango/apps/accounts/services.py`)
- User creation → Users and addresses: creates users (evidence: `Base_Dijango_vue_js/Base_dijango/apps/accounts/managers.py`)
- Catalog API → Catalog operations: delegates to
- Catalog operations → Products and stock: updates (evidence: `Base_Dijango_vue_js/Base_dijango/apps/catalog/services.py`)
- Order API → Cart and checkout: delegates to
- Cart and checkout → Carts and orders: updates (evidence: `Base_Dijango_vue_js/Base_dijango/apps/orders/services.py`)
- Cart and checkout → Products and stock: checks stock (evidence: `Base_Dijango_vue_js/Base_dijango/apps/orders/services.py`)
- Cart and checkout → Users and addresses: checks address (evidence: `Base_Dijango_vue_js/Base_dijango/apps/orders/services.py`)
- Customer engagement → Engagement records: records activity (evidence: `Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py`)
- Customer engagement → Products and stock: references products (evidence: `Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py`)
- Customer engagement → Carts and orders: checks eligibility (evidence: `Base_Dijango_vue_js/Base_dijango/apps/engagement/services.py`)
- Cart and checkout → Customer engagement: uses voucher services (evidence: `Base_Dijango_vue_js/Base_dijango/apps/orders/services.py`)
- Exchange workflow → Exchange records: updates (evidence: `Base_Dijango_vue_js/Base_dijango/apps/exchanges/services.py`)
- Exchange workflow → Carts and orders: checks order (evidence: `Base_Dijango_vue_js/Base_dijango/apps/exchanges/services.py`)
- Exchange workflow → Products and stock: reserves stock (evidence: `Base_Dijango_vue_js/Base_dijango/apps/exchanges/services.py`)
