# nourchene-hamrita/e-commerce-app architecture

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

## Overview

This repository pairs an e-commerce API with a React administration dashboard. An administrator signs in, then navigates product and user views; the dashboard fetches products through its API-call layer, while product creation uploads an image before submitting product data. The API exposes authentication, user, product, cart, order, and checkout routes backed by MongoDB models. The README provides no substantive feature documentation, so the graph relies on the sampled code and SOURCE INDEX; some dashboard and API wiring remains unverified.

Main entry points: [`admin/src/App.js`](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/App.js) (Route shell), [`api/index.js`](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/index.js) (Express API), [`admin/src/redux/apiCalls.js`](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/apiCalls.js) (API operations), [`admin/src/pages/product/Product.jsx`](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/product/Product.jsx) (Product editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admin_ui["Admin interface"]
  node_admin_app["Route shell<br/>[App.js]"]
  node_admin_login["Sign-in<br/>[Login.jsx]"]
  node_admin_home["Dashboard<br/>[Home.jsx]"]
  node_admin_charts["Charts and metrics<br/>[Chart.jsx]"]
  node_admin_featured["Summary metrics<br/>[FeaturedInfo.jsx]"]
  node_admin_nav["Sidebar navigation<br/>[Sidebar.jsx]"]
  node_admin_user_list["User list<br/>[UserList.jsx]"]
  node_admin_user_detail["User editor<br/>[User.jsx]"]
  node_admin_user_new["Create user<br/>[NewUser.jsx]"]
  node_admin_product_list["Product list<br/>[ProductList.jsx]"]
  node_admin_product_detail["Product editor<br/>[Product.jsx]"]
  node_admin_product_new["Create product<br/>[NewProduct.jsx]"]
end

subgraph group_admin_state["Admin data access"]
  node_admin_upload_config["Image storage config<br/>[firebase.js]"]
  node_admin_api_calls["API operations<br/>[apiCalls.js]"]
  node_admin_product_state["Product state<br/>[productRedux.js]"]
  node_admin_user_state["User state<br/>[userRedux.js]"]
  node_admin_http["HTTP clients<br/>[requestMethods.js]"]
end

subgraph group_api_routes["API routes"]
  node_api_server["Express API<br/>[index.js]"]
  node_auth_routes["Authentication<br/>[auth.js]"]
  node_user_routes["User routes<br/>[user.js]"]
  node_product_routes["Product routes<br/>[product.js]"]
  node_cart_routes["Cart routes<br/>[cart.js]"]
  node_order_routes["Order and income<br/>[order.js]"]
  node_stripe_routes["Checkout routes<br/>[stripe.js]"]
  node_token_guard["Token authorization<br/>[verifyToken.js]"]
end

subgraph group_api_domain["API domain"]
  node_user_model[("User records<br/>[User.js]")]
  node_product_model[("Product records<br/>[Product.js]")]
  node_cart_model[("Cart records<br/>[Cart.js]")]
  node_order_model[("Order records<br/>[Order.js]")]
end

node_admin_actor(("Administrator"))
node_mongo[("MongoDB")]
node_image_storage[("Firebase Storage")]

node_admin_actor -->|"uses"| node_admin_app
node_admin_app -->|"routes to"| node_admin_login
node_admin_app -->|"routes to"| node_admin_home
node_admin_app -->|"routes to"| node_admin_user_list
node_admin_app -->|"routes to"| node_admin_user_detail
node_admin_app -->|"routes to"| node_admin_user_new
node_admin_app -->|"routes to"| node_admin_product_list
node_admin_app -->|"routes to"| node_admin_product_detail
node_admin_app -->|"routes to"| node_admin_product_new
node_admin_app -->|"renders"| node_admin_nav
node_admin_home -->|"renders"| node_admin_charts
node_admin_home -->|"renders"| node_admin_featured
node_admin_login -->|"calls"| node_admin_api_calls
node_admin_product_list -->|"calls"| node_admin_api_calls
node_admin_product_new -->|"uses"| node_admin_upload_config
node_admin_product_new -->|"uploads image"| node_image_storage
node_admin_product_new -->|"submits product"| node_admin_api_calls
node_admin_product_detail -->|"renders"| node_admin_charts
node_admin_product_detail -->|"requests income"| node_admin_http
node_admin_product_detail -->|"requests income"| node_api_server
node_admin_api_calls -->|"uses clients"| node_admin_http
node_admin_api_calls -->|"dispatches actions"| node_admin_product_state
node_admin_api_calls -->|"dispatches actions"| node_admin_user_state
node_admin_http -->|"targets API"| node_api_server
node_api_server -->|"mounts"| node_user_routes
node_api_server -->|"mounts"| node_auth_routes
node_api_server -->|"mounts"| node_product_routes
node_api_server -->|"mounts"| node_cart_routes
node_api_server -->|"mounts"| node_order_routes
node_api_server -->|"mounts"| node_stripe_routes
node_api_server -->|"connects"| node_mongo
node_auth_routes -->|"reads and writes"| node_user_model
node_user_routes -->|"uses model"| node_user_model
node_product_routes -->|"uses model"| node_product_model
node_cart_routes -->|"uses model"| node_cart_model
node_order_routes -->|"uses model"| node_order_model
node_cart_routes -->|"checks token"| node_token_guard
node_order_routes -->|"checks token"| node_token_guard
node_product_routes -->|"checks token"| node_token_guard
node_user_routes -->|"checks token"| node_token_guard

click node_admin_app "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/App.js"
click node_admin_login "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/login/Login.jsx"
click node_admin_home "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/home/Home.jsx"
click node_admin_charts "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/components/chart/Chart.jsx"
click node_admin_featured "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/components/featuredInfo/FeaturedInfo.jsx"
click node_admin_nav "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/components/sidebar/Sidebar.jsx"
click node_admin_user_list "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/userList/UserList.jsx"
click node_admin_user_detail "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/user/User.jsx"
click node_admin_user_new "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/newUser/NewUser.jsx"
click node_admin_product_list "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/productList/ProductList.jsx"
click node_admin_product_detail "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/product/Product.jsx"
click node_admin_product_new "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/newProduct/NewProduct.jsx"
click node_admin_upload_config "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/firebase.js"
click node_admin_api_calls "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/apiCalls.js"
click node_admin_product_state "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/productRedux.js"
click node_admin_user_state "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/userRedux.js"
click node_admin_http "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/requestMethods.js"
click node_api_server "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/index.js"
click node_auth_routes "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/auth.js"
click node_user_routes "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/user.js"
click node_product_routes "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/product.js"
click node_cart_routes "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/cart.js"
click node_order_routes "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/order.js"
click node_stripe_routes "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/stripe.js"
click node_token_guard "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/verifyToken.js"
click node_user_model "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/User.js"
click node_product_model "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/Product.js"
click node_cart_model "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/Cart.js"
click node_order_model "https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/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_admin_app,node_admin_login,node_admin_home,node_admin_charts,node_admin_featured,node_admin_nav,node_admin_user_list,node_admin_user_detail,node_admin_user_new,node_admin_product_list,node_admin_product_detail,node_admin_product_new toneBlue
class node_admin_upload_config,node_admin_api_calls,node_admin_product_state,node_admin_user_state,node_admin_http,node_mongo,node_image_storage toneAmber
class node_api_server,node_auth_routes,node_user_routes,node_product_routes,node_cart_routes,node_order_routes,node_stripe_routes,node_token_guard toneMint
class node_user_model,node_product_model,node_cart_model,node_order_model toneRose
class node_admin_actor toneIndigo
```

## Components

### Admin interface

- [Route shell](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/App.js): `admin/src/App.js`
- [Sign-in](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/login/Login.jsx): `admin/src/pages/login/Login.jsx`
- [Dashboard](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/home/Home.jsx): `admin/src/pages/home/Home.jsx`
- [Charts and metrics](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/components/chart/Chart.jsx): `admin/src/components/chart/Chart.jsx`
- [Summary metrics](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/components/featuredInfo/FeaturedInfo.jsx): `admin/src/components/featuredInfo/FeaturedInfo.jsx`
- [Sidebar navigation](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/components/sidebar/Sidebar.jsx): `admin/src/components/sidebar/Sidebar.jsx`
- [User list](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/userList/UserList.jsx): `admin/src/pages/userList/UserList.jsx`
- [User editor](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/user/User.jsx): `admin/src/pages/user/User.jsx`
- [Create user](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/newUser/NewUser.jsx): `admin/src/pages/newUser/NewUser.jsx`
- [Product list](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/productList/ProductList.jsx): `admin/src/pages/productList/ProductList.jsx`
- [Product editor](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/product/Product.jsx): `admin/src/pages/product/Product.jsx`
- [Create product](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/pages/newProduct/NewProduct.jsx): `admin/src/pages/newProduct/NewProduct.jsx`

### Admin data access

- [Image storage config](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/firebase.js): `admin/src/firebase.js`
- [API operations](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/apiCalls.js): `admin/src/redux/apiCalls.js`
- [Product state](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/productRedux.js): `admin/src/redux/productRedux.js`
- [User state](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/redux/userRedux.js): `admin/src/redux/userRedux.js`
- [HTTP clients](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/admin/src/requestMethods.js): `admin/src/requestMethods.js`

### API routes

- [Express API](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/index.js): `api/index.js`
- [Authentication](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/auth.js): `api/routes/auth.js`
- [User routes](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/user.js): `api/routes/user.js`
- [Product routes](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/product.js): `api/routes/product.js`
- [Cart routes](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/cart.js): `api/routes/cart.js`
- [Order and income](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/order.js): `api/routes/order.js`
- [Checkout routes](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/stripe.js): `api/routes/stripe.js`
- [Token authorization](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/routes/verifyToken.js): `api/routes/verifyToken.js`

### API domain

- [User records](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/User.js): `api/models/User.js`
- [Product records](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/Product.js): `api/models/Product.js`
- [Cart records](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/Cart.js): `api/models/Cart.js`
- [Order records](https://github.com/nourchene-hamrita/e-commerce-app/blob/master/api/models/Order.js): `api/models/Order.js`

### Other components

- **Administrator**
- **MongoDB**
- **Firebase Storage**

## Connections

- Administrator → Route shell: uses (evidence: `admin/src/App.js`)
- Route shell → Sign-in: routes to (evidence: `admin/src/App.js`)
- Route shell → Dashboard: routes to (evidence: `admin/src/App.js`)
- Route shell → User list: routes to (evidence: `admin/src/App.js`)
- Route shell → User editor: routes to (evidence: `admin/src/App.js`)
- Route shell → Create user: routes to (evidence: `admin/src/App.js`)
- Route shell → Product list: routes to (evidence: `admin/src/App.js`)
- Route shell → Product editor: routes to (evidence: `admin/src/App.js`)
- Route shell → Create product: routes to (evidence: `admin/src/App.js`)
- Route shell → Sidebar navigation: renders (evidence: `admin/src/App.js`)
- Dashboard → Charts and metrics: renders (evidence: `admin/src/pages/home/Home.jsx`)
- Dashboard → Summary metrics: renders (evidence: `admin/src/pages/home/Home.jsx`)
- Sign-in → API operations: calls (evidence: `admin/src/pages/login/Login.jsx`)
- Product list → API operations: calls (evidence: `admin/src/pages/productList/ProductList.jsx`)
- Create product → Image storage config: uses (evidence: `admin/src/pages/newProduct/NewProduct.jsx`)
- Create product → Firebase Storage: uploads image (evidence: `admin/src/pages/newProduct/NewProduct.jsx`)
- Create product → API operations: submits product (evidence: `admin/src/pages/newProduct/NewProduct.jsx`)
- Product editor → Charts and metrics: renders (evidence: `admin/src/pages/product/Product.jsx`)
- Product editor → HTTP clients: requests income (evidence: `admin/src/pages/product/Product.jsx`)
- Product editor → Express API: requests income (evidence: `admin/src/pages/product/Product.jsx`)
- API operations → HTTP clients: uses clients (evidence: `admin/src/redux/apiCalls.js`)
- API operations → Product state: dispatches actions (evidence: `admin/src/redux/apiCalls.js`)
- API operations → User state: dispatches actions (evidence: `admin/src/redux/apiCalls.js`)
- HTTP clients → Express API: targets API (evidence: `admin/src/requestMethods.js`)
- Express API → User routes: mounts (evidence: `api/index.js`)
- Express API → Authentication: mounts (evidence: `api/index.js`)
- Express API → Product routes: mounts (evidence: `api/index.js`)
- Express API → Cart routes: mounts (evidence: `api/index.js`)
- Express API → Order and income: mounts (evidence: `api/index.js`)
- Express API → Checkout routes: mounts (evidence: `api/index.js`)
- Express API → MongoDB: connects (evidence: `api/index.js`)
- Authentication → User records: reads and writes (evidence: `api/routes/auth.js`)
- User routes → User records: uses model (evidence: `api/routes/user.js`)
- Product routes → Product records: uses model (evidence: `api/routes/product.js`)
- Cart routes → Cart records: uses model (evidence: `api/routes/cart.js`)
- Order and income → Order records: uses model (evidence: `api/routes/order.js`)
- Cart routes → Token authorization: checks token (evidence: `api/routes/cart.js`)
- Order and income → Token authorization: checks token (evidence: `api/routes/order.js`)
- Product routes → Token authorization: checks token (evidence: `api/routes/product.js`)
- User routes → Token authorization: checks token (evidence: `api/routes/user.js`)
