# er-ajayqa/ecommerceapplicationadvancebackendlearning architecture

> Architecture diagram of the GitHub repository er-ajayqa/ecommerceapplicationadvancebackendlearning, 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/er-ajayqa/ecommerceapplicationadvancebackendlearning
- Repository: https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning

## Overview

This is an Express e-commerce API: clients can authenticate, browse products and categories, manage addresses and carts, and place orders. The visible product workflow routes requests through the app to product controllers and services, which handle catalog operations, image uploads, caching, and persistence. Other domain modules are included because the source tree establishes them as major API capabilities, but their internal call chains were not sampled. The graph therefore omits uncertain links rather than inferring them from module names or imports.

Main entry points: [`backend/src/app.ts`](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/app.ts) (Express app), [`backend/src/modules/product/product.service.ts`](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.service.ts) (Product service), [`backend/src/modules/auth/auth.service.ts`](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/auth/auth.service.ts) (Auth module), [`backend/src/lib/prisma.ts`](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/lib/prisma.ts) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_app["Express app<br/>[app.ts]"]
end

subgraph group_commerce["Commerce domains"]
  node_product_controller["Product controller"]
  node_product_service["Product service<br/>[product.service.ts]"]
  node_product_repository["Product repository"]
  node_category["Category module"]
  node_cart_controller["Cart controller<br/>[cart.controller.ts]"]
  node_cart_service["Cart service<br/>[cart.service.ts]"]
  node_cart_repository["Cart repository<br/>[cart.repository.ts]"]
  node_order["Order module<br/>[order.service.ts]"]
  node_address["Address module<br/>[address.service.ts]"]
end

subgraph group_identity["Identity"]
  node_auth["Auth module<br/>[auth.service.ts]"]
  node_auth_helpers["Auth helpers<br/>[auth.helper.ts]"]
  node_jwt["JWT helpers<br/>[jwt.helper.ts]"]
end

