# dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline architecture

> Architecture diagram of the GitHub repository dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline, 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/full-stack-task-ecommercemanager-with-devops-pipeline
- Repository: https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline

## Overview

This is a full-stack commerce application: shoppers browse products, register or sign in, add items to a cart, and proceed through order and Stripe checkout; administrators manage products. The React client calls an Express API backed by Prisma and PostgreSQL, with JWT authentication guarding user and admin actions. The README also documents Docker-based local operation and Stripe test payments. The graph preserves those major capabilities; backend registration and route wiring are cited where shown, while some client-to-API and payment relationships are documented or left unverified because their calling excerpts are unavailable.

Main entry points: [`client/src/App.jsx`](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/App.jsx) (App routing), [`client/src/api/axios.js`](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/api/axios.js) (HTTP client), [`client/src/context/AuthContext.jsx`](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/context/AuthContext.jsx) (Auth state), [`server/src/config/db.js`](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/config/db.js) (Prisma client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Shopper client"]
  node_app["App routing<br/>[App.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_catalog["Product browsing<br/>[Home.jsx]"]
  node_product["Product details<br/>[ProductDetails.jsx]"]
  node_productcard["Product card<br/>[ProductCard.jsx]"]
  node_cartstate["Cart state<br/>[CartContext.jsx]"]
  node_cartpage["Cart checkout<br/>[Cart.jsx]"]
  node_success["Checkout success"]
  node_login["Sign in<br/>[Login.jsx]"]
  node_register["Registration<br/>[Register.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_http["HTTP client<br/>[axios.js]"]
end

subgraph group_api["Commerce API"]
  node_productroutes["Product routes<br/>[productRoutes.js]"]
  node_productcontroller["Product management"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth handling<br/>[authController.js]"]
  node_orderroutes["Order routes<br/>[orderRoutes.js]"]
  node_ordercontroller["Order processing<br/>[orderController.js]"]
  node_paymentroutes["Payment routes<br/>[paymentRoutes.js]"]
  node_paymentcontroller["Payment handling"]
end

subgraph group_data["Persistence and payments"]
  node_database[("PostgreSQL<br/>[schema.prisma]")]
  node_prisma["Prisma client<br/>[db.js]"]
  node_stripe["Stripe"]
end

subgraph group_security["Identity and access"]
  node_authmiddleware["JWT access<br/>[auth.js]"]
end

node_shopper(("Shopper"))
node_admin(("Administrator"))

node_shopper -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_product
node_app -->|"routes to"| node_cartpage
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_adminui
node_app -->|"routes to"| node_success
node_catalog -->|"renders"| node_productcard
node_productcard -->|"adds item"| node_cartstate
node_product -->|"adds item"| node_cartstate
node_cartpage -->|"reads cart"| node_cartstate
node_login -->|"signs in"| node_authstate
node_register -->|"registers"| node_authstate
node_navbar -->|"uses identity"| node_authstate
node_navbar -->|"reads cart"| node_cartstate
node_adminui -->|"calls API"| node_http
node_catalog -->|"calls API"| node_http
node_product -->|"calls API"| node_http
node_cartpage -->|"calls API"| node_http
node_authstate -->|"sends auth requests"| node_http
node_http -.->|"HTTP requests"| node_productroutes
node_http -.->|"HTTP requests"| node_authroutes
node_http -.->|"HTTP requests"| node_orderroutes
node_http -.->|"HTTP requests"| node_paymentroutes
node_productroutes -->|"dispatches"| node_productcontroller
node_authroutes -->|"dispatches"| node_authcontroller
node_orderroutes -->|"dispatches"| node_ordercontroller
node_paymentroutes -->|"dispatches"| node_paymentcontroller
node_productcontroller -->|"queries"| node_prisma
node_authcontroller -->|"queries"| node_prisma
node_ordercontroller -->|"queries and updates"| node_prisma
node_prisma -.->|"persists data"| node_database
node_paymentcontroller -.->|"creates checkout"| node_stripe
node_authroutes -.->|"guards routes"| node_authmiddleware
node_orderroutes -->|"guards routes"| node_authmiddleware
node_paymentroutes -->|"guards routes"| node_authmiddleware
node_productroutes -->|"guards admin actions"| node_authmiddleware

click node_app "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/App.jsx"
click node_navbar "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/components/Navbar.jsx"
click node_catalog "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Home.jsx"
click node_product "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/ProductDetails.jsx"
click node_productcard "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/components/ProductCard.jsx"
click node_cartstate "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/context/CartContext.jsx"
click node_cartpage "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Cart.jsx"
click node_success "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/CheckoutSuccess.jsx"
click node_login "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Login.jsx"
click node_register "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Register.jsx"
click node_authstate "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/context/AuthContext.jsx"
click node_adminui "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/AdminDashboard.jsx"
click node_http "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/api/axios.js"
click node_productroutes "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/productRoutes.js"
click node_productcontroller "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/productController.js"
click node_authroutes "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/authRoutes.js"
click node_authcontroller "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/authController.js"
click node_orderroutes "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/orderRoutes.js"
click node_ordercontroller "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/orderController.js"
click node_paymentroutes "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/paymentRoutes.js"
click node_paymentcontroller "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/paymentController.js"
click node_database "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/prisma/schema.prisma"
click node_prisma "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/config/db.js"
click node_authmiddleware "https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/middleware/auth.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,node_navbar,node_catalog,node_product,node_productcard,node_cartstate,node_cartpage,node_success,node_login,node_register,node_authstate,node_adminui,node_http toneBlue
class node_productroutes,node_productcontroller,node_authroutes,node_authcontroller,node_orderroutes,node_ordercontroller,node_paymentroutes,node_paymentcontroller toneAmber
class node_database,node_prisma,node_stripe toneMint
class node_authmiddleware toneRose
class node_shopper,node_admin toneIndigo
```

## Components

### Shopper client

- [App routing](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Navigation](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/components/Navbar.jsx): `client/src/components/Navbar.jsx`
- [Product browsing](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Home.jsx): `client/src/pages/Home.jsx`
- [Product details](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/ProductDetails.jsx): `client/src/pages/ProductDetails.jsx`
- [Product card](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/components/ProductCard.jsx): `client/src/components/ProductCard.jsx`
- [Cart state](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/context/CartContext.jsx): `client/src/context/CartContext.jsx`
- [Cart checkout](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Cart.jsx): `client/src/pages/Cart.jsx`
- [Checkout success](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/CheckoutSuccess.jsx): `client/src/pages/CheckoutSuccess.jsx`
- [Sign in](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Registration](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/Register.jsx): `client/src/pages/Register.jsx`
- [Auth state](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Admin dashboard](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/pages/AdminDashboard.jsx): `client/src/pages/AdminDashboard.jsx`
- [HTTP client](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/client/src/api/axios.js): `client/src/api/axios.js`

### Commerce API

- [Product routes](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/productRoutes.js): `server/src/routes/productRoutes.js`
- [Product management](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/productController.js): `server/src/controllers/productController.js`
- [Auth routes](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Auth handling](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [Order routes](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/orderRoutes.js): `server/src/routes/orderRoutes.js`
- [Order processing](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/orderController.js): `server/src/controllers/orderController.js`
- [Payment routes](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/routes/paymentRoutes.js): `server/src/routes/paymentRoutes.js`
- [Payment handling](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/controllers/paymentController.js): `server/src/controllers/paymentController.js`

### Persistence and payments

- [PostgreSQL](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/prisma/schema.prisma): `server/prisma/schema.prisma`
- [Prisma client](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/config/db.js): `server/src/config/db.js`
- **Stripe**

### Identity and access

- [JWT access](https://github.com/dissouri001/full-stack-task-ecommercemanager-with-devops-pipeline/blob/main/server/src/middleware/auth.js): `server/src/middleware/auth.js`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → App routing: uses (evidence: `client/src/App.jsx`)
- Administrator → App routing: uses (evidence: `client/src/App.jsx`)
- App routing → Navigation: renders (evidence: `client/src/App.jsx`)
- App routing → Product browsing: routes to (evidence: `client/src/App.jsx`)
- App routing → Product details: routes to (evidence: `client/src/App.jsx`)
- App routing → Cart checkout: routes to (evidence: `client/src/App.jsx`)
- App routing → Sign in: routes to (evidence: `client/src/App.jsx`)
- App routing → Registration: routes to (evidence: `client/src/App.jsx`)
- App routing → Admin dashboard: routes to (evidence: `client/src/App.jsx`)
- App routing → Checkout success: routes to (evidence: `client/src/App.jsx`)
- Product browsing → Product card: renders (evidence: `client/src/pages/Home.jsx`)
- Product card → Cart state: adds item (evidence: `client/src/components/ProductCard.jsx`)
- Product details → Cart state: adds item (evidence: `client/src/pages/ProductDetails.jsx`)
- Cart checkout → Cart state: reads cart (evidence: `client/src/pages/Cart.jsx`)
- Sign in → Auth state: signs in (evidence: `client/src/pages/Login.jsx`)
- Registration → Auth state: registers (evidence: `client/src/pages/Register.jsx`)
- Navigation → Auth state: uses identity (evidence: `client/src/components/Navbar.jsx`)
- Navigation → Cart state: reads cart (evidence: `client/src/components/Navbar.jsx`)
- Admin dashboard → HTTP client: calls API (evidence: `client/src/pages/AdminDashboard.jsx`)
- Product browsing → HTTP client: calls API (evidence: `client/src/pages/Home.jsx`)
- Product details → HTTP client: calls API (evidence: `client/src/pages/ProductDetails.jsx`)
- Cart checkout → HTTP client: calls API (evidence: `client/src/pages/Cart.jsx`)
- Auth state → HTTP client: sends auth requests (evidence: `client/src/context/AuthContext.jsx`)
- HTTP client → Product routes: HTTP requests
- HTTP client → Auth routes: HTTP requests
- HTTP client → Order routes: HTTP requests
- HTTP client → Payment routes: HTTP requests
- Product routes → Product management: dispatches (evidence: `server/src/routes/productRoutes.js`)
- Auth routes → Auth handling: dispatches (evidence: `server/src/routes/authRoutes.js`)
- Order routes → Order processing: dispatches (evidence: `server/src/routes/orderRoutes.js`)
- Payment routes → Payment handling: dispatches (evidence: `server/src/routes/paymentRoutes.js`)
- Product management → Prisma client: queries (evidence: `server/src/controllers/productController.js`)
- Auth handling → Prisma client: queries (evidence: `server/src/controllers/authController.js`)
- Order processing → Prisma client: queries and updates (evidence: `server/src/controllers/orderController.js`)
- Prisma client → PostgreSQL: persists data
- Payment handling → Stripe: creates checkout
- Auth routes → JWT access: guards routes
- Order routes → JWT access: guards routes (evidence: `server/src/routes/orderRoutes.js`)
- Payment routes → JWT access: guards routes (evidence: `server/src/routes/paymentRoutes.js`)
- Product routes → JWT access: guards admin actions (evidence: `server/src/routes/productRoutes.js`)
