# devops002026-web/k8_opsnova_bookstore architecture

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

- Interactive diagram: https://gitdiagram.com/devops002026-web/k8_opsnova_bookstore
- Repository: https://github.com/devops002026-web/k8_opsnova_bookstore

## Overview

OpsNova is a Kubernetes teaching application: its catalog serves a tools-themed catalog and metadata, while a separate order service places orders after checking catalog stock and price. The primary flow is a user submitting an order through the order service, which calls the catalog over HTTP and persists a confirmed order. Catalog browsing and JWT login are separate user flows. Relationships use the excerpts, SOURCE INDEX references, and README statements; some profile-specific wiring and unexcerpted modules are therefore represented only where documented.

Main entry points: [`catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java`](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java) (Browser login), [`order-service/src/main/java/tech/opsnova/order/service/OrderService.java`](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/service/OrderService.java) (Order service), [`catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java`](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java) (Login API), [`catalog-service/src/main/java/tech/opsnova/catalog/controller/BookController.java`](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/BookController.java) (Book API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog service"]
  node_catalog_views["Catalog pages"]
  node_catalog_api["Book API"]
  node_book_service["Book service<br/>[BookService.java]"]
  node_book_store["Book repository"]
  node_books_db[("Books database")]
end

subgraph group_orders["Order service"]
  node_catalog_client["Catalog client<br/>[CatalogClient.java]"]
  node_order_api["Order API"]
  node_order_views["Order pages"]
  node_order_service["Order service<br/>[OrderService.java]"]
  node_order_store["Order repository"]
  node_orders_db[("Orders database")]
end

subgraph group_identity["Authentication"]
  node_login_view["Browser login"]
  node_auth_api["Login API"]
  node_users["User credentials"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_revocation["Token revocation"]
  node_redis_revocation["Redis revocation"]
end

subgraph group_runtime["Runtime metadata"]
  node_catalog_info["Catalog pod info"]
  node_order_info["Order pod info"]
end

node_user(("User"))
node_api_client(("API client"))
node_redis[("Redis")]
node_postgres[("PostgreSQL")]

node_user -->|"browses"| node_catalog_views
node_user -->|"places orders"| node_order_views
node_api_client -->|"submits orders"| node_order_api
node_api_client -->|"requests books"| node_catalog_api
node_catalog_views -->|"loads books"| node_book_service
node_catalog_api -->|"delegates"| node_book_service
node_book_service -->|"reads and writes"| node_book_store
node_book_store -->|"persists books"| node_books_db
node_order_api -->|"delegates"| node_order_service
node_order_views -->|"delegates"| node_order_service
node_order_service -->|"checks stock and price"| node_catalog_client
node_catalog_client -->|"requests book data"| node_catalog_api
node_order_service -->|"saves and queries"| node_order_store
node_order_store -->|"persists orders"| node_orders_db
node_user -->|"logs in"| node_login_view
node_login_view -->|"authenticates"| node_users
node_login_view -->|"issues token"| node_jwt
node_login_view -->|"revokes token"| node_revocation
node_auth_api -->|"authenticates"| node_users
node_auth_api -->|"issues token"| node_jwt
node_auth_api -->|"uses revocation"| node_revocation
node_redis_revocation -->|"reads and writes"| node_redis
node_revocation -.->|"optional implementation"| node_redis_revocation
node_catalog_info -->|"reports pod info"| node_user
node_order_info -.->|"reports pod info"| node_user
node_books_db -.->|"external-db profile"| node_postgres
node_orders_db -.->|"external-db profile"| node_postgres

click node_catalog_views "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/web/BookViewController.java"
click node_catalog_api "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/BookController.java"
click node_book_service "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/service/BookService.java"
click node_book_store "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/repository/BookRepository.java"
click node_catalog_client "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/client/CatalogClient.java"
click node_order_api "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/controller/OrderController.java"
click node_order_views "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/web/OrderViewController.java"
click node_order_service "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/service/OrderService.java"
click node_order_store "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/repository/OrderRepository.java"
click node_login_view "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java"
click node_auth_api "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java"
click node_users "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/HardcodedUsers.java"
click node_jwt "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/JwtService.java"
click node_revocation "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/TokenRevocationService.java"
click node_redis_revocation "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/RedisTokenRevocationService.java"
click node_catalog_info "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/InfoController.java"
click node_order_info "https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/controller/InfoController.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_catalog_views,node_catalog_api,node_book_service,node_book_store,node_books_db,node_user,node_api_client toneBlue
class node_catalog_client,node_order_api,node_order_views,node_order_service,node_order_store,node_orders_db,node_redis,node_postgres toneAmber
class node_login_view,node_auth_api,node_users,node_jwt,node_revocation,node_redis_revocation toneMint
class node_catalog_info,node_order_info toneRose
```

## Components

### Catalog service

- [Catalog pages](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/web/BookViewController.java): `catalog-service/src/main/java/tech/opsnova/catalog/web/BookViewController.java`
- [Book API](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/BookController.java): `catalog-service/src/main/java/tech/opsnova/catalog/controller/BookController.java`
- [Book service](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/service/BookService.java): `catalog-service/src/main/java/tech/opsnova/catalog/service/BookService.java`
- [Book repository](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/repository/BookRepository.java): `catalog-service/src/main/java/tech/opsnova/catalog/repository/BookRepository.java`
- **Books database**

### Order service

- [Catalog client](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/client/CatalogClient.java): `order-service/src/main/java/tech/opsnova/order/client/CatalogClient.java`
- [Order API](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/controller/OrderController.java): `order-service/src/main/java/tech/opsnova/order/controller/OrderController.java`
- [Order pages](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/web/OrderViewController.java): `order-service/src/main/java/tech/opsnova/order/web/OrderViewController.java`
- [Order service](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/service/OrderService.java): `order-service/src/main/java/tech/opsnova/order/service/OrderService.java`
- [Order repository](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/repository/OrderRepository.java): `order-service/src/main/java/tech/opsnova/order/repository/OrderRepository.java`
- **Orders database**

### Authentication

- [Browser login](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java): `catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java`
- [Login API](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java): `catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java`
- [User credentials](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/HardcodedUsers.java): `catalog-service/src/main/java/tech/opsnova/catalog/security/HardcodedUsers.java`
- [JWT service](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/JwtService.java): `catalog-service/src/main/java/tech/opsnova/catalog/security/JwtService.java`
- [Token revocation](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/TokenRevocationService.java): `catalog-service/src/main/java/tech/opsnova/catalog/security/TokenRevocationService.java`
- [Redis revocation](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/security/RedisTokenRevocationService.java): `catalog-service/src/main/java/tech/opsnova/catalog/security/RedisTokenRevocationService.java`

### Runtime metadata

- [Catalog pod info](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/catalog-service/src/main/java/tech/opsnova/catalog/controller/InfoController.java): `catalog-service/src/main/java/tech/opsnova/catalog/controller/InfoController.java`
- [Order pod info](https://github.com/devops002026-web/k8_opsnova_bookstore/blob/main/order-service/src/main/java/tech/opsnova/order/controller/InfoController.java): `order-service/src/main/java/tech/opsnova/order/controller/InfoController.java`

### Other components

- **User**
- **API client**
- **Redis**
- **PostgreSQL**

## Connections

- User → Catalog pages: browses (evidence: `README.md`)
- User → Order pages: places orders (evidence: `README.md`)
- API client → Order API: submits orders (evidence: `README.md`)
- API client → Book API: requests books (evidence: `README.md`)
- Catalog pages → Book service: loads books (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/web/BookViewController.java`)
- Book API → Book service: delegates (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/controller/BookController.java`)
- Book service → Book repository: reads and writes (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/service/BookService.java`)
- Book repository → Books database: persists books (evidence: `README.md`)
- Order API → Order service: delegates (evidence: `order-service/src/main/java/tech/opsnova/order/controller/OrderController.java`)
- Order pages → Order service: delegates (evidence: `order-service/src/main/java/tech/opsnova/order/web/OrderViewController.java`)
- Order service → Catalog client: checks stock and price (evidence: `order-service/src/main/java/tech/opsnova/order/service/OrderService.java`)
- Catalog client → Book API: requests book data (evidence: `README.md`)
- Order service → Order repository: saves and queries (evidence: `order-service/src/main/java/tech/opsnova/order/service/OrderService.java`)
- Order repository → Orders database: persists orders (evidence: `README.md`)
- User → Browser login: logs in (evidence: `README.md`)
- Browser login → User credentials: authenticates (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java`)
- Browser login → JWT service: issues token (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java`)
- Browser login → Token revocation: revokes token (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/web/LoginViewController.java`)
- Login API → User credentials: authenticates (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java`)
- Login API → JWT service: issues token (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java`)
- Login API → Token revocation: uses revocation (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/controller/AuthController.java`)
- Redis revocation → Redis: reads and writes (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/security/RedisTokenRevocationService.java`)
- Token revocation → Redis revocation: optional implementation (evidence: `catalog-service/src/main/java/tech/opsnova/catalog/security/RedisTokenRevocationService.java`)
- Catalog pod info → User: reports pod info (evidence: `README.md`)
- Order pod info → User: reports pod info (evidence: `README.md`)
- Books database → PostgreSQL: external-db profile (evidence: `README.md`)
- Orders database → PostgreSQL: external-db profile (evidence: `README.md`)
