How 1younesalloui/booklib works
BookLib’s mobile workflow is discover/search → inspect a title → save or update its reading status, rating, and review; a separate chat offers shelf-aware AI assistance. Django serves discovery, shelf, and chat APIs, with book and shelf records persisted in relational models. The README documents multi-provider aggregation, filtering, pagination, caching, and deduplication, though provider and cache internals are only partially sampled. Edges for those documented backend behaviors use the sampled views file; unsampled UI/API wiring is omitted where no relationship is evidenced.
Main entry points: views.py API handlers · api.ts API client · index.tsx Home feed · explore.tsx Explore search
Components 18
Mobile app
- Home feed
frontend/src/app/index.tsx - Explore search
frontend/src/app/explore.tsx - Personal library
frontend/src/app/library.tsx - AI chat
frontend/src/app/chat.tsx - Book details
frontend/src/components/BookDetailModal.tsx - Book cards
frontend/src/components/BookCard.tsx - API client
frontend/src/services/api.ts - Theme preferences
frontend/src/theme/index.ts
Backend API
- API routing
backend/bookrating/app/urls.py - API handlers
backend/bookrating/app/views.py - Request serializers
backend/bookrating/app/serializers.py - AI response engine
backend/bookrating/app/ai_engine.py
Books and shelves
- Book records
backend/bookrating/app/models.py - Shelf records
backend/bookrating/app/models.py
External services
- Book providers
backend/bookrating/app/views.py - Groq AI
- SQL database
Other components
- Reader
Connections 29
- Reader → Home feed: browses
README.md - Reader → Explore search: searches
README.md - Reader → Personal library: manages shelf
README.md - Reader → AI chat: chats
README.md - Home feed → API client: loads feed
frontend/src/app/index.tsx - Explore search → API client: searches books
frontend/src/app/explore.tsx - Personal library → API client: loads shelf
README.md - Book details → API client: updates shelf
frontend/src/components/BookDetailModal.tsx - API client → API routing: sends requests
README.md - API routing → API handlers: routes requests
backend/bookrating/app/urls.py - API handlers → Request serializers: validates chat
backend/bookrating/app/views.py - API handlers → Book records: reads and writes
backend/bookrating/app/views.py - API handlers → Shelf records: reads and writes
backend/bookrating/app/views.py - API handlers → Book providers: aggregates titles
README.md - Book providers → Book records: supplies metadata
backend/bookrating/app/views.py - AI chat → API client: uses chat API
frontend/src/app/chat.tsx - API client → API handlers: requests chat
- API handlers → AI response engine: gets response
backend/bookrating/app/views.py - AI response engine → Groq AI: calls model
backend/bookrating/app/ai_engine.py - AI response engine → Shelf records: uses shelf context
- Book records → SQL database: persists
- Shelf records → SQL database: persists
- Home feed → Book cards: renders titles
frontend/src/app/index.tsx - Explore search → Book cards: renders results
frontend/src/app/explore.tsx - Personal library → Book cards: renders shelf
README.md - Home feed → Book details: opens title
frontend/src/app/index.tsx - Explore search → Book details: opens title
README.md - Personal library → Book details: opens title
README.md - Theme preferences → SQL database: stores preference