# madgulavamshi06/jumia_clone_backend architecture

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

## Overview

This repository is the backend for a Jumia-style e-commerce application. Its main workflow routes product discovery and administration requests through Express handlers to product and category models; authenticated buyers can pay and view orders, while administrators can manage catalog data and order status. Separate routes handle registration, login, and profile access. The README also describes frontend-facing features such as favorites and sorting, but this tree provides no distinct backend implementation for them. Edges reflect shown route wiring and source-index references; unsampled implementations are not inferred.

Main entry points: [`routes/productRoute.js`](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/productRoute.js) (Product routes), [`routes/authRoute.js`](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/authRoute.js) (Auth routes), [`index.js`](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/index.js) (Express server), [`middleware/authToken.js`](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/middleware/authToken.js) (Token and roles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP entry"]
  node_server["Express server<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[authRoute.js]"]
  node_category_routes["Category routes<br/>[categoryRoutes.js]"]
  node_product_routes["Product routes<br/>[productRoute.js]"]
end

subgraph group_identity["Identity and access"]
  node_registration["Registration"]
  node_login["Login<br/>[loginController.js]"]
  node_profile["Profile update"]
  node_password["Password reset"]
  node_access["Token and roles<br/>[authToken.js]"]
  node_password_helpers["Password hashing<br/>[authHelper.js]"]
end

subgraph group_catalog["Catalog"]
  node_product_admin["Product management"]
  node_product_update["Product updates"]
  node_product_browse["Product discovery"]
  node_category_ops["Category operations"]
end

subgraph group_commerce["Orders and payments"]
  node_payment["Payment processing"]
  node_buyer_orders["Buyer orders"]
  node_admin_orders["Order administration"]
end

subgraph group_persistence["Data models"]
  node_category_model[("Category data<br/>[categoryModel.js]")]
  node_product_model[("Product data<br/>[productModel.js]")]
  node_user_model[("User data<br/>[userModel.js]")]
  node_order_model[("Order data<br/>[orderModel.js]")]
end

node_client(("API client"))
node_payment_service["Braintree"]

node_client -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_category_routes
node_server -->|"mounts routes"| node_product_routes
node_auth_routes -->|"routes registration"| node_registration
node_auth_routes -->|"routes login"| node_login
node_auth_routes -->|"routes profile"| node_profile
node_auth_routes -->|"routes reset"| node_password
node_auth_routes -->|"guards requests"| node_access
node_category_routes -->|"routes category"| node_category_ops
node_category_routes -->|"guards admin routes"| node_access
node_product_routes -->|"routes creation"| node_product_admin
node_product_routes -->|"routes updates"| node_product_update
node_product_routes -->|"routes browsing"| node_product_browse
node_product_routes -->|"routes payment"| node_payment
node_product_routes -->|"routes buyer orders"| node_buyer_orders
node_product_routes -->|"routes admin orders"| node_admin_orders
node_product_routes -->|"guards operations"| node_access
node_registration -->|"saves user"| node_user_model
node_registration -->|"hashes password"| node_password_helpers
node_login -->|"checks user"| node_user_model
node_login -->|"checks password"| node_password_helpers
node_profile -->|"updates user"| node_user_model
node_access -->|"checks role"| node_user_model
node_product_admin -->|"creates product"| node_product_model
node_product_update -->|"updates product"| node_product_model
node_product_browse -->|"queries products"| node_product_model
node_category_ops -->|"manages categories"| node_category_model
node_payment -->|"records order"| node_order_model
node_payment -.->|"charges payment"| node_payment_service
node_buyer_orders -->|"queries orders"| node_order_model
node_admin_orders -->|"queries orders"| node_order_model

click node_server "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/index.js"
click node_auth_routes "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/authRoute.js"
click node_category_routes "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/categoryRoutes.js"
click node_product_routes "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/productRoute.js"
click node_registration "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/registerController.js"
click node_login "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/loginController.js"
click node_profile "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/updateprofileController.js"
click node_password "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/forgotPasswordController.js"
click node_access "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/middleware/authToken.js"
click node_password_helpers "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/helpers/authHelper.js"
click node_product_admin "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/createproductController.js"
click node_product_update "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/updateproductController.js"
click node_product_browse "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/getproductController.js"
click node_category_ops "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/categoryController.js"
click node_category_model "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/categoryModel.js"
click node_product_model "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/productModel.js"
click node_user_model "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/userModel.js"
click node_payment "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/braintreePaymentController.js"
click node_buyer_orders "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/getOrdersController.js"
click node_admin_orders "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/getAllOrdersController.js"
click node_order_model "https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/orderModel.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_auth_routes,node_category_routes,node_product_routes,node_client toneBlue
class node_registration,node_login,node_profile,node_password,node_access,node_password_helpers toneAmber
class node_product_admin,node_product_update,node_product_browse,node_category_ops toneMint
class node_payment,node_buyer_orders,node_admin_orders toneRose
class node_category_model,node_product_model,node_user_model,node_order_model,node_payment_service toneIndigo
```

## Components

### HTTP entry

- [Express server](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/index.js): `index.js`
- [Auth routes](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/authRoute.js): `routes/authRoute.js`
- [Category routes](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/categoryRoutes.js): `routes/categoryRoutes.js`
- [Product routes](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/routes/productRoute.js): `routes/productRoute.js`

### Identity and access

- [Registration](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/registerController.js): `controllers/registerController.js`
- [Login](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/loginController.js): `controllers/loginController.js`
- [Profile update](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/updateprofileController.js): `controllers/updateprofileController.js`
- [Password reset](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/forgotPasswordController.js): `controllers/forgotPasswordController.js`
- [Token and roles](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/middleware/authToken.js): `middleware/authToken.js`
- [Password hashing](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/helpers/authHelper.js): `helpers/authHelper.js`

### Catalog

- [Product management](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/createproductController.js): `controllers/createproductController.js`
- [Product updates](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/updateproductController.js): `controllers/updateproductController.js`
- [Product discovery](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/getproductController.js): `controllers/getproductController.js`
- [Category operations](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/categoryController.js): `controllers/categoryController.js`

### Orders and payments

- [Payment processing](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/braintreePaymentController.js): `controllers/braintreePaymentController.js`
- [Buyer orders](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/getOrdersController.js): `controllers/getOrdersController.js`
- [Order administration](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/controllers/getAllOrdersController.js): `controllers/getAllOrdersController.js`

### Data models

- [Category data](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/categoryModel.js): `models/categoryModel.js`
- [Product data](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/productModel.js): `models/productModel.js`
- [User data](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/userModel.js): `models/userModel.js`
- [Order data](https://github.com/madgulavamshi06/jumia_clone_backend/blob/main/models/orderModel.js): `models/orderModel.js`

### Other components

- **API client**
- **Braintree**

## Connections

- API client → Express server: sends requests
- Express server → Auth routes: mounts routes (evidence: `index.js`)
- Express server → Category routes: mounts routes (evidence: `index.js`)
- Express server → Product routes: mounts routes (evidence: `index.js`)
- Auth routes → Registration: routes registration (evidence: `routes/authRoute.js`)
- Auth routes → Login: routes login (evidence: `routes/authRoute.js`)
- Auth routes → Profile update: routes profile (evidence: `routes/authRoute.js`)
- Auth routes → Password reset: routes reset (evidence: `routes/authRoute.js`)
- Auth routes → Token and roles: guards requests (evidence: `routes/authRoute.js`)
- Category routes → Category operations: routes category (evidence: `routes/categoryRoutes.js`)
- Category routes → Token and roles: guards admin routes (evidence: `routes/categoryRoutes.js`)
- Product routes → Product management: routes creation (evidence: `routes/productRoute.js`)
- Product routes → Product updates: routes updates (evidence: `routes/productRoute.js`)
- Product routes → Product discovery: routes browsing (evidence: `routes/productRoute.js`)
- Product routes → Payment processing: routes payment (evidence: `routes/productRoute.js`)
- Product routes → Buyer orders: routes buyer orders (evidence: `routes/productRoute.js`)
- Product routes → Order administration: routes admin orders (evidence: `routes/productRoute.js`)
- Product routes → Token and roles: guards operations (evidence: `routes/productRoute.js`)
- Registration → User data: saves user (evidence: `controllers/registerController.js`)
- Registration → Password hashing: hashes password (evidence: `controllers/registerController.js`)
- Login → User data: checks user (evidence: `controllers/loginController.js`)
- Login → Password hashing: checks password (evidence: `controllers/loginController.js`)
- Profile update → User data: updates user (evidence: `controllers/updateprofileController.js`)
- Token and roles → User data: checks role (evidence: `middleware/authToken.js`)
- Product management → Product data: creates product (evidence: `controllers/createproductController.js`)
- Product updates → Product data: updates product (evidence: `controllers/updateproductController.js`)
- Product discovery → Product data: queries products (evidence: `controllers/getproductController.js`)
- Category operations → Category data: manages categories (evidence: `controllers/categoryController.js`)
- Payment processing → Order data: records order (evidence: `controllers/braintreePaymentController.js`)
- Payment processing → Braintree: charges payment
- Buyer orders → Order data: queries orders (evidence: `controllers/getOrdersController.js`)
- Order administration → Order data: queries orders (evidence: `controllers/getAllOrdersController.js`)
