How devchinmaysamal17/fintrack---personal-finance-dashboard works
FinTrack is a personal-finance dashboard: users register or log in, then manage transactions, categories, and budgets and review their finances in the browser. FastAPI serves the UI and API; authenticated routes use JWT identity and SQLAlchemy sessions to access PostgreSQL. The graph preserves the documented dashboard, transaction, category, and budget experiences. UI/API links rely on the README; source excerpts show backend routing and selected calls, so unsampled frontend implementation details are not inferred.
Main entry points: main.py FastAPI app and static UI · dependencies.py Session lifecycle · models.py Finance data models · users.py Account management
Components 20
Browser UI
- Login and signup
Frontend/login-script.js - Session utilities
Frontend/utils.js - Finance dashboard
Frontend/dashboard.js - Transaction view
Frontend/transactions.js - Budget view
Frontend/budget.js
API workflows
- FastAPI app and static UI
Backend/main.py - Account management
Backend/routers/users.py - Transaction API
Backend/routers/transactions.py - Category API
Backend/routers/categories.py - Budget API
Backend/routers/budgets.py - Request and response shapes
Backend/schemas.py
Identity and sessions
- Login endpoint
Backend/routers/auth.py - JWT create and verify
Backend/jwt_token.py - Password hashing
Backend/hashing.py - Current-user authentication
Backend/oauth2.py
Persistence
- Session lifecycle
Backend/dependencies.py - Database engine
Backend/database.py - Finance data models
Backend/models.py
Other components
- User browser
- PostgreSQL
Connections 37
- User browser → FastAPI app and static UI: requests pages
README.md - FastAPI app and static UI → Login and signup: serves UI
Backend/main.py - FastAPI app and static UI → Session utilities: mounts static files
Backend/main.py - Login and signup → FastAPI app and static UI: registers and logs in
README.md - Session utilities → FastAPI app and static UI: checks session
README.md - Finance dashboard → FastAPI app and static UI: fetches transactions
README.md - Transaction view → FastAPI app and static UI: manages transactions
README.md - Budget view → FastAPI app and static UI: fetches budgets and transactions
README.md - FastAPI app and static UI → Login endpoint: registers router
Backend/main.py - FastAPI app and static UI → Account management: registers router
Backend/main.py - FastAPI app and static UI → Transaction API: registers router
Backend/main.py - FastAPI app and static UI → Category API: registers router
Backend/main.py - FastAPI app and static UI → Budget API: registers router
Backend/main.py - FastAPI app and static UI → Current-user authentication: authenticates /me
Backend/main.py - Account management → Password hashing: hashes passwords
Backend/routers/users.py - Login endpoint → Password hashing: verifies passwords
Backend/routers/auth.py - Login endpoint → JWT create and verify: issues JWT
Backend/routers/auth.py - Current-user authentication → JWT create and verify: verifies JWT
Backend/oauth2.py - Current-user authentication → Session lifecycle: loads user
Backend/oauth2.py - Current-user authentication → Finance data models: queries user
Backend/oauth2.py - Session lifecycle → Database engine: opens session
Backend/dependencies.py - FastAPI app and static UI → Finance data models: creates tables
README.md - Account management → Finance data models: creates user and categories
Backend/routers/users.py - Login endpoint → Finance data models: queries account
Backend/routers/auth.py - Transaction API → Finance data models: reads and writes
Backend/routers/transactions.py - Category API → Finance data models: reads and writes
Backend/routers/categories.py - Budget API → Finance data models: reads and writes
Backend/routers/budgets.py - Account management → Session lifecycle: uses session
Backend/routers/users.py - Login endpoint → Session lifecycle: uses session
Backend/routers/auth.py - Transaction API → Session lifecycle: uses session
Backend/routers/transactions.py - Category API → Session lifecycle: uses session
Backend/routers/categories.py - Budget API → Session lifecycle: uses session
Backend/routers/budgets.py - Account management → Request and response shapes: validates and shapes
Backend/routers/users.py - Transaction API → Request and response shapes: validates and shapes
Backend/routers/transactions.py - Category API → Request and response shapes: validates and shapes
Backend/routers/categories.py - Budget API → Request and response shapes: validates and shapes
Backend/routers/budgets.py - Database engine → PostgreSQL: connects to
README.md