# raghunandan96660/fintrack-application architecture

> Architecture diagram of the GitHub repository raghunandan96660/fintrack-application, 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/raghunandan96660/fintrack-application
- Repository: https://github.com/raghunandan96660/fintrack-application

## Overview

FinTrack is a personal-finance platform with a React reference client, a Spring API service, and an asynchronous worker. Users authenticate, manage accounts and transactions, upload CSV imports, create budgets, and review summaries and notifications. The API persists commands and publishes events through a transactional outbox; the worker processes transaction and import workflows and evaluates budgets. README documents the service boundaries and integrations; sampled sources confirm selected account, transaction, auth, summary, notification, and import behavior. Other links are documented rather than source-verified.

Main entry points: [`frontend/src/App.tsx`](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/App.tsx) (React application), [`services/worker-service/src/main/java/com/fintrack/workerservice/transaction/repository/FinancialTransactionRepository.java`](https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/transaction/repository/FinancialTransactionRepository.java) (Event processing), [`frontend/src/pages/AccountsPage.tsx`](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/AccountsPage.tsx) (Accounts and transactions), [`services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java`](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java) (Identity and tokens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Reference client"]
  node_app["React application<br/>[App.tsx]"]
  node_authui["Login and registration<br/>[LoginPage.tsx]"]
  node_accountui["Accounts and transactions<br/>[AccountsPage.tsx]"]
  node_budgetui["Budgets and alerts<br/>[BudgetsPage.tsx]"]
  node_importui["CSV imports<br/>[ImportsPage.tsx]"]
  node_summaryui["Dashboard and summaries<br/>[DashboardPage.tsx]"]
  node_notifyui["Notifications"]
end

subgraph group_api["API service"]
  node_auth["Identity and tokens<br/>[AuthService.java]"]
  node_accounts["Account management"]
  node_transactions["Transaction management"]
  node_budgets["Budget management<br/>[BudgetService.java]"]
  node_imports["Import submission"]
  node_summaries["Spending summaries"]
  node_notifications["Notification queries"]
  node_outbox["Transactional outbox"]
end

subgraph group_async["Async processing"]
  node_worker["Event processing"]
  node_categorization["Auto-categorization"]
  node_budgeteval["Budget evaluation"]
  node_batch["Restartable CSV batch"]
end

subgraph group_platform["Shared platform"]
  node_db[("PostgreSQL")]
  node_queue["Amazon SQS"]
  node_s3[("Amazon S3")]
  node_redis[("Redis rate limits")]
end

node_user(("Finance user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_accountui
node_app -->|"routes to"| node_budgetui
node_app -->|"routes to"| node_importui
node_app -->|"routes to"| node_summaryui
node_app -->|"routes to"| node_notifyui
node_authui -->|"authenticates via"| node_auth
node_accountui -->|"calls API"| node_accounts
node_accountui -->|"calls API"| node_transactions
node_budgetui -->|"calls API"| node_budgets
node_importui -->|"submits files"| node_imports
node_summaryui -->|"requests summaries"| node_summaries
node_notifyui -->|"requests alerts"| node_notifications
node_auth -->|"reads and writes"| node_db
node_accounts -->|"reads and writes"| node_db
node_transactions -->|"reads and writes"| node_db
node_transactions -->|"writes events"| node_outbox
node_budgets -->|"reads and writes"| node_db
node_imports -->|"stores source files"| node_s3
node_imports -->|"tracks imports"| node_db
node_summaries -->|"queries spending"| node_db
node_notifications -->|"reads notifications"| node_db
node_outbox -->|"publishes events"| node_queue
node_queue -->|"delivers events"| node_worker
node_worker -->|"reads and writes"| node_db
node_worker -->|"categorizes transactions"| node_categorization
node_worker -->|"evaluates spending"| node_budgeteval
node_budgeteval -->|"creates alerts"| node_notifications
node_worker -->|"processes imports"| node_batch
node_batch -->|"reads and writes files"| node_s3
node_batch -->|"checkpoints rows"| node_db
node_auth -.->|"rate limits"| node_redis

click node_app "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/App.tsx"
click node_authui "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/LoginPage.tsx"
click node_accountui "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/AccountsPage.tsx"
click node_budgetui "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/BudgetsPage.tsx"
click node_importui "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/ImportsPage.tsx"
click node_summaryui "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/DashboardPage.tsx"
click node_notifyui "https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/NotificationsPage.tsx"
click node_auth "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java"
click node_accounts "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/account/service/FinancialAccountService.java"
click node_transactions "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java"
click node_budgets "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/budget/service/BudgetService.java"
click node_imports "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/transactionimport/service/TransactionImportSubmissionService.java"
click node_summaries "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/summary/service/SpendingSummaryService.java"
click node_notifications "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/notification/service/NotificationService.java"
click node_outbox "https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/outbox/service/OutboxRelayService.java"
click node_worker "https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/transaction/repository/FinancialTransactionRepository.java"
click node_categorization "https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/category/service/CategorizationService.java"
click node_budgeteval "https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/budget/service/BudgetEvaluationService.java"
click node_batch "https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/transactionimport/batch/service/TransactionImportJobLaunchService.java"

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_app,node_authui,node_accountui,node_budgetui,node_importui,node_summaryui,node_notifyui,node_user toneBlue
class node_auth,node_accounts,node_transactions,node_budgets,node_imports,node_summaries,node_notifications,node_outbox toneAmber
class node_worker,node_categorization,node_budgeteval,node_batch toneMint
class node_db,node_queue,node_s3,node_redis toneRose
```

## Components

### Reference client

- [React application](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Login and registration](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/LoginPage.tsx): `frontend/src/pages/LoginPage.tsx`
- [Accounts and transactions](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/AccountsPage.tsx): `frontend/src/pages/AccountsPage.tsx`
- [Budgets and alerts](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/BudgetsPage.tsx): `frontend/src/pages/BudgetsPage.tsx`
- [CSV imports](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/ImportsPage.tsx): `frontend/src/pages/ImportsPage.tsx`
- [Dashboard and summaries](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/DashboardPage.tsx): `frontend/src/pages/DashboardPage.tsx`
- [Notifications](https://github.com/raghunandan96660/fintrack-application/blob/master/frontend/src/pages/NotificationsPage.tsx): `frontend/src/pages/NotificationsPage.tsx`

### API service

- [Identity and tokens](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java): `services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java`
- [Account management](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/account/service/FinancialAccountService.java): `services/api-service/src/main/java/com/fintrack/apiservice/account/service/FinancialAccountService.java`
- [Transaction management](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java): `services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java`
- [Budget management](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/budget/service/BudgetService.java): `services/api-service/src/main/java/com/fintrack/apiservice/budget/service/BudgetService.java`
- [Import submission](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/transactionimport/service/TransactionImportSubmissionService.java): `services/api-service/src/main/java/com/fintrack/apiservice/transactionimport/service/TransactionImportSubmissionService.java`
- [Spending summaries](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/summary/service/SpendingSummaryService.java): `services/api-service/src/main/java/com/fintrack/apiservice/summary/service/SpendingSummaryService.java`
- [Notification queries](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/notification/service/NotificationService.java): `services/api-service/src/main/java/com/fintrack/apiservice/notification/service/NotificationService.java`
- [Transactional outbox](https://github.com/raghunandan96660/fintrack-application/blob/master/services/api-service/src/main/java/com/fintrack/apiservice/outbox/service/OutboxRelayService.java): `services/api-service/src/main/java/com/fintrack/apiservice/outbox/service/OutboxRelayService.java`

### Async processing

- [Event processing](https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/transaction/repository/FinancialTransactionRepository.java): `services/worker-service/src/main/java/com/fintrack/workerservice/transaction/repository/FinancialTransactionRepository.java`
- [Auto-categorization](https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/category/service/CategorizationService.java): `services/worker-service/src/main/java/com/fintrack/workerservice/category/service/CategorizationService.java`
- [Budget evaluation](https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/budget/service/BudgetEvaluationService.java): `services/worker-service/src/main/java/com/fintrack/workerservice/budget/service/BudgetEvaluationService.java`
- [Restartable CSV batch](https://github.com/raghunandan96660/fintrack-application/blob/master/services/worker-service/src/main/java/com/fintrack/workerservice/transactionimport/batch/service/TransactionImportJobLaunchService.java): `services/worker-service/src/main/java/com/fintrack/workerservice/transactionimport/batch/service/TransactionImportJobLaunchService.java`

### Shared platform

- **PostgreSQL**
- **Amazon SQS**
- **Amazon S3**
- **Redis rate limits**

### Other components

- **Finance user**

## Connections

- Finance user → React application: uses (evidence: `README.md`)
- React application → Login and registration: routes to (evidence: `frontend/src/App.tsx`)
- React application → Accounts and transactions: routes to (evidence: `frontend/src/App.tsx`)
- React application → Budgets and alerts: routes to (evidence: `frontend/src/App.tsx`)
- React application → CSV imports: routes to (evidence: `frontend/src/App.tsx`)
- React application → Dashboard and summaries: routes to (evidence: `frontend/src/App.tsx`)
- React application → Notifications: routes to (evidence: `frontend/src/App.tsx`)
- Login and registration → Identity and tokens: authenticates via (evidence: `README.md`)
- Accounts and transactions → Account management: calls API (evidence: `README.md`)
- Accounts and transactions → Transaction management: calls API (evidence: `README.md`)
- Budgets and alerts → Budget management: calls API (evidence: `README.md`)
- CSV imports → Import submission: submits files (evidence: `README.md`)
- Dashboard and summaries → Spending summaries: requests summaries (evidence: `README.md`)
- Notifications → Notification queries: requests alerts (evidence: `README.md`)
- Identity and tokens → PostgreSQL: reads and writes (evidence: `services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java`)
- Account management → PostgreSQL: reads and writes (evidence: `services/api-service/src/main/java/com/fintrack/apiservice/account/service/FinancialAccountService.java`)
- Transaction management → PostgreSQL: reads and writes (evidence: `services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java`)
- Transaction management → Transactional outbox: writes events (evidence: `services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java`)
- Budget management → PostgreSQL: reads and writes (evidence: `services/api-service/src/main/java/com/fintrack/apiservice/budget/service/BudgetService.java`)
- Import submission → Amazon S3: stores source files (evidence: `README.md`)
- Import submission → PostgreSQL: tracks imports (evidence: `README.md`)
- Spending summaries → PostgreSQL: queries spending (evidence: `services/api-service/src/main/java/com/fintrack/apiservice/summary/service/SpendingSummaryService.java`)
- Notification queries → PostgreSQL: reads notifications (evidence: `README.md`)
- Transactional outbox → Amazon SQS: publishes events (evidence: `README.md`)
- Amazon SQS → Event processing: delivers events (evidence: `README.md`)
- Event processing → PostgreSQL: reads and writes (evidence: `README.md`)
- Event processing → Auto-categorization: categorizes transactions (evidence: `README.md`)
- Event processing → Budget evaluation: evaluates spending (evidence: `README.md`)
- Budget evaluation → Notification queries: creates alerts (evidence: `README.md`)
- Event processing → Restartable CSV batch: processes imports (evidence: `README.md`)
- Restartable CSV batch → Amazon S3: reads and writes files (evidence: `README.md`)
- Restartable CSV batch → PostgreSQL: checkpoints rows (evidence: `README.md`)
- Identity and tokens → Redis rate limits: rate limits (evidence: `README.md`)
