# mikenito/onlinebookstore architecture

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

- Interactive diagram: https://gitdiagram.com/mikenito/onlinebookstore
- Repository: https://github.com/mikenito/onlinebookstore

## Overview

OnlineBookStore is a Spring Boot REST API for looking up books and creating or listing orders. A client submits an ISBN and quantity; the order service resolves the book, rejects an unknown ISBN, and saves the order. The README also documents Basic authentication and PostgreSQL, though database configuration and the security-to-request wiring were not sampled. The graph shows documented API capabilities and source-visible service calls; optional framework and persistence connections are dashed where their wiring is not shown.

Main entry points: [`src/main/java/com/online/book/store/services/OrderService.java`](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/services/OrderService.java) (Order operations), [`src/main/java/com/online/book/store/repositories/BookRepository.java`](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/repositories/BookRepository.java) (Book repository), [`src/main/java/com/online/book/store/repositories/OrderRepository.java`](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/repositories/OrderRepository.java) (Order repository), [`src/main/java/com/online/book/store/controllers/OrderController.java`](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/controllers/OrderController.java) (Order endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API access"]
  node_security["Basic authentication"]
  node_order_api["Order endpoints"]
end

subgraph group_catalog["Book catalog"]
  node_book_service["Book lookup<br/>[BookService.java]"]
  node_book_model["Book record<br/>[Book.java]"]
end

subgraph group_orders["Order processing"]
  node_order_service["Order operations<br/>[OrderService.java]"]
  node_order_model["Order record<br/>[Order.java]"]
  node_not_found["Missing-book error"]
end

subgraph group_persistence["Persistence"]
  node_book_repository["Book repository"]
  node_order_repository["Order repository"]
end

node_client(("API client"))
node_postgres[("PostgreSQL")]

node_client -->|"calls API"| node_order_api
node_client -.->|"authenticates"| node_security
node_security -.->|"protects requests"| node_order_api
node_order_api -->|"submits or lists"| node_order_service
node_order_service -->|"looks up ISBN"| node_book_service
node_book_service -->|"queries ISBN"| node_book_repository
node_order_service -->|"saves or lists"| node_order_repository
node_order_service -->|"throws if absent"| node_not_found
node_book_repository -->|"queries entity"| node_book_model
node_order_repository -->|"stores entity"| node_order_model
node_order_model -->|"references book"| node_book_model
node_book_repository -.->|"persists records"| node_postgres
node_order_repository -.->|"persists records"| node_postgres

click node_security "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/security/WebSecurityConfig.java"
click node_order_api "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/controllers/OrderController.java"
click node_book_service "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/services/BookService.java"
click node_book_model "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/domain/Book.java"
click node_book_repository "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/repositories/BookRepository.java"
click node_order_service "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/services/OrderService.java"
click node_order_model "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/domain/Order.java"
click node_not_found "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/exceptions/BookNotFoundException.java"
click node_order_repository "https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/repositories/OrderRepository.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_security,node_order_api,node_client toneBlue
class node_book_service,node_book_model,node_postgres toneAmber
class node_order_service,node_order_model,node_not_found toneMint
class node_book_repository,node_order_repository toneRose
```

## Components

### API access

- [Basic authentication](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/security/WebSecurityConfig.java): `src/main/java/com/online/book/store/security/WebSecurityConfig.java`
- [Order endpoints](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/controllers/OrderController.java): `src/main/java/com/online/book/store/controllers/OrderController.java`

### Book catalog

- [Book lookup](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/services/BookService.java): `src/main/java/com/online/book/store/services/BookService.java`
- [Book record](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/domain/Book.java): `src/main/java/com/online/book/store/domain/Book.java`

### Order processing

- [Order operations](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/services/OrderService.java): `src/main/java/com/online/book/store/services/OrderService.java`
- [Order record](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/domain/Order.java): `src/main/java/com/online/book/store/domain/Order.java`
- [Missing-book error](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/exceptions/BookNotFoundException.java): `src/main/java/com/online/book/store/exceptions/BookNotFoundException.java`

### Persistence

- [Book repository](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/repositories/BookRepository.java): `src/main/java/com/online/book/store/repositories/BookRepository.java`
- [Order repository](https://github.com/mikenito/onlinebookstore/blob/master/src/main/java/com/online/book/store/repositories/OrderRepository.java): `src/main/java/com/online/book/store/repositories/OrderRepository.java`

### Other components

- **API client**
- **PostgreSQL**

## Connections

- API client → Order endpoints: calls API (evidence: `README.md`)
- API client → Basic authentication: authenticates (evidence: `README.md`)
- Basic authentication → Order endpoints: protects requests (evidence: `src/main/java/com/online/book/store/security/WebSecurityConfig.java`)
- Order endpoints → Order operations: submits or lists (evidence: `src/main/java/com/online/book/store/controllers/OrderController.java`)
- Order operations → Book lookup: looks up ISBN (evidence: `src/main/java/com/online/book/store/services/OrderService.java`)
- Book lookup → Book repository: queries ISBN (evidence: `src/main/java/com/online/book/store/services/BookService.java`)
- Order operations → Order repository: saves or lists (evidence: `src/main/java/com/online/book/store/services/OrderService.java`)
- Order operations → Missing-book error: throws if absent (evidence: `src/main/java/com/online/book/store/services/OrderService.java`)
- Book repository → Book record: queries entity (evidence: `src/main/java/com/online/book/store/repositories/BookRepository.java`)
- Order repository → Order record: stores entity (evidence: `src/main/java/com/online/book/store/repositories/OrderRepository.java`)
- Order record → Book record: references book (evidence: `src/main/java/com/online/book/store/domain/Order.java`)
- Book repository → PostgreSQL: persists records
- Order repository → PostgreSQL: persists records
