# zaiburcrime/ledgerledger architecture

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

- Interactive diagram: https://gitdiagram.com/zaiburcrime/ledgerledger
- Repository: https://github.com/zaiburcrime/ledgerledger

## Overview

LEDGER is a desktop personal-finance tracker: users sign in, then manage expenses, allowances, budgets, income, and savings goals and review monthly totals and reports. The tree contains two parallel editions, so both are represented. Source excerpts show account-file handling and the totals calculation, but do not expose enough wiring to trace the full window-to-data workflow; unsupported links are omitted.

Main entry points: [`LEDGER/src/LoginDialog.java`](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/LoginDialog.java) (Sign-in dialog), [`LEDGER_ARRANGED/src/LoginDialog.java`](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/LoginDialog.java) (Sign-in dialog (arranged)), [`LEDGER/src/LedgerData.java`](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/LedgerData.java) (Ledger data), [`LEDGER_ARRANGED/src/LedgerData.java`](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/LedgerData.java) (Ledger data (arranged))

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts"]
  node_login["Sign-in dialog<br/>[LoginDialog.java]"]
  node_arranged_login["Sign-in dialog &#40;arranged&#41;<br/>[LoginDialog.java]"]
  node_account_file[("Account file")]
end

subgraph group_app["Ledger application"]
  node_tracker["Tracker window"]
  node_arranged_tracker["Tracker window &#40;arranged&#41;"]
end

subgraph group_data["Finance data"]
  node_ledger_data["Ledger data<br/>[LedgerData.java]"]
  node_arranged_data["Ledger data &#40;arranged&#41;<br/>[LedgerData.java]"]
  node_expense["Expense records<br/>[Expense.java]"]
  node_arranged_expense["Expense records &#40;arranged&#41;<br/>[Expense.java]"]
  node_goal["Savings goals<br/>[Goal.java]"]
  node_money_entry["Money entries<br/>[MoneyEntry.java]"]
end

subgraph group_insights["Totals and reports"]
  node_totals["Dashboard totals"]
  node_arranged_totals["Dashboard totals &#40;arranged&#41;"]
  node_report_bar["Report bars<br/>[ReportBar.java]"]
  node_slice["Report slices<br/>[Slice.java]"]
end

node_actor(("Ledger user"))

node_actor -->|"signs in"| node_login
node_actor -->|"signs in"| node_arranged_login
node_login -->|"loads and saves"| node_account_file
node_arranged_login -->|"loads and saves"| node_account_file
node_ledger_data -->|"creates totals"| node_totals
node_totals -->|"reads figures"| node_ledger_data
node_arranged_data -->|"creates totals"| node_arranged_totals
node_arranged_totals -->|"reads figures"| node_arranged_data

click node_login "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/LoginDialog.java"
click node_arranged_login "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/LoginDialog.java"
click node_tracker "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/FinancialTracker.java"
click node_arranged_tracker "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/FinancialTracker.java"
click node_ledger_data "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/LedgerData.java"
click node_arranged_data "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/LedgerData.java"
click node_expense "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/Expense.java"
click node_arranged_expense "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/Expense.java"
click node_goal "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/Goal.java"
click node_money_entry "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/MoneyEntry.java"
click node_totals "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/DashboardTotals.java"
click node_arranged_totals "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/DashboardTotals.java"
click node_report_bar "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/ReportBar.java"
click node_slice "https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/Slice.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_login,node_arranged_login,node_account_file,node_actor toneBlue
class node_tracker,node_arranged_tracker toneAmber
class node_ledger_data,node_arranged_data,node_expense,node_arranged_expense,node_goal,node_money_entry toneMint
class node_totals,node_arranged_totals,node_report_bar,node_slice toneRose
```

## Components

### Accounts

- [Sign-in dialog](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/LoginDialog.java): `LEDGER/src/LoginDialog.java`
- [Sign-in dialog (arranged)](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/LoginDialog.java): `LEDGER_ARRANGED/src/LoginDialog.java`
- **Account file**

### Ledger application

- [Tracker window](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/FinancialTracker.java): `LEDGER/src/FinancialTracker.java`
- [Tracker window (arranged)](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/FinancialTracker.java): `LEDGER_ARRANGED/src/FinancialTracker.java`

### Finance data

- [Ledger data](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/LedgerData.java): `LEDGER/src/LedgerData.java`
- [Ledger data (arranged)](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/LedgerData.java): `LEDGER_ARRANGED/src/LedgerData.java`
- [Expense records](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/Expense.java): `LEDGER/src/Expense.java`
- [Expense records (arranged)](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/Expense.java): `LEDGER_ARRANGED/src/Expense.java`
- [Savings goals](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/Goal.java): `LEDGER/src/Goal.java`
- [Money entries](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/MoneyEntry.java): `LEDGER/src/MoneyEntry.java`

### Totals and reports

- [Dashboard totals](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/DashboardTotals.java): `LEDGER/src/DashboardTotals.java`
- [Dashboard totals (arranged)](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER_ARRANGED/src/DashboardTotals.java): `LEDGER_ARRANGED/src/DashboardTotals.java`
- [Report bars](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/ReportBar.java): `LEDGER/src/ReportBar.java`
- [Report slices](https://github.com/zaiburcrime/ledgerledger/blob/main/LEDGER/src/Slice.java): `LEDGER/src/Slice.java`

### Other components

- **Ledger user**

## Connections

- Ledger user → Sign-in dialog: signs in (evidence: `LEDGER/src/LoginDialog.java`)
- Ledger user → Sign-in dialog (arranged): signs in (evidence: `LEDGER_ARRANGED/src/LoginDialog.java`)
- Sign-in dialog → Account file: loads and saves (evidence: `LEDGER/src/LoginDialog.java`)
- Sign-in dialog (arranged) → Account file: loads and saves (evidence: `LEDGER_ARRANGED/src/LoginDialog.java`)
- Ledger data → Dashboard totals: creates totals (evidence: `LEDGER/src/LedgerData.java`)
- Dashboard totals → Ledger data: reads figures (evidence: `LEDGER/src/DashboardTotals.java`)
- Ledger data (arranged) → Dashboard totals (arranged): creates totals (evidence: `LEDGER_ARRANGED/src/LedgerData.java`)
- Dashboard totals (arranged) → Ledger data (arranged): reads figures (evidence: `LEDGER_ARRANGED/src/DashboardTotals.java`)
