# dissouri001/shop-ecommerce-devops-project- architecture

> Architecture diagram of the GitHub repository dissouri001/shop-ecommerce-devops-project-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dissouri001/shop-ecommerce-devops-project-
- Repository: https://github.com/dissouri001/shop-ecommerce-devops-project-

## Overview

SHOP is a technology e-commerce storefront with a React client and an Express API backed by MySQL. The shopper workflow loads and filters products, displays them, and adds selections to a browser-local cart; the UI explicitly describes that cart as a demonstration. The API also supports registration, login, admin product creation, authenticated checkout, and order history. Source excerpts show the route, database, and component relationships; the frontend does not connect its local cart to checkout in the sampled code.

Main entry points: [`shop/frontend/src/App.js`](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/App.js) (Storefront app), [`shop/backend/server.js`](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/server.js) (HTTP API server), [`shop/backend/config/db.js`](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/config/db.js) (MySQL connection pool), [`shop/backend/routes/products.js`](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/products.js) (Product routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["Storefront app<br/>[App.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_product_list["Product list<br/>[ProductList.js]"]
  node_product_card["Product card<br/>[ProductCard.js]"]
  node_browser_cart["Local cart<br/>[Cart.js]"]
end

subgraph group_api["Commerce API"]
  node_server["HTTP API server<br/>[server.js]"]
  node_product_routes["Product routes<br/>[products.js]"]
  node_cart_routes["Checkout and orders<br/>[cart.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Account routes<br/>[auth.js]"]
  node_auth_middleware["Token authorization<br/>[auth.js]"]
end

subgraph group_persistence["Persistence"]
  node_db_pool["MySQL connection pool<br/>[db.js]"]
  node_mysql[("MySQL database<br/>[init.sql]")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses storefront"| node_app
node_app -->|"fetches products"| node_api_client
node_app -->|"renders products"| node_product_list
node_app -->|"renders cart"| node_browser_cart
node_product_list -->|"renders cards"| node_product_card
node_app -->|"updates selections"| node_browser_cart
node_api_client -.->|"requests API"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_product_routes
node_server -->|"mounts routes"| node_cart_routes
node_server -->|"checks database"| node_db_pool
node_auth_routes -->|"reads and writes users"| node_db_pool
node_product_routes -->|"reads and writes products"| node_db_pool
node_cart_routes -->|"authenticates requests"| node_auth_middleware
node_product_routes -->|"guards admin creation"| node_auth_middleware
node_cart_routes -->|"records orders"| node_db_pool
node_db_pool -.->|"queries database"| node_mysql

click node_app "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/App.js"
click node_api_client "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/api.js"
click node_product_list "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/components/ProductList.js"
click node_product_card "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/components/ProductCard.js"
click node_browser_cart "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/components/Cart.js"
click node_server "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/server.js"
click node_product_routes "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/products.js"
click node_cart_routes "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/cart.js"
click node_auth_routes "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/auth.js"
click node_auth_middleware "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/middleware/auth.js"
click node_db_pool "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/config/db.js"
click node_mysql "https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/database/init.sql"

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,node_api_client,node_product_list,node_product_card,node_browser_cart toneBlue
class node_server,node_product_routes,node_cart_routes toneAmber
class node_auth_routes,node_auth_middleware toneMint
class node_db_pool,node_mysql toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [Storefront app](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/App.js): `shop/frontend/src/App.js`
- [API client](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/api.js): `shop/frontend/src/api.js`
- [Product list](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/components/ProductList.js): `shop/frontend/src/components/ProductList.js`
- [Product card](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/components/ProductCard.js): `shop/frontend/src/components/ProductCard.js`
- [Local cart](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/frontend/src/components/Cart.js): `shop/frontend/src/components/Cart.js`

### Commerce API

- [HTTP API server](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/server.js): `shop/backend/server.js`
- [Product routes](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/products.js): `shop/backend/routes/products.js`
- [Checkout and orders](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/cart.js): `shop/backend/routes/cart.js`

### Identity and access

- [Account routes](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/routes/auth.js): `shop/backend/routes/auth.js`
- [Token authorization](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/middleware/auth.js): `shop/backend/middleware/auth.js`

### Persistence

- [MySQL connection pool](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/backend/config/db.js): `shop/backend/config/db.js`
- [MySQL database](https://github.com/dissouri001/shop-ecommerce-devops-project-/blob/main/shop/database/init.sql): `shop/database/init.sql`

### Other components

- **Shopper**

## Connections

- Shopper → Storefront app: uses storefront (evidence: `shop/frontend/src/App.js`)
- Storefront app → API client: fetches products (evidence: `shop/frontend/src/App.js`)
- Storefront app → Product list: renders products (evidence: `shop/frontend/src/App.js`)
- Storefront app → Local cart: renders cart (evidence: `shop/frontend/src/App.js`)
- Product list → Product card: renders cards (evidence: `shop/frontend/src/components/ProductList.js`)
- Storefront app → Local cart: updates selections (evidence: `shop/frontend/src/App.js`)
- API client → HTTP API server: requests API (evidence: `shop/frontend/src/api.js`)
- HTTP API server → Account routes: mounts routes (evidence: `shop/backend/server.js`)
- HTTP API server → Product routes: mounts routes (evidence: `shop/backend/server.js`)
- HTTP API server → Checkout and orders: mounts routes (evidence: `shop/backend/server.js`)
- HTTP API server → MySQL connection pool: checks database (evidence: `shop/backend/server.js`)
- Account routes → MySQL connection pool: reads and writes users (evidence: `shop/backend/routes/auth.js`)
- Product routes → MySQL connection pool: reads and writes products (evidence: `shop/backend/routes/products.js`)
- Checkout and orders → Token authorization: authenticates requests (evidence: `shop/backend/routes/cart.js`)
- Product routes → Token authorization: guards admin creation (evidence: `shop/backend/routes/products.js`)
- Checkout and orders → MySQL connection pool: records orders (evidence: `shop/backend/routes/cart.js`)
- MySQL connection pool → MySQL database: queries database