subgraph group_infra["Infrastructure"]
  node_database[("PostgreSQL<br/>[prisma.ts]")]
  node_redis_client["Redis client<br/>[redis.ts]"]
  node_cache_helper["Cache helper<br/>[cache.helper.ts]"]
  node_cloudinary["Cloudinary helper"]
  node_env["Environment config<br/>[env.config.ts]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts auth routes"| node_auth
node_app -->|"mounts category routes"| node_category
node_app -->|"mounts product routes"| node_product_controller
node_app -->|"mounts order routes"| node_order
node_app -->|"mounts address routes"| node_address
node_app -->|"mounts cart routes"| node_cart_controller
node_product_controller -->|"calls"| node_product_service
node_cart_controller -->|"calls"| node_cart_service
node_product_service -.->|"uses repository"| node_product_repository
node_cart_service -.->|"uses repository"| node_cart_repository
node_product_service -->|"uploads images"| node_cloudinary
node_product_service -->|"reads and writes cache"| node_redis_client
node_product_service -->|"invalidates cache"| node_cache_helper
node_auth -->|"hashes passwords"| node_auth_helpers
node_auth -->|"issues tokens"| node_jwt
node_product_repository -.->|"persists products"| node_database
node_cart_repository -.->|"persists carts"| node_database
node_env -->|"configures connection"| node_database
node_env -->|"configures connection"| node_redis_client

click node_app "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/app.ts"
click node_product_controller "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.controller.ts"
click node_product_service "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.service.ts"
click node_product_repository "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.repository.ts"
click node_category "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/category/category.service.ts"
click node_cart_controller "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/cart/cart.controller.ts"
click node_cart_service "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/cart/cart.service.ts"
click node_cart_repository "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/cart/cart.repository.ts"
click node_order "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/order/order.service.ts"
click node_address "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/address/address.service.ts"
click node_auth "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/auth/auth.service.ts"
click node_auth_helpers "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/auth.helper.ts"
click node_jwt "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/jwt.helper.ts"
click node_database "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/lib/prisma.ts"
click node_redis_client "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/lib/redis.ts"
click node_cache_helper "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/cache.helper.ts"
click node_cloudinary "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/cloudinary/cloudinary.helper.ts"
click node_env "https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/config/env.config.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_client toneBlue
class node_product_controller,node_product_service,node_product_repository,node_category,node_cart_controller,node_cart_service,node_cart_repository,node_order,node_address toneAmber
class node_auth,node_auth_helpers,node_jwt toneMint
class node_database,node_redis_client,node_cache_helper,node_cloudinary,node_env toneRose
```

## Components

### API entry

- [Express app](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/app.ts): `backend/src/app.ts`

### Commerce domains

- [Product controller](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.controller.ts): `backend/src/modules/product/product.controller.ts`
- [Product service](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.service.ts): `backend/src/modules/product/product.service.ts`
- [Product repository](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/product/product.repository.ts): `backend/src/modules/product/product.repository.ts`
- [Category module](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/category/category.service.ts): `backend/src/modules/category/category.service.ts`
- [Cart controller](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/cart/cart.controller.ts): `backend/src/modules/cart/cart.controller.ts`
- [Cart service](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/cart/cart.service.ts): `backend/src/modules/cart/cart.service.ts`
- [Cart repository](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/cart/cart.repository.ts): `backend/src/modules/cart/cart.repository.ts`
- [Order module](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/order/order.service.ts): `backend/src/modules/order/order.service.ts`
- [Address module](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/address/address.service.ts): `backend/src/modules/address/address.service.ts`

### Identity

- [Auth module](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Auth helpers](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/auth.helper.ts): `backend/src/utils/auth.helper.ts`
- [JWT helpers](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/jwt.helper.ts): `backend/src/utils/jwt.helper.ts`

### Infrastructure

- [PostgreSQL](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/lib/prisma.ts): `backend/src/lib/prisma.ts`
- [Redis client](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/lib/redis.ts): `backend/src/lib/redis.ts`
- [Cache helper](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/cache.helper.ts): `backend/src/utils/cache.helper.ts`
- [Cloudinary helper](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/utils/cloudinary/cloudinary.helper.ts): `backend/src/utils/cloudinary/cloudinary.helper.ts`
- [Environment config](https://github.com/er-ajayqa/ecommerceapplicationadvancebackendlearning/blob/main/backend/src/config/env.config.ts): `backend/src/config/env.config.ts`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests
- Express app → Auth module: mounts auth routes (evidence: `backend/src/app.ts`)
- Express app → Category module: mounts category routes (evidence: `backend/src/app.ts`)
- Express app → Product controller: mounts product routes (evidence: `backend/src/app.ts`)
- Express app → Order module: mounts order routes (evidence: `backend/src/app.ts`)
- Express app → Address module: mounts address routes (evidence: `backend/src/app.ts`)
- Express app → Cart controller: mounts cart routes (evidence: `backend/src/app.ts`)
- Product controller → Product service: calls (evidence: `backend/src/modules/product/product.controller.ts`)
- Cart controller → Cart service: calls (evidence: `backend/src/modules/cart/cart.controller.ts`)
- Product service → Product repository: uses repository
- Cart service → Cart repository: uses repository
- Product service → Cloudinary helper: uploads images (evidence: `backend/src/modules/product/product.service.ts`)
- Product service → Redis client: reads and writes cache (evidence: `backend/src/modules/product/product.service.ts`)
- Product service → Cache helper: invalidates cache (evidence: `backend/src/modules/product/product.service.ts`)
- Auth module → Auth helpers: hashes passwords (evidence: `backend/src/modules/auth/auth.service.ts`)
- Auth module → JWT helpers: issues tokens (evidence: `backend/src/modules/auth/auth.service.ts`)
- Product repository → PostgreSQL: persists products (evidence: `backend/src/modules/product/product.repository.ts`)
- Cart repository → PostgreSQL: persists carts (evidence: `backend/src/modules/cart/cart.repository.ts`)
- Environment config → PostgreSQL: configures connection (evidence: `backend/src/lib/prisma.ts`)
- Environment config → Redis client: configures connection (evidence: `backend/src/lib/redis.ts`)
