# dwizsharma/personal-finance-manager architecture

> Architecture diagram of the GitHub repository dwizsharma/personal-finance-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dwizsharma/personal-finance-manager
- Repository: https://github.com/dwizsharma/personal-finance-manager

## Overview

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: [`src/main/java/com/financemanager/service/FinanceService.java`](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/FinanceService.java) (Finance calculations), [`src/main/java/com/financemanager/controller/ExpenseController.java`](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/ExpenseController.java) (Income and expense entry), [`src/main/java/com/financemanager/controller/DashboardController.java`](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/DashboardController.java) (Dashboard insights), [`src/main/java/com/financemanager/service/UserService.java`](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/UserService.java) (User services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry and identity"]
  node_web["Web routes and pages"]
  node_auth["Registration and login"]
  node_identity["User services<br/>[UserService.java]"]
end

subgraph group_transactions["Financial activity"]
  node_entrytx["Income and expense entry"]
  node_statement["CSV statement import"]
  node_upi["UPI and SMS capture"]
  node_ledger[("Income and expense records<br/>[Expense.java]")]
  node_splits[("Category transaction splits")]
end

subgraph group_insights["Budgets and insights"]
  node_finance["Finance calculations"]
  node_budget[("Budget limits and alerts<br/>[Budget.java]")]
  node_dashboard["Dashboard insights"]
  node_health["Financial health score"]
  node_reports["Financial reports"]
end

subgraph group_extensions["Finance extensions"]
  node_accounts["Accounts and transfers"]
  node_bills["Recurring bill reminders"]
  node_goals[("Savings goals<br/>[SavingsGoal.java]")]
  node_assistant["Finance assistant"]
end

subgraph group_persistence["Persistence"]
  node_store[("MySQL finance data")]
  node_repos["Spring Data repositories"]
end

node_user(("Finance user"))

node_user -->|"registers or logs in"| node_auth
node_auth -.->|"creates user"| node_identity
node_user -.->|"records transactions"| node_entrytx
node_entrytx -->|"resolves user"| node_identity
node_entrytx -->|"records expense"| node_finance
node_statement -->|"records transactions"| node_finance
node_upi -->|"records expense"| node_finance
node_finance -->|"creates expense"| node_ledger
node_finance -->|"allocates categories"| node_splits
node_entrytx -.->|"views results"| node_dashboard
node_dashboard -->|"loads summaries"| node_finance
node_dashboard -->|"loads health score"| node_health
node_finance -->|"checks category spend"| node_splits
node_finance -->|"checks limits"| node_budget
node_user -->|"downloads report"| node_reports
node_reports -->|"loads finance data"| node_finance
node_user -->|"uploads statement"| node_statement
node_user -->|"manages accounts"| node_accounts
node_user -->|"adds reminders"| node_bills
node_user -.->|"asks finance questions"| node_assistant
node_finance -->|"queries and saves"| node_repos
node_identity -->|"queries and saves users"| node_repos
node_repos -.->|"persists records"| node_store

click node_web "https://github.com/dwizsharma/personal-finance-manager/tree/main/src/main/java/com/financemanager/controller"
click node_auth "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/AuthController.java"
click node_identity "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/UserService.java"
click node_entrytx "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/ExpenseController.java"
click node_statement "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/StatementImportController.java"
click node_upi "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/UpiIntegrationService.java"
click node_ledger "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/Expense.java"
click node_splits "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/TransactionSplit.java"
click node_finance "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/FinanceService.java"
click node_budget "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/Budget.java"
click node_dashboard "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/DashboardController.java"
click node_health "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/FinancialHealthService.java"
click node_reports "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/ReportController.java"
click node_accounts "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/TransferController.java"
click node_bills "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/RecurringBillController.java"
click node_goals "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/SavingsGoal.java"
click node_assistant "https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/FinanceAssistantController.java"
click node_repos "https://github.com/dwizsharma/personal-finance-manager/tree/main/src/main/java/com/financemanager/repository"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_auth,node_identity,node_user toneBlue
class node_entrytx,node_statement,node_upi,node_ledger,node_splits toneAmber
class node_finance,node_budget,node_dashboard,node_health,node_reports toneMint
class node_accounts,node_bills,node_goals,node_assistant toneRose
class node_store,node_repos toneIndigo
```

## Components

### Web entry and identity

- [Web routes and pages](https://github.com/dwizsharma/personal-finance-manager/tree/main/src/main/java/com/financemanager/controller): `src/main/java/com/financemanager/controller`
- [Registration and login](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/AuthController.java): `src/main/java/com/financemanager/controller/AuthController.java`
- [User services](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/UserService.java): `src/main/java/com/financemanager/service/UserService.java`

### Financial activity

- [Income and expense entry](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/ExpenseController.java): `src/main/java/com/financemanager/controller/ExpenseController.java`
- [CSV statement import](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/StatementImportController.java): `src/main/java/com/financemanager/controller/StatementImportController.java`
- [UPI and SMS capture](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/UpiIntegrationService.java): `src/main/java/com/financemanager/service/UpiIntegrationService.java`
- [Income and expense records](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/Expense.java): `src/main/java/com/financemanager/entity/Expense.java`
- [Category transaction splits](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/TransactionSplit.java): `src/main/java/com/financemanager/entity/TransactionSplit.java`

### Budgets and insights

- [Finance calculations](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/FinanceService.java): `src/main/java/com/financemanager/service/FinanceService.java`
- [Budget limits and alerts](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/Budget.java): `src/main/java/com/financemanager/entity/Budget.java`
- [Dashboard insights](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/DashboardController.java): `src/main/java/com/financemanager/controller/DashboardController.java`
- [Financial health score](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/service/FinancialHealthService.java): `src/main/java/com/financemanager/service/FinancialHealthService.java`
- [Financial reports](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/ReportController.java): `src/main/java/com/financemanager/controller/ReportController.java`

### Finance extensions

- [Accounts and transfers](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/TransferController.java): `src/main/java/com/financemanager/controller/TransferController.java`
- [Recurring bill reminders](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/RecurringBillController.java): `src/main/java/com/financemanager/controller/RecurringBillController.java`
- [Savings goals](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/entity/SavingsGoal.java): `src/main/java/com/financemanager/entity/SavingsGoal.java`
- [Finance assistant](https://github.com/dwizsharma/personal-finance-manager/blob/main/src/main/java/com/financemanager/controller/FinanceAssistantController.java): `src/main/java/com/financemanager/controller/FinanceAssistantController.java`

### Persistence

- **MySQL finance data**
- [Spring Data repositories](https://github.com/dwizsharma/personal-finance-manager/tree/main/src/main/java/com/financemanager/repository): `src/main/java/com/financemanager/repository`

### Other components

- **Finance user**

## Connections

- Finance user → Registration and login: registers or logs in (evidence: `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 (evidence: `src/main/java/com/financemanager/controller/ExpenseController.java`)
- Income and expense entry → Finance calculations: records expense (evidence: `src/main/java/com/financemanager/controller/ExpenseController.java`)
- CSV statement import → Finance calculations: records transactions (evidence: `src/main/java/com/financemanager/controller/StatementImportController.java`)
- UPI and SMS capture → Finance calculations: records expense (evidence: `src/main/java/com/financemanager/service/UpiIntegrationService.java`)
- Finance calculations → Income and expense records: creates expense (evidence: `src/main/java/com/financemanager/service/FinanceService.java`)
- Finance calculations → Category transaction splits: allocates categories (evidence: `src/main/java/com/financemanager/service/FinanceService.java`)
- Income and expense entry → Dashboard insights: views results
- Dashboard insights → Finance calculations: loads summaries (evidence: `src/main/java/com/financemanager/controller/DashboardController.java`)
- Dashboard insights → Financial health score: loads health score (evidence: `src/main/java/com/financemanager/controller/DashboardController.java`)
- Finance calculations → Category transaction splits: checks category spend (evidence: `src/main/java/com/financemanager/service/FinanceService.java`)
- Finance calculations → Budget limits and alerts: checks limits (evidence: `src/main/java/com/financemanager/service/FinanceService.java`)
- Finance user → Financial reports: downloads report (evidence: `README.md`)
- Financial reports → Finance calculations: loads finance data (evidence: `src/main/java/com/financemanager/controller/ReportController.java`)
- Finance user → CSV statement import: uploads statement (evidence: `README.md`)
- Finance user → Accounts and transfers: manages accounts (evidence: `README.md`)
- Finance user → Recurring bill reminders: adds reminders (evidence: `README.md`)
- Finance user → Finance assistant: asks finance questions
- Finance calculations → Spring Data repositories: queries and saves (evidence: `src/main/java/com/financemanager/service/FinanceService.java`)
- User services → Spring Data repositories: queries and saves users (evidence: `src/main/java/com/financemanager/service/UserService.java`)
- Spring Data repositories → MySQL finance data: persists records
