# lazyoroz/fintrack architecture

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

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

## Overview

FinTrack is a personal-finance REST API. Authenticated clients manage accounts, categories, transactions and transfers, budgets, recurring transactions, and dashboard summaries; the API persists financial state through EF Core. Registration and login use an authentication service, while a hosted worker processes due recurring transactions. The README documents the broader capabilities; sampled controllers and the source index support the main API-to-persistence links. Some application behavior is documented but its implementation was not sampled, so those links are omitted where not evidenced.

Main entry points: [`backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs`](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs) (EF Core Context), [`backend/FinTrack.Infrastructure/Services/AuthService.cs`](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/Services/AuthService.cs) (Auth Service), [`backend/FinTrack.Api/Program.cs`](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Program.cs) (API Startup), [`backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs`](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs) (Recurring API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_accounts["Accounts API"]
  node_categories["Categories API"]
  node_transactions["Transactions API"]
  node_budgets["Budgets API"]
  node_dashboard["Dashboard API"]
  node_recurring_api["Recurring API"]
  node_auth_api["Authentication API<br/>[AuthController.cs]"]
end

subgraph group_auth["Identity"]
  node_auth_service["Auth Service<br/>[AuthService.cs]"]
  node_auth_contract["Auth Contract<br/>[IAuthService.cs]"]
  node_auth_models["Auth Models<br/>[Auth]"]
end

subgraph group_finance["Finance Domain"]
  node_domain["Financial Entities<br/>[Entities]"]
  node_finance_models["Finance DTOs"]
end

subgraph group_infra["Persistence Processing"]
  node_dbcontext["EF Core Context"]
  node_worker["Recurring Worker"]
  node_startup["API Startup<br/>[Program.cs]"]
end

node_client(("API Client"))
node_mysql[("MySQL")]

node_client -->|"manages accounts"| node_accounts
node_client -->|"manages categories"| node_categories
node_client -->|"records activity"| node_transactions
node_client -->|"tracks budgets"| node_budgets
node_client -->|"requests summary"| node_dashboard
node_client -->|"manages schedules"| node_recurring_api
node_client -->|"registers or logs in"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_service -->|"implements"| node_auth_contract
node_auth_api -->|"accepts and returns"| node_auth_models
node_auth_service -->|"uses"| node_auth_models
node_auth_service -->|"reads and writes users"| node_dbcontext
node_accounts -->|"reads and writes"| node_dbcontext
node_categories -->|"reads and writes"| node_dbcontext
node_transactions -->|"reads and writes"| node_dbcontext
node_budgets -->|"reads and writes"| node_dbcontext
node_dashboard -->|"queries summary data"| node_dbcontext
node_recurring_api -->|"reads and writes"| node_dbcontext
node_recurring_api -->|"uses requests and responses"| node_finance_models
node_dbcontext -->|"maps entities"| node_domain
node_dbcontext -->|"persists through EF Core"| node_mysql
node_worker -->|"processes due items"| node_dbcontext
node_startup -->|"configures persistence"| node_dbcontext
node_startup -->|"registers service"| node_auth_service
node_startup -->|"registers worker"| node_worker

click node_accounts "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/AccountsController.cs"
click node_categories "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/CategoriesController.cs"
click node_transactions "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/TransactionsController.cs"
click node_budgets "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/BudgetsController.cs"
click node_dashboard "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/DashboardController.cs"
click node_recurring_api "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs"
click node_auth_api "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/AuthController.cs"
click node_auth_service "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/Services/AuthService.cs"
click node_auth_contract "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Application/Interfaces/IAuthService.cs"
click node_auth_models "https://github.com/lazyoroz/fintrack/tree/main/backend/FinTrack.Application/Auth"
click node_domain "https://github.com/lazyoroz/fintrack/tree/main/backend/FinTrack.Domain/Entities"
click node_finance_models "https://github.com/lazyoroz/fintrack/tree/main/backend/FinTrack.Application"
click node_dbcontext "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs"
click node_worker "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/BackgroundServices/RecurringTransactionWorker.cs"
click node_startup "https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/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_accounts,node_categories,node_transactions,node_budgets,node_dashboard,node_recurring_api,node_auth_api,node_client toneBlue
class node_auth_service,node_auth_contract,node_auth_models,node_mysql toneAmber
class node_domain,node_finance_models toneMint
class node_dbcontext,node_worker,node_startup toneRose
```

## Components

### REST API

- [Accounts API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/AccountsController.cs): `backend/FinTrack.Api/Controllers/AccountsController.cs`
- [Categories API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/CategoriesController.cs): `backend/FinTrack.Api/Controllers/CategoriesController.cs`
- [Transactions API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/TransactionsController.cs): `backend/FinTrack.Api/Controllers/TransactionsController.cs`
- [Budgets API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/BudgetsController.cs): `backend/FinTrack.Api/Controllers/BudgetsController.cs`
- [Dashboard API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/DashboardController.cs): `backend/FinTrack.Api/Controllers/DashboardController.cs`
- [Recurring API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs): `backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs`
- [Authentication API](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Controllers/AuthController.cs): `backend/FinTrack.Api/Controllers/AuthController.cs`

### Identity

- [Auth Service](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/Services/AuthService.cs): `backend/FinTrack.Infrastructure/Services/AuthService.cs`
- [Auth Contract](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Application/Interfaces/IAuthService.cs): `backend/FinTrack.Application/Interfaces/IAuthService.cs`
- [Auth Models](https://github.com/lazyoroz/fintrack/tree/main/backend/FinTrack.Application/Auth): `backend/FinTrack.Application/Auth`

### Finance Domain

- [Financial Entities](https://github.com/lazyoroz/fintrack/tree/main/backend/FinTrack.Domain/Entities): `backend/FinTrack.Domain/Entities`
- [Finance DTOs](https://github.com/lazyoroz/fintrack/tree/main/backend/FinTrack.Application): `backend/FinTrack.Application`

### Persistence Processing

- [EF Core Context](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs): `backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs`
- [Recurring Worker](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Infrastructure/BackgroundServices/RecurringTransactionWorker.cs): `backend/FinTrack.Infrastructure/BackgroundServices/RecurringTransactionWorker.cs`
- [API Startup](https://github.com/lazyoroz/fintrack/blob/main/backend/FinTrack.Api/Program.cs): `backend/FinTrack.Api/Program.cs`

### Other components

- **API Client**
- **MySQL**

## Connections

- API Client → Accounts API: manages accounts
- API Client → Categories API: manages categories
- API Client → Transactions API: records activity
- API Client → Budgets API: tracks budgets
- API Client → Dashboard API: requests summary
- API Client → Recurring API: manages schedules
- API Client → Authentication API: registers or logs in
- Authentication API → Auth Service: delegates auth (evidence: `backend/FinTrack.Api/Controllers/AuthController.cs`)
- Auth Service → Auth Contract: implements (evidence: `backend/FinTrack.Infrastructure/Services/AuthService.cs`)
- Authentication API → Auth Models: accepts and returns (evidence: `backend/FinTrack.Api/Controllers/AuthController.cs`)
- Auth Service → Auth Models: uses (evidence: `backend/FinTrack.Infrastructure/Services/AuthService.cs`)
- Auth Service → EF Core Context: reads and writes users (evidence: `backend/FinTrack.Infrastructure/Services/AuthService.cs`)
- Accounts API → EF Core Context: reads and writes (evidence: `backend/FinTrack.Api/Controllers/AccountsController.cs`)
- Categories API → EF Core Context: reads and writes (evidence: `backend/FinTrack.Api/Controllers/CategoriesController.cs`)
- Transactions API → EF Core Context: reads and writes (evidence: `backend/FinTrack.Api/Controllers/TransactionsController.cs`)
- Budgets API → EF Core Context: reads and writes (evidence: `backend/FinTrack.Api/Controllers/BudgetsController.cs`)
- Dashboard API → EF Core Context: queries summary data (evidence: `backend/FinTrack.Api/Controllers/DashboardController.cs`)
- Recurring API → EF Core Context: reads and writes (evidence: `backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs`)
- Recurring API → Finance DTOs: uses requests and responses (evidence: `backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs`)
- EF Core Context → Financial Entities: maps entities (evidence: `backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs`)
- EF Core Context → MySQL: persists through EF Core
- Recurring Worker → EF Core Context: processes due items (evidence: `backend/FinTrack.Infrastructure/BackgroundServices/RecurringTransactionWorker.cs`)
- API Startup → EF Core Context: configures persistence (evidence: `backend/FinTrack.Api/Program.cs`)
- API Startup → Auth Service: registers service (evidence: `backend/FinTrack.Api/Program.cs`)
- API Startup → Recurring Worker: registers worker (evidence: `backend/FinTrack.Api/Program.cs`)
