How it-chhaya/istad-reading-api works
This is a Spring REST API for a book-management service. Clients can register and authenticate, manage books, and use supporting account, genre, file, email, and notification endpoints. The clearest evidenced flow is request controller → service → persistence for accounts, books, and files; account verification also sends email. The README is empty, so the broader product capabilities are taken from the source tree. Several peripheral service-to-storage relationships are omitted where the excerpts do not show the calls.
Main entry points: AuthServiceImpl.java Authentication · FileServiceImpl.java File operations · BookServiceImpl.java Book operations · UserRepository.java User repository
Components 20
Identity and access
- Auth endpoints
src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java - Authentication
src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java - Security user lookup
src/main/java/co/istad/bmsapi/config/security/UserDetailsServiceImpl.java - User endpoints
src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java - User management
src/main/java/co/istad/bmsapi/api/user/UserServiceImpl.java
Book catalog
- Book endpoints
src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java - Book operations
src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java - Genre endpoints
src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java - Genre operations
src/main/java/co/istad/bmsapi/api/genre/GenreServiceImpl.java
Supporting services
- File endpoints
src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java - File operations
src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java - Email endpoints
src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java - Email delivery
src/main/java/co/istad/bmsapi/api/email/EmailServiceImpl.java - Notification endpoints
src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java - Notification operations
src/main/java/co/istad/bmsapi/api/notification/NotificationServiceImpl.java
Persistence
- User repository
src/main/java/co/istad/bmsapi/data/repository/UserRepository.java - Book repository
src/main/java/co/istad/bmsapi/data/repository/BookRepository.java - File repository
src/main/java/co/istad/bmsapi/data/repository/FileRepository.java - Relational database
Other components
- API client
Connections 22
- API client → Auth endpoints: requests
src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java - Auth endpoints → Authentication: delegates
src/main/java/co/istad/bmsapi/api/auth/web/AuthRestController.java - Authentication → User repository: reads and writes
src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java - Authentication → File operations: looks up profile
src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java - Authentication → Email delivery: sends verification
src/main/java/co/istad/bmsapi/api/auth/AuthServiceImpl.java - Security user lookup → User repository: loads account
src/main/java/co/istad/bmsapi/config/security/UserDetailsServiceImpl.java - API client → User endpoints: requests
src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java - User endpoints → User management: delegates
src/main/java/co/istad/bmsapi/api/user/web/UserRestController.java - API client → Book endpoints: requests
src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java - Book endpoints → Book operations: delegates
src/main/java/co/istad/bmsapi/api/book/web/BookRestController.java - Book operations → Book repository: queries books
src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java - Book operations → File operations: uses file data
src/main/java/co/istad/bmsapi/api/book/BookServiceImpl.java - API client → Genre endpoints: requests
src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java - Genre endpoints → Genre operations: delegates
src/main/java/co/istad/bmsapi/api/genre/web/GenreRestController.java - API client → File endpoints: requests
src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java - File endpoints → File operations: delegates
src/main/java/co/istad/bmsapi/api/file/web/FileRestController.java - File operations → File repository: reads and writes
src/main/java/co/istad/bmsapi/api/file/FileServiceImpl.java - API client → Email endpoints: requests
src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java - Email endpoints → Email delivery: delegates
src/main/java/co/istad/bmsapi/api/email/web/EmailRestController.java - API client → Notification endpoints: requests
src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java - Notification endpoints → Notification operations: delegates
src/main/java/co/istad/bmsapi/api/notification/web/NotificationRestController.java - User repository → Relational database: queries
src/main/java/co/istad/bmsapi/data/repository/UserRepository.java