# dharnezz/digital-market-place architecture

> Architecture diagram of the GitHub repository dharnezz/digital-market-place, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dharnezz/digital-market-place
- Repository: https://github.com/dharnezz/digital-market-place

## Overview

This is a full-stack digital-products marketplace: React pages consume a Spring REST API that enforces authentication, seller ownership, moderation, transaction rules, and download authorization. The principal buyer workflow is product discovery → cart → checkout → payment → order → purchase entitlement → digital library and authorized download. Sellers manage listings and admins moderate pending products; verified buyers can review products. The README documents the layered backend and these capabilities. Several subsystem links below reflect README documentation; unsampled implementation details are not asserted.

Main entry points: [`frontend/src/pages`](https://github.com/dharnezz/digital-market-place/tree/main/frontend/src/pages) (Feature pages), [`backend/src/main/java/com/digitalmarketplace/repository`](https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/repository) (Repositories), [`frontend/src/App.jsx`](https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/App.jsx) (React SPA), [`backend/src/main/java/com/digitalmarketplace/service/ProductService.java`](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/ProductService.java) (Product rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_spa["React SPA<br/>[App.jsx]"]
  node_routes["Route guards<br/>[AppRoutes.jsx]"]
  node_pages["Feature pages"]
  node_api["API client<br/>[api.js]"]
  node_authui["Auth state<br/>[AuthContext.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_authapi["Auth endpoints"]
  node_security["JWT security"]
end

subgraph group_catalog["Catalog and moderation"]
  node_productapi["Product endpoints"]
  node_productservice["Product rules"]
  node_moderation["Admin moderation"]
  node_category["Category service"]
end

subgraph group_commerce["Buying and delivery"]
  node_cart["Cart service<br/>[CartService.java]"]
  node_orders["Order service<br/>[OrderService.java]"]
  node_payments["Payment service"]
  node_processor["Payment processor"]
  node_entitlements["Purchase entitlements"]
  node_library["Library and download"]
  node_reviews["Verified-buyer reviews<br/>[ReviewService.java]"]
end

subgraph group_backend["Backend data and services"]
  node_repositories["Repositories"]
  node_database[("Marketplace database")]
end

node_buyer(("Buyer"))
node_seller(("Seller"))
node_admin(("Admin"))
node_files["External file storage"]

node_buyer -->|"browses and buys"| node_spa
node_seller -->|"manages listings"| node_spa
node_admin -->|"moderates listings"| node_spa
node_spa -->|"loads routes"| node_routes
node_routes -->|"routes to"| node_pages
node_pages -->|"requests data"| node_api
node_spa -->|"provides auth state"| node_authui
node_api -->|"calls REST API"| node_authapi
node_authapi -->|"issues JWT"| node_security
node_productapi -->|"delegates rules"| node_productservice
node_productservice -->|"queries listings"| node_repositories
node_moderation -->|"moderates products"| node_productservice
node_productservice -.->|"uses categories"| node_category
node_pages -->|"discovers products"| node_productapi
node_pages -->|"manages cart"| node_cart
node_cart -->|"reads and writes"| node_repositories
node_pages -->|"checks out"| node_orders
node_orders -->|"reads cart"| node_cart
node_orders -->|"validates products"| node_productservice
node_orders -->|"persists orders"| node_repositories
node_pages -->|"pays order"| node_payments
node_payments -->|"dispatches payment"| node_processor
node_payments -->|"grants purchase"| node_entitlements
node_pages -->|"views purchases"| node_library
node_library -->|"checks authorization"| node_entitlements
node_entitlements -->|"stores entitlements"| node_repositories
node_library -.->|"authorizes file access"| node_files
node_pages -->|"reads and submits reviews"| node_reviews
node_reviews -->|"reads and writes"| node_repositories
node_reviews -->|"verifies purchase"| node_entitlements
node_repositories -->|"persists entities"| node_database

click node_spa "https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_pages "https://github.com/dharnezz/digital-market-place/tree/main/frontend/src/pages"
click node_api "https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/services/api.js"
click node_authui "https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/context/AuthContext.jsx"
click node_authapi "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/AuthController.java"
click node_security "https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/security"
click node_productapi "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/ProductController.java"
click node_productservice "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/ProductService.java"
click node_moderation "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/ProductModerationController.java"
click node_category "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/CategoryService.java"
click node_cart "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/CartService.java"
click node_orders "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/OrderService.java"
click node_payments "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/PaymentService.java"
click node_processor "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/payment/MockPaymentProcessor.java"
click node_entitlements "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/PurchaseEntitlementService.java"
click node_library "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/DigitalLibraryController.java"
click node_reviews "https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/ReviewService.java"
click node_repositories "https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/repository"
click node_database "https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/entity"

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_spa,node_routes,node_pages,node_api,node_authui toneBlue
class node_authapi,node_security,node_files toneAmber
class node_productapi,node_productservice,node_moderation,node_category toneMint
class node_cart,node_orders,node_payments,node_processor,node_entitlements,node_library,node_reviews toneRose
class node_repositories,node_database,node_buyer,node_seller,node_admin toneIndigo
```

## Components

### React application

- [React SPA](https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Route guards](https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Feature pages](https://github.com/dharnezz/digital-market-place/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Auth state](https://github.com/dharnezz/digital-market-place/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`

### Identity and access

- [Auth endpoints](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/AuthController.java): `backend/src/main/java/com/digitalmarketplace/controller/AuthController.java`
- [JWT security](https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/security): `backend/src/main/java/com/digitalmarketplace/security`

### Catalog and moderation

- [Product endpoints](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/ProductController.java): `backend/src/main/java/com/digitalmarketplace/controller/ProductController.java`
- [Product rules](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/ProductService.java): `backend/src/main/java/com/digitalmarketplace/service/ProductService.java`
- [Admin moderation](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/ProductModerationController.java): `backend/src/main/java/com/digitalmarketplace/controller/ProductModerationController.java`
- [Category service](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/CategoryService.java): `backend/src/main/java/com/digitalmarketplace/service/CategoryService.java`

### Buying and delivery

- [Cart service](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/CartService.java): `backend/src/main/java/com/digitalmarketplace/service/CartService.java`
- [Order service](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/OrderService.java): `backend/src/main/java/com/digitalmarketplace/service/OrderService.java`
- [Payment service](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/PaymentService.java): `backend/src/main/java/com/digitalmarketplace/service/PaymentService.java`
- [Payment processor](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/payment/MockPaymentProcessor.java): `backend/src/main/java/com/digitalmarketplace/service/payment/MockPaymentProcessor.java`
- [Purchase entitlements](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/PurchaseEntitlementService.java): `backend/src/main/java/com/digitalmarketplace/service/PurchaseEntitlementService.java`
- [Library and download](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/controller/DigitalLibraryController.java): `backend/src/main/java/com/digitalmarketplace/controller/DigitalLibraryController.java`
- [Verified-buyer reviews](https://github.com/dharnezz/digital-market-place/blob/main/backend/src/main/java/com/digitalmarketplace/service/ReviewService.java): `backend/src/main/java/com/digitalmarketplace/service/ReviewService.java`

### Backend data and services

- [Repositories](https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/repository): `backend/src/main/java/com/digitalmarketplace/repository`
- [Marketplace database](https://github.com/dharnezz/digital-market-place/tree/main/backend/src/main/java/com/digitalmarketplace/entity): `backend/src/main/java/com/digitalmarketplace/entity`

### Other components

- **Buyer**
- **Seller**
- **Admin**
- **External file storage**

## Connections

- Buyer → React SPA: browses and buys (evidence: `README.md`)
- Seller → React SPA: manages listings (evidence: `README.md`)
- Admin → React SPA: moderates listings (evidence: `README.md`)
- React SPA → Route guards: loads routes (evidence: `frontend/src/App.jsx`)
- Route guards → Feature pages: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Feature pages → API client: requests data (evidence: `README.md`)
- React SPA → Auth state: provides auth state (evidence: `frontend/src/App.jsx`)
- API client → Auth endpoints: calls REST API (evidence: `README.md`)
- Auth endpoints → JWT security: issues JWT (evidence: `backend/src/main/java/com/digitalmarketplace/controller/AuthController.java`)
- Product endpoints → Product rules: delegates rules (evidence: `README.md`)
- Product rules → Repositories: queries listings (evidence: `backend/src/main/java/com/digitalmarketplace/service/ProductService.java`)
- Admin moderation → Product rules: moderates products (evidence: `README.md`)
- Product rules → Category service: uses categories
- Feature pages → Product endpoints: discovers products (evidence: `README.md`)
- Feature pages → Cart service: manages cart (evidence: `README.md`)
- Cart service → Repositories: reads and writes (evidence: `backend/src/main/java/com/digitalmarketplace/service/CartService.java`)
- Feature pages → Order service: checks out (evidence: `README.md`)
- Order service → Cart service: reads cart (evidence: `backend/src/main/java/com/digitalmarketplace/service/OrderService.java`)
- Order service → Product rules: validates products (evidence: `backend/src/main/java/com/digitalmarketplace/service/OrderService.java`)
- Order service → Repositories: persists orders (evidence: `backend/src/main/java/com/digitalmarketplace/service/OrderService.java`)
- Feature pages → Payment service: pays order (evidence: `README.md`)
- Payment service → Payment processor: dispatches payment (evidence: `README.md`)
- Payment service → Purchase entitlements: grants purchase (evidence: `README.md`)
- Feature pages → Library and download: views purchases (evidence: `README.md`)
- Library and download → Purchase entitlements: checks authorization (evidence: `README.md`)
- Purchase entitlements → Repositories: stores entitlements (evidence: `README.md`)
- Library and download → External file storage: authorizes file access
- Feature pages → Verified-buyer reviews: reads and submits reviews (evidence: `README.md`)
- Verified-buyer reviews → Repositories: reads and writes (evidence: `backend/src/main/java/com/digitalmarketplace/service/ReviewService.java`)
- Verified-buyer reviews → Purchase entitlements: verifies purchase (evidence: `backend/src/main/java/com/digitalmarketplace/service/ReviewService.java`)
- Repositories → Marketplace database: persists entities (evidence: `README.md`)
