How rupeshrn/aivarsel works
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: StatementParserEngine.kt Import Orchestrator · TransactionRepositoryImpl.kt Transaction Ledger · ImportScreen.kt Statement Import · parser Bank Detection & Parsing
Components 20
Statement Import
- Statement Import
app/src/main/java/com/varsel/expensetracker/ui/import_statement/ImportScreen.kt - Import Orchestrator
app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt - Bank Detection & Parsing
app/src/main/java/com/varsel/expensetracker/parser - OCR Processing
app/src/main/java/com/varsel/expensetracker/util/OcrManager.kt - Balance Reconciliation
app/src/main/java/com/varsel/expensetracker/parser/ReconciliationEngine.kt - Import Snapshots
app/src/main/java/com/varsel/expensetracker/data/repository/StatementSnapshotRepositoryImpl.kt
Transactions & Rules
- Transaction Ledger
app/src/main/java/com/varsel/expensetracker/data/repository/TransactionRepositoryImpl.kt - Transaction Model
app/src/main/java/com/varsel/expensetracker/domain/model/Transaction.kt - Category Rules
app/src/main/java/com/varsel/expensetracker/category/CategoryRuleEngine.kt - Learned Categories
app/src/main/java/com/varsel/expensetracker/category/CustomRuleEngine.kt - Manual Entry
app/src/main/java/com/varsel/expensetracker/domain/usecase/AddManualTransactionUseCase.kt
Financial Planning
- Budgets
app/src/main/java/com/varsel/expensetracker/ui/budget - Recurring Items
app/src/main/java/com/varsel/expensetracker/domain/engine/RecurringMatcherEngine.kt - Loans & Amortization
app/src/main/java/com/varsel/expensetracker/domain/engine/LoanAmortizationEngine.kt - Financial Events
app/src/main/java/com/varsel/expensetracker/domain/usecase/CreateFinancialEventAllocationUseCase.kt
Analytics & Review
- Dashboard
app/src/main/java/com/varsel/expensetracker/ui/dashboard/DashboardScreen.kt - Reports & Analytics
app/src/main/java/com/varsel/expensetracker/ui/reports/ReportsScreen.kt
Local Platform
- Room Database
app/src/main/java/com/varsel/expensetracker/data/local/AppDatabase.kt - Device Security
app/src/main/java/com/varsel/expensetracker/security/BiometricAuthManager.kt
Other components
- User
Connections 22
- User → Statement Import: uploads statement
README.md - Statement Import → Import Orchestrator: starts import
- Import Orchestrator → Bank Detection & Parsing: detects and parses
app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt - Import Orchestrator → Balance Reconciliation: checks balances
app/src/main/java/com/varsel/expensetracker/util/StatementParserEngine.kt - Import Orchestrator → Learned Categories: applies learned rules
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
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
README.md - Learned Categories → Category Rules: provides learned matches
app/src/main/java/com/varsel/expensetracker/category/CategoryRuleEngine.kt - User → Budgets: sets spending limits
README.md - User → Recurring Items: tracks obligations
README.md - User → Loans & Amortization: manages loan accounts
README.md - User → Financial Events: tracks linked events
- Transaction Ledger → Dashboard: summarizes activity
- Transaction Ledger → Reports & Analytics: feeds analytics
README.md - Transaction Ledger → Room Database: persists locally
README.md - Import Snapshots → Room Database: stores audit history
- User → Device Security: unlocks app