# antonvosc/fastapi-book-project architecture

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

- Interactive diagram: https://gitdiagram.com/antonvosc/fastapi-book-project
- Repository: https://github.com/antonvosc/fastapi-book-project

## Overview

Bookly is presented as a book-sharing REST API. The visible request path is HTTP book CRUD → FastAPI routes → BookService → SQLModel book records, using an injected async database session. README capabilities include JWT authentication, email verification, role-based access, background tasks, and cover-image storage, but their implementations are not present in the supplied tree; those branches are documented rather than traced. The separate root-level main.py sample is not wired into the Bookly app. Edges for documented integrations cite the README; source-level edges cite the excerpts showing them.

Main entry points: [`src/db/main.py`](https://github.com/antonvosc/fastapi-book-project/blob/main/src/db/main.py) (DB Session), [`src/books/routes.py`](https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/routes.py) (Book Routes), [`src/__init__.py`](https://github.com/antonvosc/fastapi-book-project/blob/main/src/__init__.py) (FastAPI App), [`src/books/service.py`](https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/service.py) (Book Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Book API"]
  node_app["FastAPI App<br/>[__init__.py]"]
  node_routes["Book Routes<br/>[routes.py]"]
  node_service["Book Service<br/>[service.py]"]
  node_schemas["Book Schemas<br/>[schemas.py]"]
end

subgraph group_data["Book Data"]
  node_session["DB Session<br/>[main.py]"]
  node_config["Settings<br/>[config.py]"]
  node_bookmodel[("Book Records<br/>[models.py]")]
end

subgraph group_identity["Identity"]
  node_auth["JWT Authentication"]
  node_verification["Email Verification"]
  node_roles["Role Access"]
end

subgraph group_integrations["Background And Files"]
  node_tasks["Background Tasks"]
  node_covers["Cover Images"]
end

node_reader(("API Client"))
node_postgres[("PostgreSQL")]
node_redis[("Redis")]
node_minio[("MinIO Storage")]

node_reader -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_routes
node_routes -->|"calls"| node_service
node_routes -->|"injects session"| node_session
node_routes -->|"validates and serializes"| node_schemas
node_service -->|"queries and mutates"| node_bookmodel
node_service -->|"uses payload models"| node_schemas
node_session -->|"reads database URL"| node_config
node_session -->|"registers metadata"| node_bookmodel
node_app -->|"initializes database"| node_session
node_session -.->|"connects to"| node_postgres
node_auth -.->|"includes"| node_verification
node_auth -.->|"enforces"| node_roles
node_tasks -.->|"uses broker"| node_redis
node_covers -.->|"stores images"| node_minio

click node_app "https://github.com/antonvosc/fastapi-book-project/blob/main/src/__init__.py"
click node_routes "https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/routes.py"
click node_service "https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/service.py"
click node_schemas "https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/schemas.py"
click node_session "https://github.com/antonvosc/fastapi-book-project/blob/main/src/db/main.py"
click node_config "https://github.com/antonvosc/fastapi-book-project/blob/main/src/config.py"
click node_bookmodel "https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/models.py"
click node_auth "https://github.com/antonvosc/fastapi-book-project/tree/main/src/auth"
click node_verification "https://github.com/antonvosc/fastapi-book-project/tree/main/src/auth"
click node_roles "https://github.com/antonvosc/fastapi-book-project/tree/main/src/auth"
click node_tasks "https://github.com/antonvosc/fastapi-book-project/tree/main/src"
click node_covers "https://github.com/antonvosc/fastapi-book-project/tree/main/src"

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_routes,node_service,node_schemas,node_reader toneBlue
class node_session,node_config,node_bookmodel,node_postgres,node_redis,node_minio toneAmber
class node_auth,node_verification,node_roles toneMint
class node_tasks,node_covers toneRose
```

## Components

### Book API

- [FastAPI App](https://github.com/antonvosc/fastapi-book-project/blob/main/src/__init__.py): `src/__init__.py`
- [Book Routes](https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/routes.py): `src/books/routes.py`
- [Book Service](https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/service.py): `src/books/service.py`
- [Book Schemas](https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/schemas.py): `src/books/schemas.py`

### Book Data

- [DB Session](https://github.com/antonvosc/fastapi-book-project/blob/main/src/db/main.py): `src/db/main.py`
- [Settings](https://github.com/antonvosc/fastapi-book-project/blob/main/src/config.py): `src/config.py`
- [Book Records](https://github.com/antonvosc/fastapi-book-project/blob/main/src/books/models.py): `src/books/models.py`

### Identity

- [JWT Authentication](https://github.com/antonvosc/fastapi-book-project/tree/main/src/auth): `src/auth`
- [Email Verification](https://github.com/antonvosc/fastapi-book-project/tree/main/src/auth): `src/auth`
- [Role Access](https://github.com/antonvosc/fastapi-book-project/tree/main/src/auth): `src/auth`

### Background And Files

- [Background Tasks](https://github.com/antonvosc/fastapi-book-project/tree/main/src): `src`
- [Cover Images](https://github.com/antonvosc/fastapi-book-project/tree/main/src): `src`

### Other components

- **API Client**
- **PostgreSQL**
- **Redis**
- **MinIO Storage**

## Connections

- API Client → FastAPI App: sends requests (evidence: `src/__init__.py`)
- FastAPI App → Book Routes: mounts routes (evidence: `src/__init__.py`)
- Book Routes → Book Service: calls (evidence: `src/books/routes.py`)
- Book Routes → DB Session: injects session (evidence: `src/books/routes.py`)
- Book Routes → Book Schemas: validates and serializes (evidence: `src/books/routes.py`)
- Book Service → Book Records: queries and mutates (evidence: `src/books/service.py`)
- Book Service → Book Schemas: uses payload models (evidence: `src/books/service.py`)
- DB Session → Settings: reads database URL (evidence: `src/db/main.py`)
- DB Session → Book Records: registers metadata (evidence: `src/db/main.py`)
- FastAPI App → DB Session: initializes database (evidence: `src/__init__.py`)
- DB Session → PostgreSQL: connects to (evidence: `src/db/main.py`)
- JWT Authentication → Email Verification: includes (evidence: `README.md`)
- JWT Authentication → Role Access: enforces (evidence: `README.md`)
- Background Tasks → Redis: uses broker (evidence: `README.md`)
- Cover Images → MinIO Storage: stores images (evidence: `README.md`)
