# vedantgonbare/ecommerce-platform architecture

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

- Interactive diagram: https://gitdiagram.com/vedantgonbare/ecommerce-platform
- Repository: https://github.com/vedantgonbare/ecommerce-platform

## Overview

This is a full-stack e-commerce platform: shoppers browse products, manage a persistent cart, place orders, complete checkout, and view order outcomes; accounts and reviews support that journey. The React UI calls a modular FastAPI backend, whose domain services use PostgreSQL, Redis caching, Stripe, and Celery. The graph preserves the documented categories, search, reviews, and background-job capabilities. Some subsystem links rely on README statements or the SOURCE INDEX because their implementation files were not excerpted.

Main entry points: [`backend/app/main.py`](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/modules/orders/service.py`](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/orders/service.py) (Orders), [`backend/app/modules/auth/router.py`](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/router.py) (Auth routes), [`backend/app/modules/products/service.py`](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/products/service.py) (Product catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Shopper interface"]
  node_webapp["React application<br/>[App.jsx]"]
  node_shopper_pages["Shopper pages"]
  node_auth_context["Auth context<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[client.js]"]
end

subgraph group_identity["Identity"]
  node_auth_routes["Auth routes<br/>[router.py]"]
  node_auth_service["Auth service<br/>[service.py]"]
  node_auth_security["JWT security<br/>[security.py]"]
  node_revocation["Token revocation"]
  node_users[("User records<br/>[models.py]")]
end

subgraph group_catalog["Catalog"]
  node_product_routes["Product routes<br/>[router.py]"]
  node_product_service["Product catalog<br/>[service.py]"]
  node_categories["Categories"]
end

subgraph group_commerce["Commerce"]
  node_cart["Cart<br/>[service.py]"]
  node_orders["Orders<br/>[service.py]"]
  node_payments["Payments<br/>[service.py]"]
  node_reviews["Reviews"]
end

subgraph group_platform["Runtime services"]
  node_api["FastAPI application<br/>[main.py]"]
  node_postgres[("PostgreSQL<br/>[session.py]")]
  node_redis[("Redis cache<br/>[redis.py]")]
  node_celery["Celery jobs<br/>[celery_app.py]"]
end

node_shopper(("Shopper"))
node_stripe["Stripe"]

node_shopper -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_shopper_pages
node_webapp -->|"reads session"| node_auth_context
node_auth_context -->|"requests user"| node_api_client
node_shopper_pages -->|"requests data"| node_api_client
node_api_client -->|"calls API"| node_api
node_api -->|"registers"| node_auth_routes
node_api -->|"registers"| node_product_routes
node_api -->|"registers routes"| node_categories
node_api -->|"registers routes"| node_cart
node_api -->|"registers routes"| node_orders
node_api -->|"registers routes"| node_payments
node_api -->|"registers routes"| node_reviews
node_auth_routes -->|"calls"| node_auth_service
node_auth_routes -->|"creates tokens"| node_auth_security
node_auth_routes -->|"checks or revokes"| node_revocation
node_auth_service -->|"creates or authenticates"| node_users
node_auth_routes -->|"loads current user"| node_users
node_product_routes -->|"calls"| node_product_service
node_product_service -->|"checks category"| node_categories
node_product_service -->|"invalidates cache"| node_redis
node_cart -->|"checks products"| node_product_service
node_orders -->|"loads cart"| node_cart
node_payments -->|"uses order service"| node_orders
node_orders -->|"dispatches confirmation"| node_celery
node_payments -->|"creates checkout"| node_stripe
node_stripe -->|"notifies webhook"| node_payments
node_api -->|"provides sessions"| node_postgres
node_product_service -->|"reads and writes"| node_postgres
node_cart -->|"reads and writes"| node_postgres
node_orders -->|"locks and persists"| node_postgres
node_reviews -->|"verifies purchase"| node_orders
node_celery -.->|"runs confirmation task"| node_orders

click node_webapp "https://github.com/vedantgonbare/ecommerce-platform/blob/main/frontend/src/App.jsx"
click node_shopper_pages "https://github.com/vedantgonbare/ecommerce-platform/tree/main/frontend/src/pages"
click node_auth_context "https://github.com/vedantgonbare/ecommerce-platform/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/vedantgonbare/ecommerce-platform/blob/main/frontend/src/api/client.js"
click node_api "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/router.py"
click node_auth_service "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/service.py"
click node_auth_security "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/security.py"
click node_revocation "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/token_revocation.py"
click node_users "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/users/models.py"
click node_product_routes "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/products/router.py"
click node_product_service "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/products/service.py"
click node_categories "https://github.com/vedantgonbare/ecommerce-platform/tree/main/backend/app/modules/categories"
click node_cart "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/cart/service.py"
click node_orders "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/orders/service.py"
click node_payments "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/payments/service.py"
click node_reviews "https://github.com/vedantgonbare/ecommerce-platform/tree/main/backend/app/modules/reviews"
click node_postgres "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/db/session.py"
click node_redis "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/core/redis.py"
click node_celery "https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/core/celery_app.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_webapp,node_shopper_pages,node_auth_context,node_api_client toneBlue
class node_auth_routes,node_auth_service,node_auth_security,node_revocation,node_users toneAmber
class node_product_routes,node_product_service,node_categories toneMint
class node_cart,node_orders,node_payments,node_reviews toneRose
class node_api,node_postgres,node_redis,node_celery,node_shopper,node_stripe toneIndigo
```

## Components

### Shopper interface

- [React application](https://github.com/vedantgonbare/ecommerce-platform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Shopper pages](https://github.com/vedantgonbare/ecommerce-platform/tree/main/frontend/src/pages): `frontend/src/pages`
- [Auth context](https://github.com/vedantgonbare/ecommerce-platform/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/vedantgonbare/ecommerce-platform/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Identity

- [Auth routes](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/router.py): `backend/app/modules/auth/router.py`
- [Auth service](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/service.py): `backend/app/modules/auth/service.py`
- [JWT security](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/security.py): `backend/app/modules/auth/security.py`
- [Token revocation](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/auth/token_revocation.py): `backend/app/modules/auth/token_revocation.py`
- [User records](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/users/models.py): `backend/app/modules/users/models.py`

### Catalog

- [Product routes](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/products/router.py): `backend/app/modules/products/router.py`
- [Product catalog](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/products/service.py): `backend/app/modules/products/service.py`
- [Categories](https://github.com/vedantgonbare/ecommerce-platform/tree/main/backend/app/modules/categories): `backend/app/modules/categories`

### Commerce

- [Cart](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/cart/service.py): `backend/app/modules/cart/service.py`
- [Orders](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/orders/service.py): `backend/app/modules/orders/service.py`
- [Payments](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/modules/payments/service.py): `backend/app/modules/payments/service.py`
- [Reviews](https://github.com/vedantgonbare/ecommerce-platform/tree/main/backend/app/modules/reviews): `backend/app/modules/reviews`

### Runtime services

- [FastAPI application](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/main.py): `backend/app/main.py`
- [PostgreSQL](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- [Redis cache](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/core/redis.py): `backend/app/core/redis.py`
- [Celery jobs](https://github.com/vedantgonbare/ecommerce-platform/blob/main/backend/app/core/celery_app.py): `backend/app/core/celery_app.py`

### Other components

- **Shopper**
- **Stripe**

## Connections

- Shopper → React application: uses (evidence: `README.md`)
- React application → Shopper pages: routes to (evidence: `frontend/src/App.jsx`)
- React application → Auth context: reads session (evidence: `frontend/src/App.jsx`)
- Auth context → API client: requests user (evidence: `frontend/src/context/AuthContext.jsx`)
- Shopper pages → API client: requests data (evidence: `frontend/src/pages/Cart.jsx`)
- API client → FastAPI application: calls API (evidence: `README.md`)
- FastAPI application → Auth routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Product routes: registers (evidence: `backend/app/main.py`)
- FastAPI application → Categories: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Cart: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Orders: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Payments: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Reviews: registers routes (evidence: `backend/app/main.py`)
- Auth routes → Auth service: calls (evidence: `backend/app/modules/auth/router.py`)
- Auth routes → JWT security: creates tokens (evidence: `backend/app/modules/auth/router.py`)
- Auth routes → Token revocation: checks or revokes (evidence: `backend/app/modules/auth/router.py`)
- Auth service → User records: creates or authenticates (evidence: `backend/app/modules/auth/service.py`)
- Auth routes → User records: loads current user (evidence: `backend/app/modules/auth/router.py`)
- Product routes → Product catalog: calls (evidence: `backend/app/modules/products/router.py`)
- Product catalog → Categories: checks category (evidence: `backend/app/modules/products/service.py`)
- Product catalog → Redis cache: invalidates cache (evidence: `backend/app/modules/products/service.py`)
- Cart → Product catalog: checks products (evidence: `backend/app/modules/cart/service.py`)
- Orders → Cart: loads cart (evidence: `backend/app/modules/orders/service.py`)
- Payments → Orders: uses order service (evidence: `backend/app/modules/payments/service.py`)
- Orders → Celery jobs: dispatches confirmation (evidence: `backend/app/modules/orders/service.py`)
- Payments → Stripe: creates checkout (evidence: `README.md`)
- Stripe → Payments: notifies webhook (evidence: `README.md`)
- FastAPI application → PostgreSQL: provides sessions (evidence: `backend/app/main.py`)
- Product catalog → PostgreSQL: reads and writes (evidence: `backend/app/modules/products/service.py`)
- Cart → PostgreSQL: reads and writes (evidence: `backend/app/modules/cart/service.py`)
- Orders → PostgreSQL: locks and persists (evidence: `backend/app/modules/orders/service.py`)
- Reviews → Orders: verifies purchase (evidence: `README.md`)
- Celery jobs → Orders: runs confirmation task (evidence: `README.md`)
