# shubham-kashyap/nest-prisma-template architecture

> Architecture diagram of the GitHub repository shubham-kashyap/nest-prisma-template, 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/shubham-kashyap/nest-prisma-template
- Repository: https://github.com/shubham-kashyap/nest-prisma-template

## Overview

This repository is a NestJS commerce backend: web and admin clients use separate API surfaces for authentication, catalog, users, carts, and orders, with system health endpoints alongside them. Controllers delegate to feature or shared services; the application also configures database, cache, and queue modules. The README documents Redis caching and a BullMQ notification/resiliency system. Unsampled service and queue internals limit evidence for their runtime links, so those links are not asserted.

Main entry points: [`src/app.module.ts`](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/app.module.ts) (Nest application), [`src/modules/web/products/products.controller.ts`](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/products/products.controller.ts) (Web products), [`src/modules/web/cart/cart.controller.ts`](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/cart/cart.controller.ts) (Web cart), [`src/modules/web/order/order.controller.ts`](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/order/order.controller.ts) (Web orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surfaces"]
  node_web_auth["Web auth<br/>[auth.controller.ts]"]
  node_web_products["Web products"]
  node_web_cart["Web cart<br/>[cart.controller.ts]"]
  node_web_orders["Web orders"]
  node_web_user_api["Web user API<br/>[user.controller.ts]"]
  node_specifications["Specifications"]
  node_admin_auth["Admin auth<br/>[auth.controller.ts]"]
  node_admin_products["Admin products"]
  node_admin_users["Admin users<br/>[user.controller.ts]"]
  node_health["System health"]
end

subgraph group_commerce["Commerce services"]
  node_auth_service["Shared auth<br/>[auth.service.ts]"]
  node_products_service["Product service"]
  node_user_service["User service<br/>[user.service.ts]"]
  node_cart_service["Cart service<br/>[cart.service.ts]"]
  node_order_service["Order service<br/>[order.service.ts]"]
end

subgraph group_platform["Platform infrastructure"]
  node_database_module["Database module"]
  node_mongodb[("MongoDB")]
  node_cache_module["Cache module"]
  node_hybrid_cache["Hybrid cache"]
  node_redis[("Redis")]
  node_application["Nest application<br/>[app.module.ts]"]
end

subgraph group_messaging["Messaging"]
  node_queue_module["Queue module<br/>[queue.module.ts]"]
  node_email_queue["Email queue"]
  node_email_worker["Email worker<br/>[email.worker.ts]"]
  node_email_sender["Email sender"]
end

node_web_user(("Web user"))
node_admin_user(("Admin"))

node_web_user -->|"requests"| node_web_auth
node_web_user -->|"requests"| node_web_products
node_web_user -->|"requests"| node_web_cart
node_web_user -->|"requests"| node_web_orders
node_web_user -->|"requests"| node_web_user_api
node_web_user -.->|"requests"| node_specifications
node_admin_user -->|"requests"| node_admin_auth
node_admin_user -->|"requests"| node_admin_products
node_admin_user -->|"requests"| node_admin_users
node_web_products -->|"calls"| node_products_service
node_admin_products -->|"calls"| node_products_service
node_web_cart -->|"calls"| node_cart_service
node_web_orders -->|"calls"| node_order_service
node_web_user_api -->|"calls"| node_user_service
node_application -->|"imports"| node_database_module
node_application -->|"imports"| node_cache_module
node_application -->|"imports"| node_queue_module
node_application -.->|"configures"| node_mongodb
node_hybrid_cache -->|"reads/writes"| node_redis
node_email_worker -.->|"delegates"| node_email_sender
node_queue_module -.->|"configures"| node_email_queue

click node_web_auth "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/auth/auth.controller.ts"
click node_web_products "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/products/products.controller.ts"
click node_web_cart "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/cart/cart.controller.ts"
click node_web_orders "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/order/order.controller.ts"
click node_web_user_api "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/user/user.controller.ts"
click node_specifications "https://github.com/shubham-kashyap/nest-prisma-template/tree/master/src/modules/web/specifications"
click node_admin_auth "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/admin/auth/auth.controller.ts"
click node_admin_products "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/admin/products/products.controller.ts"
click node_admin_users "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/admin/user/user.controller.ts"
click node_health "https://github.com/shubham-kashyap/nest-prisma-template/tree/master/src/modules/system/health"
click node_auth_service "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/service/auth.service.ts"
click node_products_service "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/service/products.service.ts"
click node_user_service "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/service/user.service.ts"
click node_cart_service "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/cart/cart.service.ts"
click node_order_service "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/order/order.service.ts"
click node_database_module "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/module/application-database.module.ts"
click node_cache_module "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/module/application-cache.module.ts"
click node_hybrid_cache "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/services/cache/hybrid-cache.service.ts"
click node_queue_module "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/queue/queue.module.ts"
click node_email_queue "https://github.com/shubham-kashyap/nest-prisma-template/tree/master/src/modules/queue"
click node_email_worker "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/queue/workers/email.worker.ts"
click node_email_sender "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/queue/services/email-sender.service.ts"
click node_application "https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/app.module.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_web_auth,node_web_products,node_web_cart,node_web_orders,node_web_user_api,node_specifications,node_admin_auth,node_admin_products,node_admin_users,node_health,node_web_user toneBlue
class node_auth_service,node_products_service,node_user_service,node_cart_service,node_order_service toneAmber
class node_database_module,node_mongodb,node_cache_module,node_hybrid_cache,node_redis,node_application toneMint
class node_queue_module,node_email_queue,node_email_worker,node_email_sender toneRose
class node_admin_user toneIndigo
```

## Components

### API surfaces

- [Web auth](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/auth/auth.controller.ts): `src/modules/web/auth/auth.controller.ts`
- [Web products](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/products/products.controller.ts): `src/modules/web/products/products.controller.ts`
- [Web cart](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/cart/cart.controller.ts): `src/modules/web/cart/cart.controller.ts`
- [Web orders](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/order/order.controller.ts): `src/modules/web/order/order.controller.ts`
- [Web user API](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/user/user.controller.ts): `src/modules/web/user/user.controller.ts`
- [Specifications](https://github.com/shubham-kashyap/nest-prisma-template/tree/master/src/modules/web/specifications): `src/modules/web/specifications`
- [Admin auth](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/admin/auth/auth.controller.ts): `src/modules/admin/auth/auth.controller.ts`
- [Admin products](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/admin/products/products.controller.ts): `src/modules/admin/products/products.controller.ts`
- [Admin users](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/admin/user/user.controller.ts): `src/modules/admin/user/user.controller.ts`
- [System health](https://github.com/shubham-kashyap/nest-prisma-template/tree/master/src/modules/system/health): `src/modules/system/health`

### Commerce services

- [Shared auth](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/service/auth.service.ts): `src/modules/shared/service/auth.service.ts`
- [Product service](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/service/products.service.ts): `src/modules/shared/service/products.service.ts`
- [User service](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/service/user.service.ts): `src/modules/shared/service/user.service.ts`
- [Cart service](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/cart/cart.service.ts): `src/modules/web/cart/cart.service.ts`
- [Order service](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/web/order/order.service.ts): `src/modules/web/order/order.service.ts`

### Platform infrastructure

- [Database module](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/module/application-database.module.ts): `src/modules/shared/module/application-database.module.ts`
- **MongoDB**
- [Cache module](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/shared/module/application-cache.module.ts): `src/modules/shared/module/application-cache.module.ts`
- [Hybrid cache](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/services/cache/hybrid-cache.service.ts): `src/services/cache/hybrid-cache.service.ts`
- **Redis**
- [Nest application](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/app.module.ts): `src/app.module.ts`

### Messaging

- [Queue module](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/queue/queue.module.ts): `src/modules/queue/queue.module.ts`
- [Email queue](https://github.com/shubham-kashyap/nest-prisma-template/tree/master/src/modules/queue): `src/modules/queue`
- [Email worker](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/queue/workers/email.worker.ts): `src/modules/queue/workers/email.worker.ts`
- [Email sender](https://github.com/shubham-kashyap/nest-prisma-template/blob/master/src/modules/queue/services/email-sender.service.ts): `src/modules/queue/services/email-sender.service.ts`

### Other components

- **Web user**
- **Admin**

## Connections

- Web user → Web auth: requests (evidence: `src/modules/web/auth/auth.controller.ts`)
- Web user → Web products: requests (evidence: `src/modules/web/products/products.controller.ts`)
- Web user → Web cart: requests (evidence: `src/modules/web/cart/cart.controller.ts`)
- Web user → Web orders: requests (evidence: `src/modules/web/order/order.controller.ts`)
- Web user → Web user API: requests (evidence: `src/modules/web/user/user.controller.ts`)
- Web user → Specifications: requests
- Admin → Admin auth: requests (evidence: `src/modules/admin/auth/auth.controller.ts`)
- Admin → Admin products: requests (evidence: `src/modules/admin/products/products.controller.ts`)
- Admin → Admin users: requests (evidence: `src/modules/admin/user/user.controller.ts`)
- Web products → Product service: calls (evidence: `src/modules/web/products/products.controller.ts`)
- Admin products → Product service: calls (evidence: `src/modules/admin/products/products.controller.ts`)
- Web cart → Cart service: calls (evidence: `src/modules/web/cart/cart.controller.ts`)
- Web orders → Order service: calls (evidence: `src/modules/web/order/order.controller.ts`)
- Web user API → User service: calls (evidence: `src/modules/web/user/user.controller.ts`)
- Nest application → Database module: imports (evidence: `src/app.module.ts`)
- Nest application → Cache module: imports (evidence: `src/app.module.ts`)
- Nest application → Queue module: imports (evidence: `src/app.module.ts`)
- Nest application → MongoDB: configures
- Hybrid cache → Redis: reads/writes (evidence: `src/services/cache/hybrid-cache.service.ts`)
- Email worker → Email sender: delegates
- Queue module → Email queue: configures
