How yuvarajucet/bookmark-api works
bookmark-api is a FastAPI service for account registration, verification, login and password recovery, plus authenticated bookmark/category management. Requests enter through the application’s mounted routers; handlers validate inputs and delegate to controllers, which use a SQLite schema. Account email workflows send verification or reset messages. The README gives setup guidance but no additional product capabilities. Edges reflect shown calls or imports; admin and settings internals are not sampled, so their behavior is not expanded.
Main entry points: user.py User routes · userDBController.py User controller · app.py FastAPI application · bookmark.py Bookmark routes
Components 18
API routing
- FastAPI application
app.py - User routes
routes/user.py - Bookmark routes
routes/bookmark.py - Admin routes
routes/admin.py - Settings routes
routes/userSettings.py - Admin controller
dbController/adminDBController.py
Accounts and auth
- User schemas
schemas/user.py - User controller
dbController/userDBController.py - JWT request guard
auth/athenticateUser.py - JWT handler
auth/authenticateHandler.py - Email service
helper/emailHelper.py
Bookmark management
- Bookmark schemas
schemas/bookmark.py - Bookmark controller
dbController/bookmarkDBController.py - Bookmark helper
helper/boomarkHelper.py
Persistence
- SQLite schema
models/model.py
Shared services
- User helper
helper/userHelper.py
Other components
- API client
- SMTP email service
Connections 26
- API client → FastAPI application: sends requests
app.py - FastAPI application → User routes: mounts
app.py - FastAPI application → Bookmark routes: mounts
app.py - FastAPI application → Admin routes: mounts
app.py - FastAPI application → Settings routes: mounts
app.py - User routes → User schemas: accepts
routes/user.py - User routes → User controller: calls
routes/user.py - User routes → User helper: calls
routes/user.py - User routes → Email service: calls
routes/user.py - User routes → JWT request guard: guards routes
routes/user.py - Email service → User controller: requests reset token
helper/emailHelper.py - Email service → SMTP email service: sends mail
helper/emailHelper.py - User controller → User schemas: uses
dbController/userDBController.py - User controller → User helper: calls
dbController/userDBController.py - User controller → JWT handler: signs tokens
dbController/userDBController.py - JWT request guard → JWT handler: decodes token
auth/athenticateUser.py - Bookmark routes → Bookmark schemas: accepts
routes/bookmark.py - Bookmark routes → Bookmark controller: calls
routes/bookmark.py - Bookmark routes → Bookmark helper: generates and fetches
routes/bookmark.py - Bookmark routes → JWT request guard: guards routes
routes/bookmark.py - Bookmark controller → Bookmark schemas: uses
dbController/bookmarkDBController.py - Bookmark controller → JWT handler: decodes token
dbController/bookmarkDBController.py - User controller → SQLite schema: queries
dbController/userDBController.py - Bookmark controller → SQLite schema: queries
dbController/bookmarkDBController.py - Admin routes → Admin controller: calls
routes/admin.py - Admin controller → SQLite schema: imports schema
dbController/adminDBController.py