# 246vansh/fullstack-ecommerce-app architecture

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

- Interactive diagram: https://gitdiagram.com/246vansh/fullstack-ecommerce-app
- Repository: https://github.com/246vansh/fullstack-ecommerce-app

## Overview

This repository implements an online storefront and commerce backend. The customer journey spans catalog browsing, cart and checkout, payment, order tracking, and reviews; separate capabilities cover authentication, account management, notifications, and administration. The backend is organized around HTTP routes, controllers, domain services, and a MariaDB/Prisma store. The tree identifies broad frontend capabilities, but its runtime wiring was not sampled; the graph therefore focuses on source-supported backend relationships and marks the storefront entry as unverified.

Main entry points: [`backend/services/orderService.js`](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/orderService.js) (Order Management), [`backend/config/db.js`](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/config/db.js) (MariaDB Store), [`backend/services/refundService.js`](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/refundService.js) (Refunds), [`backend/services/authService.js`](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/authService.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront_ui["Storefront UI"]
  node_frontend_services["Frontend Services"]
end

subgraph group_api["HTTP API"]
  node_server["API Server<br/>[server.js]"]
  node_routes["Route Registry<br/>[index.js]"]
  node_admin_routes["Admin Routes<br/>[adminRoutes.js]"]
  node_review_routes["Review Routes<br/>[reviewRoutes.js]"]
  node_admin_catalog["Admin Catalog"]
  node_review_controller["Review Controller"]
  node_auth_controller["Auth Controller<br/>[authController.js]"]
end

subgraph group_identity["Identity"]
  node_auth_service["Authentication<br/>[authService.js]"]
  node_refresh_tokens["Session Tokens"]
  node_jwt["JWT Utilities<br/>[jwt.js]"]
  node_auth_middleware["Auth Middleware<br/>[auth.js]"]
end

subgraph group_commerce["Commerce Services"]
  node_orders["Order Management<br/>[orderService.js]"]
  node_checkout["Checkout<br/>[checkoutService.js]"]
  node_pricing["Pricing<br/>[pricingService.js]"]
  node_coupons["Coupons<br/>[couponService.js]"]
  node_payments["Payments<br/>[paymentService.js]"]
  node_refunds["Refunds<br/>[refundService.js]"]
  node_reviews["Product Reviews<br/>[reviewService.js]"]
  node_notifications["Notifications"]
end

subgraph group_persistence["Persistence"]
  node_database[("MariaDB Store<br/>[db.js]")]
end

node_shopper(("Shopper"))

node_shopper -.->|"uses"| node_storefront_ui
node_storefront_ui -.->|"requests data"| node_frontend_services
node_frontend_services -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -.->|"registers"| node_admin_routes
node_admin_routes -->|"dispatches"| node_admin_catalog
node_admin_catalog -->|"accesses"| node_database
node_review_routes -->|"dispatches"| node_review_controller
node_review_controller -->|"delegates to"| node_reviews
node_reviews -->|"reads and writes"| node_database
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"revokes sessions"| node_refresh_tokens
node_auth_controller -->|"manages tokens"| node_refresh_tokens
node_refresh_tokens -->|"uses tokens"| node_jwt
node_auth_middleware -->|"verifies tokens"| node_jwt
node_auth_middleware -->|"checks sessions"| node_database
node_orders -->|"loads cart items"| node_checkout
node_orders -->|"claims coupons"| node_coupons
node_orders -->|"checks refund state"| node_refunds
node_orders -->|"reads and writes"| node_database
node_payments -->|"uses order service"| node_orders
node_payments -->|"uses refund service"| node_refunds
node_refunds -->|"restores stock"| node_orders
node_refunds -->|"converts amounts"| node_pricing
node_orders -->|"prices orders"| node_pricing
node_orders -->|"uses notifications"| node_notifications
node_coupons -->|"calculates discounts"| node_pricing
node_auth_service -->|"accesses"| node_database

click node_storefront_ui "https://github.com/246vansh/fullstack-ecommerce-app/tree/main/frontend/src/pages"
click node_frontend_services "https://github.com/246vansh/fullstack-ecommerce-app/tree/main/frontend/src/services"
click node_server "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/server.js"
click node_routes "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/routes/index.js"
click node_admin_routes "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/routes/adminRoutes.js"
click node_review_routes "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/routes/reviewRoutes.js"
click node_admin_catalog "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/controllers/adminCatalogController.js"
click node_review_controller "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/controllers/reviewController.js"
click node_auth_controller "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/controllers/authController.js"
click node_auth_service "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/authService.js"
click node_refresh_tokens "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/refreshTokenService.js"
click node_jwt "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/utils/jwt.js"
click node_auth_middleware "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/middleware/auth.js"
click node_orders "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/orderService.js"
click node_checkout "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/checkoutService.js"
click node_pricing "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/pricingService.js"
click node_coupons "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/couponService.js"
click node_payments "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/paymentService.js"
click node_refunds "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/refundService.js"
click node_reviews "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/reviewService.js"
click node_notifications "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/notificationService.js"
click node_database "https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/config/db.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_storefront_ui,node_frontend_services toneBlue
class node_server,node_routes,node_admin_routes,node_review_routes,node_admin_catalog,node_review_controller,node_auth_controller toneAmber
class node_auth_service,node_refresh_tokens,node_jwt,node_auth_middleware toneMint
class node_orders,node_checkout,node_pricing,node_coupons,node_payments,node_refunds,node_reviews,node_notifications toneRose
class node_database,node_shopper toneIndigo
```

## Components

### Storefront

- [Storefront UI](https://github.com/246vansh/fullstack-ecommerce-app/tree/main/frontend/src/pages): `frontend/src/pages`
- [Frontend Services](https://github.com/246vansh/fullstack-ecommerce-app/tree/main/frontend/src/services): `frontend/src/services`

### HTTP API

- [API Server](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/server.js): `backend/server.js`
- [Route Registry](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/routes/index.js): `backend/routes/index.js`
- [Admin Routes](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Review Routes](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/routes/reviewRoutes.js): `backend/routes/reviewRoutes.js`
- [Admin Catalog](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/controllers/adminCatalogController.js): `backend/controllers/adminCatalogController.js`
- [Review Controller](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/controllers/reviewController.js): `backend/controllers/reviewController.js`
- [Auth Controller](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`

### Identity

- [Authentication](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/authService.js): `backend/services/authService.js`
- [Session Tokens](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/refreshTokenService.js): `backend/services/refreshTokenService.js`
- [JWT Utilities](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/utils/jwt.js): `backend/utils/jwt.js`
- [Auth Middleware](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`

### Commerce Services

- [Order Management](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/orderService.js): `backend/services/orderService.js`
- [Checkout](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/checkoutService.js): `backend/services/checkoutService.js`
- [Pricing](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/pricingService.js): `backend/services/pricingService.js`
- [Coupons](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/couponService.js): `backend/services/couponService.js`
- [Payments](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/paymentService.js): `backend/services/paymentService.js`
- [Refunds](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/refundService.js): `backend/services/refundService.js`
- [Product Reviews](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/reviewService.js): `backend/services/reviewService.js`
- [Notifications](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/services/notificationService.js): `backend/services/notificationService.js`

### Persistence

- [MariaDB Store](https://github.com/246vansh/fullstack-ecommerce-app/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Shopper**

## Connections

- Shopper → Storefront UI: uses
- Storefront UI → Frontend Services: requests data
- Frontend Services → API Server: calls API
- API Server → Route Registry: mounts routes (evidence: `backend/server.js`)
- Route Registry → Admin Routes: registers
- Admin Routes → Admin Catalog: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Admin Catalog → MariaDB Store: accesses
- Review Routes → Review Controller: dispatches (evidence: `backend/routes/reviewRoutes.js`)
- Review Controller → Product Reviews: delegates to (evidence: `backend/controllers/reviewController.js`)
- Product Reviews → MariaDB Store: reads and writes (evidence: `backend/services/reviewService.js`)
- Auth Controller → Authentication: delegates to (evidence: `backend/controllers/authController.js`)
- Authentication → Session Tokens: revokes sessions (evidence: `backend/services/authService.js`)
- Auth Controller → Session Tokens: manages tokens (evidence: `backend/controllers/authController.js`)
- Session Tokens → JWT Utilities: uses tokens (evidence: `backend/services/refreshTokenService.js`)
- Auth Middleware → JWT Utilities: verifies tokens (evidence: `backend/middleware/auth.js`)
- Auth Middleware → MariaDB Store: checks sessions (evidence: `backend/middleware/auth.js`)
- Order Management → Checkout: loads cart items (evidence: `backend/services/orderService.js`)
- Order Management → Coupons: claims coupons (evidence: `backend/services/orderService.js`)
- Order Management → Refunds: checks refund state (evidence: `backend/services/orderService.js`)
- Order Management → MariaDB Store: reads and writes (evidence: `backend/services/orderService.js`)
- Payments → Order Management: uses order service (evidence: `backend/services/paymentService.js`)
- Payments → Refunds: uses refund service (evidence: `backend/services/paymentService.js`)
- Refunds → Order Management: restores stock (evidence: `backend/services/refundService.js`)
- Refunds → Pricing: converts amounts (evidence: `backend/services/refundService.js`)
- Order Management → Pricing: prices orders (evidence: `backend/services/orderService.js`)
- Order Management → Notifications: uses notifications (evidence: `backend/services/orderService.js`)
- Coupons → Pricing: calculates discounts (evidence: `backend/services/couponService.js`)
- Authentication → MariaDB Store: accesses (evidence: `backend/services/authService.js`)
