# rupeshrn/aivarsel architecture

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

- Interactive diagram: https://gitdiagram.com/rupeshrn/aivarsel
- Repository: https://github.com/rupeshrn/aivarsel

## Overview

VarSel is an offline Android expense tracker. The principal workflow is importing a bank statement: the app detects its bank and format, parses transactions, reconciles totals, applies learned categorization, and presents results for review and local tracking. Other major capabilities include manual transaction entry, budgets, recurring items, loans, financial-event tracking, and analytics. The graph reflects README claims and shown parser/storage references; UI-to-domain wiring and several feature implementations were not sampled, so those relationships are left out or marked unverified.

Main entry points: [`app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt`](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt) (Import Orchestrator), [`app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt`](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt) (Transaction Ledger), [`app/src/main/java/com/varsel/expensetracker/ui/import_statement/ImportScreen.kt`](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/import_statement/ImportScreen.kt) (Statement Import), [`app/src/main/java/com/varsel/expensetracker/parser`](https://github.com/rupeshrn/aivarsel/tree/main/app/src/main/java/com/varsel/expensetracker/parser) (Bank Detection & Parsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Statement Import"]
  node_import_ui["Statement Import<br/>[ImportScreen.kt]"]
  node_parser_flow["Import Orchestrator"]
  node_bank_parse["Bank Detection &amp; Parsing"]
  node_ocr["OCR Processing<br/>[OcrManager.kt]"]
  node_reconcile["Balance Reconciliation"]
  node_snapshots["Import Snapshots"]
end

subgraph group_ledger["Transactions &amp; Rules"]
  node_transactions["Transaction Ledger"]
  node_transaction_model["Transaction Model<br/>[Transaction.kt]"]
  node_categorization["Category Rules"]
  node_learning["Learned Categories"]
  node_manual_entry["Manual Entry"]
end

subgraph group_finance["Financial Planning"]
  node_budgets["Budgets"]
  node_recurring["Recurring Items"]
  node_loans["Loans &amp; Amortization"]
  node_financial_events["Financial Events"]
end

subgraph group_insights["Analytics &amp; Review"]
  node_dashboard["Dashboard<br/>[DashboardScreen.kt]"]
  node_reports["Reports &amp; Analytics<br/>[ReportsScreen.kt]"]
end

subgraph group_platform["Local Platform"]
  node_database[("Room Database<br/>[AppDatabase.kt]")]
  node_security["Device Security"]
end

node_user(("User"))

node_user -->|"uploads statement"| node_import_ui
node_import_ui -.->|"starts import"| node_parser_flow
node_parser_flow -->|"detects and parses"| node_bank_parse
node_parser_flow -->|"checks balances"| node_reconcile
node_parser_flow -->|"applies learned rules"| node_learning
node_bank_parse -.->|"extracts scanned text"| node_ocr
node_parser_flow -.->|"records import history"| node_snapshots
node_parser_flow -.->|"saves reviewed entries"| node_transactions
node_transactions -.->|"maps records"| node_transaction_model
node_user -.->|"adds transaction"| node_manual_entry
node_manual_entry -.->|"stores entry"| node_transactions
node_user -->|"sets categories"| node_categorization
node_learning -->|"provides learned matches"| node_categorization
node_user -->|"sets spending limits"| node_budgets
node_user -->|"tracks obligations"| node_recurring
node_user -->|"manages loan accounts"| node_loans
node_user -.->|"tracks linked events"| node_financial_events
node_transactions -.->|"summarizes activity"| node_dashboard
node_transactions -->|"feeds analytics"| node_reports
node_transactions -->|"persists locally"| node_database
node_snapshots -.->|"stores audit history"| node_database
node_user -.->|"unlocks app"| node_security

click node_import_ui "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/import_statement/ImportScreen.kt"
click node_parser_flow "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt"
click node_bank_parse "https://github.com/rupeshrn/aivarsel/tree/main/app/src/main/java/com/varsel/expensetracker/parser"
click node_ocr "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/util/OcrManager.kt"
click node_reconcile "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/parser/ReconciliationEngine.kt"
click node_snapshots "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/repository/StatementSnapshotRepositoryImpl.kt"
click node_transactions "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt"
click node_transaction_model "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/model/Transaction.kt"
click node_categorization "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/category/CategoryRuleEngine.kt"
click node_learning "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/category/CustomRuleEngine.kt"
click node_manual_entry "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/usecase/AddManualTransactionUseCase.kt"
click node_budgets "https://github.com/rupeshrn/aivarsel/tree/main/app/src/main/java/com/varsel/expensetracker/ui/budget"
click node_recurring "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/engine/RecurringMatcherEngine.kt"
click node_loans "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/engine/LoanAmortizationEngine.kt"
click node_financial_events "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/usecase/CreateFinancialEventAllocationUseCase.kt"
click node_dashboard "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/dashboard/DashboardScreen.kt"
click node_reports "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/reports/ReportsScreen.kt"
click node_database "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/local/AppDatabase.kt"
click node_security "https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/security/BiometricAuthManager.kt"

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_import_ui,node_parser_flow,node_bank_parse,node_ocr,node_reconcile,node_snapshots,node_user toneBlue
class node_transactions,node_transaction_model,node_categorization,node_learning,node_manual_entry toneAmber
class node_budgets,node_recurring,node_loans,node_financial_events toneMint
class node_dashboard,node_reports toneRose
class node_database,node_security toneIndigo
```

## Components

### Statement Import

- [Statement Import](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/import_statement/ImportScreen.kt): `app/src/main/java/com/varsel/expensetracker/ui/import_statement/ImportScreen.kt`
- [Import Orchestrator](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt): `app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt`
- [Bank Detection & Parsing](https://github.com/rupeshrn/aivarsel/tree/main/app/src/main/java/com/varsel/expensetracker/parser): `app/src/main/java/com/varsel/expensetracker/parser`
- [OCR Processing](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/util/OcrManager.kt): `app/src/main/java/com/varsel/expensetracker/util/OcrManager.kt`
- [Balance Reconciliation](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/parser/ReconciliationEngine.kt): `app/src/main/java/com/varsel/expensetracker/parser/ReconciliationEngine.kt`
- [Import Snapshots](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/repository/StatementSnapshotRepositoryImpl.kt): `app/src/main/java/com/varsel/expensetracker/data/repository/StatementSnapshotRepositoryImpl.kt`

### Transactions & Rules

- [Transaction Ledger](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt): `app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt`
- [Transaction Model](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/model/Transaction.kt): `app/src/main/java/com/varsel/expensetracker/domain/model/Transaction.kt`
- [Category Rules](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/category/CategoryRuleEngine.kt): `app/src/main/java/com/varsel/expensetracker/category/CategoryRuleEngine.kt`
- [Learned Categories](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/category/CustomRuleEngine.kt): `app/src/main/java/com/varsel/expensetracker/category/CustomRuleEngine.kt`
- [Manual Entry](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/usecase/AddManualTransactionUseCase.kt): `app/src/main/java/com/varsel/expensetracker/domain/usecase/AddManualTransactionUseCase.kt`

### Financial Planning

- [Budgets](https://github.com/rupeshrn/aivarsel/tree/main/app/src/main/java/com/varsel/expensetracker/ui/budget): `app/src/main/java/com/varsel/expensetracker/ui/budget`
- [Recurring Items](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/engine/RecurringMatcherEngine.kt): `app/src/main/java/com/varsel/expensetracker/domain/engine/RecurringMatcherEngine.kt`
- [Loans & Amortization](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/engine/LoanAmortizationEngine.kt): `app/src/main/java/com/varsel/expensetracker/domain/engine/LoanAmortizationEngine.kt`
- [Financial Events](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/domain/usecase/CreateFinancialEventAllocationUseCase.kt): `app/src/main/java/com/varsel/expensetracker/domain/usecase/CreateFinancialEventAllocationUseCase.kt`

### Analytics & Review

- [Dashboard](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/dashboard/DashboardScreen.kt): `app/src/main/java/com/varsel/expensetracker/ui/dashboard/DashboardScreen.kt`
- [Reports & Analytics](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/ui/reports/ReportsScreen.kt): `app/src/main/java/com/varsel/expensetracker/ui/reports/ReportsScreen.kt`

### Local Platform

- [Room Database](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/data/local/AppDatabase.kt): `app/src/main/java/com/varsel/expensetracker/data/local/AppDatabase.kt`
- [Device Security](https://github.com/rupeshrn/aivarsel/blob/main/app/src/main/java/com/varsel/expensetracker/security/BiometricAuthManager.kt): `app/src/main/java/com/varsel/expensetracker/security/BiometricAuthManager.kt`

### Other components

- **User**

## Connections

- User → Statement Import: uploads statement (evidence: `README.md`)
- Statement Import → Import Orchestrator: starts import
- Import Orchestrator → Bank Detection & Parsing: detects and parses (evidence: `app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt`)
- Import Orchestrator → Balance Reconciliation: checks balances (evidence: `app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt`)
- Import Orchestrator → Learned Categories: applies learned rules (evidence: `app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt`)
- Bank Detection & Parsing → OCR Processing: extracts scanned text
- Import Orchestrator → Import Snapshots: records import history
- Import Orchestrator → Transaction Ledger: saves reviewed entries
- Transaction Ledger → Transaction Model: maps records (evidence: `app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt`)
- User → Manual Entry: adds transaction
- Manual Entry → Transaction Ledger: stores entry
- User → Category Rules: sets categories (evidence: `README.md`)
- Learned Categories → Category Rules: provides learned matches (evidence: `app/src/main/java/com/varsel/expensetracker/category/CategoryRuleEngine.kt`)
- User → Budgets: sets spending limits (evidence: `README.md`)
- User → Recurring Items: tracks obligations (evidence: `README.md`)
- User → Loans & Amortization: manages loan accounts (evidence: `README.md`)
- User → Financial Events: tracks linked events
- Transaction Ledger → Dashboard: summarizes activity
- Transaction Ledger → Reports & Analytics: feeds analytics (evidence: `README.md`)
- Transaction Ledger → Room Database: persists locally (evidence: `README.md`)
- Import Snapshots → Room Database: stores audit history
- User → Device Security: unlocks app
