How say-boop/booknest works
BookNest is a FastAPI REST API for managing each user’s personal book library. Users register or log in to obtain a JWT; authenticated users can manage, search, filter, sort, import, export, and view statistics for their own books. The internal flow separates HTTP routing, service logic, and database repositories. Redis caches per-user statistics, while Celery handles scheduled reminders. The graph reflects shown calls and README-documented capabilities; unsampled scheduling and broker wiring are documented rather than inferred from source.
Main entry points: tasks.py Book reminders · service.py User service · router.py Book routes · dependencies.py JWT auth
Components 21
API and identity
- FastAPI app
app/main.py - User routes
app/features/users/router.py - User service
app/features/users/service.py - JWT auth
app/core/dependencies.py - JWT tokens
app/core/generate_jwt.py - Password hashing
app/core/security.py - User model
app/features/users/models.py
Book library
- Book routes
app/features/books/router.py - Book service
app/features/books/service.py - Book repository
app/features/books/repository.py - Book model
app/features/books/models.py
Persistence and cache
- User repository
app/features/users/repository.py - DB session
app/core/database.py - PostgreSQL
- Redis client
app/core/redis_client.py - Redis cache
Background work
- Celery app
app/core/celery_app.py - Book reminders
app/features/books/tasks.py - RabbitMQ broker
Other components
- Reader
- Application log
Connections 26
- Reader → FastAPI app: uses API
README.md - FastAPI app → User routes: registers routes
app/main.py - FastAPI app → Book routes: registers routes
app/main.py - User routes → User service: calls
app/features/users/router.py - User service → User repository: calls
app/features/users/service.py - User service → Password hashing: hashes passwords
app/features/users/service.py - User service → JWT tokens: creates token
app/features/users/service.py - User routes → JWT auth: requires identity
app/features/users/router.py - Book routes → JWT auth: requires identity
app/features/books/router.py - JWT auth → JWT tokens: verifies token
app/core/dependencies.py - JWT auth → User repository: loads user
app/core/dependencies.py - Book routes → Book service: calls
app/features/books/router.py - Book service → Book repository: calls
app/features/books/service.py - Book service → Redis client: invalidates stats
app/features/books/service.py - Book routes → Redis client: obtains client
app/features/books/router.py - Book repository → Book model: queries and writes
app/features/books/repository.py - User repository → User model: queries and writes
app/features/users/repository.py - Book repository → DB session: uses session
app/features/books/repository.py - User repository → DB session: uses session
app/features/users/repository.py - DB session → PostgreSQL: connects to
app/core/database.py - Redis client → Redis cache: connects to
README.md - Celery app → RabbitMQ broker: uses broker
README.md - Book reminders → Celery app: registers task
app/features/books/tasks.py - Book reminders → DB session: reads books
app/features/books/tasks.py - Book reminders → Book model: checks status
app/features/books/tasks.py - Book reminders → Application log: logs reminder
README.md