# hohrandrey/finlytics architecture

> Architecture diagram of the GitHub repository hohrandrey/finlytics, 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/hohrandrey/finlytics
- Repository: https://github.com/hohrandrey/finlytics

## Overview

Finlytics is an offline desktop personal-finance tracker. The user enters or edits income and expense operations, organizes them with categories, and reviews filtered history and financial summaries. The runtime flow runs from the desktop entry point through Compose navigation and screens, via a stateful view model and repository, to SQLite persistence. The README also documents filtering, category management, charts, and statistics. Edges reflect shown calls or README-described capabilities; unsampled relationships are omitted rather than inferred.

Main entry points: [`src/main/kotlin/viewmodel/FinanceViewModel.kt`](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/viewmodel/FinanceViewModel.kt) (Finance state logic), [`src/main/kotlin/Main.kt`](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/Main.kt) (Desktop entry), [`src/main/kotlin/ui/AppNavigation.kt`](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/AppNavigation.kt) (Screen navigation), [`src/main/kotlin/ui/screens/OverviewScreen.kt`](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/OverviewScreen.kt) (Overview analytics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop application"]
  node_entry["Desktop entry<br/>[Main.kt]"]
  node_appui["App shell<br/>[App.kt]"]
  node_navigation["Screen navigation<br/>[AppNavigation.kt]"]
end

subgraph group_experience["Finance experience"]
  node_overview["Overview analytics<br/>[OverviewScreen.kt]"]
  node_history["Operation history<br/>[HistoryScreen.kt]"]
  node_settings["Category settings<br/>[SettingsScreen.kt]"]
  node_operationdialog["Operation editor<br/>[OperationDialog.kt]"]
  node_categorydialog["Category editor"]
  node_navigationbar["Navigation bar<br/>[NavigationBar.kt]"]
  node_piechart["Pie chart<br/>[PieChart.kt]"]
  node_progress["Comparison progress"]
end

subgraph group_logic["State and domain"]
  node_viewmodel["Finance state logic"]
  node_state["Finance state<br/>[FinanceState.kt]"]
  node_operation["Operation model<br/>[Operation.kt]"]
  node_repository["Finance repository"]
end

subgraph group_storage["SQLite persistence"]
  node_databaseinit["Database initialization"]
  node_dbconfig["SQLite configuration<br/>[DatabaseConfig.kt]"]
  node_categories["Category requests"]
  node_transactions["Transaction requests"]
  node_sqlite[("SQLite database")]
end

node_user(("Desktop user"))

node_user -->|"launches"| node_entry
node_entry -->|"renders"| node_appui
node_entry -->|"creates"| node_viewmodel
node_entry -->|"shows"| node_operationdialog
node_entry -->|"shows"| node_categorydialog
node_appui -->|"renders"| node_navigation
node_navigation -->|"routes"| node_overview
node_navigation -->|"routes"| node_history
node_navigation -->|"routes"| node_settings
node_navigation -->|"uses state"| node_viewmodel
node_overview -->|"reads state"| node_viewmodel
node_history -->|"reads state"| node_viewmodel
node_settings -->|"manages categories"| node_viewmodel
node_operationdialog -->|"submits edits"| node_viewmodel
node_categorydialog -->|"submits category"| node_viewmodel
node_history -->|"renders"| node_navigationbar
node_overview -->|"renders"| node_navigationbar
node_settings -->|"renders"| node_navigationbar
node_overview -->|"renders"| node_piechart
node_overview -->|"renders"| node_progress
node_viewmodel -->|"updates"| node_state
node_viewmodel -->|"loads and saves"| node_repository
node_repository -->|"uses model"| node_operation
node_repository -->|"initializes"| node_databaseinit
node_repository -->|"requests operations"| node_transactions
node_repository -->|"requests categories"| node_categories
node_databaseinit -->|"configures"| node_dbconfig
node_databaseinit -->|"seeds defaults"| node_categories
node_transactions -.->|"reads and writes"| node_sqlite
node_categories -.->|"reads and writes"| node_sqlite
node_dbconfig -.->|"selects file"| node_sqlite

click node_entry "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/Main.kt"
click node_appui "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/App.kt"
click node_navigation "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/AppNavigation.kt"
click node_overview "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/OverviewScreen.kt"
click node_history "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/HistoryScreen.kt"
click node_settings "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/SettingsScreen.kt"
click node_operationdialog "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/OperationDialog.kt"
click node_categorydialog "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/AddCategoryDialog.kt"
click node_navigationbar "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/NavigationBar.kt"
click node_piechart "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/PieChart.kt"
click node_progress "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/GhostRaceProgressBar.kt"
click node_viewmodel "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/viewmodel/FinanceViewModel.kt"
click node_state "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/viewmodel/FinanceState.kt"
click node_operation "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/models/Operation.kt"
click node_repository "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/repository/FinanceRepository.kt"
click node_databaseinit "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/db/database_request/DatabaseInitializer.kt"
click node_dbconfig "https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/db/database_request/DatabaseConfig.kt"
click node_categories "https://github.com/hohrandrey/finlytics/tree/main/src/main/kotlin/db/database_request"
click node_transactions "https://github.com/hohrandrey/finlytics/tree/main/src/main/kotlin/db/database_request"

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_entry,node_appui,node_navigation,node_user toneBlue
class node_overview,node_history,node_settings,node_operationdialog,node_categorydialog,node_navigationbar,node_piechart,node_progress toneAmber
class node_viewmodel,node_state,node_operation,node_repository toneMint
class node_databaseinit,node_dbconfig,node_categories,node_transactions,node_sqlite toneRose
```

## Components

### Desktop application

- [Desktop entry](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/Main.kt): `src/main/kotlin/Main.kt`
- [App shell](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/App.kt): `src/main/kotlin/ui/App.kt`
- [Screen navigation](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/AppNavigation.kt): `src/main/kotlin/ui/AppNavigation.kt`

### Finance experience

- [Overview analytics](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/OverviewScreen.kt): `src/main/kotlin/ui/screens/OverviewScreen.kt`
- [Operation history](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/HistoryScreen.kt): `src/main/kotlin/ui/screens/HistoryScreen.kt`
- [Category settings](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/screens/SettingsScreen.kt): `src/main/kotlin/ui/screens/SettingsScreen.kt`
- [Operation editor](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/OperationDialog.kt): `src/main/kotlin/ui/components/OperationDialog.kt`
- [Category editor](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/AddCategoryDialog.kt): `src/main/kotlin/ui/components/AddCategoryDialog.kt`
- [Navigation bar](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/NavigationBar.kt): `src/main/kotlin/ui/components/NavigationBar.kt`
- [Pie chart](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/PieChart.kt): `src/main/kotlin/ui/components/PieChart.kt`
- [Comparison progress](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/ui/components/GhostRaceProgressBar.kt): `src/main/kotlin/ui/components/GhostRaceProgressBar.kt`

### State and domain

- [Finance state logic](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/viewmodel/FinanceViewModel.kt): `src/main/kotlin/viewmodel/FinanceViewModel.kt`
- [Finance state](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/viewmodel/FinanceState.kt): `src/main/kotlin/viewmodel/FinanceState.kt`
- [Operation model](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/models/Operation.kt): `src/main/kotlin/models/Operation.kt`
- [Finance repository](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/repository/FinanceRepository.kt): `src/main/kotlin/repository/FinanceRepository.kt`

### SQLite persistence

- [Database initialization](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/db/database_request/DatabaseInitializer.kt): `src/main/kotlin/db/database_request/DatabaseInitializer.kt`
- [SQLite configuration](https://github.com/hohrandrey/finlytics/blob/main/src/main/kotlin/db/database_request/DatabaseConfig.kt): `src/main/kotlin/db/database_request/DatabaseConfig.kt`
- [Category requests](https://github.com/hohrandrey/finlytics/tree/main/src/main/kotlin/db/database_request): `src/main/kotlin/db/database_request`
- [Transaction requests](https://github.com/hohrandrey/finlytics/tree/main/src/main/kotlin/db/database_request): `src/main/kotlin/db/database_request`
- **SQLite database**

### Other components

- **Desktop user**

## Connections

- Desktop user → Desktop entry: launches (evidence: `src/main/kotlin/Main.kt`)
- Desktop entry → App shell: renders (evidence: `src/main/kotlin/Main.kt`)
- Desktop entry → Finance state logic: creates (evidence: `src/main/kotlin/Main.kt`)
- Desktop entry → Operation editor: shows (evidence: `src/main/kotlin/Main.kt`)
- Desktop entry → Category editor: shows (evidence: `src/main/kotlin/Main.kt`)
- App shell → Screen navigation: renders (evidence: `src/main/kotlin/ui/App.kt`)
- Screen navigation → Overview analytics: routes (evidence: `src/main/kotlin/ui/AppNavigation.kt`)
- Screen navigation → Operation history: routes (evidence: `src/main/kotlin/ui/AppNavigation.kt`)
- Screen navigation → Category settings: routes (evidence: `src/main/kotlin/ui/AppNavigation.kt`)
- Screen navigation → Finance state logic: uses state (evidence: `src/main/kotlin/ui/AppNavigation.kt`)
- Overview analytics → Finance state logic: reads state (evidence: `src/main/kotlin/ui/screens/OverviewScreen.kt`)
- Operation history → Finance state logic: reads state (evidence: `src/main/kotlin/ui/screens/HistoryScreen.kt`)
- Category settings → Finance state logic: manages categories (evidence: `src/main/kotlin/ui/screens/SettingsScreen.kt`)
- Operation editor → Finance state logic: submits edits (evidence: `src/main/kotlin/ui/components/OperationDialog.kt`)
- Category editor → Finance state logic: submits category (evidence: `src/main/kotlin/ui/components/AddCategoryDialog.kt`)
- Operation history → Navigation bar: renders (evidence: `src/main/kotlin/ui/screens/HistoryScreen.kt`)
- Overview analytics → Navigation bar: renders (evidence: `src/main/kotlin/ui/screens/OverviewScreen.kt`)
- Category settings → Navigation bar: renders (evidence: `src/main/kotlin/ui/screens/SettingsScreen.kt`)
- Overview analytics → Pie chart: renders (evidence: `src/main/kotlin/ui/screens/OverviewScreen.kt`)
- Overview analytics → Comparison progress: renders (evidence: `src/main/kotlin/ui/screens/OverviewScreen.kt`)
- Finance state logic → Finance state: updates (evidence: `src/main/kotlin/viewmodel/FinanceViewModel.kt`)
- Finance state logic → Finance repository: loads and saves (evidence: `src/main/kotlin/viewmodel/FinanceViewModel.kt`)
- Finance repository → Operation model: uses model (evidence: `src/main/kotlin/repository/FinanceRepository.kt`)
- Finance repository → Database initialization: initializes (evidence: `src/main/kotlin/repository/FinanceRepository.kt`)
- Finance repository → Transaction requests: requests operations (evidence: `src/main/kotlin/repository/FinanceRepository.kt`)
- Finance repository → Category requests: requests categories (evidence: `src/main/kotlin/repository/FinanceRepository.kt`)
- Database initialization → SQLite configuration: configures (evidence: `src/main/kotlin/db/database_request/DatabaseInitializer.kt`)
- Database initialization → Category requests: seeds defaults (evidence: `src/main/kotlin/db/database_request/DatabaseInitializer.kt`)
- Transaction requests → SQLite database: reads and writes
- Category requests → SQLite database: reads and writes
- SQLite configuration → SQLite database: selects file
