How lazyoroz/fintrack works
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: FinTrackDbContext.cs EF Core Context · AuthService.cs Auth Service · Program.cs API Startup · RecurringTransactionsController.cs Recurring API
Components 17
REST API
- Accounts API
backend/FinTrack.Api/Controllers/AccountsController.cs - Categories API
backend/FinTrack.Api/Controllers/CategoriesController.cs - Transactions API
backend/FinTrack.Api/Controllers/TransactionsController.cs - Budgets API
backend/FinTrack.Api/Controllers/BudgetsController.cs - Dashboard API
backend/FinTrack.Api/Controllers/DashboardController.cs - Recurring API
backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs - Authentication API
backend/FinTrack.Api/Controllers/AuthController.cs
Identity
- Auth Service
backend/FinTrack.Infrastructure/Services/AuthService.cs - Auth Contract
backend/FinTrack.Application/Interfaces/IAuthService.cs - Auth Models
backend/FinTrack.Application/Auth
Finance Domain
- Financial Entities
backend/FinTrack.Domain/Entities - Finance DTOs
backend/FinTrack.Application
Persistence Processing
- EF Core Context
backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs - Recurring Worker
backend/FinTrack.Infrastructure/BackgroundServices/RecurringTransactionWorker.cs - API Startup
backend/FinTrack.Api/Program.cs
Other components
- API Client
- MySQL
Connections 25
- 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
backend/FinTrack.Api/Controllers/AuthController.cs - Auth Service → Auth Contract: implements
backend/FinTrack.Infrastructure/Services/AuthService.cs - Authentication API → Auth Models: accepts and returns
backend/FinTrack.Api/Controllers/AuthController.cs - Auth Service → Auth Models: uses
backend/FinTrack.Infrastructure/Services/AuthService.cs - Auth Service → EF Core Context: reads and writes users
backend/FinTrack.Infrastructure/Services/AuthService.cs - Accounts API → EF Core Context: reads and writes
backend/FinTrack.Api/Controllers/AccountsController.cs - Categories API → EF Core Context: reads and writes
backend/FinTrack.Api/Controllers/CategoriesController.cs - Transactions API → EF Core Context: reads and writes
backend/FinTrack.Api/Controllers/TransactionsController.cs - Budgets API → EF Core Context: reads and writes
backend/FinTrack.Api/Controllers/BudgetsController.cs - Dashboard API → EF Core Context: queries summary data
backend/FinTrack.Api/Controllers/DashboardController.cs - Recurring API → EF Core Context: reads and writes
backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs - Recurring API → Finance DTOs: uses requests and responses
backend/FinTrack.Api/Controllers/RecurringTransactionsController.cs - EF Core Context → Financial Entities: maps entities
backend/FinTrack.Infrastructure/Persistence/FinTrackDbContext.cs - EF Core Context → MySQL: persists through EF Core
- Recurring Worker → EF Core Context: processes due items
backend/FinTrack.Infrastructure/BackgroundServices/RecurringTransactionWorker.cs - API Startup → EF Core Context: configures persistence
backend/FinTrack.Api/Program.cs - API Startup → Auth Service: registers service
backend/FinTrack.Api/Program.cs - API Startup → Recurring Worker: registers worker
backend/FinTrack.Api/Program.cs