# arnab-shuvo/fakecommerce architecture

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

- Interactive diagram: https://gitdiagram.com/arnab-shuvo/fakecommerce
- Repository: https://github.com/arnab-shuvo/fakecommerce

## Overview

FakeCommerce is a sample REST API for frontend training. A client sends requests to Express routes; routes apply validation and, where required, authentication/admin checks before invoking controllers. Controllers implement product, category, cart, order, and user operations using Mongoose models, with MongoDB as the documented backing store. The README describes catalog browsing and management, account signup/signin and profile/admin user operations, cart access, checkout and order management. Source evidence is incomplete for several route/controller implementations, so only indexed or explicitly documented relationships are shown; unsampled capabilities remain represented without speculative wiring.

Main entry points: [`server.js`](https://github.com/arnab-shuvo/fakecommerce/blob/master/server.js) (Express server), [`auth/auth.js`](https://github.com/arnab-shuvo/fakecommerce/blob/master/auth/auth.js) (Authentication), [`routes/user.js`](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/user.js) (User routes), [`routes/product.js`](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/product.js) (Product routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_server["Express server<br/>[server.js]"]
  node_user_routes["User routes<br/>[user.js]"]
  node_product_routes["Product routes<br/>[product.js]"]
  node_category_routes["Category routes<br/>[category.js]"]
  node_cart_routes["Cart routes<br/>[cart.js]"]
  node_order_routes["Order routes<br/>[order.js]"]
  node_validators["Request validators"]
end

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[auth.js]"]
  node_admin["Admin authorization<br/>[isAdmin.js]"]
  node_user_controller["User operations<br/>[user.js]"]
end

subgraph group_catalog["Catalog"]
  node_product_controller["Product operations<br/>[product.js]"]
  node_category_controller["Category operations<br/>[category.js]"]
end

subgraph group_commerce["Cart and orders"]
  node_cart_controller["Cart operations<br/>[cart.js]"]
  node_order_controller["Order operations<br/>[order.js]"]
end

subgraph group_persistence["Data models"]
  node_user_model["User model<br/>[user.js]"]
  node_product_model["Product model<br/>[product.js]"]
  node_category_model["Category model<br/>[categories.js]"]
  node_cart_model["Cart model<br/>[cart.js]"]
  node_order_model["Order model<br/>[order.js]"]
end

node_client(("API client"))
node_mongodb[("MongoDB")]

node_client -->|"sends requests"| node_server
node_server -->|"mounts at products"| node_product_routes
node_server -->|"mounts at cart"| node_cart_routes
node_server -->|"mounts at root"| node_user_routes
node_server -->|"mounts at category"| node_category_routes
node_server -->|"mounts at order"| node_order_routes
node_server -->|"connects to"| node_mongodb
node_user_routes -->|"dispatches to"| node_user_controller
node_product_routes -->|"dispatches to"| node_product_controller
node_category_routes -->|"dispatches to"| node_category_controller
node_cart_routes -->|"dispatches to"| node_cart_controller
node_order_routes -->|"dispatches to"| node_order_controller
node_user_routes -->|"validates requests"| node_validators
node_product_routes -->|"validates requests"| node_validators
node_category_routes -->|"validates requests"| node_validators
node_cart_routes -->|"validates requests"| node_validators
node_order_routes -->|"validates requests"| node_validators
node_user_routes -->|"checks identity"| node_auth
node_product_routes -->|"checks identity"| node_auth
node_category_routes -->|"checks identity"| node_auth
node_cart_routes -->|"checks identity"| node_auth
node_order_routes -->|"checks identity"| node_auth
node_user_routes -->|"checks admin role"| node_admin
node_product_routes -->|"checks admin role"| node_admin
node_category_routes -->|"checks admin role"| node_admin
node_order_routes -->|"checks admin role"| node_admin
node_auth -->|"loads user"| node_user_model
node_user_controller -->|"reads and writes"| node_user_model
node_product_controller -->|"reads and writes"| node_product_model
node_product_controller -->|"looks up category"| node_category_model
node_category_controller -->|"reads and writes"| node_category_model
node_cart_controller -->|"reads and writes"| node_cart_model
node_order_controller -->|"reads and writes"| node_order_model
node_order_controller -->|"uses cart"| node_cart_model
node_cart_model -->|"references products"| node_product_model
node_cart_model -->|"references users"| node_user_model
node_order_model -->|"references products"| node_product_model
node_order_model -->|"references users"| node_user_model

click node_server "https://github.com/arnab-shuvo/fakecommerce/blob/master/server.js"
click node_user_routes "https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/user.js"
click node_product_routes "https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/product.js"
click node_category_routes "https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/category.js"
click node_cart_routes "https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/cart.js"
click node_order_routes "https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/order.js"
click node_validators "https://github.com/arnab-shuvo/fakecommerce/tree/master/validator"
click node_auth "https://github.com/arnab-shuvo/fakecommerce/blob/master/auth/auth.js"
click node_admin "https://github.com/arnab-shuvo/fakecommerce/blob/master/middleware/isAdmin.js"
click node_user_controller "https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/user.js"
click node_product_controller "https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/product.js"
click node_category_controller "https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/category.js"
click node_cart_controller "https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/cart.js"
click node_order_controller "https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/order.js"
click node_user_model "https://github.com/arnab-shuvo/fakecommerce/blob/master/model/user.js"
click node_product_model "https://github.com/arnab-shuvo/fakecommerce/blob/master/model/product.js"
click node_category_model "https://github.com/arnab-shuvo/fakecommerce/blob/master/model/categories.js"
click node_cart_model "https://github.com/arnab-shuvo/fakecommerce/blob/master/model/cart.js"
click node_order_model "https://github.com/arnab-shuvo/fakecommerce/blob/master/model/order.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_server,node_user_routes,node_product_routes,node_category_routes,node_cart_routes,node_order_routes,node_validators,node_client toneBlue
class node_auth,node_admin,node_user_controller,node_mongodb toneAmber
class node_product_controller,node_category_controller toneMint
class node_cart_controller,node_order_controller toneRose
class node_user_model,node_product_model,node_category_model,node_cart_model,node_order_model toneIndigo
```

## Components

### API entry

- [Express server](https://github.com/arnab-shuvo/fakecommerce/blob/master/server.js): `server.js`
- [User routes](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/user.js): `routes/user.js`
- [Product routes](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/product.js): `routes/product.js`
- [Category routes](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/category.js): `routes/category.js`
- [Cart routes](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/cart.js): `routes/cart.js`
- [Order routes](https://github.com/arnab-shuvo/fakecommerce/blob/master/routes/order.js): `routes/order.js`
- [Request validators](https://github.com/arnab-shuvo/fakecommerce/tree/master/validator): `validator`

### Identity and access

- [Authentication](https://github.com/arnab-shuvo/fakecommerce/blob/master/auth/auth.js): `auth/auth.js`
- [Admin authorization](https://github.com/arnab-shuvo/fakecommerce/blob/master/middleware/isAdmin.js): `middleware/isAdmin.js`
- [User operations](https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/user.js): `controller/user.js`

### Catalog

- [Product operations](https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/product.js): `controller/product.js`
- [Category operations](https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/category.js): `controller/category.js`

### Cart and orders

- [Cart operations](https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/cart.js): `controller/cart.js`
- [Order operations](https://github.com/arnab-shuvo/fakecommerce/blob/master/controller/order.js): `controller/order.js`

### Data models

- [User model](https://github.com/arnab-shuvo/fakecommerce/blob/master/model/user.js): `model/user.js`
- [Product model](https://github.com/arnab-shuvo/fakecommerce/blob/master/model/product.js): `model/product.js`
- [Category model](https://github.com/arnab-shuvo/fakecommerce/blob/master/model/categories.js): `model/categories.js`
- [Cart model](https://github.com/arnab-shuvo/fakecommerce/blob/master/model/cart.js): `model/cart.js`
- [Order model](https://github.com/arnab-shuvo/fakecommerce/blob/master/model/order.js): `model/order.js`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → Express server: sends requests (evidence: `README.md`)
- Express server → Product routes: mounts at products (evidence: `server.js`)
- Express server → Cart routes: mounts at cart (evidence: `server.js`)
- Express server → User routes: mounts at root (evidence: `server.js`)
- Express server → Category routes: mounts at category (evidence: `server.js`)
- Express server → Order routes: mounts at order (evidence: `server.js`)
- Express server → MongoDB: connects to (evidence: `server.js`)
- User routes → User operations: dispatches to (evidence: `routes/user.js`)
- Product routes → Product operations: dispatches to (evidence: `routes/product.js`)
- Category routes → Category operations: dispatches to (evidence: `routes/category.js`)
- Cart routes → Cart operations: dispatches to (evidence: `routes/cart.js`)
- Order routes → Order operations: dispatches to (evidence: `routes/order.js`)
- User routes → Request validators: validates requests (evidence: `routes/user.js`)
- Product routes → Request validators: validates requests (evidence: `routes/product.js`)
- Category routes → Request validators: validates requests (evidence: `routes/category.js`)
- Cart routes → Request validators: validates requests (evidence: `routes/cart.js`)
- Order routes → Request validators: validates requests (evidence: `routes/order.js`)
- User routes → Authentication: checks identity (evidence: `routes/user.js`)
- Product routes → Authentication: checks identity (evidence: `routes/product.js`)
- Category routes → Authentication: checks identity (evidence: `routes/category.js`)
- Cart routes → Authentication: checks identity (evidence: `routes/cart.js`)
- Order routes → Authentication: checks identity (evidence: `routes/order.js`)
- User routes → Admin authorization: checks admin role (evidence: `routes/user.js`)
- Product routes → Admin authorization: checks admin role (evidence: `routes/product.js`)
- Category routes → Admin authorization: checks admin role (evidence: `routes/category.js`)
- Order routes → Admin authorization: checks admin role (evidence: `routes/order.js`)
- Authentication → User model: loads user (evidence: `auth/auth.js`)
- User operations → User model: reads and writes (evidence: `controller/user.js`)
- Product operations → Product model: reads and writes (evidence: `controller/product.js`)
- Product operations → Category model: looks up category (evidence: `controller/product.js`)
- Category operations → Category model: reads and writes (evidence: `controller/category.js`)
- Cart operations → Cart model: reads and writes (evidence: `controller/cart.js`)
- Order operations → Order model: reads and writes (evidence: `controller/order.js`)
- Order operations → Cart model: uses cart (evidence: `controller/order.js`)
- Cart model → Product model: references products (evidence: `model/cart.js`)
- Cart model → User model: references users (evidence: `model/cart.js`)
- Order model → Product model: references products (evidence: `model/order.js`)
- Order model → User model: references users (evidence: `model/order.js`)
