# it-chhaya/istad-reading-api architecture

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

- Interactive diagram: https://gitdiagram.com/it-chhaya/istad-reading-api
- Repository: https://github.com/it-chhaya/istad-reading-api

## Overview

This is a Spring REST API for a book-management service. Clients can register and authenticate, manage books, and use supporting account, genre, file, email, and notification endpoints. The clearest evidenced flow is request controller → service → persistence for accounts, books, and files; account verification also sends email. The README is empty, so the broader product capabilities are taken from the source tree. Several peripheral service-to-storage relationships are omitted where the excerpts do not show the calls.

Main entry points: [`src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java`](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java) (Authentication), [`src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java`](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java) (File operations), [`src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java`](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java) (Book operations), [`src/main/java/co/istad/bmsapi/data/repository/UserRepository.java`](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_api["Auth endpoints"]
  node_auth_service["Authentication"]
  node_security_user["Security user lookup"]
  node_user_api["User endpoints"]
  node_user_service["User management"]
end

subgraph group_catalog["Book catalog"]
  node_book_api["Book endpoints"]
  node_book_service["Book operations"]
  node_genre_api["Genre endpoints"]
  node_genre_service["Genre operations"]
end

subgraph group_support["Supporting services"]
  node_file_api["File endpoints"]
  node_file_service["File operations"]
  node_email_api["Email endpoints"]
  node_email_service["Email delivery"]
  node_notification_api["Notification endpoints"]
  node_notification_service["Notification operations"]
end

subgraph group_persistence["Persistence"]
  node_user_repo["User repository"]
  node_book_repo["Book repository"]
  node_file_repo["File repository"]
  node_database[("Relational database")]
end

node_client(("API client"))

node_client -->|"requests"| node_auth_api
node_auth_api -->|"delegates"| node_auth_service
node_auth_service -->|"reads and writes"| node_user_repo
node_auth_service -->|"looks up profile"| node_file_service
node_auth_service -->|"sends verification"| node_email_service
node_security_user -->|"loads account"| node_user_repo
node_client -->|"requests"| node_user_api
node_user_api -->|"delegates"| node_user_service
node_client -->|"requests"| node_book_api
node_book_api -->|"delegates"| node_book_service
node_book_service -->|"queries books"| node_book_repo
node_book_service -->|"uses file data"| node_file_service
node_client -->|"requests"| node_genre_api
node_genre_api -->|"delegates"| node_genre_service
node_client -->|"requests"| node_file_api
node_file_api -->|"delegates"| node_file_service
node_file_service -->|"reads and writes"| node_file_repo
node_client -->|"requests"| node_email_api
node_email_api -->|"delegates"| node_email_service
node_client -->|"requests"| node_notification_api
node_notification_api -->|"delegates"| node_notification_service
node_user_repo -->|"queries"| node_database

click node_auth_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java"
click node_auth_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java"
click node_security_user "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/config/security/UserDetailsServiceImpl.java"
click node_user_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java"
click node_user_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/user/UserServiceImpl.java"
click node_book_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java"
click node_book_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java"
click node_genre_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java"
click node_genre_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/genre/GenreServiceImpl.java"
click node_file_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java"
click node_file_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java"
click node_email_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java"
click node_email_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/email/EmailServiceImpl.java"
click node_notification_api "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java"
click node_notification_service "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/notification/NotificationServiceImpl.java"
click node_user_repo "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/UserRepository.java"
click node_book_repo "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/BookRepository.java"
click node_file_repo "https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/FileRepository.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_auth_api,node_auth_service,node_security_user,node_user_api,node_user_service,node_client toneBlue
class node_book_api,node_book_service,node_genre_api,node_genre_service toneAmber
class node_file_api,node_file_service,node_email_api,node_email_service,node_notification_api,node_notification_service toneMint
class node_user_repo,node_book_repo,node_file_repo,node_database toneRose
```

## Components

### Identity and access

- [Auth endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java): `src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java`
- [Authentication](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java): `src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java`
- [Security user lookup](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/config/security/UserDetailsServiceImpl.java): `src/main/java/co/istad/bmsapi/config/security/UserDetailsServiceImpl.java`
- [User endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java): `src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java`
- [User management](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/user/UserServiceImpl.java): `src/main/java/co/istad/bmsapi/api/user/UserServiceImpl.java`

### Book catalog

- [Book endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java): `src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java`
- [Book operations](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java): `src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java`
- [Genre endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java): `src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java`
- [Genre operations](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/genre/GenreServiceImpl.java): `src/main/java/co/istad/bmsapi/api/genre/GenreServiceImpl.java`

### Supporting services

- [File endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java): `src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java`
- [File operations](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java): `src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java`
- [Email endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java): `src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java`
- [Email delivery](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/email/EmailServiceImpl.java): `src/main/java/co/istad/bmsapi/api/email/EmailServiceImpl.java`
- [Notification endpoints](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java): `src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java`
- [Notification operations](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/api/notification/NotificationServiceImpl.java): `src/main/java/co/istad/bmsapi/api/notification/NotificationServiceImpl.java`

### Persistence

- [User repository](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/UserRepository.java): `src/main/java/co/istad/bmsapi/data/repository/UserRepository.java`
- [Book repository](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/BookRepository.java): `src/main/java/co/istad/bmsapi/data/repository/BookRepository.java`
- [File repository](https://github.com/it-chhaya/istad-reading-api/blob/main/src/main/java/co/istad/bmsapi/data/repository/FileRepository.java): `src/main/java/co/istad/bmsapi/data/repository/FileRepository.java`
- **Relational database**

### Other components

- **API client**

## Connections

- API client → Auth endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java`)
- Auth endpoints → Authentication: delegates (evidence: `src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java`)
- Authentication → User repository: reads and writes (evidence: `src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java`)
- Authentication → File operations: looks up profile (evidence: `src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java`)
- Authentication → Email delivery: sends verification (evidence: `src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java`)
- Security user lookup → User repository: loads account (evidence: `src/main/java/co/istad/bmsapi/config/security/UserDetailsServiceImpl.java`)
- API client → User endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java`)
- User endpoints → User management: delegates (evidence: `src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java`)
- API client → Book endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java`)
- Book endpoints → Book operations: delegates (evidence: `src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java`)
- Book operations → Book repository: queries books (evidence: `src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java`)
- Book operations → File operations: uses file data (evidence: `src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java`)
- API client → Genre endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java`)
- Genre endpoints → Genre operations: delegates (evidence: `src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java`)
- API client → File endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java`)
- File endpoints → File operations: delegates (evidence: `src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java`)
- File operations → File repository: reads and writes (evidence: `src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java`)
- API client → Email endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java`)
- Email endpoints → Email delivery: delegates (evidence: `src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java`)
- API client → Notification endpoints: requests (evidence: `src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java`)
- Notification endpoints → Notification operations: delegates (evidence: `src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java`)
- User repository → Relational database: queries (evidence: `src/main/java/co/istad/bmsapi/data/repository/UserRepository.java`)
