How raghunandan96660/fintrack-application works
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: App.tsx React application · FinancialTransactionRepository.java Event processing · AccountsPage.tsx Accounts and transactions · AuthService.java Identity and tokens
Components 24
Reference client
- React application
frontend/src/App.tsx - Login and registration
frontend/src/pages/LoginPage.tsx - Accounts and transactions
frontend/src/pages/AccountsPage.tsx - Budgets and alerts
frontend/src/pages/BudgetsPage.tsx - CSV imports
frontend/src/pages/ImportsPage.tsx - Dashboard and summaries
frontend/src/pages/DashboardPage.tsx - Notifications
frontend/src/pages/NotificationsPage.tsx
API service
- Identity and tokens
services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java - Account management
services/api-service/src/main/java/com/fintrack/apiservice/account/service/FinancialAccountService.java - Transaction management
services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java - Budget management
services/api-service/src/main/java/com/fintrack/apiservice/budget/service/BudgetService.java - Import submission
services/api-service/src/main/java/com/fintrack/apiservice/transactionimport/service/TransactionImportSubmissionService.java - Spending summaries
services/api-service/src/main/java/com/fintrack/apiservice/summary/service/SpendingSummaryService.java - Notification queries
services/api-service/src/main/java/com/fintrack/apiservice/notification/service/NotificationService.java - Transactional outbox
services/api-service/src/main/java/com/fintrack/apiservice/outbox/service/OutboxRelayService.java
Async processing
- Event processing
services/worker-service/src/main/java/com/fintrack/workerservice/transaction/repository/FinancialTransactionRepository.java - Auto-categorization
services/worker-service/src/main/java/com/fintrack/workerservice/category/service/CategorizationService.java - Budget evaluation
services/worker-service/src/main/java/com/fintrack/workerservice/budget/service/BudgetEvaluationService.java - Restartable CSV batch
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 33
- Finance user → React application: uses
README.md - React application → Login and registration: routes to
frontend/src/App.tsx - React application → Accounts and transactions: routes to
frontend/src/App.tsx - React application → Budgets and alerts: routes to
frontend/src/App.tsx - React application → CSV imports: routes to
frontend/src/App.tsx - React application → Dashboard and summaries: routes to
frontend/src/App.tsx - React application → Notifications: routes to
frontend/src/App.tsx - Login and registration → Identity and tokens: authenticates via
README.md - Accounts and transactions → Account management: calls API
README.md - Accounts and transactions → Transaction management: calls API
README.md - Budgets and alerts → Budget management: calls API
README.md - CSV imports → Import submission: submits files
README.md - Dashboard and summaries → Spending summaries: requests summaries
README.md - Notifications → Notification queries: requests alerts
README.md - Identity and tokens → PostgreSQL: reads and writes
services/api-service/src/main/java/com/fintrack/apiservice/auth/service/AuthService.java - Account management → PostgreSQL: reads and writes
services/api-service/src/main/java/com/fintrack/apiservice/account/service/FinancialAccountService.java - Transaction management → PostgreSQL: reads and writes
services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java - Transaction management → Transactional outbox: writes events
services/api-service/src/main/java/com/fintrack/apiservice/transaction/service/FinancialTransactionService.java - Budget management → PostgreSQL: reads and writes
services/api-service/src/main/java/com/fintrack/apiservice/budget/service/BudgetService.java - Import submission → Amazon S3: stores source files
README.md - Import submission → PostgreSQL: tracks imports
README.md - Spending summaries → PostgreSQL: queries spending
services/api-service/src/main/java/com/fintrack/apiservice/summary/service/SpendingSummaryService.java - Notification queries → PostgreSQL: reads notifications
README.md - Transactional outbox → Amazon SQS: publishes events
README.md - Amazon SQS → Event processing: delivers events
README.md - Event processing → PostgreSQL: reads and writes
README.md - Event processing → Auto-categorization: categorizes transactions
README.md - Event processing → Budget evaluation: evaluates spending
README.md - Budget evaluation → Notification queries: creates alerts
README.md - Event processing → Restartable CSV batch: processes imports
README.md - Restartable CSV batch → Amazon S3: reads and writes files
README.md - Restartable CSV batch → PostgreSQL: checkpoints rows
README.md - Identity and tokens → Redis rate limits: rate limits
README.md