# raksa-lab/kamrongkrabkhndrodth_backend architecture

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

- Interactive diagram: https://gitdiagram.com/raksa-lab/kamrongkrabkhndrodth_backend
- Repository: https://github.com/raksa-lab/kamrongkrabkhndrodth_backend

## Overview

Readwell is a FastAPI/PostgreSQL storefront and admin API. Storefront users browse and filter books or view hero slides; administrators log in, manage books and slides, and upload images. The API owns routing and request handling, while SQLAlchemy models persist catalog, slide, and admin data. README documents these capabilities; sampled source shows app startup, authentication, book management, and upload behavior. Hero-slide implementation is represented from the source index, not inspected in full. The README explicitly excludes customer login, cart, checkout, and payment; purchases remain on Telegram.

Main entry points: [`app/main.py`](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/main.py) (FastAPI application), [`app/db/session.py`](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/db/session.py) (Database sessions), [`app/api/uploads.py`](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/uploads.py) (Image upload), [`app/api/admin_books.py`](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/admin_books.py) (Book management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API capabilities"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_public_books["Book browsing<br/>[books.py]"]
  node_admin_books["Book management<br/>[admin_books.py]"]
  node_hero_slides["Hero slides<br/>[hero_slides.py]"]
  node_book_schema["Book schemas<br/>[book.py]"]
  node_slide_schema["Slide schemas<br/>[hero_slide.py]"]
end

subgraph group_identity["Admin identity"]
  node_login["Admin login<br/>[auth.py]"]
  node_auth_guard["Admin authorization<br/>[dependencies.py]"]
  node_security["Token security<br/>[security.py]"]
  node_auth_schema["Login schemas<br/>[auth.py]"]
end

subgraph group_persistence["Persistence"]
  node_book_model["Book records<br/>[book.py]"]
  node_slide_model["Hero slide records<br/>[hero_slide.py]"]
  node_admin_model["Admin records<br/>[admin_user.py]"]
  node_db_session["Database sessions<br/>[session.py]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_media["Media and configuration"]
  node_upload_api["Image upload<br/>[uploads.py]"]
  node_settings["Runtime settings<br/>[config.py]"]
  node_local_uploads[("Local image files")]
  node_minio[("MinIO storage")]
  node_supabase[("Supabase storage")]
end

node_storefront(("Storefront user"))
node_admin(("Administrator"))

node_storefront -->|"requests API"| node_api_app
node_admin -->|"uses API"| node_api_app
node_api_app -->|"registers routes"| node_public_books
node_api_app -->|"registers routes"| node_admin_books
node_api_app -->|"registers routes"| node_login
node_api_app -->|"registers routes"| node_hero_slides
node_api_app -->|"registers routes"| node_upload_api
node_public_books -->|"queries database"| node_db_session
node_public_books -->|"reads books"| node_book_model
node_public_books -->|"formats results"| node_book_schema
node_admin_books -->|"requires admin"| node_auth_guard
node_admin_books -->|"queries database"| node_db_session
node_admin_books -->|"manages records"| node_book_model
node_admin_books -->|"validates payloads"| node_book_schema
node_hero_slides -->|"uses sessions"| node_db_session
node_hero_slides -->|"uses records"| node_slide_model
node_hero_slides -->|"uses schemas"| node_slide_schema
node_login -->|"queries admin"| node_db_session
node_login -->|"finds account"| node_admin_model
node_login -->|"checks password"| node_security
node_login -->|"validates login"| node_auth_schema
node_auth_guard -->|"decodes token"| node_security
node_auth_guard -->|"checks account"| node_db_session
node_auth_guard -->|"loads admin"| node_admin_model
node_api_app -->|"creates tables"| node_db_session
node_api_app -->|"seeds account"| node_admin_model
node_api_app -->|"hashes seed password"| node_security
node_db_session -->|"loads database URL"| node_settings
node_db_session -->|"connects"| node_postgres
node_book_model -->|"uses declarative base"| node_db_session
node_admin_model -->|"uses declarative base"| node_db_session
node_slide_model -->|"uses declarative base"| node_db_session
node_book_schema -->|"uses availability enum"| node_book_model
node_upload_api -->|"requires admin"| node_auth_guard
node_upload_api -->|"reads storage settings"| node_settings
node_upload_api -.->|"uploads image"| node_minio
node_upload_api -->|"uploads image"| node_supabase
node_upload_api -->|"writes fallback files"| node_local_uploads
node_api_app -->|"serves uploaded files"| node_local_uploads

click node_api_app "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/main.py"
click node_public_books "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/books.py"
click node_admin_books "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/admin_books.py"
click node_hero_slides "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/hero_slides.py"
click node_login "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/auth.py"
click node_auth_guard "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/dependencies.py"
click node_security "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/core/security.py"
click node_book_schema "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/schemas/book.py"
click node_auth_schema "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/schemas/auth.py"
click node_slide_schema "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/schemas/hero_slide.py"
click node_book_model "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/models/book.py"
click node_slide_model "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/models/hero_slide.py"
click node_admin_model "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/models/admin_user.py"
click node_db_session "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/db/session.py"
click node_upload_api "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/uploads.py"
click node_settings "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/core/config.py"
click node_local_uploads "https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/tree/main/uploads"

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_api_app,node_public_books,node_admin_books,node_hero_slides,node_book_schema,node_slide_schema,node_storefront toneBlue
class node_login,node_auth_guard,node_security,node_auth_schema toneAmber
class node_book_model,node_slide_model,node_admin_model,node_db_session,node_postgres toneMint
class node_upload_api,node_settings,node_local_uploads,node_minio,node_supabase toneRose
class node_admin toneIndigo
```

## Components

### API capabilities

- [FastAPI application](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/main.py): `app/main.py`
- [Book browsing](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/books.py): `app/api/books.py`
- [Book management](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/admin_books.py): `app/api/admin_books.py`
- [Hero slides](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/hero_slides.py): `app/api/hero_slides.py`
- [Book schemas](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/schemas/book.py): `app/schemas/book.py`
- [Slide schemas](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/schemas/hero_slide.py): `app/schemas/hero_slide.py`

### Admin identity

- [Admin login](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/auth.py): `app/api/auth.py`
- [Admin authorization](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/dependencies.py): `app/api/dependencies.py`
- [Token security](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/core/security.py): `app/core/security.py`
- [Login schemas](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/schemas/auth.py): `app/schemas/auth.py`

### Persistence

- [Book records](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/models/book.py): `app/models/book.py`
- [Hero slide records](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/models/hero_slide.py): `app/models/hero_slide.py`
- [Admin records](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/models/admin_user.py): `app/models/admin_user.py`
- [Database sessions](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/db/session.py): `app/db/session.py`
- **PostgreSQL**

### Media and configuration

- [Image upload](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/api/uploads.py): `app/api/uploads.py`
- [Runtime settings](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/blob/main/app/core/config.py): `app/core/config.py`
- [Local image files](https://github.com/raksa-lab/kamrongkrabkhndrodth_backend/tree/main/uploads): `uploads`
- **MinIO storage**
- **Supabase storage**

### Other components

- **Storefront user**
- **Administrator**

## Connections

- Storefront user → FastAPI application: requests API (evidence: `README.md`)
- Administrator → FastAPI application: uses API (evidence: `README.md`)
- FastAPI application → Book browsing: registers routes (evidence: `app/main.py`)
- FastAPI application → Book management: registers routes (evidence: `app/main.py`)
- FastAPI application → Admin login: registers routes (evidence: `app/main.py`)
- FastAPI application → Hero slides: registers routes (evidence: `app/main.py`)
- FastAPI application → Image upload: registers routes (evidence: `app/main.py`)
- Book browsing → Database sessions: queries database (evidence: `app/api/books.py`)
- Book browsing → Book records: reads books (evidence: `app/api/books.py`)
- Book browsing → Book schemas: formats results (evidence: `app/api/books.py`)
- Book management → Admin authorization: requires admin (evidence: `app/api/admin_books.py`)
- Book management → Database sessions: queries database (evidence: `app/api/admin_books.py`)
- Book management → Book records: manages records (evidence: `app/api/admin_books.py`)
- Book management → Book schemas: validates payloads (evidence: `app/api/admin_books.py`)
- Hero slides → Database sessions: uses sessions (evidence: `app/api/hero_slides.py`)
- Hero slides → Hero slide records: uses records (evidence: `app/api/hero_slides.py`)
- Hero slides → Slide schemas: uses schemas (evidence: `app/api/hero_slides.py`)
- Admin login → Database sessions: queries admin (evidence: `app/api/auth.py`)
- Admin login → Admin records: finds account (evidence: `app/api/auth.py`)
- Admin login → Token security: checks password (evidence: `app/api/auth.py`)
- Admin login → Login schemas: validates login (evidence: `app/api/auth.py`)
- Admin authorization → Token security: decodes token (evidence: `app/api/dependencies.py`)
- Admin authorization → Database sessions: checks account (evidence: `app/api/dependencies.py`)
- Admin authorization → Admin records: loads admin (evidence: `app/api/dependencies.py`)
- FastAPI application → Database sessions: creates tables (evidence: `app/main.py`)
- FastAPI application → Admin records: seeds account (evidence: `app/main.py`)
- FastAPI application → Token security: hashes seed password (evidence: `app/main.py`)
- Database sessions → Runtime settings: loads database URL (evidence: `app/db/session.py`)
- Database sessions → PostgreSQL: connects (evidence: `app/db/session.py`)
- Book records → Database sessions: uses declarative base (evidence: `app/models/book.py`)
- Admin records → Database sessions: uses declarative base (evidence: `app/models/admin_user.py`)
- Hero slide records → Database sessions: uses declarative base (evidence: `app/models/hero_slide.py`)
- Book schemas → Book records: uses availability enum (evidence: `app/schemas/book.py`)
- Image upload → Admin authorization: requires admin (evidence: `app/api/uploads.py`)
- Image upload → Runtime settings: reads storage settings (evidence: `app/api/uploads.py`)
- Image upload → MinIO storage: uploads image (evidence: `app/api/uploads.py`)
- Image upload → Supabase storage: uploads image (evidence: `app/api/uploads.py`)
- Image upload → Local image files: writes fallback files (evidence: `app/api/uploads.py`)
- FastAPI application → Local image files: serves uploaded files (evidence: `app/main.py`)
