# abhishek10600/ecommerceapplicationapi-advancebackendlearning architecture

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

- Interactive diagram: https://gitdiagram.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning
- Repository: https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning

## Overview

This is an Express ecommerce API for account authentication, product and category discovery/management, carts, orders, and addresses. The main workflow is a client request entering the mounted API routes, reaching a domain controller and service, and using persistence for domain data; product operations additionally support Redis caching and Cloudinary image storage. The source index and excerpts establish several module relationships, but many route, container, and domain implementations were not excerpted, so uncertain links are omitted or marked unverified.

Main entry points: [`backend/src/app.ts`](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/app.ts) (Express app), [`backend/src/lib/prisma.ts`](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/lib/prisma.ts) (Prisma client), [`backend/src/modules/product/product.service.ts`](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.service.ts) (Product service), [`backend/src/modules/auth/auth.service.ts`](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.service.ts) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_app["Express app<br/>[app.ts]"]
  node_auth_routes["Auth routes<br/>[auth.route.ts]"]
  node_category_routes["Category routes<br/>[category.route.ts]"]
  node_product_routes["Product routes<br/>[product.route.ts]"]
  node_order_routes["Order routes<br/>[order.route.ts]"]
  node_address_routes["Address routes<br/>[address.route.ts]"]
  node_cart_routes["Cart routes<br/>[cart.route.ts]"]
end

