# dcit318-fintrack/fintrack architecture

> Architecture diagram of the GitHub repository dcit318-fintrack/fintrack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dcit318-fintrack/fintrack
- Repository: https://github.com/dcit318-fintrack/fintrack

## Overview

FinTrack is a personal-finance web application: users authenticate, record and manage income and expenses, then review budgets, savings progress, dashboard summaries, and reports. The documented Blazor client calls an ASP.NET Core API; server controllers delegate domain work to services backed by EF Core and shared DTOs. The excerpts show several service-to-database interactions and DI registration, while the README documents the broader product capabilities. UI pages and some service implementations were not sampled, so those connections are limited to documented or indexed evidence.

Main entry points: [`src/FinTrack.Client/Services/FinTrackApiService.cs`](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/FinTrackApiService.cs) (API client), [`src/FinTrack.Shared/DTOs`](https://github.com/dcit318-fintrack/fintrack/tree/main/src/FinTrack.Shared/DTOs) (Shared contracts), [`src/FinTrack.Server/Data/FinTrackDbContext.cs`](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Data/FinTrackDbContext.cs) (EF data context), [`src/FinTrack.Server/Services/Auth/AuthService.cs`](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Auth/AuthService.cs) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_client_api["API client"]
  node_client_auth["Client auth<br/>[AuthService.cs]"]
  node_auth_handler["Token handler"]
  node_chart_script["Charts<br/>[fintrack-charts.js]"]
  node_shared_dtos["Shared contracts<br/>[DTOs]"]
end

subgraph group_identity["Authentication"]
  node_auth_controller["Auth endpoints<br/>[AuthController.cs]"]
  node_auth_service["Auth service<br/>[AuthService.cs]"]
  node_jwt["JWT generator"]
end

subgraph group_finance["Finance operations"]
  node_transactions_api["Transaction endpoints"]
  node_transactions_logic["Transaction service"]
  node_budgets_api["Budget endpoints"]
  node_budgets_logic["Budget service<br/>[BudgetService.cs]"]
  node_categories_api["Category endpoints"]
  node_savings_api["Savings endpoints"]
  node_savings_logic["Savings service"]
end

subgraph group_insights["Financial insights"]
  node_dashboard_api["Dashboard endpoint"]
  node_dashboard_logic["Dashboard service"]
  node_reports_api["Report endpoints"]
  node_reports_logic["Report service<br/>[ReportService.cs]"]
end

subgraph group_persistence["Persistence"]
  node_db_context["EF data context"]
  node_database[("Finance database")]
  node_server["API host<br/>[Program.cs]"]
end

node_user(("Finance user"))

node_user -->|"uses"| node_client_api
node_client_api -->|"calls API"| node_auth_controller
node_client_api -->|"calls API"| node_transactions_api
node_client_api -->|"calls API"| node_budgets_api
node_client_api -->|"calls API"| node_categories_api
node_client_api -->|"calls API"| node_savings_api
node_client_api -->|"calls API"| node_dashboard_api
node_client_api -->|"calls API"| node_reports_api
node_client_api -->|"uses contracts"| node_shared_dtos
node_client_auth -->|"authenticates via"| node_auth_controller
node_auth_handler -->|"attaches tokens"| node_client_api
node_auth_controller -->|"delegates to"| node_auth_service
node_auth_service -->|"requests tokens"| node_jwt
node_auth_service -->|"uses contracts"| node_shared_dtos
node_transactions_api -->|"delegates to"| node_transactions_logic
node_transactions_logic -->|"reads and writes"| node_db_context
node_transactions_api -->|"uses contracts"| node_shared_dtos
node_budgets_api -->|"delegates to"| node_budgets_logic
node_budgets_logic -->|"reads and writes"| node_db_context
node_budgets_api -->|"uses contracts"| node_shared_dtos
node_categories_api -.->|"uses contracts"| node_shared_dtos
node_savings_api -->|"delegates to"| node_savings_logic
node_savings_logic -->|"reads and writes"| node_db_context
node_savings_api -->|"uses contracts"| node_shared_dtos
node_dashboard_api -.->|"delegates to"| node_dashboard_logic
node_dashboard_logic -->|"queries data"| node_db_context
node_dashboard_logic -->|"uses budgets"| node_budgets_logic
node_reports_api -->|"delegates to"| node_reports_logic
node_reports_logic -->|"queries data"| node_db_context
node_dashboard_api -.->|"returns summary"| node_shared_dtos
node_reports_api -->|"returns reports"| node_shared_dtos
node_db_context -->|"persists entities"| node_database
node_server -->|"configures store"| node_db_context
node_chart_script -.->|"visualizes trends"| node_user

click node_client_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/FinTrackApiService.cs"
click node_client_auth "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/AuthService.cs"
click node_auth_handler "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/AuthenticationHandler.cs"
click node_chart_script "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/wwwroot/js/fintrack-charts.js"
click node_auth_controller "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/AuthController.cs"
click node_auth_service "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Auth/AuthService.cs"
click node_jwt "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Auth/JwtTokenGenerator.cs"
click node_transactions_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/TransactionsController.cs"
click node_transactions_logic "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Transactions/TransactionService.cs"
click node_budgets_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/BudgetsController.cs"
click node_budgets_logic "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Budgets/BudgetService.cs"
click node_categories_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/CategoriesController.cs"
click node_savings_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/SavingsGoalsController.cs"
click node_savings_logic "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Savings/SavingsGoalService.cs"
click node_dashboard_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/DashboardController.cs"
click node_dashboard_logic "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Dashboard/DashboardService.cs"
click node_reports_api "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/ReportsController.cs"
click node_reports_logic "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Reports/ReportService.cs"
click node_shared_dtos "https://github.com/dcit318-fintrack/fintrack/tree/main/src/FinTrack.Shared/DTOs"
click node_db_context "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Data/FinTrackDbContext.cs"
click node_server "https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Program.cs"

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_client_api,node_client_auth,node_auth_handler,node_chart_script,node_shared_dtos,node_user toneBlue
class node_auth_controller,node_auth_service,node_jwt toneAmber
class node_transactions_api,node_transactions_logic,node_budgets_api,node_budgets_logic,node_categories_api,node_savings_api,node_savings_logic toneMint
class node_dashboard_api,node_dashboard_logic,node_reports_api,node_reports_logic toneRose
class node_db_context,node_database,node_server toneIndigo
```

## Components

### Client

- [API client](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/FinTrackApiService.cs): `src/FinTrack.Client/Services/FinTrackApiService.cs`
- [Client auth](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/AuthService.cs): `src/FinTrack.Client/Services/AuthService.cs`
- [Token handler](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/Services/AuthenticationHandler.cs): `src/FinTrack.Client/Services/AuthenticationHandler.cs`
- [Charts](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Client/wwwroot/js/fintrack-charts.js): `src/FinTrack.Client/wwwroot/js/fintrack-charts.js`
- [Shared contracts](https://github.com/dcit318-fintrack/fintrack/tree/main/src/FinTrack.Shared/DTOs): `src/FinTrack.Shared/DTOs`

### Authentication

- [Auth endpoints](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/AuthController.cs): `src/FinTrack.Server/Controllers/AuthController.cs`
- [Auth service](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Auth/AuthService.cs): `src/FinTrack.Server/Services/Auth/AuthService.cs`
- [JWT generator](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Auth/JwtTokenGenerator.cs): `src/FinTrack.Server/Services/Auth/JwtTokenGenerator.cs`

### Finance operations

- [Transaction endpoints](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/TransactionsController.cs): `src/FinTrack.Server/Controllers/TransactionsController.cs`
- [Transaction service](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Transactions/TransactionService.cs): `src/FinTrack.Server/Services/Transactions/TransactionService.cs`
- [Budget endpoints](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/BudgetsController.cs): `src/FinTrack.Server/Controllers/BudgetsController.cs`
- [Budget service](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Budgets/BudgetService.cs): `src/FinTrack.Server/Services/Budgets/BudgetService.cs`
- [Category endpoints](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/CategoriesController.cs): `src/FinTrack.Server/Controllers/CategoriesController.cs`
- [Savings endpoints](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/SavingsGoalsController.cs): `src/FinTrack.Server/Controllers/SavingsGoalsController.cs`
- [Savings service](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Savings/SavingsGoalService.cs): `src/FinTrack.Server/Services/Savings/SavingsGoalService.cs`

### Financial insights

- [Dashboard endpoint](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/DashboardController.cs): `src/FinTrack.Server/Controllers/DashboardController.cs`
- [Dashboard service](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Dashboard/DashboardService.cs): `src/FinTrack.Server/Services/Dashboard/DashboardService.cs`
- [Report endpoints](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Controllers/ReportsController.cs): `src/FinTrack.Server/Controllers/ReportsController.cs`
- [Report service](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Services/Reports/ReportService.cs): `src/FinTrack.Server/Services/Reports/ReportService.cs`

### Persistence

- [EF data context](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Data/FinTrackDbContext.cs): `src/FinTrack.Server/Data/FinTrackDbContext.cs`
- **Finance database**
- [API host](https://github.com/dcit318-fintrack/fintrack/blob/main/src/FinTrack.Server/Program.cs): `src/FinTrack.Server/Program.cs`

### Other components

- **Finance user**

## Connections

- Finance user → API client: uses (evidence: `README.md`)
- API client → Auth endpoints: calls API (evidence: `README.md`)
- API client → Transaction endpoints: calls API (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- API client → Budget endpoints: calls API (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- API client → Category endpoints: calls API (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- API client → Savings endpoints: calls API (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- API client → Dashboard endpoint: calls API (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- API client → Report endpoints: calls API (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- API client → Shared contracts: uses contracts (evidence: `src/FinTrack.Client/Services/FinTrackApiService.cs`)
- Client auth → Auth endpoints: authenticates via (evidence: `README.md`)
- Token handler → API client: attaches tokens (evidence: `src/FinTrack.Client/Program.cs`)
- Auth endpoints → Auth service: delegates to
- Auth service → JWT generator: requests tokens (evidence: `src/FinTrack.Server/Services/Auth/AuthService.cs`)
- Auth service → Shared contracts: uses contracts (evidence: `src/FinTrack.Server/Services/Auth/AuthService.cs`)
- Transaction endpoints → Transaction service: delegates to (evidence: `src/FinTrack.Server/Controllers/TransactionsController.cs`)
- Transaction service → EF data context: reads and writes (evidence: `src/FinTrack.Server/Services/Transactions/TransactionService.cs`)
- Transaction endpoints → Shared contracts: uses contracts (evidence: `src/FinTrack.Server/Controllers/TransactionsController.cs`)
- Budget endpoints → Budget service: delegates to (evidence: `src/FinTrack.Server/Controllers/BudgetsController.cs`)
- Budget service → EF data context: reads and writes (evidence: `src/FinTrack.Server/Services/Budgets/BudgetService.cs`)
- Budget endpoints → Shared contracts: uses contracts (evidence: `src/FinTrack.Server/Controllers/BudgetsController.cs`)
- Category endpoints → Shared contracts: uses contracts
- Savings endpoints → Savings service: delegates to (evidence: `src/FinTrack.Server/Controllers/SavingsGoalsController.cs`)
- Savings service → EF data context: reads and writes (evidence: `src/FinTrack.Server/Services/Savings/SavingsGoalService.cs`)
- Savings endpoints → Shared contracts: uses contracts (evidence: `src/FinTrack.Server/Controllers/SavingsGoalsController.cs`)
- Dashboard endpoint → Dashboard service: delegates to
- Dashboard service → EF data context: queries data (evidence: `src/FinTrack.Server/Services/Dashboard/DashboardService.cs`)
- Dashboard service → Budget service: uses budgets (evidence: `src/FinTrack.Server/Services/Dashboard/DashboardService.cs`)
- Report endpoints → Report service: delegates to (evidence: `src/FinTrack.Server/Controllers/ReportsController.cs`)
- Report service → EF data context: queries data (evidence: `src/FinTrack.Server/Services/Reports/ReportService.cs`)
- Dashboard endpoint → Shared contracts: returns summary
- Report endpoints → Shared contracts: returns reports (evidence: `src/FinTrack.Server/Controllers/ReportsController.cs`)
- EF data context → Finance database: persists entities (evidence: `src/FinTrack.Server/Data/FinTrackDbContext.cs`)
- API host → EF data context: configures store (evidence: `src/FinTrack.Server/Program.cs`)
- Charts → Finance user: visualizes trends (evidence: `README.md`)
