How kevinbrgl/ensai-it-project-2a-team-27- works
Ex-Libris is a reading tracker with a React web app and FastAPI/PostgreSQL backend. A reader enters through the routed app, then uses catalog discovery, a personal library, playlists, reviews, social profiles, and reading-progress features. The backend exposes these capabilities through API routes, with services mediating business rules and DAOs accessing PostgreSQL; book services also integrate with Open Library. The README and sampled sources establish the runtime shape, but most feature pages, routes, and services were not inspected, so some feature links are intentionally unverified.
Main entry points: routes Feature routes · deps.py Request dependencies · dao Data access · App.jsx React router
Components 17
Web app
- React router
frontend/src/App.jsx - Feature pages
frontend/src/pages - API client
frontend/src/api - App server
frontend/app.py
API layer
- API runtime
src/main.py - API router
src/api/main.py - Feature routes
src/api/routes - Request dependencies
src/api/deps.py
Domain services
- Catalog and recommendations
src/services - Library and playlists
src/services - Reviews and ratings
src/services/reviews_service.py - Accounts and community
src/services/users_service.py - Progress and achievements
src/services
Persistence
- Data access
src/dao - PostgreSQL
External systems
- Open Library
Other components
- Reader
Connections 19
- Reader → React router: uses
README.md - React router → Feature pages: routes to
frontend/src/App.jsx - React router → App server: served by
README.md - App server → API runtime: forwards API
README.md - API runtime → API router: starts
src/main.py - API router → Feature routes: registers routes
src/api/main.py - Feature routes → Request dependencies: resolves services
src/api/routes/reviews_routes.py - Request dependencies → Reviews and ratings: builds review service
src/api/deps.py - Feature routes → Reviews and ratings: invokes
src/api/routes/reviews_routes.py - Request dependencies → Accounts and community: builds user service
src/api/deps.py - Feature routes → Accounts and community: uses
src/api/routes/users_routes.py - Feature routes → Catalog and recommendations: uses
src/api/routes/users_routes.py - Feature routes → Library and playlists: uses
src/api/routes/users_routes.py - Feature routes → Progress and achievements: uses
src/api/routes/users_routes.py - Request dependencies → Data access: constructs DAOs
src/api/deps.py - Reviews and ratings → Data access: queries through
src/services/reviews_service.py - Accounts and community → Data access: queries through
src/services/users_service.py - Data access → PostgreSQL: reads and writes
src/dao/reviews_dao.py - Catalog and recommendations → Open Library: looks up books
README.md