subgraph group_identity["Identity"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_auth_repository["Auth repository<br/>[auth.repository.ts]"]
  node_auth_tokens["Token helpers<br/>[Jwt.helper.ts]"]
end

subgraph group_commerce["Commerce"]
  node_category["Category service"]
  node_product_controller["Product controller"]
  node_product["Product service<br/>[product.service.ts]"]
  node_cart_controller["Cart controller<br/>[cart.controller.ts]"]
  node_cart["Cart service<br/>[cart.service.ts]"]
  node_orders["Order service<br/>[order.service.ts]"]
  node_addresses["Address service<br/>[address.service.ts]"]
end

subgraph group_infra["Persistence and integrations"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_database[("PostgreSQL")]
  node_redis["Redis client<br/>[redis.ts]"]
  node_cloudinary["Cloudinary"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts auth"| node_auth_routes
node_app -->|"mounts categories"| node_category_routes
node_app -->|"mounts products"| node_product_routes
node_app -->|"mounts orders"| node_order_routes
node_app -->|"mounts addresses"| node_address_routes
node_app -->|"mounts cart"| node_cart_routes
node_auth_controller -->|"delegates via container"| node_auth_service
node_auth_service -->|"uses repository"| node_auth_repository
node_auth_service -->|"generates and verifies"| node_auth_tokens
node_auth_repository -->|"queries data"| node_prisma
node_category -->|"reads cache"| node_redis
node_product_controller -->|"calls service"| node_product
node_product -->|"caches listings"| node_redis
node_product -->|"uploads and deletes images"| node_cloudinary
node_product -.->|"persists products"| node_prisma
node_cart_controller -->|"calls service"| node_cart
node_cart -.->|"persists cart data"| node_prisma
node_orders -.->|"persists orders"| node_prisma
node_addresses -.->|"persists addresses"| node_prisma
node_prisma -->|"connects to"| node_database

click node_app "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.route.ts"
click node_category_routes "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/category/category.route.ts"
click node_product_routes "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.route.ts"
click node_order_routes "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/order/order.route.ts"
click node_address_routes "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/address/address.route.ts"
click node_cart_routes "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/cart/cart.route.ts"
click node_auth_controller "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.controller.ts"
click node_auth_service "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.service.ts"
click node_auth_repository "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.repository.ts"
click node_auth_tokens "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/utils/Jwt.helper.ts"
click node_category "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/category/category.service.ts"
click node_product_controller "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.controller.ts"
click node_product "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.service.ts"
click node_cart_controller "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/cart/cart.controller.ts"
click node_cart "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/cart/cart.service.ts"
click node_orders "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/order/order.service.ts"
click node_addresses "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/address/address.service.ts"
click node_prisma "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/lib/prisma.ts"
click node_redis "https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/lib/redis.ts"

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_routes,node_category_routes,node_product_routes,node_order_routes,node_address_routes,node_cart_routes,node_client toneBlue
class node_auth_controller,node_auth_service,node_auth_repository,node_auth_tokens toneAmber
class node_category,node_product_controller,node_product,node_cart_controller,node_cart,node_orders,node_addresses toneMint
class node_prisma,node_database,node_redis,node_cloudinary toneRose
```

## Components

### API entry

- [Express app](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Auth routes](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.route.ts): `backend/src/modules/auth/auth.route.ts`
- [Category routes](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/category/category.route.ts): `backend/src/modules/category/category.route.ts`
- [Product routes](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.route.ts): `backend/src/modules/product/product.route.ts`
- [Order routes](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/order/order.route.ts): `backend/src/modules/order/order.route.ts`
- [Address routes](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/address/address.route.ts): `backend/src/modules/address/address.route.ts`
- [Cart routes](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/cart/cart.route.ts): `backend/src/modules/cart/cart.route.ts`

### Identity

- [Auth controller](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.controller.ts): `backend/src/modules/auth/auth.controller.ts`
- [Auth service](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Auth repository](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/auth/auth.repository.ts): `backend/src/modules/auth/auth.repository.ts`
- [Token helpers](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/utils/Jwt.helper.ts): `backend/src/utils/Jwt.helper.ts`

### Commerce

- [Category service](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/category/category.service.ts): `backend/src/modules/category/category.service.ts`
- [Product controller](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.controller.ts): `backend/src/modules/product/product.controller.ts`
- [Product service](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/product/product.service.ts): `backend/src/modules/product/product.service.ts`
- [Cart controller](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/cart/cart.controller.ts): `backend/src/modules/cart/cart.controller.ts`
- [Cart service](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/cart/cart.service.ts): `backend/src/modules/cart/cart.service.ts`
- [Order service](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/order/order.service.ts): `backend/src/modules/order/order.service.ts`
- [Address service](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/modules/address/address.service.ts): `backend/src/modules/address/address.service.ts`

### Persistence and integrations

- [Prisma client](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/lib/prisma.ts): `backend/src/lib/prisma.ts`
- **PostgreSQL**
- [Redis client](https://github.com/abhishek10600/ecommerceapplicationapi-advancebackendlearning/blob/main/backend/src/lib/redis.ts): `backend/src/lib/redis.ts`
- **Cloudinary**

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `backend/src/app.ts`)
- Express app → Auth routes: mounts auth (evidence: `backend/src/app.ts`)
- Express app → Category routes: mounts categories (evidence: `backend/src/app.ts`)
- Express app → Product routes: mounts products (evidence: `backend/src/app.ts`)
- Express app → Order routes: mounts orders (evidence: `backend/src/app.ts`)
- Express app → Address routes: mounts addresses (evidence: `backend/src/app.ts`)
- Express app → Cart routes: mounts cart (evidence: `backend/src/app.ts`)
- Auth controller → Auth service: delegates via container (evidence: `backend/src/modules/auth/auth.controller.ts`)
- Auth service → Auth repository: uses repository (evidence: `backend/src/modules/auth/auth.service.ts`)
- Auth service → Token helpers: generates and verifies (evidence: `backend/src/modules/auth/auth.service.ts`)
- Auth repository → Prisma client: queries data (evidence: `backend/src/modules/auth/auth.repository.ts`)
- Category service → Redis client: reads cache (evidence: `backend/src/modules/category/category.service.ts`)
- Product controller → Product service: calls service (evidence: `backend/src/modules/product/product.controller.ts`)
- Product service → Redis client: caches listings (evidence: `backend/src/modules/product/product.service.ts`)
- Product service → Cloudinary: uploads and deletes images (evidence: `backend/src/modules/product/product.service.ts`)
- Product service → Prisma client: persists products
- Cart controller → Cart service: calls service (evidence: `backend/src/modules/cart/cart.controller.ts`)
- Cart service → Prisma client: persists cart data
- Order service → Prisma client: persists orders (evidence: `backend/src/modules/order/order.service.ts`)
- Address service → Prisma client: persists addresses
- Prisma client → PostgreSQL: connects to (evidence: `backend/src/lib/prisma.ts`)
