# petruhertea/personal-finance-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/petruhertea/personal-finance-tracker
- Repository: https://github.com/petruhertea/personal-finance-tracker

## Overview

Personal Finance Tracker is an Angular SPA backed by a Spring Boot REST API. Users authenticate with cookie-based JWTs, then manage transactions, budgets, categories, profiles, and imported bank statements; dashboard visualizations summarize their financial data. The README documents the major capabilities and frontend/backend REST boundary. Source excerpts and the SOURCE INDEX support selected controller-to-service and import-to-service relationships; other subsystem wiring is not asserted where it was not shown.

Main entry points: [`frontend/angular-personal-finance-tracker/src/app/app.component.ts`](https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/app.component.ts) (Finance SPA), [`backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java`](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java) (User endpoints), [`backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java`](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java) (Auth endpoints), [`backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/TransactionService.java`](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/TransactionService.java) (Transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_spa["Finance SPA<br/>[app.component.ts]"]
  node_routes["Feature routes<br/>[app.routes.ts]"]
  node_authui["Auth client<br/>[auth.service.ts]"]
  node_features["Finance features"]
  node_importui["Statement import"]
end

subgraph group_api["REST API"]
  node_authapi["Auth endpoints"]
  node_userapi["User endpoints"]
  node_profileapi["Profile endpoints"]
  node_csvapi["CSV endpoint"]
end

subgraph group_domain["Finance services"]
  node_transaction["Transactions"]
  node_budget["Budgets<br/>[BudgetService.java]"]
  node_category["Categories"]
  node_profile["Account profile"]
  node_csv["CSV parsing"]
  node_pdf["PDF parsing"]
  node_email["Email service<br/>[EmailService.java]"]
end

subgraph group_persistence["Persistence"]
  node_store[("Relational database")]
  node_entities["Finance entities"]
  node_repos["Data repositories"]
end

node_person(("User"))

node_person -->|"uses"| node_spa
node_spa -->|"authenticates via"| node_authui
node_spa -->|"navigates"| node_routes
node_routes -->|"routes to"| node_features
node_person -->|"manages finances"| node_features
node_person -->|"uploads statement"| node_importui
node_spa -->|"calls REST API"| node_authapi
node_features -.->|"calls REST API"| node_userapi
node_importui -.->|"uploads file"| node_csvapi
node_authui -->|"posts login"| node_authapi
node_authapi -->|"uses"| node_profile
node_authapi -->|"sends verification"| node_email
node_userapi -->|"queries"| node_transaction
node_userapi -->|"queries"| node_budget
node_userapi -->|"queries"| node_category
node_profileapi -->|"delegates to"| node_profile
node_csv -->|"saves imports"| node_transaction
node_csv -->|"uses"| node_category
node_csvapi -.->|"dispatches to"| node_csv
node_pdf -->|"saves imports"| node_transaction
node_pdf -->|"uses"| node_category
node_transaction -.->|"persists via"| node_repos
node_repos -.->|"stores"| node_entities
node_entities -->|"mapped in"| node_store

click node_spa "https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/app.component.ts"
click node_routes "https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/app.routes.ts"
click node_authui "https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/services/auth.service.ts"
click node_features "https://github.com/petruhertea/personal-finance-tracker/tree/master/frontend/angular-personal-finance-tracker/src/app/components"
click node_importui "https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/components/bank-statement-import/bank-statement-import.component.ts"
click node_authapi "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java"
click node_userapi "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java"
click node_profileapi "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/ProfileController.java"
click node_csvapi "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/CsvImportController.java"
click node_transaction "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/TransactionService.java"
click node_budget "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/BudgetService.java"
click node_category "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CategoryService.java"
click node_profile "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/ProfileService.java"
click node_csv "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java"
click node_pdf "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java"
click node_email "https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/EmailService.java"
click node_entities "https://github.com/petruhertea/personal-finance-tracker/tree/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/entity"
click node_repos "https://github.com/petruhertea/personal-finance-tracker/tree/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/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_spa,node_routes,node_authui,node_features,node_importui,node_person toneBlue
class node_authapi,node_userapi,node_profileapi,node_csvapi toneAmber
class node_transaction,node_budget,node_category,node_profile,node_csv,node_pdf,node_email toneMint
class node_store,node_entities,node_repos toneRose
```

## Components

### Angular client

- [Finance SPA](https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/app.component.ts): `frontend/angular-personal-finance-tracker/src/app/app.component.ts`
- [Feature routes](https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/app.routes.ts): `frontend/angular-personal-finance-tracker/src/app/app.routes.ts`
- [Auth client](https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/services/auth.service.ts): `frontend/angular-personal-finance-tracker/src/app/services/auth.service.ts`
- [Finance features](https://github.com/petruhertea/personal-finance-tracker/tree/master/frontend/angular-personal-finance-tracker/src/app/components): `frontend/angular-personal-finance-tracker/src/app/components`
- [Statement import](https://github.com/petruhertea/personal-finance-tracker/blob/master/frontend/angular-personal-finance-tracker/src/app/components/bank-statement-import/bank-statement-import.component.ts): `frontend/angular-personal-finance-tracker/src/app/components/bank-statement-import/bank-statement-import.component.ts`

### REST API

- [Auth endpoints](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java`
- [User endpoints](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java`
- [Profile endpoints](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/ProfileController.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/ProfileController.java`
- [CSV endpoint](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/CsvImportController.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/CsvImportController.java`

### Finance services

- [Transactions](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/TransactionService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/TransactionService.java`
- [Budgets](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/BudgetService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/BudgetService.java`
- [Categories](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CategoryService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CategoryService.java`
- [Account profile](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/ProfileService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/ProfileService.java`
- [CSV parsing](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java`
- [PDF parsing](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java`
- [Email service](https://github.com/petruhertea/personal-finance-tracker/blob/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/EmailService.java): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/EmailService.java`

### Persistence

- **Relational database**
- [Finance entities](https://github.com/petruhertea/personal-finance-tracker/tree/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/entity): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/entity`
- [Data repositories](https://github.com/petruhertea/personal-finance-tracker/tree/master/backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/repository): `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/repository`

### Other components

- **User**

## Connections

- User → Finance SPA: uses
- Finance SPA → Auth client: authenticates via (evidence: `frontend/angular-personal-finance-tracker/src/app/app.component.ts`)
- Finance SPA → Feature routes: navigates (evidence: `frontend/angular-personal-finance-tracker/src/app/app.routes.ts`)
- Feature routes → Finance features: routes to (evidence: `frontend/angular-personal-finance-tracker/src/app/app.routes.ts`)
- User → Finance features: manages finances
- User → Statement import: uploads statement
- Finance SPA → Auth endpoints: calls REST API
- Finance features → User endpoints: calls REST API
- Statement import → CSV endpoint: uploads file
- Auth client → Auth endpoints: posts login (evidence: `frontend/angular-personal-finance-tracker/src/app/services/auth.service.ts`)
- Auth endpoints → Account profile: uses (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java`)
- Auth endpoints → Email service: sends verification (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java`)
- User endpoints → Transactions: queries (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java`)
- User endpoints → Budgets: queries (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java`)
- User endpoints → Categories: queries (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java`)
- Profile endpoints → Account profile: delegates to (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/ProfileController.java`)
- CSV parsing → Transactions: saves imports (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java`)
- CSV parsing → Categories: uses (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java`)
- CSV endpoint → CSV parsing: dispatches to (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/CsvImportController.java`)
- PDF parsing → Transactions: saves imports (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java`)
- PDF parsing → Categories: uses (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java`)
- Transactions → Data repositories: persists via
- Data repositories → Finance entities: stores (evidence: `backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/repository/TransactionRepository.java`)
- Finance entities → Relational database: mapped in
