# mtotschnig/myexpenses architecture

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

- Interactive diagram: https://gitdiagram.com/mtotschnig/myexpenses
- Repository: https://github.com/mtotschnig/myexpenses

## Overview

MyExpenses is an Android app for recording and analyzing personal income and expenses. Users enter transactions, organize them across accounts and plans, and review balances, reconciliations, and visual summaries. The app also supports import/export, recurring plans, widgets, OCR-assisted entry, and remote synchronization. The tree and README establish these major capabilities, but most implementation excerpts are absent; edges for those documented flows are therefore cited to the README, and the graph avoids guessing internal call chains.

Main entry points: [`myExpenses/src/main/java/org/totschnig/myexpenses/db2/Repository.kt`](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2/Repository.kt) (Data repository), [`ocr/src/main/java/org/totschnig/ocr/OcrHandler.kt`](https://github.com/mtotschnig/myexpenses/blob/master/ocr/src/main/java/org/totschnig/ocr/OcrHandler.kt) (OCR processing), [`myExpenses/src/main/java/org/totschnig/myexpenses/activity`](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity) (App activities), [`myExpenses/src/main/java/org/totschnig/myexpenses/compose/transactions`](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/transactions) (Transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and interface"]
  node_application["Application lifecycle<br/>[MyApplication.kt]"]
  node_activities["App activities"]
  node_compose["Compose UI"]
  node_preferences["User preferences"]
end

subgraph group_finance["Financial records"]
  node_transactions["Transactions"]
  node_accounts["Account management"]
  node_plans["Recurring plans<br/>[RepositoryPlan.kt]"]
  node_budgets["Budgets<br/>[Budget.kt]"]
  node_analysis["Financial analysis<br/>[PieChart.kt]"]
  node_repository["Data repository<br/>[Repository.kt]"]
  node_database[("Financial database")]
end

subgraph group_data["Data exchange"]
  node_importexport["Import and export"]
  node_backup["Backup and restore"]
  node_sync["Sync orchestration"]
  node_syncproviders["Storage providers"]
end

subgraph group_integrations["Platform integrations"]
  node_cloud["Cloud storage"]
  node_ocr["OCR processing<br/>[OcrHandler.kt]"]
  node_mlkit["ML Kit engine<br/>[Engine.kt]"]
  node_tesseract["Tesseract engine<br/>[Engine.kt]"]
  node_widgets["Home-screen widgets"]
  node_banking["Banking sync<br/>[Banking.kt]"]
end

node_user(("App user"))

node_user -->|"uses"| node_activities
node_activities -.->|"presents"| node_compose
node_user -->|"records income"| node_transactions
node_user -->|"manages accounts"| node_accounts
node_user -->|"sets up plans"| node_plans
node_user -.->|"plans finances"| node_budgets
node_user -->|"reviews trends"| node_analysis
node_transactions -.->|"stores records"| node_repository
node_accounts -.->|"manages records"| node_repository
node_plans -.->|"stores plans"| node_repository
node_budgets -.->|"stores budgets"| node_repository
node_analysis -.->|"summarizes records"| node_repository
node_repository -->|"reads and writes"| node_database
node_user -->|"imports or exports"| node_importexport
node_importexport -.->|"transfers records"| node_repository
node_user -.->|"backs up data"| node_backup
node_backup -.->|"stores backup"| node_cloud
node_user -.->|"configures sync"| node_sync
node_sync -->|"selects provider"| node_syncproviders
node_syncproviders -.->|"syncs data"| node_cloud
node_user -.->|"scans receipt"| node_ocr
node_ocr -.->|"uses engine"| node_mlkit
node_ocr -.->|"uses engine"| node_tesseract
node_user -->|"quick access"| node_widgets
node_user -->|"reconciles statements"| node_banking
node_banking -.->|"updates records"| node_repository
node_application -->|"reads settings"| node_preferences

click node_application "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/MyApplication.kt"
click node_activities "https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity"
click node_compose "https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose"
click node_preferences "https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/preference"
click node_transactions "https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/transactions"
click node_accounts "https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/accounts"
click node_plans "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2/RepositoryPlan.kt"
click node_budgets "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/Budget.kt"
click node_analysis "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/PieChart.kt"
click node_repository "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2/Repository.kt"
click node_database "https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2"
click node_importexport "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity/CsvImportActivity.kt"
click node_backup "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity/BackupRestoreActivity.kt"
click node_sync "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/sync/GenericAccountService.kt"
click node_syncproviders "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/sync/SyncBackendProvider.kt"
click node_ocr "https://github.com/mtotschnig/myexpenses/blob/master/ocr/src/main/java/org/totschnig/ocr/OcrHandler.kt"
click node_mlkit "https://github.com/mtotschnig/myexpenses/blob/master/mlkit/src/main/java/org/totschnig/mlkit/Engine.kt"
click node_tesseract "https://github.com/mtotschnig/myexpenses/blob/master/tesseract/src/main/java/org/totschnig/tesseract/Engine.kt"
click node_widgets "https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/widget/AccountWidgetService.kt"
click node_banking "https://github.com/mtotschnig/myexpenses/blob/master/fints/src/main/java/org/totschnig/fints/Banking.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_application,node_activities,node_compose,node_preferences,node_user toneBlue
class node_transactions,node_accounts,node_plans,node_budgets,node_analysis,node_repository,node_database toneAmber
class node_importexport,node_backup,node_sync,node_syncproviders toneMint
class node_cloud,node_ocr,node_mlkit,node_tesseract,node_widgets,node_banking toneRose
```

## Components

### App and interface

- [Application lifecycle](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/MyApplication.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/MyApplication.kt`
- [App activities](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity): `myExpenses/src/main/java/org/totschnig/myexpenses/activity`
- [Compose UI](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose): `myExpenses/src/main/java/org/totschnig/myexpenses/compose`
- [User preferences](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/preference): `myExpenses/src/main/java/org/totschnig/myexpenses/preference`

### Financial records

- [Transactions](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/transactions): `myExpenses/src/main/java/org/totschnig/myexpenses/compose/transactions`
- [Account management](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/accounts): `myExpenses/src/main/java/org/totschnig/myexpenses/compose/accounts`
- [Recurring plans](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2/RepositoryPlan.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/db2/RepositoryPlan.kt`
- [Budgets](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/Budget.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/compose/Budget.kt`
- [Financial analysis](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/compose/PieChart.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/compose/PieChart.kt`
- [Data repository](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2/Repository.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/db2/Repository.kt`
- [Financial database](https://github.com/mtotschnig/myexpenses/tree/master/myExpenses/src/main/java/org/totschnig/myexpenses/db2): `myExpenses/src/main/java/org/totschnig/myexpenses/db2`

### Data exchange

- [Import and export](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity/CsvImportActivity.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/activity/CsvImportActivity.kt`
- [Backup and restore](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/activity/BackupRestoreActivity.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/activity/BackupRestoreActivity.kt`
- [Sync orchestration](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/sync/GenericAccountService.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/sync/GenericAccountService.kt`
- [Storage providers](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/sync/SyncBackendProvider.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/sync/SyncBackendProvider.kt`

### Platform integrations

- **Cloud storage**
- [OCR processing](https://github.com/mtotschnig/myexpenses/blob/master/ocr/src/main/java/org/totschnig/ocr/OcrHandler.kt): `ocr/src/main/java/org/totschnig/ocr/OcrHandler.kt`
- [ML Kit engine](https://github.com/mtotschnig/myexpenses/blob/master/mlkit/src/main/java/org/totschnig/mlkit/Engine.kt): `mlkit/src/main/java/org/totschnig/mlkit/Engine.kt`
- [Tesseract engine](https://github.com/mtotschnig/myexpenses/blob/master/tesseract/src/main/java/org/totschnig/tesseract/Engine.kt): `tesseract/src/main/java/org/totschnig/tesseract/Engine.kt`
- [Home-screen widgets](https://github.com/mtotschnig/myexpenses/blob/master/myExpenses/src/main/java/org/totschnig/myexpenses/widget/AccountWidgetService.kt): `myExpenses/src/main/java/org/totschnig/myexpenses/widget/AccountWidgetService.kt`
- [Banking sync](https://github.com/mtotschnig/myexpenses/blob/master/fints/src/main/java/org/totschnig/fints/Banking.kt): `fints/src/main/java/org/totschnig/fints/Banking.kt`

### Other components

- **App user**

## Connections

- App user → App activities: uses (evidence: `README.md`)
- App activities → Compose UI: presents (evidence: `myExpenses/src/main/java/org/totschnig/myexpenses/activity/BaseActivity.kt`)
- App user → Transactions: records income (evidence: `README.md`)
- App user → Account management: manages accounts (evidence: `README.md`)
- App user → Recurring plans: sets up plans (evidence: `README.md`)
- App user → Budgets: plans finances
- App user → Financial analysis: reviews trends (evidence: `README.md`)
- Transactions → Data repository: stores records
- Account management → Data repository: manages records
- Recurring plans → Data repository: stores plans
- Budgets → Data repository: stores budgets
- Financial analysis → Data repository: summarizes records
- Data repository → Financial database: reads and writes (evidence: `myExpenses/src/main/java/org/totschnig/myexpenses/db2/Repository.kt`)
- App user → Import and export: imports or exports (evidence: `README.md`)
- Import and export → Data repository: transfers records
- App user → Backup and restore: backs up data
- Backup and restore → Cloud storage: stores backup
- App user → Sync orchestration: configures sync
- Sync orchestration → Storage providers: selects provider (evidence: `myExpenses/src/main/java/org/totschnig/myexpenses/sync/GenericAccountService.kt`)
- Storage providers → Cloud storage: syncs data
- App user → OCR processing: scans receipt
- OCR processing → ML Kit engine: uses engine
- OCR processing → Tesseract engine: uses engine
- App user → Home-screen widgets: quick access (evidence: `README.md`)
- App user → Banking sync: reconciles statements (evidence: `README.md`)
- Banking sync → Data repository: updates records
- Application lifecycle → User preferences: reads settings (evidence: `myExpenses/src/main/java/org/totschnig/myexpenses/preference/PrefKey.kt`)
