# sarankrishna21/fsd-project architecture

> Architecture diagram of the GitHub repository sarankrishna21/fsd-project, 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/sarankrishna21/fsd-project
- Repository: https://github.com/sarankrishna21/fsd-project

## Overview

This is a full-stack digital bookstore and reading library. Readers discover books, authenticate, purchase or claim titles, access their library, read PDFs, track progress, bookmark pages, and review books; administrators manage catalog content, users, and orders. The frontend routes users and makes API requests, while Spring controllers delegate domain work to services and persistence. The excerpts show book, review, authentication, and file-storage internals; other documented capabilities are represented at subsystem level where implementation was not sampled.

Main entry points: [`frontend/src/App.jsx`](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/App.jsx) (Routes & Layouts), [`frontend/src/api/index.js`](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/api/index.js) (API Client), [`frontend/src/pages/user/ReaderPage.jsx`](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/pages/user/ReaderPage.jsx) (PDF Reader), [`frontend/src/pages/admin`](https://github.com/sarankrishna21/fsd-project/tree/main/frontend/src/pages/admin) (Admin Pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["Routes &amp; Layouts<br/>[App.jsx]"]
  node_authctx["Auth State<br/>[AuthContext.jsx]"]
  node_cartctx["Cart State<br/>[CartContext.jsx]"]
  node_apiclient["API Client<br/>[index.js]"]
  node_userpages["Reader Pages"]
  node_readerpage["PDF Reader<br/>[ReaderPage.jsx]"]
  node_adminpages["Admin Pages"]
end

subgraph group_identity["Identity &amp; Access"]
  node_authcontroller["Authentication API"]
  node_authservice["Authentication Service<br/>[AuthService.java]"]
  node_users[("User Accounts<br/>[User.java]")]
  node_security["JWT Security"]
end

subgraph group_catalog["Catalog &amp; Content"]
  node_bookcontroller["Book API"]
  node_bookservice["Catalog Service<br/>[BookService.java]"]
  node_bookstore[("Book Catalog<br/>[Book.java]")]
  node_filestorage["File Storage"]
  node_reviewcontroller["Review API"]
  node_reviewservice["Review Service<br/>[ReviewService.java]"]
  node_reviewstore[("Reviews<br/>[Review.java]")]
end

subgraph group_readercommerce["Reading &amp; Commerce"]
  node_orderservice["Orders &amp; Checkout<br/>[OrderService.java]"]
  node_payments["Demo Payments"]
  node_library["Library &amp; Progress"]
  node_readingfeatures["Bookmarks &amp; Progress"]
end

subgraph group_operations["Administration"]
  node_adminservice["Admin Operations<br/>[AdminService.java]"]
  node_categoryapi["Category Management"]
  node_persistence[("Repositories")]
end

node_reader(("Reader"))
node_admin(("Administrator"))

node_reader -.->|"browses"| node_app
node_admin -.->|"manages"| node_app
node_app -->|"provides"| node_authctx
node_app -->|"provides"| node_cartctx
node_app -->|"routes to"| node_userpages
node_app -->|"routes to"| node_readerpage
node_app -->|"routes to"| node_adminpages
node_authctx -->|"calls auth"| node_apiclient
node_userpages -.->|"requests data"| node_apiclient
node_readerpage -->|"requests reading data"| node_apiclient
node_adminpages -.->|"requests admin data"| node_apiclient
node_apiclient -.->|"calls REST APIs"| node_authcontroller
node_apiclient -.->|"calls REST APIs"| node_bookcontroller
node_authcontroller -.->|"delegates"| node_authservice
node_authservice -->|"reads and saves"| node_users
node_authservice -->|"issues tokens"| node_security
node_bookcontroller -->|"delegates"| node_bookservice
node_bookservice -->|"reads and saves"| node_bookstore
node_bookservice -->|"queries"| node_persistence
node_bookservice -->|"stores uploads"| node_filestorage
node_reviewcontroller -->|"delegates"| node_reviewservice
node_reviewservice -->|"creates and reads"| node_reviewstore
node_reviewservice -->|"checks eligibility"| node_persistence
node_reviewservice -->|"updates ratings"| node_bookstore
node_orderservice -->|"invokes payment"| node_payments
node_orderservice -->|"reads and saves"| node_persistence
node_userpages -.->|"checks out"| node_orderservice
node_readerpage -.->|"opens owned books"| node_library
node_readerpage -.->|"tracks reading"| node_readingfeatures
node_adminpages -.->|"manages platform"| node_adminservice
node_adminpages -.->|"manages categories"| node_categoryapi

click node_app "https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/context/AuthContext.jsx"
click node_cartctx "https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/context/CartContext.jsx"
click node_apiclient "https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/api/index.js"
click node_userpages "https://github.com/sarankrishna21/fsd-project/tree/main/frontend/src/pages/user"
click node_readerpage "https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/pages/user/ReaderPage.jsx"
click node_adminpages "https://github.com/sarankrishna21/fsd-project/tree/main/frontend/src/pages/admin"
click node_authcontroller "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/AuthController.java"
click node_authservice "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/AuthService.java"
click node_users "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/entity/User.java"
click node_bookcontroller "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/BookController.java"
click node_bookservice "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/BookService.java"
click node_bookstore "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/entity/Book.java"
click node_filestorage "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/FileStorageService.java"
click node_reviewcontroller "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/ReviewController.java"
click node_reviewservice "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/ReviewService.java"
click node_reviewstore "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/entity/Review.java"
click node_orderservice "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/OrderService.java"
click node_payments "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/PaymentService.java"
click node_library "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/LibraryService.java"
click node_readingfeatures "https://github.com/sarankrishna21/fsd-project/tree/main/backend/src/main/java/com/library/store/service"
click node_adminservice "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/AdminService.java"
click node_categoryapi "https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/CategoryController.java"
click node_persistence "https://github.com/sarankrishna21/fsd-project/tree/main/backend/src/main/java/com/library/store/repository"
click node_security "https://github.com/sarankrishna21/fsd-project/tree/main/backend/src/main/java/com/library/store/security"

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_authctx,node_cartctx,node_apiclient,node_userpages,node_readerpage,node_adminpages toneBlue
class node_authcontroller,node_authservice,node_users,node_security toneAmber
class node_bookcontroller,node_bookservice,node_bookstore,node_filestorage,node_reviewcontroller,node_reviewservice,node_reviewstore toneMint
class node_orderservice,node_payments,node_library,node_readingfeatures toneRose
class node_adminservice,node_categoryapi,node_persistence,node_reader,node_admin toneIndigo
```

## Components

### Frontend

- [Routes & Layouts](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth State](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Cart State](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [API Client](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/api/index.js): `frontend/src/api/index.js`
- [Reader Pages](https://github.com/sarankrishna21/fsd-project/tree/main/frontend/src/pages/user): `frontend/src/pages/user`
- [PDF Reader](https://github.com/sarankrishna21/fsd-project/blob/main/frontend/src/pages/user/ReaderPage.jsx): `frontend/src/pages/user/ReaderPage.jsx`
- [Admin Pages](https://github.com/sarankrishna21/fsd-project/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`

### Identity & Access

- [Authentication API](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/AuthController.java): `backend/src/main/java/com/library/store/controller/AuthController.java`
- [Authentication Service](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/AuthService.java): `backend/src/main/java/com/library/store/service/AuthService.java`
- [User Accounts](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/entity/User.java): `backend/src/main/java/com/library/store/entity/User.java`
- [JWT Security](https://github.com/sarankrishna21/fsd-project/tree/main/backend/src/main/java/com/library/store/security): `backend/src/main/java/com/library/store/security`

### Catalog & Content

- [Book API](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/BookController.java): `backend/src/main/java/com/library/store/controller/BookController.java`
- [Catalog Service](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/BookService.java): `backend/src/main/java/com/library/store/service/BookService.java`
- [Book Catalog](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/entity/Book.java): `backend/src/main/java/com/library/store/entity/Book.java`
- [File Storage](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/FileStorageService.java): `backend/src/main/java/com/library/store/service/FileStorageService.java`
- [Review API](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/ReviewController.java): `backend/src/main/java/com/library/store/controller/ReviewController.java`
- [Review Service](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/ReviewService.java): `backend/src/main/java/com/library/store/service/ReviewService.java`
- [Reviews](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/entity/Review.java): `backend/src/main/java/com/library/store/entity/Review.java`

### Reading & Commerce

- [Orders & Checkout](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/OrderService.java): `backend/src/main/java/com/library/store/service/OrderService.java`
- [Demo Payments](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/PaymentService.java): `backend/src/main/java/com/library/store/service/PaymentService.java`
- [Library & Progress](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/LibraryService.java): `backend/src/main/java/com/library/store/service/LibraryService.java`
- [Bookmarks & Progress](https://github.com/sarankrishna21/fsd-project/tree/main/backend/src/main/java/com/library/store/service): `backend/src/main/java/com/library/store/service`

### Administration

- [Admin Operations](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/service/AdminService.java): `backend/src/main/java/com/library/store/service/AdminService.java`
- [Category Management](https://github.com/sarankrishna21/fsd-project/blob/main/backend/src/main/java/com/library/store/controller/CategoryController.java): `backend/src/main/java/com/library/store/controller/CategoryController.java`
- [Repositories](https://github.com/sarankrishna21/fsd-project/tree/main/backend/src/main/java/com/library/store/repository): `backend/src/main/java/com/library/store/repository`

### Other components

- **Reader**
- **Administrator**

## Connections

- Reader → Routes & Layouts: browses (evidence: `README.md`)
- Administrator → Routes & Layouts: manages (evidence: `README.md`)
- Routes & Layouts → Auth State: provides (evidence: `frontend/src/App.jsx`)
- Routes & Layouts → Cart State: provides (evidence: `frontend/src/App.jsx`)
- Routes & Layouts → Reader Pages: routes to (evidence: `frontend/src/App.jsx`)
- Routes & Layouts → PDF Reader: routes to (evidence: `frontend/src/App.jsx`)
- Routes & Layouts → Admin Pages: routes to (evidence: `frontend/src/App.jsx`)
- Auth State → API Client: calls auth (evidence: `frontend/src/context/AuthContext.jsx`)
- Reader Pages → API Client: requests data (evidence: `frontend/src/pages/user/ReaderPage.jsx`)
- PDF Reader → API Client: requests reading data (evidence: `frontend/src/pages/user/ReaderPage.jsx`)
- Admin Pages → API Client: requests admin data (evidence: `frontend/src/pages/admin/AdminBookForm.jsx`)
- API Client → Authentication API: calls REST APIs
- API Client → Book API: calls REST APIs
- Authentication API → Authentication Service: delegates
- Authentication Service → User Accounts: reads and saves (evidence: `backend/src/main/java/com/library/store/service/AuthService.java`)
- Authentication Service → JWT Security: issues tokens (evidence: `backend/src/main/java/com/library/store/service/AuthService.java`)
- Book API → Catalog Service: delegates (evidence: `backend/src/main/java/com/library/store/controller/BookController.java`)
- Catalog Service → Book Catalog: reads and saves (evidence: `backend/src/main/java/com/library/store/service/BookService.java`)
- Catalog Service → Repositories: queries (evidence: `backend/src/main/java/com/library/store/service/BookService.java`)
- Catalog Service → File Storage: stores uploads (evidence: `backend/src/main/java/com/library/store/service/BookService.java`)
- Review API → Review Service: delegates (evidence: `backend/src/main/java/com/library/store/controller/ReviewController.java`)
- Review Service → Reviews: creates and reads (evidence: `backend/src/main/java/com/library/store/service/ReviewService.java`)
- Review Service → Repositories: checks eligibility (evidence: `backend/src/main/java/com/library/store/service/ReviewService.java`)
- Review Service → Book Catalog: updates ratings (evidence: `backend/src/main/java/com/library/store/service/ReviewService.java`)
- Orders & Checkout → Demo Payments: invokes payment (evidence: `backend/src/main/java/com/library/store/service/OrderService.java`)
- Orders & Checkout → Repositories: reads and saves (evidence: `backend/src/main/java/com/library/store/service/OrderService.java`)
- Reader Pages → Orders & Checkout: checks out (evidence: `README.md`)
- PDF Reader → Library & Progress: opens owned books (evidence: `README.md`)
- PDF Reader → Bookmarks & Progress: tracks reading (evidence: `README.md`)
- Admin Pages → Admin Operations: manages platform (evidence: `README.md`)
- Admin Pages → Category Management: manages categories (evidence: `README.md`)
