# nikhil240896/e-commerce-ts architecture

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

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

## Overview

This is a TypeScript/Express commerce API for user registration and login, product catalog management, and order creation and lookup. Requests enter through the server and mounted routes, then controllers validate or check inputs, invoke services and models, and return JSON; order creation also checks and updates product inventory. Authentication verifies JWTs and user roles. The source index documents several imports, but not every runtime detail; edges are limited to relationships shown in excerpts or indexed references.

Main entry points: [`src/app.ts`](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/app.ts) (Express app), [`src/controllers/userController.ts`](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/userController.ts) (User controller), [`src/controllers/orderController.ts`](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/orderController.ts) (Order controller), [`src/controllers/productController.ts`](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/productController.ts) (Product controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["Server startup<br/>[server.ts]"]
  node_app["Express app<br/>[app.ts]"]
end

subgraph group_identity["Identity and access"]
  node_user_routes["User routes<br/>[userRoutes.ts]"]
  node_user_controller["User controller<br/>[userController.ts]"]
  node_user_validation["User validation<br/>[uservalidation.ts]"]
  node_user_service["User service<br/>[userService.ts]"]
  node_user_model[("User model<br/>[userModel.ts]")]
  node_auth["JWT middleware<br/>[verifyToken.ts]"]
end

subgraph group_catalog["Product catalog"]
  node_product_routes["Product routes<br/>[productRoutes.ts]"]
  node_product_controller["Product controller"]
  node_product_validation["Product validation"]
  node_product_service["Product service<br/>[productService.ts]"]
  node_product_model[("Product model<br/>[productModel.ts]")]
end

subgraph group_orders["Order processing"]
  node_order_routes["Order routes<br/>[orderRoutes.ts]"]
  node_order_controller["Order controller<br/>[orderController.ts]"]
  node_order_validation["Order validation<br/>[orderValidation.ts]"]
  node_order_service["Order service<br/>[orderService.ts]"]
  node_order_model[("Order model<br/>[orderModel.ts]")]
end

subgraph group_shared["Shared infrastructure"]
  node_database_connect["Database connection<br/>[db-connect.ts]"]
  node_config["Environment config<br/>[config.ts]"]
  node_error_handler["Error handler"]
  node_async_handler["Async wrapper<br/>[asyncHandler.ts]"]
  node_app_error["Application errors<br/>[appError.ts]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_server -->|"reads settings"| node_config
node_server -->|"connects database"| node_database_connect
node_server -->|"starts app"| node_app
node_app -->|"mounts routes"| node_user_routes
node_app -->|"mounts routes"| node_product_routes
node_app -->|"mounts routes"| node_order_routes
node_app -->|"handles errors"| node_error_handler
node_user_routes -->|"routes requests"| node_user_controller
node_user_controller -->|"validates input"| node_user_validation
node_user_controller -->|"invokes service"| node_user_service
node_user_controller -->|"checks existing user"| node_user_model
node_user_service -->|"uses model"| node_user_model
node_user_model -->|"signs tokens with"| node_config
node_product_routes -->|"routes requests"| node_product_controller
node_product_routes -->|"guards requests"| node_auth
node_product_controller -->|"validates creation"| node_product_validation
node_product_controller -->|"invokes service"| node_product_service
node_product_service -->|"uses model"| node_product_model
node_order_routes -->|"routes requests"| node_order_controller
node_order_controller -->|"validates input"| node_order_validation
node_order_controller -->|"checks and updates stock"| node_product_model
node_order_controller -->|"invokes service"| node_order_service
node_order_service -->|"uses model"| node_order_model
node_auth -->|"loads user"| node_user_model
node_auth -->|"verifies with secret"| node_config
node_error_handler -->|"reads settings"| node_config
node_error_handler -->|"formats errors"| node_app_error
node_user_controller -->|"wraps handlers"| node_async_handler
node_product_controller -->|"wraps handlers"| node_async_handler
node_order_controller -->|"wraps handlers"| node_async_handler

click node_server "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/server.ts"
click node_app "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/app.ts"
click node_user_routes "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/routes/userRoutes.ts"
click node_user_controller "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/userController.ts"
click node_user_validation "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/validations/uservalidation.ts"
click node_user_service "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/services/userService.ts"
click node_user_model "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/models/userModel.ts"
click node_auth "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/middlewares/verifyToken.ts"
click node_product_routes "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/routes/productRoutes.ts"
click node_product_controller "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/productController.ts"
click node_product_validation "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/validations/productValidation.ts"
click node_product_service "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/services/productService.ts"
click node_product_model "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/models/productModel.ts"
click node_order_routes "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/routes/orderRoutes.ts"
click node_order_controller "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/orderController.ts"
click node_order_validation "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/validations/orderValidation.ts"
click node_order_service "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/services/orderService.ts"
click node_order_model "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/models/orderModel.ts"
click node_database_connect "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/db/db-connect.ts"
click node_config "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/config/config.ts"
click node_error_handler "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/globalErrorHandler.ts"
click node_async_handler "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/utils/asyncHandler.ts"
click node_app_error "https://github.com/nikhil240896/e-commerce-ts/blob/main/src/utils/appError.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_server,node_app,node_client toneBlue
class node_user_routes,node_user_controller,node_user_validation,node_user_service,node_user_model,node_auth toneAmber
class node_product_routes,node_product_controller,node_product_validation,node_product_service,node_product_model toneMint
class node_order_routes,node_order_controller,node_order_validation,node_order_service,node_order_model toneRose
class node_database_connect,node_config,node_error_handler,node_async_handler,node_app_error toneIndigo
```

## Components

### API runtime

- [Server startup](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/server.ts): `src/server.ts`
- [Express app](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/app.ts): `src/app.ts`

### Identity and access

- [User routes](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/routes/userRoutes.ts): `src/routes/userRoutes.ts`
- [User controller](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/userController.ts): `src/controllers/userController.ts`
- [User validation](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/validations/uservalidation.ts): `src/validations/uservalidation.ts`
- [User service](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/services/userService.ts): `src/services/userService.ts`
- [User model](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/models/userModel.ts): `src/models/userModel.ts`
- [JWT middleware](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/middlewares/verifyToken.ts): `src/middlewares/verifyToken.ts`

### Product catalog

- [Product routes](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/routes/productRoutes.ts): `src/routes/productRoutes.ts`
- [Product controller](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/productController.ts): `src/controllers/productController.ts`
- [Product validation](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/validations/productValidation.ts): `src/validations/productValidation.ts`
- [Product service](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/services/productService.ts): `src/services/productService.ts`
- [Product model](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/models/productModel.ts): `src/models/productModel.ts`

### Order processing

- [Order routes](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/routes/orderRoutes.ts): `src/routes/orderRoutes.ts`
- [Order controller](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/orderController.ts): `src/controllers/orderController.ts`
- [Order validation](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/validations/orderValidation.ts): `src/validations/orderValidation.ts`
- [Order service](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/services/orderService.ts): `src/services/orderService.ts`
- [Order model](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/models/orderModel.ts): `src/models/orderModel.ts`

### Shared infrastructure

- [Database connection](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/db/db-connect.ts): `src/db/db-connect.ts`
- [Environment config](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/config/config.ts): `src/config/config.ts`
- [Error handler](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/controllers/globalErrorHandler.ts): `src/controllers/globalErrorHandler.ts`
- [Async wrapper](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/utils/asyncHandler.ts): `src/utils/asyncHandler.ts`
- [Application errors](https://github.com/nikhil240896/e-commerce-ts/blob/main/src/utils/appError.ts): `src/utils/appError.ts`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `src/app.ts`)
- Server startup → Environment config: reads settings (evidence: `src/server.ts`)
- Server startup → Database connection: connects database (evidence: `src/server.ts`)
- Server startup → Express app: starts app (evidence: `src/server.ts`)
- Express app → User routes: mounts routes (evidence: `src/app.ts`)
- Express app → Product routes: mounts routes (evidence: `src/app.ts`)
- Express app → Order routes: mounts routes (evidence: `src/app.ts`)
- Express app → Error handler: handles errors (evidence: `src/app.ts`)
- User routes → User controller: routes requests (evidence: `src/routes/userRoutes.ts`)
- User controller → User validation: validates input (evidence: `src/controllers/userController.ts`)
- User controller → User service: invokes service (evidence: `src/controllers/userController.ts`)
- User controller → User model: checks existing user (evidence: `src/controllers/userController.ts`)
- User service → User model: uses model (evidence: `src/services/userService.ts`)
- User model → Environment config: signs tokens with (evidence: `src/models/userModel.ts`)
- Product routes → Product controller: routes requests (evidence: `src/routes/productRoutes.ts`)
- Product routes → JWT middleware: guards requests (evidence: `src/routes/productRoutes.ts`)
- Product controller → Product validation: validates creation (evidence: `src/controllers/productController.ts`)
- Product controller → Product service: invokes service (evidence: `src/controllers/productController.ts`)
- Product service → Product model: uses model (evidence: `src/services/productService.ts`)
- Order routes → Order controller: routes requests (evidence: `src/routes/orderRoutes.ts`)
- Order controller → Order validation: validates input (evidence: `src/controllers/orderController.ts`)
- Order controller → Product model: checks and updates stock (evidence: `src/controllers/orderController.ts`)
- Order controller → Order service: invokes service (evidence: `src/controllers/orderController.ts`)
- Order service → Order model: uses model (evidence: `src/services/orderService.ts`)
- JWT middleware → User model: loads user (evidence: `src/middlewares/verifyToken.ts`)
- JWT middleware → Environment config: verifies with secret (evidence: `src/middlewares/verifyToken.ts`)
- Error handler → Environment config: reads settings (evidence: `src/controllers/globalErrorHandler.ts`)
- Error handler → Application errors: formats errors (evidence: `src/controllers/globalErrorHandler.ts`)
- User controller → Async wrapper: wraps handlers (evidence: `src/controllers/userController.ts`)
- Product controller → Async wrapper: wraps handlers (evidence: `src/controllers/productController.ts`)
- Order controller → Async wrapper: wraps handlers (evidence: `src/controllers/orderController.ts`)
