# kishorsan/yenma architecture

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

- Interactive diagram: https://gitdiagram.com/kishorsan/yenma
- Repository: https://github.com/kishorsan/yenma

## Overview

Yenma is an offline Flutter money tracker: users manage transactions and review monthly cash-flow summaries, with debt splitting and repayment as a documented extension. The graph preserves the substantial transaction, debt, planning, split, commitment, and SMS-related areas visible in the tree, while distinguishing the Android SMS bridge and desktop host. Dart implementation details were not sampled, so relationships among those features and data layers are not asserted; the README describes the layers but does not establish their call paths.

Main entry points: [`android/app/src/main/kotlin/com/kiki/yenma/MainActivity.kt`](https://github.com/kishorsan/yenma/blob/main/android/app/src/main/kotlin/com/kiki/yenma/MainActivity.kt) (Android SMS bridge), [`lib/main.dart`](https://github.com/kishorsan/yenma/blob/main/lib/main.dart) (App entry), [`lib/app/yenma_app.dart`](https://github.com/kishorsan/yenma/blob/main/lib/app/yenma_app.dart) (App shell), [`lib/app/money_controller.dart`](https://github.com/kishorsan/yenma/blob/main/lib/app/money_controller.dart) (Money controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Flutter application"]
  node_app_entry["App entry<br/>[main.dart]"]
  node_app_shell["App shell<br/>[yenma_app.dart]"]
  node_money_controller["Money controller"]
end

subgraph group_money["Money features"]
  node_transactions["Transactions"]
  node_home["Overview and history<br/>[home_screen.dart]"]
  node_debts["Debt management<br/>[debts_screen.dart]"]
  node_splits["Expense splitting<br/>[split_screen.dart]"]
  node_planning["Monthly planning"]
  node_commitments["Commitments<br/>[emi_screen.dart]"]
end

subgraph group_data["Data and domain"]
  node_money_domain["Money domain<br/>[money.dart]"]
  node_debt_domain["Debt domain<br/>[debt.dart]"]
  node_sqlite[("SQLite persistence<br/>[yenma_schema.dart]")]
  node_sms_pipeline["SMS transaction pipeline"]
end

subgraph group_platform["Platform integration"]
  node_android_bridge["Android SMS bridge<br/>[MainActivity.kt]"]
  node_daily_receiver["Daily sync receiver"]
  node_windows_host["Windows Flutter host<br/>[flutter_window.cpp]"]
  node_win_window["Win32 window<br/>[win32_window.cpp]"]
  node_win_entry["Windows entry point<br/>[main.cpp]"]
end

node_user(("User"))

node_user -->|"launches"| node_app_entry
node_app_entry -.->|"starts"| node_app_shell
node_app_shell -.->|"uses"| node_money_controller
node_user -->|"records"| node_transactions
node_user -->|"reviews"| node_home
node_user -->|"tracks debts"| node_debts
node_user -->|"splits expenses"| node_splits
node_user -.->|"plans monthly"| node_planning
node_user -.->|"tracks commitments"| node_commitments
node_money_controller -.->|"persists data"| node_sqlite
node_android_bridge -.->|"provides SMS"| node_sms_pipeline
node_android_bridge -->|"schedules sync"| node_daily_receiver
node_daily_receiver -->|"launches activity"| node_android_bridge
node_win_entry -->|"creates host"| node_windows_host
node_windows_host -->|"inherits window"| node_win_window

click node_app_entry "https://github.com/kishorsan/yenma/blob/main/lib/main.dart"
click node_app_shell "https://github.com/kishorsan/yenma/blob/main/lib/app/yenma_app.dart"
click node_money_controller "https://github.com/kishorsan/yenma/blob/main/lib/app/money_controller.dart"
click node_transactions "https://github.com/kishorsan/yenma/blob/main/lib/features/transaction_form.dart"
click node_home "https://github.com/kishorsan/yenma/blob/main/lib/features/home_screen.dart"
click node_debts "https://github.com/kishorsan/yenma/blob/main/lib/features/debts/debts_screen.dart"
click node_splits "https://github.com/kishorsan/yenma/blob/main/lib/features/split/split_screen.dart"
click node_planning "https://github.com/kishorsan/yenma/blob/main/lib/features/monthly_plan_screen.dart"
click node_commitments "https://github.com/kishorsan/yenma/blob/main/lib/features/emi/emi_screen.dart"
click node_money_domain "https://github.com/kishorsan/yenma/blob/main/lib/domain/money.dart"
click node_debt_domain "https://github.com/kishorsan/yenma/blob/main/lib/domain/debt.dart"
click node_sqlite "https://github.com/kishorsan/yenma/blob/main/lib/data/yenma_schema.dart"
click node_sms_pipeline "https://github.com/kishorsan/yenma/blob/main/lib/data/sms_transaction_pipeline.dart"
click node_android_bridge "https://github.com/kishorsan/yenma/blob/main/android/app/src/main/kotlin/com/kiki/yenma/MainActivity.kt"
click node_daily_receiver "https://github.com/kishorsan/yenma/blob/main/android/app/src/main/kotlin/com/kiki/yenma/DailySyncReceiver.kt"
click node_windows_host "https://github.com/kishorsan/yenma/blob/main/windows/runner/flutter_window.cpp"
click node_win_window "https://github.com/kishorsan/yenma/blob/main/windows/runner/win32_window.cpp"
click node_win_entry "https://github.com/kishorsan/yenma/blob/main/windows/runner/main.cpp"

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_app_entry,node_app_shell,node_money_controller,node_user toneBlue
class node_transactions,node_home,node_debts,node_splits,node_planning,node_commitments toneAmber
class node_money_domain,node_debt_domain,node_sqlite,node_sms_pipeline toneMint
class node_android_bridge,node_daily_receiver,node_windows_host,node_win_window,node_win_entry toneRose
```

## Components

### Flutter application

- [App entry](https://github.com/kishorsan/yenma/blob/main/lib/main.dart): `lib/main.dart`
- [App shell](https://github.com/kishorsan/yenma/blob/main/lib/app/yenma_app.dart): `lib/app/yenma_app.dart`
- [Money controller](https://github.com/kishorsan/yenma/blob/main/lib/app/money_controller.dart): `lib/app/money_controller.dart`

### Money features

- [Transactions](https://github.com/kishorsan/yenma/blob/main/lib/features/transaction_form.dart): `lib/features/transaction_form.dart`
- [Overview and history](https://github.com/kishorsan/yenma/blob/main/lib/features/home_screen.dart): `lib/features/home_screen.dart`
- [Debt management](https://github.com/kishorsan/yenma/blob/main/lib/features/debts/debts_screen.dart): `lib/features/debts/debts_screen.dart`
- [Expense splitting](https://github.com/kishorsan/yenma/blob/main/lib/features/split/split_screen.dart): `lib/features/split/split_screen.dart`
- [Monthly planning](https://github.com/kishorsan/yenma/blob/main/lib/features/monthly_plan_screen.dart): `lib/features/monthly_plan_screen.dart`
- [Commitments](https://github.com/kishorsan/yenma/blob/main/lib/features/emi/emi_screen.dart): `lib/features/emi/emi_screen.dart`

### Data and domain

- [Money domain](https://github.com/kishorsan/yenma/blob/main/lib/domain/money.dart): `lib/domain/money.dart`
- [Debt domain](https://github.com/kishorsan/yenma/blob/main/lib/domain/debt.dart): `lib/domain/debt.dart`
- [SQLite persistence](https://github.com/kishorsan/yenma/blob/main/lib/data/yenma_schema.dart): `lib/data/yenma_schema.dart`
- [SMS transaction pipeline](https://github.com/kishorsan/yenma/blob/main/lib/data/sms_transaction_pipeline.dart): `lib/data/sms_transaction_pipeline.dart`

### Platform integration

- [Android SMS bridge](https://github.com/kishorsan/yenma/blob/main/android/app/src/main/kotlin/com/kiki/yenma/MainActivity.kt): `android/app/src/main/kotlin/com/kiki/yenma/MainActivity.kt`
- [Daily sync receiver](https://github.com/kishorsan/yenma/blob/main/android/app/src/main/kotlin/com/kiki/yenma/DailySyncReceiver.kt): `android/app/src/main/kotlin/com/kiki/yenma/DailySyncReceiver.kt`
- [Windows Flutter host](https://github.com/kishorsan/yenma/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Win32 window](https://github.com/kishorsan/yenma/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`
- [Windows entry point](https://github.com/kishorsan/yenma/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`

### Other components

- **User**

## Connections

- User → App entry: launches (evidence: `README.md`)
- App entry → App shell: starts
- App shell → Money controller: uses
- User → Transactions: records (evidence: `README.md`)
- User → Overview and history: reviews (evidence: `README.md`)
- User → Debt management: tracks debts (evidence: `README.md`)
- User → Expense splitting: splits expenses (evidence: `README.md`)
- User → Monthly planning: plans monthly
- User → Commitments: tracks commitments
- Money controller → SQLite persistence: persists data
- Android SMS bridge → SMS transaction pipeline: provides SMS
- Android SMS bridge → Daily sync receiver: schedules sync (evidence: `android/app/src/main/kotlin/com/kiki/yenma/MainActivity.kt`)
- Daily sync receiver → Android SMS bridge: launches activity (evidence: `android/app/src/main/kotlin/com/kiki/yenma/DailySyncReceiver.kt`)
- Windows entry point → Windows Flutter host: creates host (evidence: `windows/runner/main.cpp`)
- Windows Flutter host → Win32 window: inherits window (evidence: `windows/runner/flutter_window.cpp`)
