How raksa-lab/kamrongkrabkhndrodth_backend works
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: main.py FastAPI application · session.py Database sessions · uploads.py Image upload · admin_books.py Book management
Components 22
API capabilities
- FastAPI application
app/main.py - Book browsing
app/api/books.py - Book management
app/api/admin_books.py - Hero slides
app/api/hero_slides.py - Book schemas
app/schemas/book.py - Slide schemas
app/schemas/hero_slide.py
Admin identity
- Admin login
app/api/auth.py - Admin authorization
app/api/dependencies.py - Token security
app/core/security.py - Login schemas
app/schemas/auth.py
Persistence
- Book records
app/models/book.py - Hero slide records
app/models/hero_slide.py - Admin records
app/models/admin_user.py - Database sessions
app/db/session.py - PostgreSQL
Media and configuration
- Image upload
app/api/uploads.py - Runtime settings
app/core/config.py - Local image files
uploads - MinIO storage
- Supabase storage
Other components
- Storefront user
- Administrator
Connections 39
- Storefront user → FastAPI application: requests API
README.md - Administrator → FastAPI application: uses API
README.md - FastAPI application → Book browsing: registers routes
app/main.py - FastAPI application → Book management: registers routes
app/main.py - FastAPI application → Admin login: registers routes
app/main.py - FastAPI application → Hero slides: registers routes
app/main.py - FastAPI application → Image upload: registers routes
app/main.py - Book browsing → Database sessions: queries database
app/api/books.py - Book browsing → Book records: reads books
app/api/books.py - Book browsing → Book schemas: formats results
app/api/books.py - Book management → Admin authorization: requires admin
app/api/admin_books.py - Book management → Database sessions: queries database
app/api/admin_books.py - Book management → Book records: manages records
app/api/admin_books.py - Book management → Book schemas: validates payloads
app/api/admin_books.py - Hero slides → Database sessions: uses sessions
app/api/hero_slides.py - Hero slides → Hero slide records: uses records
app/api/hero_slides.py - Hero slides → Slide schemas: uses schemas
app/api/hero_slides.py - Admin login → Database sessions: queries admin
app/api/auth.py - Admin login → Admin records: finds account
app/api/auth.py - Admin login → Token security: checks password
app/api/auth.py - Admin login → Login schemas: validates login
app/api/auth.py - Admin authorization → Token security: decodes token
app/api/dependencies.py - Admin authorization → Database sessions: checks account
app/api/dependencies.py - Admin authorization → Admin records: loads admin
app/api/dependencies.py - FastAPI application → Database sessions: creates tables
app/main.py - FastAPI application → Admin records: seeds account
app/main.py - FastAPI application → Token security: hashes seed password
app/main.py - Database sessions → Runtime settings: loads database URL
app/db/session.py - Database sessions → PostgreSQL: connects
app/db/session.py - Book records → Database sessions: uses declarative base
app/models/book.py - Admin records → Database sessions: uses declarative base
app/models/admin_user.py - Hero slide records → Database sessions: uses declarative base
app/models/hero_slide.py - Book schemas → Book records: uses availability enum
app/schemas/book.py - Image upload → Admin authorization: requires admin
app/api/uploads.py - Image upload → Runtime settings: reads storage settings
app/api/uploads.py - Image upload → MinIO storage: uploads image
app/api/uploads.py - Image upload → Supabase storage: uploads image
app/api/uploads.py - Image upload → Local image files: writes fallback files
app/api/uploads.py - FastAPI application → Local image files: serves uploaded files
app/main.py