# westamz/bookshelf architecture

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

- Interactive diagram: https://gitdiagram.com/westamz/bookshelf
- Repository: https://github.com/westamz/bookshelf

## Overview

Bookshelf is a React/.NET digital library: users authenticate, browse and search the catalog, and inspect book and author details. The frontend routes pages through domain services to the API; backend controllers access the relational library and identity context. The graph retains account, comment, genre, author, book, and seeded-data capabilities documented in the README. Edges are limited to relationships evidenced by excerpts, the source index, or README; unexcerpted feature wiring is not inferred.

Main entry points: [`backend/BookshelfAPI/ApplicationDbContext.cs`](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/ApplicationDbContext.cs) (EF and Identity context), [`frontend/src/router.tsx`](https://github.com/westamz/bookshelf/blob/main/frontend/src/router.tsx) (Routes and access), [`frontend/src/pages/books`](https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/books) (Book pages), [`frontend/src/pages/auth`](https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/auth) (Login and register)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_router["Routes and access<br/>[router.tsx]"]
  node_book_pages["Book pages"]
  node_author_pages["Author pages"]
  node_auth_pages["Login and register"]
  node_auth_state["Auth state<br/>[AuthContext.tsx]"]
  node_book_service["Book service<br/>[BooksService.ts]"]
  node_author_service["Author service<br/>[AuthorsService.ts]"]
  node_auth_service["Auth service<br/>[AuthService.ts]"]
  node_genre_service["Genre service<br/>[GenreService.ts]"]
end

subgraph group_api["API services"]
  node_account["Account endpoints"]
  node_books["Book endpoints<br/>[BooksController.cs]"]
  node_authors["Author endpoints"]
  node_genres["Genre endpoints<br/>[GenreController.cs]"]
  node_comments["Comment endpoints"]
end

subgraph group_domain["Library domain"]
  node_library_model["Library entities"]
  node_seed["Sample data seeder<br/>[DbSeeder.cs]"]
end

subgraph group_persistence["Data and identity"]
  node_db[("EF and Identity context")]
end

node_reader(("Reader"))
node_api{{"Bookshelf API"}}
node_sql[("SQL Server")]

node_reader -->|"navigates"| node_router
node_router -->|"routes to"| node_book_pages
node_router -->|"routes to"| node_author_pages
node_router -->|"routes to"| node_auth_pages
node_router -->|"checks access"| node_auth_state
node_auth_pages -->|"requests auth"| node_auth_service
node_auth_service -->|"updates session"| node_auth_state
node_auth_pages -->|"uses session"| node_auth_state
node_book_pages -->|"requests books"| node_book_service
node_book_pages -->|"requests genres"| node_genre_service
node_author_pages -->|"requests authors"| node_author_service
node_book_service -.->|"HTTP requests"| node_api
node_author_service -->|"HTTP requests"| node_api
node_auth_service -->|"HTTP requests"| node_api
node_genre_service -.->|"HTTP requests"| node_api
node_api -.->|"routes requests"| node_books
node_api -.->|"routes requests"| node_authors
node_api -.->|"routes requests"| node_account
node_api -.->|"routes requests"| node_genres
node_api -.->|"routes requests"| node_comments
node_books -->|"queries and saves"| node_db
node_authors -->|"accesses data"| node_db
node_genres -->|"accesses data"| node_db
node_comments -->|"accesses data"| node_db
node_account -.->|"manages identity"| node_db
node_db -->|"maps entities"| node_library_model
node_seed -->|"seeds records"| node_db
node_db -.->|"persists data"| node_sql

click node_router "https://github.com/westamz/bookshelf/blob/main/frontend/src/router.tsx"
click node_book_pages "https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/books"
click node_author_pages "https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/authors"
click node_auth_pages "https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/auth"
click node_auth_state "https://github.com/westamz/bookshelf/blob/main/frontend/src/contexts/AuthContext.tsx"
click node_book_service "https://github.com/westamz/bookshelf/blob/main/frontend/src/services/BooksService.ts"
click node_author_service "https://github.com/westamz/bookshelf/blob/main/frontend/src/services/AuthorsService.ts"
click node_auth_service "https://github.com/westamz/bookshelf/blob/main/frontend/src/services/AuthService.ts"
click node_genre_service "https://github.com/westamz/bookshelf/blob/main/frontend/src/services/GenreService.ts"
click node_account "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/AccountController.cs"
click node_books "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/BooksController.cs"
click node_authors "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/AuthorController.cs"
click node_genres "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/GenreController.cs"
click node_comments "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/CommentsController.cs"
click node_library_model "https://github.com/westamz/bookshelf/tree/main/backend/BookshelfAPI/Entities"
click node_seed "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Data/DbSeeder.cs"
click node_db "https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/ApplicationDbContext.cs"

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_router,node_book_pages,node_author_pages,node_auth_pages,node_auth_state,node_book_service,node_author_service,node_auth_service,node_genre_service toneBlue
class node_account,node_books,node_authors,node_genres,node_comments,node_sql toneAmber
class node_library_model,node_seed,node_api toneMint
class node_db toneRose
class node_reader toneIndigo
```

## Components

### Web client

- [Routes and access](https://github.com/westamz/bookshelf/blob/main/frontend/src/router.tsx): `frontend/src/router.tsx`
- [Book pages](https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/books): `frontend/src/pages/books`
- [Author pages](https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/authors): `frontend/src/pages/authors`
- [Login and register](https://github.com/westamz/bookshelf/tree/main/frontend/src/pages/auth): `frontend/src/pages/auth`
- [Auth state](https://github.com/westamz/bookshelf/blob/main/frontend/src/contexts/AuthContext.tsx): `frontend/src/contexts/AuthContext.tsx`
- [Book service](https://github.com/westamz/bookshelf/blob/main/frontend/src/services/BooksService.ts): `frontend/src/services/BooksService.ts`
- [Author service](https://github.com/westamz/bookshelf/blob/main/frontend/src/services/AuthorsService.ts): `frontend/src/services/AuthorsService.ts`
- [Auth service](https://github.com/westamz/bookshelf/blob/main/frontend/src/services/AuthService.ts): `frontend/src/services/AuthService.ts`
- [Genre service](https://github.com/westamz/bookshelf/blob/main/frontend/src/services/GenreService.ts): `frontend/src/services/GenreService.ts`

### API services

- [Account endpoints](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/AccountController.cs): `backend/BookshelfAPI/Controllers/AccountController.cs`
- [Book endpoints](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/BooksController.cs): `backend/BookshelfAPI/Controllers/BooksController.cs`
- [Author endpoints](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/AuthorController.cs): `backend/BookshelfAPI/Controllers/AuthorController.cs`
- [Genre endpoints](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/GenreController.cs): `backend/BookshelfAPI/Controllers/GenreController.cs`
- [Comment endpoints](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Controllers/CommentsController.cs): `backend/BookshelfAPI/Controllers/CommentsController.cs`

### Library domain

- [Library entities](https://github.com/westamz/bookshelf/tree/main/backend/BookshelfAPI/Entities): `backend/BookshelfAPI/Entities`
- [Sample data seeder](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/Data/DbSeeder.cs): `backend/BookshelfAPI/Data/DbSeeder.cs`

### Data and identity

- [EF and Identity context](https://github.com/westamz/bookshelf/blob/main/backend/BookshelfAPI/ApplicationDbContext.cs): `backend/BookshelfAPI/ApplicationDbContext.cs`

### Other components

- **Reader**
- **Bookshelf API**
- **SQL Server**

## Connections

- Reader → Routes and access: navigates (evidence: `frontend/src/router.tsx`)
- Routes and access → Book pages: routes to (evidence: `frontend/src/router.tsx`)
- Routes and access → Author pages: routes to (evidence: `frontend/src/router.tsx`)
- Routes and access → Login and register: routes to (evidence: `frontend/src/router.tsx`)
- Routes and access → Auth state: checks access (evidence: `frontend/src/router.tsx`)
- Login and register → Auth service: requests auth (evidence: `frontend/src/pages/auth/login/LoginPage.tsx`)
- Auth service → Auth state: updates session (evidence: `frontend/src/services/AuthService.ts`)
- Login and register → Auth state: uses session (evidence: `frontend/src/pages/auth/login/LoginPage.tsx`)
- Book pages → Book service: requests books (evidence: `frontend/src/pages/books/BooksPage.tsx`)
- Book pages → Genre service: requests genres (evidence: `frontend/src/pages/books/BooksPage.tsx`)
- Author pages → Author service: requests authors (evidence: `frontend/src/pages/authors/AuthorsPage.tsx`)
- Book service → Bookshelf API: HTTP requests (evidence: `README.md`)
- Author service → Bookshelf API: HTTP requests (evidence: `frontend/src/services/AuthorsService.ts`)
- Auth service → Bookshelf API: HTTP requests (evidence: `frontend/src/services/AuthService.ts`)
- Genre service → Bookshelf API: HTTP requests (evidence: `README.md`)
- Bookshelf API → Book endpoints: routes requests (evidence: `README.md`)
- Bookshelf API → Author endpoints: routes requests (evidence: `README.md`)
- Bookshelf API → Account endpoints: routes requests (evidence: `README.md`)
- Bookshelf API → Genre endpoints: routes requests (evidence: `README.md`)
- Bookshelf API → Comment endpoints: routes requests (evidence: `README.md`)
- Book endpoints → EF and Identity context: queries and saves (evidence: `backend/BookshelfAPI/Controllers/BooksController.cs`)
- Author endpoints → EF and Identity context: accesses data (evidence: `backend/BookshelfAPI/Controllers/AuthorController.cs`)
- Genre endpoints → EF and Identity context: accesses data (evidence: `backend/BookshelfAPI/Controllers/GenreController.cs`)
- Comment endpoints → EF and Identity context: accesses data (evidence: `backend/BookshelfAPI/Controllers/CommentsController.cs`)
- Account endpoints → EF and Identity context: manages identity
- EF and Identity context → Library entities: maps entities (evidence: `backend/BookshelfAPI/ApplicationDbContext.cs`)
- Sample data seeder → EF and Identity context: seeds records (evidence: `backend/BookshelfAPI/Data/DbSeeder.cs`)
- EF and Identity context → SQL Server: persists data (evidence: `README.md`)
