# janufniarz/money architecture

> Architecture diagram of the GitHub repository janufniarz/money, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/janufniarz/money
- Repository: https://github.com/janufniarz/money

## Overview

##### Main components
- Flutter UI Layer
– Views (screens): e.g. Home, AllEntries, AllAccounts, Budgets, AddEntry, AddAccount, AddBudget, AccountView
– Widgets (reusable UI): BalanceCard, EntryCard, BudgetCard, GraphCircular, GraphLinear, DatePicker, MyScaffold
– Navigation: NavDirector (routes & page orchestration)
– Invoker (PlatformChannel interface)
- Android Native Layer
– MethodChannel handler in MainActivity (entry point for platform calls)
– Converter & Storable interfaces (data marshalling)
– Room entities: Account, Entry, Budget
– DAOs: AccountDao, EntryDao, BudgetDao
– Room Databases: AccountDatabase, EntryDatabase, BudgetDatabase
- Local Persistence
– SQLite (via Android Room)
- External Services
– None in current scope (all data is local)

##### Architectural patterns
- Layered architecture: Presentation (Flutter UI) → Platform Integration (PlatformChannel) → Data (Room)
- Repository-style separation: Invoker abstracts data access from UI
- MVU/MVC–style in Flutter: Views + Widgets separate from business logic
- Android Room for ORM pattern

##### Technologies and frameworks
- Dart & Flutter (UI toolkit)
- Material Design (widgets & theming)
- MethodChannel (Flutter ↔ Native bridge)
- Android Room (SQLite ORM)
- Java (Native handlers, DAOs, Entities)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Flutter App Layer
    subgraph "Flutter App"
        direction TB
        MainD["main.dart"]:::flutter
        subgraph "Views"
            direction TB
            Home["Home"]:::flutter
            AllEntries["AllEntries"]:::flutter
            AllAccounts["AllAccounts"]:::flutter
            Budgets["Budgets"]:::flutter
            AddEntry["AddEntry"]:::flutter
            AddAccount["AddAccount"]:::flutter
            AddBudget["AddBudget"]:::flutter
            AccountView["AccountView"]:::flutter
        end
        subgraph "Widgets"
            direction TB
            BalanceCard["BalanceCard"]:::flutter
            EntryCard["EntryCard"]:::flutter
            BudgetCard["BudgetCard"]:::flutter
            GraphCircular["GraphCircular"]:::flutter
            GraphLinear["GraphLinear"]:::flutter
            DatePicker["DatePicker"]:::flutter
            MyScaffold["MyScaffold"]:::flutter
        end
        Nav["NavDirector"]:::flutter
        Invoker["Invoker"]:::bridge
        Palette["Palette"]:::flutter
    end

    %% Platform Channel Bridge
    subgraph "Platform Channel"
        direction TB
        Activity["MainActivity"]:::bridge
    end

    %% Android Native Module
    subgraph "Android Module"
        direction TB
        Converter["Converter"]:::native
        Storable["Storable"]:::native
        subgraph "Room Entities"
            direction TB
            AccountEnt["Account"]:::native
            EntryEnt["Entry"]:::native
            BudgetEnt["Budget"]:::native
        end
        subgraph "DAOs"
            direction TB
            AccountDao["AccountDao"]:::native
            EntryDao["EntryDao"]:::native
            BudgetDao["BudgetDao"]:::native
        end
        subgraph "Databases"
            direction TB
            AccountDB["AccountDatabase"]:::native
            EntryDB["EntryDatabase"]:::native
            BudgetDB["BudgetDatabase"]:::native
        end
        subgraph "Enums"
            direction TB
            Category["Category"]:::native
            Interval["Interval"]:::native
            TypeEnum["Type"]:::native
        end
    end

    %% SQLite Database
    DB["SQLite DB"]:::database

    %% Data Flows
    MainD -->|"launch"| Home
    Home -->|"invokeMethod('getAllEntries')"| Invoker
    Invoker -->|"MethodChannel"| Activity
    Activity -->|"to Converter"| Converter
    Converter -->|"marshal"| Storable
    Converter -->|"uses AccountDao"| AccountDao
    Converter -->|"uses EntryDao"| EntryDao
    Converter -->|"uses BudgetDao"| BudgetDao
    AccountDao -->|"@Query / CRUD"| AccountDB
    EntryDao -->|"@Query / CRUD"| EntryDB
    BudgetDao -->|"@Query / CRUD"| BudgetDB
    AccountDB -->|"persistence"| DB
    EntryDB -->|"persistence"| DB
    BudgetDB -->|"persistence"| DB

    %% Click Events
    click MainD "https://github.com/janufniarz/money/blob/main/lib/main.dart"
    click Home "https://github.com/janufniarz/money/blob/main/lib/views/home.dart"
    click AllEntries "https://github.com/janufniarz/money/blob/main/lib/views/all_entries.dart"
    click AllAccounts "https://github.com/janufniarz/money/blob/main/lib/views/all_accounts.dart"
    click Budgets "https://github.com/janufniarz/money/blob/main/lib/views/budgets.dart"
    click AddEntry "https://github.com/janufniarz/money/blob/main/lib/views/add_entry.dart"
    click AddAccount "https://github.com/janufniarz/money/blob/main/lib/views/add_accout.dart"
    click AddBudget "https://github.com/janufniarz/money/blob/main/lib/views/add_budget.dart"
    click AccountView "https://github.com/janufniarz/money/blob/main/lib/views/account_view.dart"
    click BalanceCard "https://github.com/janufniarz/money/blob/main/lib/widgets/balance_card.dart"
    click EntryCard "https://github.com/janufniarz/money/blob/main/lib/widgets/entry_card.dart"
    click BudgetCard "https://github.com/janufniarz/money/blob/main/lib/widgets/budget_card.dart"
    click GraphCircular "https://github.com/janufniarz/money/blob/main/lib/widgets/graph_circular.dart"
    click GraphLinear "https://github.com/janufniarz/money/blob/main/lib/widgets/graph_linear.dart"
    click DatePicker "https://github.com/janufniarz/money/blob/main/lib/widgets/date_picker.dart"
    click MyScaffold "https://github.com/janufniarz/money/blob/main/lib/widgets/my_scaffold.dart"
    click Nav "https://github.com/janufniarz/money/blob/main/lib/nav_director.dart"
    click Invoker "https://github.com/janufniarz/money/blob/main/lib/invoker.dart"
    click Palette "https://github.com/janufniarz/money/blob/main/lib/palette.dart"
    click Activity "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/MainActivity.java"
    click Converter "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/Converter.java"
    click Storable "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/Storable.java"
    click AccountEnt "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/account/Account.java"
    click EntryEnt "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/entry/Entry.java"
    click BudgetEnt "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/budget/Budget.java"
    click AccountDao "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/account/AccountDao.java"
    click EntryDao "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/entry/EntryDao.java"
    click BudgetDao "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/budget/BudgetDao.java"
    click AccountDB "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/account/AccountDatabase.java"
    click EntryDB "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/entry/EntryDatabase.java"
    click BudgetDB "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/budget/BudgetDatabase.java"
    click Category "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/enums/Category.java"
    click Interval "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/enums/Interval.java"
    click TypeEnum "https://github.com/janufniarz/money/blob/main/android/app/src/main/java/com/example/money/enums/Type.java"

    %% Styles
    classDef flutter fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1
    classDef bridge fill:#C8E6C9,stroke:#1B5E20,color:#1B5E20
    classDef native fill:#FFE0B2,stroke:#E65100,color:#E65100
    classDef database fill:#D7CCC8,stroke:#5D4037,color:#5D4037
```
