# amirxnofal/e-commerce architecture

> Architecture diagram of the GitHub repository amirxnofal/e-commerce, 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/amirxnofal/e-commerce
- Repository: https://github.com/amirxnofal/e-commerce

## Overview

This is an Express e-commerce REST API. A customer or seller request enters the app’s mounted routes and proceeds through the documented route–middleware–controller–service–model layers. The main commerce flow spans product discovery, cart operations, order creation and stock handling, then reviews; identity and administration are separate capabilities. The graph preserves the major README-documented features, but unsampled route wiring and several feature implementations are represented only at the subsystem level.

Main entry points: [`src/app.js`](https://github.com/amirxnofal/e-commerce/blob/main/src/app.js) (Express app), [`src/modules/auth/auth.service.js`](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/auth/auth.service.js) (Auth flows), [`src/modules/users/user.service.js`](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/users/user.service.js) (User management), [`src/modules/products/products.service.js`](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/products/products.service.js) (Product catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API runtime"]
  node_app["Express app<br/>[app.js]"]
end

subgraph group_identity["Identity and users"]
  node_auth["Auth flows<br/>[auth.service.js]"]
  node_users["User management<br/>[user.service.js]"]
  node_userstore[("User records<br/>[user.model.js]")]
end

subgraph group_catalog["Catalog"]
  node_products["Product catalog"]
  node_productimages["Product image handling"]
  node_productstore[("Product records<br/>[product.model.js]")]
  node_categories["Category management"]
  node_categorystore[("Category records<br/>[category.model.js]")]
end

subgraph group_commerce["Commerce"]
  node_cart["Cart operations<br/>[cart.service.js]"]
  node_cartstore[("Cart records<br/>[cart.model.js]")]
  node_orders["Order lifecycle<br/>[order.service.js]"]
  node_orderstore[("Order records<br/>[order.model.js]")]
  node_reviews["Product reviews<br/>[reviews.service.js]"]
  node_reviewstore[("Review records<br/>[review.model.js]")]
end

subgraph group_platform["Platform services"]
  node_mongodb[("MongoDB")]
  node_redis[("Redis service<br/>[redis.service.js]")]
  node_cloudinary["Cloudinary uploads"]
  node_email["Email delivery"]
  node_google["Google OAuth"]
end

node_caller(("API caller"))

node_caller -->|"sends request"| node_app
node_app -->|"mounts auth routes"| node_auth
node_app -->|"mounts user routes"| node_users
node_app -->|"mounts product routes"| node_products
node_app -->|"mounts category routes"| node_categories
node_app -->|"mounts cart routes"| node_cart
node_app -->|"mounts order routes"| node_orders
node_app -->|"mounts review routes"| node_reviews
node_auth -->|"reads and writes"| node_userstore
node_auth -->|"stores OTP and revocations"| node_redis
node_auth -->|"sends OTP"| node_email
node_auth -->|"verifies identity"| node_google
node_auth -->|"uploads profile image"| node_cloudinary
node_users -->|"reads and updates"| node_userstore
node_users -->|"stores revocations"| node_redis
node_users -->|"sends confirmation"| node_email
node_users -->|"uploads profile image"| node_cloudinary
node_products -->|"reads and updates"| node_productstore
node_products -->|"checks category"| node_categorystore
node_products -->|"delegates image updates"| node_productimages
node_products -->|"uploads images"| node_cloudinary
node_categories -->|"reads and updates"| node_categorystore
node_categories -->|"reads category products"| node_productstore
node_categories -->|"uploads category image"| node_cloudinary
node_cart -->|"checks stock"| node_productstore
node_cart -->|"reads and updates"| node_cartstore
node_orders -->|"creates and updates"| node_orderstore
node_orders -->|"reads and clears cart"| node_cartstore
node_orders -->|"reserves or restores stock"| node_productstore
node_reviews -->|"checks product"| node_productstore
node_reviews -->|"checks purchase"| node_orderstore
node_reviews -->|"creates and reads reviews"| node_reviewstore

click node_app "https://github.com/amirxnofal/e-commerce/blob/main/src/app.js"
click node_auth "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/auth/auth.service.js"
click node_users "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/users/user.service.js"
click node_userstore "https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/user.model.js"
click node_products "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/products/products.service.js"
click node_productimages "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/products/product.images.service.js"
click node_productstore "https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/product.model.js"
click node_categories "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/categories/category.service.js"
click node_categorystore "https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/category.model.js"
click node_cart "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/cart/cart.service.js"
click node_cartstore "https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/cart.model.js"
click node_orders "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/orders/order.service.js"
click node_orderstore "https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/order.model.js"
click node_reviews "https://github.com/amirxnofal/e-commerce/blob/main/src/modules/reviews/reviews.service.js"
click node_reviewstore "https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/review.model.js"
click node_redis "https://github.com/amirxnofal/e-commerce/blob/main/src/database/redis/redis.service.js"
click node_cloudinary "https://github.com/amirxnofal/e-commerce/blob/main/src/common/utils/cloudinary.utils.js"
click node_email "https://github.com/amirxnofal/e-commerce/blob/main/src/common/utils/send-email.utils.js"

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 toneBlue
class node_auth,node_users,node_userstore toneAmber
class node_products,node_productimages,node_productstore,node_categories,node_categorystore,node_caller toneMint
class node_cart,node_cartstore,node_orders,node_orderstore,node_reviews,node_reviewstore toneRose
class node_mongodb,node_redis,node_cloudinary,node_email,node_google toneIndigo
```

## Components

### API runtime

- [Express app](https://github.com/amirxnofal/e-commerce/blob/main/src/app.js): `src/app.js`

### Identity and users

- [Auth flows](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/auth/auth.service.js): `src/modules/auth/auth.service.js`
- [User management](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/users/user.service.js): `src/modules/users/user.service.js`
- [User records](https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/user.model.js): `src/database/models/user.model.js`

### Catalog

- [Product catalog](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/products/products.service.js): `src/modules/products/products.service.js`
- [Product image handling](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/products/product.images.service.js): `src/modules/products/product.images.service.js`
- [Product records](https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/product.model.js): `src/database/models/product.model.js`
- [Category management](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/categories/category.service.js): `src/modules/categories/category.service.js`
- [Category records](https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/category.model.js): `src/database/models/category.model.js`

### Commerce

- [Cart operations](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/cart/cart.service.js): `src/modules/cart/cart.service.js`
- [Cart records](https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/cart.model.js): `src/database/models/cart.model.js`
- [Order lifecycle](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/orders/order.service.js): `src/modules/orders/order.service.js`
- [Order records](https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/order.model.js): `src/database/models/order.model.js`
- [Product reviews](https://github.com/amirxnofal/e-commerce/blob/main/src/modules/reviews/reviews.service.js): `src/modules/reviews/reviews.service.js`
- [Review records](https://github.com/amirxnofal/e-commerce/blob/main/src/database/models/review.model.js): `src/database/models/review.model.js`

### Platform services

- **MongoDB**
- [Redis service](https://github.com/amirxnofal/e-commerce/blob/main/src/database/redis/redis.service.js): `src/database/redis/redis.service.js`
- [Cloudinary uploads](https://github.com/amirxnofal/e-commerce/blob/main/src/common/utils/cloudinary.utils.js): `src/common/utils/cloudinary.utils.js`
- [Email delivery](https://github.com/amirxnofal/e-commerce/blob/main/src/common/utils/send-email.utils.js): `src/common/utils/send-email.utils.js`
- **Google OAuth**

### Other components

- **API caller**

## Connections

- API caller → Express app: sends request
- Express app → Auth flows: mounts auth routes (evidence: `src/app.js`)
- Express app → User management: mounts user routes (evidence: `src/app.js`)
- Express app → Product catalog: mounts product routes (evidence: `src/app.js`)
- Express app → Category management: mounts category routes (evidence: `src/app.js`)
- Express app → Cart operations: mounts cart routes (evidence: `src/app.js`)
- Express app → Order lifecycle: mounts order routes (evidence: `src/app.js`)
- Express app → Product reviews: mounts review routes (evidence: `src/app.js`)
- Auth flows → User records: reads and writes (evidence: `src/modules/auth/auth.service.js`)
- Auth flows → Redis service: stores OTP and revocations (evidence: `src/modules/auth/auth.service.js`)
- Auth flows → Email delivery: sends OTP (evidence: `src/modules/auth/auth.service.js`)
- Auth flows → Google OAuth: verifies identity (evidence: `src/modules/auth/auth.service.js`)
- Auth flows → Cloudinary uploads: uploads profile image (evidence: `src/modules/auth/auth.service.js`)
- User management → User records: reads and updates (evidence: `src/modules/users/user.service.js`)
- User management → Redis service: stores revocations (evidence: `src/modules/users/user.service.js`)
- User management → Email delivery: sends confirmation (evidence: `src/modules/users/user.service.js`)
- User management → Cloudinary uploads: uploads profile image (evidence: `src/modules/users/user.service.js`)
- Product catalog → Product records: reads and updates (evidence: `src/modules/products/products.service.js`)
- Product catalog → Category records: checks category (evidence: `src/modules/products/products.service.js`)
- Product catalog → Product image handling: delegates image updates (evidence: `src/modules/products/products.service.js`)
- Product catalog → Cloudinary uploads: uploads images (evidence: `src/modules/products/products.service.js`)
- Category management → Category records: reads and updates (evidence: `src/modules/categories/category.service.js`)
- Category management → Product records: reads category products (evidence: `src/modules/categories/category.service.js`)
- Category management → Cloudinary uploads: uploads category image (evidence: `src/modules/categories/category.service.js`)
- Cart operations → Product records: checks stock (evidence: `src/modules/cart/cart.service.js`)
- Cart operations → Cart records: reads and updates (evidence: `src/modules/cart/cart.service.js`)
- Order lifecycle → Order records: creates and updates (evidence: `src/modules/orders/order.service.js`)
- Order lifecycle → Cart records: reads and clears cart (evidence: `src/modules/orders/order.service.js`)
- Order lifecycle → Product records: reserves or restores stock (evidence: `src/modules/orders/order.service.js`)
- Product reviews → Product records: checks product (evidence: `src/modules/reviews/reviews.service.js`)
- Product reviews → Order records: checks purchase (evidence: `src/modules/reviews/reviews.service.js`)
- Product reviews → Review records: creates and reads reviews (evidence: `src/modules/reviews/reviews.service.js`)
