# emredmir/e-commerce architecture

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

- Interactive diagram: https://gitdiagram.com/emredmir/e-commerce
- Repository: https://github.com/emredmir/e-commerce

## Overview

This is a Django multi-vendor marketplace. Customers and sellers enter through Django routes and views: customers browse a shared catalog, build a cart, check out, and manage orders; sellers onboard, create stores and offers, and handle fulfillment. The architecture separates HTTP views from domain services and ORM-backed state. The graph preserves the documented catalog, seller, cart, order, payment, and shipping capabilities. Some service internals were not sampled, so uncertain links are omitted; README-level architecture relationships are cited to the README.

Main entry points: [`orders/views.py`](https://github.com/emredmir/e-commerce/blob/main/orders/views.py) (Checkout and order views), [`ecommerce_project/urls.py`](https://github.com/emredmir/e-commerce/blob/main/ecommerce_project/urls.py) (Django routes), [`orders/models.py`](https://github.com/emredmir/e-commerce/blob/main/orders/models.py) (Orders and payments), [`products/models.py`](https://github.com/emredmir/e-commerce/blob/main/products/models.py) (Catalog and offers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP and identity"]
  node_routes["Django routes<br/>[urls.py]"]
  node_account_views["Account views<br/>[views.py]"]
  node_identity[("Identity and addresses<br/>[models.py]")]
end

subgraph group_market["Marketplace catalog"]
  node_product_views["Catalog views<br/>[storefront.py]"]
  node_catalog_state[("Catalog and offers<br/>[models.py]")]
  node_catalog_services["Catalog services"]
  node_draft_review["Draft review<br/>[review_page.py]"]
  node_draft_publish["Draft publishing<br/>[publish.py]"]
  node_background_task["Image task<br/>[tasks.py]"]
end

subgraph group_checkout["Cart and orders"]
  node_cart_views["Cart views<br/>[cart.py]"]
  node_cart_service["Cart service<br/>[cart.py]"]
  node_cart_state[("Cart state<br/>[models.py]")]
  node_order_views["Checkout and order views<br/>[views.py]"]
  node_order_service["Order service<br/>[order.py]"]
  node_reservation["Stock reservations"]
  node_order_state[("Orders and payments<br/>[models.py]")]
  node_payment_service["Payment service<br/>[payment.py]"]
  node_card_storage["Stored cards<br/>[card_storage.py]"]
  node_shipping_service["Shipping and invoices<br/>[shipping.py]"]
end

subgraph group_seller["Seller operations"]
  node_store_views["Store views<br/>[views.py]"]
  node_store_state[("Store state<br/>[models.py]")]
  node_seller_approval["Seller approval"]
  node_submerchant["Submerchant onboarding"]
end

node_customer(("Customer"))
node_seller_actor(("Seller"))
node_database[("SQL Server")]
node_iyzico["iyzico"]
node_celery["Celery"]

node_customer -->|"requests"| node_routes
node_seller_actor -->|"requests"| node_routes
node_routes -->|"routes to"| node_account_views
node_routes -->|"routes to"| node_product_views
node_routes -->|"routes to"| node_cart_views
node_routes -->|"routes to"| node_order_views
node_routes -->|"routes to"| node_store_views
node_account_views -->|"manages"| node_identity
node_store_views -->|"manages"| node_store_state
node_product_views -->|"uses"| node_catalog_services
node_catalog_services -->|"reads offers"| node_catalog_state
node_draft_review -->|"reads draft data"| node_catalog_state
node_draft_review -->|"checks matches"| node_catalog_services
node_draft_publish -->|"publishes to"| node_catalog_state
node_draft_publish -->|"queues images"| node_background_task
node_background_task -->|"copies images"| node_draft_publish
node_cart_views -->|"calls"| node_cart_service
node_cart_service -->|"reads and writes"| node_cart_state
node_cart_views -->|"reads offers"| node_catalog_services
node_order_views -->|"calls"| node_cart_service
node_order_views -->|"calls"| node_order_service
node_order_views -->|"calls"| node_reservation
node_order_views -->|"calls"| node_payment_service
node_order_views -->|"calls"| node_card_storage
node_order_views -->|"calls"| node_shipping_service
node_order_service -->|"creates orders"| node_order_state
node_reservation -->|"tracks reservations"| node_order_state
node_payment_service -->|"processes payments"| node_iyzico
node_payment_service -->|"tracks transactions"| node_order_state
node_card_storage -->|"manages stored cards"| node_iyzico
node_card_storage -->|"records operations"| node_order_state
node_shipping_service -->|"updates fulfillment"| node_order_state
node_seller_approval -->|"starts onboarding"| node_submerchant
node_submerchant -->|"registers seller"| node_iyzico
node_identity -->|"persists via ORM"| node_database
node_store_state -->|"persists via ORM"| node_database
node_catalog_state -->|"persists via ORM"| node_database
node_cart_state -->|"persists via ORM"| node_database
node_order_state -->|"persists via ORM"| node_database

click node_routes "https://github.com/emredmir/e-commerce/blob/main/ecommerce_project/urls.py"
click node_account_views "https://github.com/emredmir/e-commerce/blob/main/accounts/views.py"
click node_identity "https://github.com/emredmir/e-commerce/blob/main/accounts/models.py"
click node_store_views "https://github.com/emredmir/e-commerce/blob/main/store/views.py"
click node_store_state "https://github.com/emredmir/e-commerce/blob/main/store/models.py"
click node_product_views "https://github.com/emredmir/e-commerce/blob/main/products/views/storefront.py"
click node_catalog_state "https://github.com/emredmir/e-commerce/blob/main/products/models.py"
click node_catalog_services "https://github.com/emredmir/e-commerce/blob/main/products/services/storefront_offers.py"
click node_draft_review "https://github.com/emredmir/e-commerce/blob/main/products/services/review_page.py"
click node_draft_publish "https://github.com/emredmir/e-commerce/blob/main/products/services/publish.py"
click node_background_task "https://github.com/emredmir/e-commerce/blob/main/products/tasks.py"
click node_cart_views "https://github.com/emredmir/e-commerce/blob/main/cart/views/cart.py"
click node_cart_service "https://github.com/emredmir/e-commerce/blob/main/cart/services/cart.py"
click node_cart_state "https://github.com/emredmir/e-commerce/blob/main/cart/models.py"
click node_order_views "https://github.com/emredmir/e-commerce/blob/main/orders/views.py"
click node_order_service "https://github.com/emredmir/e-commerce/blob/main/orders/services/order.py"
click node_reservation "https://github.com/emredmir/e-commerce/blob/main/orders/services/stock_reservation.py"
click node_order_state "https://github.com/emredmir/e-commerce/blob/main/orders/models.py"
click node_payment_service "https://github.com/emredmir/e-commerce/blob/main/orders/services/payment.py"
click node_card_storage "https://github.com/emredmir/e-commerce/blob/main/orders/services/card_storage.py"
click node_shipping_service "https://github.com/emredmir/e-commerce/blob/main/orders/services/shipping.py"
click node_seller_approval "https://github.com/emredmir/e-commerce/blob/main/accounts/services/seller_approval_service.py"
click node_submerchant "https://github.com/emredmir/e-commerce/blob/main/orders/services/iyzico_submerchant.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_routes,node_account_views,node_identity toneBlue
class node_product_views,node_catalog_state,node_catalog_services,node_draft_review,node_draft_publish,node_background_task,node_database toneAmber
class node_cart_views,node_cart_service,node_cart_state,node_order_views,node_order_service,node_reservation,node_order_state,node_payment_service,node_card_storage,node_shipping_service toneMint
class node_store_views,node_store_state,node_seller_approval,node_submerchant toneRose
class node_customer,node_seller_actor,node_iyzico,node_celery toneIndigo
```

## Components

### HTTP and identity

- [Django routes](https://github.com/emredmir/e-commerce/blob/main/ecommerce_project/urls.py): `ecommerce_project/urls.py`
- [Account views](https://github.com/emredmir/e-commerce/blob/main/accounts/views.py): `accounts/views.py`
- [Identity and addresses](https://github.com/emredmir/e-commerce/blob/main/accounts/models.py): `accounts/models.py`

### Marketplace catalog

- [Catalog views](https://github.com/emredmir/e-commerce/blob/main/products/views/storefront.py): `products/views/storefront.py`
- [Catalog and offers](https://github.com/emredmir/e-commerce/blob/main/products/models.py): `products/models.py`
- [Catalog services](https://github.com/emredmir/e-commerce/blob/main/products/services/storefront_offers.py): `products/services/storefront_offers.py`
- [Draft review](https://github.com/emredmir/e-commerce/blob/main/products/services/review_page.py): `products/services/review_page.py`
- [Draft publishing](https://github.com/emredmir/e-commerce/blob/main/products/services/publish.py): `products/services/publish.py`
- [Image task](https://github.com/emredmir/e-commerce/blob/main/products/tasks.py): `products/tasks.py`

### Cart and orders

- [Cart views](https://github.com/emredmir/e-commerce/blob/main/cart/views/cart.py): `cart/views/cart.py`
- [Cart service](https://github.com/emredmir/e-commerce/blob/main/cart/services/cart.py): `cart/services/cart.py`
- [Cart state](https://github.com/emredmir/e-commerce/blob/main/cart/models.py): `cart/models.py`
- [Checkout and order views](https://github.com/emredmir/e-commerce/blob/main/orders/views.py): `orders/views.py`
- [Order service](https://github.com/emredmir/e-commerce/blob/main/orders/services/order.py): `orders/services/order.py`
- [Stock reservations](https://github.com/emredmir/e-commerce/blob/main/orders/services/stock_reservation.py): `orders/services/stock_reservation.py`
- [Orders and payments](https://github.com/emredmir/e-commerce/blob/main/orders/models.py): `orders/models.py`
- [Payment service](https://github.com/emredmir/e-commerce/blob/main/orders/services/payment.py): `orders/services/payment.py`
- [Stored cards](https://github.com/emredmir/e-commerce/blob/main/orders/services/card_storage.py): `orders/services/card_storage.py`
- [Shipping and invoices](https://github.com/emredmir/e-commerce/blob/main/orders/services/shipping.py): `orders/services/shipping.py`

### Seller operations

- [Store views](https://github.com/emredmir/e-commerce/blob/main/store/views.py): `store/views.py`
- [Store state](https://github.com/emredmir/e-commerce/blob/main/store/models.py): `store/models.py`
- [Seller approval](https://github.com/emredmir/e-commerce/blob/main/accounts/services/seller_approval_service.py): `accounts/services/seller_approval_service.py`
- [Submerchant onboarding](https://github.com/emredmir/e-commerce/blob/main/orders/services/iyzico_submerchant.py): `orders/services/iyzico_submerchant.py`

### Other components

- **Customer**
- **Seller**
- **SQL Server**
- **iyzico**
- **Celery**

## Connections

- Customer → Django routes: requests (evidence: `README.md`)
- Seller → Django routes: requests (evidence: `README.md`)
- Django routes → Account views: routes to (evidence: `README.md`)
- Django routes → Catalog views: routes to (evidence: `README.md`)
- Django routes → Cart views: routes to (evidence: `README.md`)
- Django routes → Checkout and order views: routes to (evidence: `README.md`)
- Django routes → Store views: routes to (evidence: `README.md`)
- Account views → Identity and addresses: manages (evidence: `README.md`)
- Store views → Store state: manages (evidence: `README.md`)
- Catalog views → Catalog services: uses (evidence: `README.md`)
- Catalog services → Catalog and offers: reads offers (evidence: `products/services/storefront_offers.py`)
- Draft review → Catalog and offers: reads draft data (evidence: `products/services/review_page.py`)
- Draft review → Catalog services: checks matches (evidence: `products/services/review_page.py`)
- Draft publishing → Catalog and offers: publishes to (evidence: `products/services/publish.py`)
- Draft publishing → Image task: queues images (evidence: `products/services/publish.py`)
- Image task → Draft publishing: copies images (evidence: `products/tasks.py`)
- Cart views → Cart service: calls (evidence: `cart/views/cart.py`)
- Cart service → Cart state: reads and writes (evidence: `README.md`)
- Cart views → Catalog services: reads offers (evidence: `cart/views/cart.py`)
- Checkout and order views → Cart service: calls (evidence: `orders/views.py`)
- Checkout and order views → Order service: calls (evidence: `orders/views.py`)
- Checkout and order views → Stock reservations: calls (evidence: `orders/views.py`)
- Checkout and order views → Payment service: calls (evidence: `orders/views.py`)
- Checkout and order views → Stored cards: calls (evidence: `orders/views.py`)
- Checkout and order views → Shipping and invoices: calls (evidence: `orders/views.py`)
- Order service → Orders and payments: creates orders (evidence: `README.md`)
- Stock reservations → Orders and payments: tracks reservations (evidence: `orders/services/stock_reservation.py`)
- Payment service → iyzico: processes payments (evidence: `README.md`)
- Payment service → Orders and payments: tracks transactions (evidence: `README.md`)
- Stored cards → iyzico: manages stored cards (evidence: `README.md`)
- Stored cards → Orders and payments: records operations (evidence: `orders/services/card_storage.py`)
- Shipping and invoices → Orders and payments: updates fulfillment (evidence: `README.md`)
- Seller approval → Submerchant onboarding: starts onboarding (evidence: `accounts/services/seller_approval_service.py`)
- Submerchant onboarding → iyzico: registers seller (evidence: `README.md`)
- Identity and addresses → SQL Server: persists via ORM (evidence: `README.md`)
- Store state → SQL Server: persists via ORM (evidence: `README.md`)
- Catalog and offers → SQL Server: persists via ORM (evidence: `README.md`)
- Cart state → SQL Server: persists via ORM (evidence: `README.md`)
- Orders and payments → SQL Server: persists via ORM (evidence: `README.md`)
