How dwizsharma/personal-finance-manager works
Personal Finance Manager is a Spring MVC web app for recording and analyzing a user’s finances. The main workflow is registration/login, transaction entry (including CSV import and category splits), then budget checks and dashboard/report views; accounts, transfers, bills, goals, and notifications extend that workflow. The graph groups documented but unsampled capabilities at their existing controller or service directories. Source-index references and excerpts support the shown internal calls; some README-described routes and integrations are not evidenced in sampled source, so those links are dashed or omitted.
Main entry points: FinanceService.java Finance calculations · ExpenseController.java Income and expense entry · DashboardController.java Dashboard insights · UserService.java User services
Components 20
Web entry and identity
- Web routes and pages
src/main/java/com/financemanager/controller - Registration and login
src/main/java/com/financemanager/controller/AuthController.java - User services
src/main/java/com/financemanager/service/UserService.java
Financial activity
- Income and expense entry
src/main/java/com/financemanager/controller/ExpenseController.java - CSV statement import
src/main/java/com/financemanager/controller/StatementImportController.java - UPI and SMS capture
src/main/java/com/financemanager/service/UpiIntegrationService.java - Income and expense records
src/main/java/com/financemanager/entity/Expense.java - Category transaction splits
src/main/java/com/financemanager/entity/TransactionSplit.java
Budgets and insights
- Finance calculations
src/main/java/com/financemanager/service/FinanceService.java - Budget limits and alerts
src/main/java/com/financemanager/entity/Budget.java - Dashboard insights
src/main/java/com/financemanager/controller/DashboardController.java - Financial health score
src/main/java/com/financemanager/service/FinancialHealthService.java - Financial reports
src/main/java/com/financemanager/controller/ReportController.java
Finance extensions
- Accounts and transfers
src/main/java/com/financemanager/controller/TransferController.java - Recurring bill reminders
src/main/java/com/financemanager/controller/RecurringBillController.java - Savings goals
src/main/java/com/financemanager/entity/SavingsGoal.java - Finance assistant
src/main/java/com/financemanager/controller/FinanceAssistantController.java
Persistence
- MySQL finance data
- Spring Data repositories
src/main/java/com/financemanager/repository
Other components
- Finance user
Connections 23
- Finance user → Registration and login: registers or logs in
README.md - Registration and login → User services: creates user
- Finance user → Income and expense entry: records transactions
- Income and expense entry → User services: resolves user
src/main/java/com/financemanager/controller/ExpenseController.java - Income and expense entry → Finance calculations: records expense
src/main/java/com/financemanager/controller/ExpenseController.java - CSV statement import → Finance calculations: records transactions
src/main/java/com/financemanager/controller/StatementImportController.java - UPI and SMS capture → Finance calculations: records expense
src/main/java/com/financemanager/service/UpiIntegrationService.java - Finance calculations → Income and expense records: creates expense
src/main/java/com/financemanager/service/FinanceService.java - Finance calculations → Category transaction splits: allocates categories
src/main/java/com/financemanager/service/FinanceService.java - Income and expense entry → Dashboard insights: views results
- Dashboard insights → Finance calculations: loads summaries
src/main/java/com/financemanager/controller/DashboardController.java - Dashboard insights → Financial health score: loads health score
src/main/java/com/financemanager/controller/DashboardController.java - Finance calculations → Category transaction splits: checks category spend
src/main/java/com/financemanager/service/FinanceService.java - Finance calculations → Budget limits and alerts: checks limits
src/main/java/com/financemanager/service/FinanceService.java - Finance user → Financial reports: downloads report
README.md - Financial reports → Finance calculations: loads finance data
src/main/java/com/financemanager/controller/ReportController.java - Finance user → CSV statement import: uploads statement
README.md - Finance user → Accounts and transfers: manages accounts
README.md - Finance user → Recurring bill reminders: adds reminders
README.md - Finance user → Finance assistant: asks finance questions
- Finance calculations → Spring Data repositories: queries and saves
src/main/java/com/financemanager/service/FinanceService.java - User services → Spring Data repositories: queries and saves users
src/main/java/com/financemanager/service/UserService.java - Spring Data repositories → MySQL finance data: persists records