How petruhertea/personal-finance-tracker works
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: app.component.ts Finance SPA · UserController.java User endpoints · AuthController.java Auth endpoints · TransactionService.java Transactions
Components 20
Angular client
- Finance SPA
frontend/angular-personal-finance-tracker/src/app/app.component.ts - Feature routes
frontend/angular-personal-finance-tracker/src/app/app.routes.ts - Auth client
frontend/angular-personal-finance-tracker/src/app/services/auth.service.ts - Finance features
frontend/angular-personal-finance-tracker/src/app/components - Statement import
frontend/angular-personal-finance-tracker/src/app/components/bank-statement-import/bank-statement-import.component.ts
REST API
- Auth endpoints
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java - User endpoints
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java - Profile endpoints
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/ProfileController.java - CSV endpoint
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/CsvImportController.java
Finance services
- Transactions
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/TransactionService.java - Budgets
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/BudgetService.java - Categories
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CategoryService.java - Account profile
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/ProfileService.java - CSV parsing
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java - PDF parsing
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java - Email service
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/EmailService.java
Persistence
- Relational database
- Finance entities
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/entity - Data repositories
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/repository
Other components
- User
Connections 24
- User → Finance SPA: uses
- Finance SPA → Auth client: authenticates via
frontend/angular-personal-finance-tracker/src/app/app.component.ts - Finance SPA → Feature routes: navigates
frontend/angular-personal-finance-tracker/src/app/app.routes.ts - Feature routes → Finance features: routes to
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
frontend/angular-personal-finance-tracker/src/app/services/auth.service.ts - Auth endpoints → Account profile: uses
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java - Auth endpoints → Email service: sends verification
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/AuthController.java - User endpoints → Transactions: queries
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java - User endpoints → Budgets: queries
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java - User endpoints → Categories: queries
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/UserController.java - Profile endpoints → Account profile: delegates to
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/ProfileController.java - CSV parsing → Transactions: saves imports
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java - CSV parsing → Categories: uses
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/CsvImportService.java - CSV endpoint → CSV parsing: dispatches to
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/controller/CsvImportController.java - PDF parsing → Transactions: saves imports
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/service/PdfImportService.java - PDF parsing → Categories: uses
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
backend/personal-finance-tracker-spring-boot/src/main/java/com/petruth/personal_finance_tracker/repository/TransactionRepository.java - Finance entities → Relational database: mapped in