# spect-apple/cyberopus---e-commerce-book-shop architecture

> Architecture diagram of the GitHub repository spect-apple/cyberopus---e-commerce-book-shop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/spect-apple/cyberopus---e-commerce-book-shop
- Repository: https://github.com/spect-apple/cyberopus---e-commerce-book-shop

## Overview

CyberOpus is a full-stack online bookstore. Customers browse and filter books, manage a cart and addresses, check out with simulated payment and reward-point redemption, then view orders; the app also supports authentication, wishlists, recommendations, and admin catalog management. The graph shows the documented React-to-REST boundary and the sampled category, catalog, authentication, cart, and checkout behavior. Several backend controllers and services are unsampled, so their internal links are omitted rather than inferred.

Main entry points: [`frontend/src/api`](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/api) (API clients), [`backend/src/main/java/com/cyberopus/service/CheckoutService.java`](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/CheckoutService.java) (Checkout service), [`frontend/src/App.tsx`](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/App.tsx) (React routes), [`backend/src/main/java/com/cyberopus/service/AuthService.java`](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/AuthService.java) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["React routes<br/>[App.tsx]"]
  node_storefront["Storefront pages"]
  node_customer_pages["Customer pages"]
  node_admin_pages["Admin pages"]
  node_api_client["API clients"]
  node_cart_state["Cart state<br/>[CartContext.tsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_ui["Auth context<br/>[AuthContext.tsx]"]
  node_auth_controller["Auth endpoints"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT security"]
end

subgraph group_catalog["Book catalog"]
  node_catalog_pages["Catalog pages"]
  node_catalog_endpoints["Catalog endpoints"]
  node_book_service["Book service<br/>[BookService.java]"]
end

subgraph group_commerce["Shopping and orders"]
  node_cart_service["Cart service<br/>[CartService.java]"]
  node_checkout_pages["Checkout and orders"]
  node_checkout_endpoint["Checkout endpoint"]
  node_checkout_service["Checkout service"]
  node_commerce_services["Order reward services"]
end

subgraph group_backend["Backend persistence"]
  node_book_store[("Book repository")]
  node_commerce_store[("Commerce repositories")]
  node_user_store[("User repository")]
end

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

node_shopper -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes to"| node_storefront
node_app -->|"routes to"| node_customer_pages
node_app -->|"routes to"| node_admin_pages
node_storefront -.->|"requests data"| node_api_client
node_customer_pages -.->|"requests data"| node_api_client
node_admin_pages -.->|"requests data"| node_api_client
node_auth_ui -.->|"requests auth"| node_api_client
node_cart_state -->|"calls cart API"| node_api_client
node_api_client -->|"calls REST API"| node_auth_controller
node_api_client -->|"calls REST API"| node_catalog_endpoints
node_api_client -->|"calls REST API"| node_checkout_endpoint
node_catalog_pages -.->|"requests catalog"| node_api_client
node_auth_controller -.->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_user_store
node_auth_service -->|"generates token"| node_jwt
node_catalog_endpoints -->|"delegates to"| node_book_service
node_catalog_endpoints -->|"reads and writes"| node_book_store
node_book_service -->|"queries books"| node_book_store
node_checkout_pages -.->|"requests checkout"| node_api_client
node_checkout_endpoint -.->|"delegates to"| node_checkout_service
node_checkout_service -->|"reads and writes"| node_commerce_store
node_checkout_service -->|"loads user"| node_user_store
node_checkout_service -->|"locks and updates stock"| node_book_store
node_checkout_service -->|"earns points"| node_commerce_services
node_commerce_services -.->|"persists commerce data"| node_commerce_store

click node_app "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/App.tsx"
click node_storefront "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages"
click node_customer_pages "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages"
click node_admin_pages "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages/admin"
click node_api_client "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/api"
click node_cart_state "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/contexts/CartContext.tsx"
click node_auth_ui "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_auth_controller "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/controller/AuthController.java"
click node_auth_service "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/AuthService.java"
click node_jwt "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/security"
click node_catalog_pages "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages"
click node_catalog_endpoints "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/controller"
click node_book_service "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/BookService.java"
click node_book_store "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/repository/BookRepository.java"
click node_cart_service "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/CartService.java"
click node_checkout_pages "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages"
click node_checkout_endpoint "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/controller/CheckoutController.java"
click node_checkout_service "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/CheckoutService.java"
click node_commerce_services "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/service"
click node_commerce_store "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/repository"
click node_user_store "https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/repository/UserRepository.java"

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_storefront,node_customer_pages,node_admin_pages,node_api_client,node_cart_state toneBlue
class node_auth_ui,node_auth_controller,node_auth_service,node_jwt toneAmber
class node_catalog_pages,node_catalog_endpoints,node_book_service toneMint
class node_cart_service,node_checkout_pages,node_checkout_endpoint,node_checkout_service,node_commerce_services toneRose
class node_book_store,node_commerce_store,node_user_store,node_shopper,node_admin toneIndigo
```

## Components

### Web experience

- [React routes](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Storefront pages](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages): `frontend/src/pages`
- [Customer pages](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages): `frontend/src/pages`
- [Admin pages](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [API clients](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/api): `frontend/src/api`
- [Cart state](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/contexts/CartContext.tsx): `frontend/src/contexts/CartContext.tsx`

### Identity and access

- [Auth context](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [Auth endpoints](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/controller/AuthController.java): `backend/src/main/java/com/cyberopus/controller/AuthController.java`
- [Auth service](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/AuthService.java): `backend/src/main/java/com/cyberopus/service/AuthService.java`
- [JWT security](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/security): `backend/src/main/java/com/cyberopus/security`

### Book catalog

- [Catalog pages](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages): `frontend/src/pages`
- [Catalog endpoints](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/controller): `backend/src/main/java/com/cyberopus/controller`
- [Book service](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/BookService.java): `backend/src/main/java/com/cyberopus/service/BookService.java`

### Shopping and orders

- [Cart service](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/CartService.java): `backend/src/main/java/com/cyberopus/service/CartService.java`
- [Checkout and orders](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/frontend/src/pages): `frontend/src/pages`
- [Checkout endpoint](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/controller/CheckoutController.java): `backend/src/main/java/com/cyberopus/controller/CheckoutController.java`
- [Checkout service](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/service/CheckoutService.java): `backend/src/main/java/com/cyberopus/service/CheckoutService.java`
- [Order reward services](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/service): `backend/src/main/java/com/cyberopus/service`

### Backend persistence

- [Book repository](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/repository/BookRepository.java): `backend/src/main/java/com/cyberopus/repository/BookRepository.java`
- [Commerce repositories](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/tree/main/backend/src/main/java/com/cyberopus/repository): `backend/src/main/java/com/cyberopus/repository`
- [User repository](https://github.com/spect-apple/cyberopus---e-commerce-book-shop/blob/main/backend/src/main/java/com/cyberopus/repository/UserRepository.java): `backend/src/main/java/com/cyberopus/repository/UserRepository.java`

### Other components

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

## Connections

- Shopper → React routes: uses (evidence: `frontend/src/App.tsx`)
- Administrator → React routes: uses (evidence: `frontend/src/App.tsx`)
- React routes → Storefront pages: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Customer pages: routes to (evidence: `frontend/src/App.tsx`)
- React routes → Admin pages: routes to (evidence: `frontend/src/App.tsx`)
- Storefront pages → API clients: requests data (evidence: `frontend/src/pages/CheckoutPage.tsx`)
- Customer pages → API clients: requests data (evidence: `frontend/src/pages/CheckoutPage.tsx`)
- Admin pages → API clients: requests data
- Auth context → API clients: requests auth (evidence: `frontend/src/contexts/AuthContext.tsx`)
- Cart state → API clients: calls cart API (evidence: `frontend/src/contexts/CartContext.tsx`)
- API clients → Auth endpoints: calls REST API (evidence: `README.md`)
- API clients → Catalog endpoints: calls REST API (evidence: `README.md`)
- API clients → Checkout endpoint: calls REST API (evidence: `README.md`)
- Catalog pages → API clients: requests catalog (evidence: `frontend/src/pages/CheckoutPage.tsx`)
- Auth endpoints → Auth service: delegates to
- Auth service → User repository: reads and writes (evidence: `backend/src/main/java/com/cyberopus/service/AuthService.java`)
- Auth service → JWT security: generates token (evidence: `backend/src/main/java/com/cyberopus/service/AuthService.java`)
- Catalog endpoints → Book service: delegates to (evidence: `backend/src/main/java/com/cyberopus/controller/CategoryController.java`)
- Catalog endpoints → Book repository: reads and writes (evidence: `backend/src/main/java/com/cyberopus/controller/CategoryController.java`)
- Book service → Book repository: queries books (evidence: `backend/src/main/java/com/cyberopus/service/BookService.java`)
- Checkout and orders → API clients: requests checkout (evidence: `frontend/src/pages/CheckoutPage.tsx`)
- Checkout endpoint → Checkout service: delegates to
- Checkout service → Commerce repositories: reads and writes (evidence: `backend/src/main/java/com/cyberopus/service/CheckoutService.java`)
- Checkout service → User repository: loads user (evidence: `backend/src/main/java/com/cyberopus/service/CheckoutService.java`)
- Checkout service → Book repository: locks and updates stock (evidence: `backend/src/main/java/com/cyberopus/service/CheckoutService.java`)
- Checkout service → Order reward services: earns points (evidence: `backend/src/main/java/com/cyberopus/service/CheckoutService.java`)
- Order reward services → Commerce repositories: persists commerce data (evidence: `backend/src/main/java/com/cyberopus/service/AuthService.java`)
