How achinthasampath/ai_powered_finance_tracker works
Expense Tracker lets users record income and expenses, import CSV bank statements for AI categorization, and review balances, spending breakdowns, and transaction history. The browser routes users to dashboard, entry, and history views; those views call a shared HTTP service, which reaches Express routes and transaction controllers. Controllers validate, summarize, and persist records through the transaction model, while statement imports invoke Gemini before bulk insertion. The README documents search/filter and dark mode; source excerpts are partial, so some view behavior and integrations are represented at their documented subsystem level.
Main entry points: App.jsx App routing · transactionService.js HTTP service · Dashboard.jsx Dashboard · server.js Express server
Components 18
Web application
- App routing
frontend/src/App.jsx - Navigation
frontend/src/components/Navbar.jsx - Theme state
frontend/src/context/ThemeContext.jsx - Dashboard
frontend/src/pages/Dashboard.jsx - Add transaction
frontend/src/pages/Add.jsx - Transaction history
frontend/src/pages/Transactions.jsx - CSV upload UI
frontend/src/components/FileUpload.jsx - HTTP service
frontend/src/services/transactionService.js
Transaction API
- Express server
backend/server.js - API routes
backend/src/routes/transactionRoutes.js - Transaction operations
backend/src/controllers/transactionController.js
Persistence
- Transaction model
backend/src/models/transactions.js - DB connection
backend/src/config/db.js
Statement import
- File parser middleware
backend/src/middleware/upload.js - AI categorization
backend/src/services/geminiService.js
Other components
- User
- MongoDB
- Gemini API
Connections 22
- User → App routing: uses
README.md - App routing → Navigation: renders
frontend/src/App.jsx - App routing → Dashboard: routes to
frontend/src/App.jsx - App routing → Add transaction: routes to
frontend/src/App.jsx - App routing → Transaction history: routes to
frontend/src/App.jsx - App routing → Theme state: provides
frontend/src/App.jsx - Navigation → Theme state: updates
frontend/src/components/Navbar.jsx - Dashboard → HTTP service: fetches data
frontend/src/pages/Dashboard.jsx - Dashboard → CSV upload UI: renders
frontend/src/pages/Dashboard.jsx - Add transaction → HTTP service: submits transaction
frontend/src/pages/Add.jsx - Transaction history → HTTP service: manages records
frontend/src/pages/Transactions.jsx - CSV upload UI → HTTP service: uploads CSV
frontend/src/components/FileUpload.jsx - HTTP service → Express server: sends HTTP requests
frontend/src/services/transactionService.js - Express server → DB connection: connects database
backend/server.js - Express server → API routes: mounts routes
backend/server.js - API routes → Transaction operations: dispatches
backend/src/routes/transactionRoutes.js - API routes → File parser middleware: parses upload
backend/src/routes/transactionRoutes.js - Transaction operations → Transaction model: reads and writes
backend/src/controllers/transactionController.js - Transaction operations → AI categorization: categorizes CSV
backend/src/controllers/transactionController.js - AI categorization → Gemini API: requests categorization
backend/src/services/geminiService.js - DB connection → MongoDB: connects
backend/src/config/db.js - Transaction model → MongoDB: persists records