# codinguser/gnucash-android architecture

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

- Interactive diagram: https://gitdiagram.com/codinguser/gnucash-android
- Repository: https://github.com/codinguser/gnucash-android

## Overview

GnuCash Android is a mobile bookkeeping companion: users maintain books, accounts and balanced transactions, then review reports or exchange data with desktop GnuCash. The tree separates presentation, accounting models, SQLite persistence, and import/export and background automation. README-documented capabilities include account hierarchies, split and scheduled transactions, budgets, reports, backups and sync. Some feature branches are represented at their subsystem paths because their implementation details were not sampled; edges are limited to documented flows or relationships visible in the excerpts and source index.

Main entry points: [`app/src/main/java/org/gnucash/android/db/adapter/TransactionsDbAdapter.java`](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/TransactionsDbAdapter.java) (Transaction adapter), [`app/src/main/java/org/gnucash/android/export`](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/export) (Format exporters), [`app/src/main/java/org/gnucash/android/ui/transaction`](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/transaction) (Transaction UI), [`app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java`](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java) (GnuCash XML import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounting["Bookkeeping"]
  node_accounts_ui["Accounts UI"]
  node_transactions_ui["Transaction UI"]
  node_budget_ui["Budget UI"]
  node_account_model["Account model<br/>[Account.java]"]
  node_transaction_model["Transaction model<br/>[Transaction.java]"]
  node_split_model["Split model<br/>[Split.java]"]
  node_scheduled_model["Scheduled actions"]
  node_book_ui["Book manager"]
end

subgraph group_storage["Persistence"]
  node_database[("SQLite books")]
  node_account_adapter["Account adapter"]
  node_transaction_adapter["Transaction adapter"]
  node_book_adapter["Book adapter"]
end

subgraph group_exchange["Data exchange"]
  node_xml_import["GnuCash XML import<br/>[GncXmlHandler.java]"]
  node_export["Format exporters"]
end

subgraph group_services["Reports and automation"]
  node_reports["Reports and charts"]
  node_scheduled_service["Scheduled execution"]
  node_backup["Backup manager<br/>[BackupManager.java]"]
  node_cloud_sync["Cloud sync"]
end

node_user(("Bookkeeper"))
node_desktop(("GnuCash desktop"))

node_user -->|"manage accounts"| node_accounts_ui
node_user -->|"record transactions"| node_transactions_ui
node_user -.->|"manage budgets"| node_budget_ui
node_user -->|"review reports"| node_reports
node_accounts_ui -->|"accesses accounts"| node_account_adapter
node_transactions_ui -->|"accesses transactions"| node_transaction_adapter
node_transactions_ui -->|"creates schedules"| node_scheduled_model
node_transaction_model -->|"contains splits"| node_split_model
node_book_ui -->|"manages books"| node_book_adapter
node_account_adapter -.->|"reads and writes"| node_database
node_transaction_adapter -.->|"reads and writes"| node_database
node_book_adapter -.->|"reads and writes"| node_database
node_desktop -->|"supplies XML data"| node_xml_import
node_xml_import -->|"imports records"| node_account_adapter
node_xml_import -->|"imports records"| node_transaction_adapter
node_user -->|"exports books"| node_export
node_export -->|"produces interchange files"| node_desktop
node_reports -->|"queries transactions"| node_transaction_adapter
node_scheduled_service -->|"records scheduled entries"| node_transaction_adapter
node_scheduled_service -->|"starts scheduled export"| node_export
node_backup -->|"uses XML exporter"| node_export
node_user -.->|"backs up books"| node_backup
node_cloud_sync -.->|"supports cloud backup"| node_backup

click node_accounts_ui "https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/account"
click node_transactions_ui "https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/transaction"
click node_budget_ui "https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/budget"
click node_account_model "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/Account.java"
click node_transaction_model "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/Transaction.java"
click node_split_model "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/Split.java"
click node_scheduled_model "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/ScheduledAction.java"
click node_book_ui "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/ui/settings/BookManagerFragment.java"
click node_database "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/DatabaseHelper.java"
click node_account_adapter "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/AccountsDbAdapter.java"
click node_transaction_adapter "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/TransactionsDbAdapter.java"
click node_book_adapter "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/BooksDbAdapter.java"
click node_xml_import "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java"
click node_export "https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/export"
click node_reports "https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/report"
click node_scheduled_service "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/service/ScheduledActionService.java"
click node_backup "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/util/BackupManager.java"
click node_cloud_sync "https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/ui/settings/dialog/OwnCloudDialogFragment.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_accounts_ui,node_transactions_ui,node_budget_ui,node_account_model,node_transaction_model,node_split_model,node_scheduled_model,node_book_ui toneBlue
class node_database,node_account_adapter,node_transaction_adapter,node_book_adapter toneAmber
class node_xml_import,node_export toneMint
class node_reports,node_scheduled_service,node_backup,node_cloud_sync toneRose
class node_user,node_desktop toneIndigo
```

## Components

### Bookkeeping

- [Accounts UI](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/account): `app/src/main/java/org/gnucash/android/ui/account`
- [Transaction UI](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/transaction): `app/src/main/java/org/gnucash/android/ui/transaction`
- [Budget UI](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/budget): `app/src/main/java/org/gnucash/android/ui/budget`
- [Account model](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/Account.java): `app/src/main/java/org/gnucash/android/model/Account.java`
- [Transaction model](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/Transaction.java): `app/src/main/java/org/gnucash/android/model/Transaction.java`
- [Split model](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/Split.java): `app/src/main/java/org/gnucash/android/model/Split.java`
- [Scheduled actions](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/model/ScheduledAction.java): `app/src/main/java/org/gnucash/android/model/ScheduledAction.java`
- [Book manager](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/ui/settings/BookManagerFragment.java): `app/src/main/java/org/gnucash/android/ui/settings/BookManagerFragment.java`

### Persistence

- [SQLite books](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/DatabaseHelper.java): `app/src/main/java/org/gnucash/android/db/DatabaseHelper.java`
- [Account adapter](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/AccountsDbAdapter.java): `app/src/main/java/org/gnucash/android/db/adapter/AccountsDbAdapter.java`
- [Transaction adapter](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/TransactionsDbAdapter.java): `app/src/main/java/org/gnucash/android/db/adapter/TransactionsDbAdapter.java`
- [Book adapter](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/db/adapter/BooksDbAdapter.java): `app/src/main/java/org/gnucash/android/db/adapter/BooksDbAdapter.java`

### Data exchange

- [GnuCash XML import](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java): `app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java`
- [Format exporters](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/export): `app/src/main/java/org/gnucash/android/export`

### Reports and automation

- [Reports and charts](https://github.com/codinguser/gnucash-android/tree/master/app/src/main/java/org/gnucash/android/ui/report): `app/src/main/java/org/gnucash/android/ui/report`
- [Scheduled execution](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/service/ScheduledActionService.java): `app/src/main/java/org/gnucash/android/service/ScheduledActionService.java`
- [Backup manager](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/util/BackupManager.java): `app/src/main/java/org/gnucash/android/util/BackupManager.java`
- [Cloud sync](https://github.com/codinguser/gnucash-android/blob/master/app/src/main/java/org/gnucash/android/ui/settings/dialog/OwnCloudDialogFragment.java): `app/src/main/java/org/gnucash/android/ui/settings/dialog/OwnCloudDialogFragment.java`

### Other components

- **Bookkeeper**
- **GnuCash desktop**

## Connections

- Bookkeeper → Accounts UI: manage accounts
- Bookkeeper → Transaction UI: record transactions
- Bookkeeper → Budget UI: manage budgets
- Bookkeeper → Reports and charts: review reports
- Accounts UI → Account adapter: accesses accounts (evidence: `app/src/main/java/org/gnucash/android/ui/account/AccountFormFragment.java`)
- Transaction UI → Transaction adapter: accesses transactions (evidence: `app/src/main/java/org/gnucash/android/ui/transaction/TransactionFormFragment.java`)
- Transaction UI → Scheduled actions: creates schedules (evidence: `app/src/main/java/org/gnucash/android/ui/transaction/TransactionFormFragment.java`)
- Transaction model → Split model: contains splits
- Book manager → Book adapter: manages books (evidence: `app/src/main/java/org/gnucash/android/ui/settings/BookManagerFragment.java`)
- Account adapter → SQLite books: reads and writes
- Transaction adapter → SQLite books: reads and writes
- Book adapter → SQLite books: reads and writes (evidence: `app/src/main/java/org/gnucash/android/db/adapter/BooksDbAdapter.java`)
- GnuCash desktop → GnuCash XML import: supplies XML data
- GnuCash XML import → Account adapter: imports records (evidence: `app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java`)
- GnuCash XML import → Transaction adapter: imports records (evidence: `app/src/main/java/org/gnucash/android/importer/GncXmlHandler.java`)
- Bookkeeper → Format exporters: exports books
- Format exporters → GnuCash desktop: produces interchange files
- Reports and charts → Transaction adapter: queries transactions (evidence: `app/src/main/java/org/gnucash/android/ui/report/ReportsActivity.java`)
- Scheduled execution → Transaction adapter: records scheduled entries (evidence: `app/src/main/java/org/gnucash/android/service/ScheduledActionService.java`)
- Scheduled execution → Format exporters: starts scheduled export (evidence: `app/src/main/java/org/gnucash/android/service/ScheduledActionService.java`)
- Backup manager → Format exporters: uses XML exporter (evidence: `app/src/main/java/org/gnucash/android/util/BackupManager.java`)
- Bookkeeper → Backup manager: backs up books
- Cloud sync → Backup manager: supports cloud backup
