# siva-sundar-08/moneylog architecture

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

- Interactive diagram: https://gitdiagram.com/siva-sundar-08/moneylog
- Repository: https://github.com/siva-sundar-08/moneylog

## Overview

MoneyLog is an offline iPhone expense tracker built with SwiftUI and SwiftData. The principal workflow is: open the add sheet from Today, enter an amount and category, validate and save through the transaction repository, then notify screens to reload. Other major areas cover the Today dashboard, searchable Activity history, monthly Insights, budgets and savings goals, settings, and recurring transactions. The graph uses README-described flows and SOURCE INDEX references; unsampled implementation details are not assumed, and there are no external services.

Main entry points: [`MoneyLog/App/AppContainer.swift`](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/App/AppContainer.swift) (App container), [`MoneyLog/Features/Shell/RootTabView.swift`](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Shell/RootTabView.swift) (Tab navigation), [`MoneyLog/Features/Shell/AppRouter.swift`](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Shell/AppRouter.swift) (App router), [`MoneyLog/Core/Repositories/TransactionRepository.swift`](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Repositories/TransactionRepository.swift) (Transaction repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_appentry["App launch<br/>[MoneyLogApp.swift]"]
  node_router["App router<br/>[AppRouter.swift]"]
  node_tabs["Tab navigation<br/>[RootTabView.swift]"]
  node_container["App container<br/>[AppContainer.swift]"]
end

subgraph group_ledger["Ledger core"]
  node_transactions["Transaction repository"]
  node_records["Ledger records"]
  node_money["Money values<br/>[Money.swift]"]
  node_accounts["Accounts<br/>[Account.swift]"]
  node_categories["Categories"]
  node_recurring["Recurring rules"]
  node_recurrence["Recurrence engine"]
end

subgraph group_planning["Planning and insights"]
  node_insights["Monthly insights<br/>[InsightsView.swift]"]
  node_insightsvm["Insights view model"]
  node_plan["Budgets and goals<br/>[PlanView.swift]"]
  node_planvm["Plan view model"]
  node_budgetmodel["Budget model<br/>[Budget.swift]"]
  node_goalmodel["Savings goals<br/>[SavingsGoal.swift]"]
end

subgraph group_persistence["Local data"]
  node_persistence[("SwiftData store")]
  node_seed["Starter data"]
  node_reset["Data reset"]
end

subgraph group_ui["Screen experience"]
  node_today["Today dashboard<br/>[TodayView.swift]"]
  node_todayvm["Today view model"]
  node_activity["Activity history<br/>[ActivityView.swift]"]
  node_activityvm["Activity view model"]
  node_add["Transaction editor"]
  node_amountentry["Amount entry<br/>[AmountEntry.swift]"]
  node_categorypicker["Category picker"]
  node_addvm["Add view model"]
  node_settings["Settings<br/>[SettingsView.swift]"]
end

node_user(("User"))

node_user -->|"opens"| node_today
node_user -->|"taps add"| node_router
node_router -->|"presents sheet"| node_add
node_user -->|"enters amount"| node_amountentry
node_amountentry -->|"builds value"| node_money
node_user -->|"chooses category"| node_categorypicker
node_user -->|"saves"| node_add
node_add -->|"submits"| node_addvm
node_addvm -->|"requests save"| node_transactions
node_transactions -->|"writes record"| node_records
node_transactions -->|"validates account"| node_accounts
node_transactions -->|"validates category"| node_categories
node_addvm -->|"bumps version"| node_router
node_router -->|"signals reload"| node_today
node_router -->|"signals reload"| node_activity
node_router -->|"signals reload"| node_insights
node_today -->|"uses model"| node_todayvm
node_activity -->|"uses model"| node_activityvm
node_insights -->|"uses model"| node_insightsvm
node_plan -.->|"uses model"| node_planvm
node_container -->|"configures"| node_transactions
node_container -->|"configures"| node_accounts
node_container -->|"configures"| node_categories
node_container -->|"seeds at launch"| node_seed
node_container -->|"processes due rules"| node_recurrence
node_recurrence -->|"reads rules"| node_recurring
node_recurrence -->|"creates transactions"| node_records
node_appentry -.->|"initializes"| node_container
node_appentry -.->|"presents app"| node_tabs
node_tabs -.->|"shows screen"| node_today
node_tabs -.->|"shows screen"| node_activity
node_tabs -.->|"shows screen"| node_insights
node_tabs -.->|"shows screen"| node_plan
node_tabs -.->|"shows screen"| node_settings
node_container -.->|"owns store"| node_persistence
node_container -->|"delegates erase"| node_reset
node_container -.->|"provides budgets"| node_budgetmodel
node_container -.->|"provides goals"| node_goalmodel

click node_appentry "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/App/MoneyLogApp.swift"
click node_router "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Shell/AppRouter.swift"
click node_tabs "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Shell/RootTabView.swift"
click node_container "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/App/AppContainer.swift"
click node_today "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Today/TodayView.swift"
click node_todayvm "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Today/TodayViewModel.swift"
click node_activity "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Activity/ActivityView.swift"
click node_activityvm "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Activity/ActivityViewModel.swift"
click node_add "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/AddTransactionView.swift"
click node_amountentry "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/AmountEntry.swift"
click node_categorypicker "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/CategoryPickerSheet.swift"
click node_addvm "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/AddTransactionViewModel.swift"
click node_insights "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Insights/InsightsView.swift"
click node_insightsvm "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Insights/InsightsViewModel.swift"
click node_plan "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Plan/PlanView.swift"
click node_planvm "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Plan/PlanViewModel.swift"
click node_settings "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Settings/SettingsView.swift"
click node_transactions "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Repositories/TransactionRepository.swift"
click node_records "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/TransactionRecord.swift"
click node_money "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Money/Money.swift"
click node_accounts "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/Account.swift"
click node_categories "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/TransactionCategory.swift"
click node_recurring "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/RecurringTransaction.swift"
click node_recurrence "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Services/RecurrenceEngine.swift"
click node_budgetmodel "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/Budget.swift"
click node_goalmodel "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/SavingsGoal.swift"
click node_persistence "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Persistence/PersistenceController.swift"
click node_seed "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Persistence/SeedDataService.swift"
click node_reset "https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Persistence/DataResetService.swift"

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_appentry,node_router,node_tabs,node_container,node_user toneBlue
class node_transactions,node_records,node_money,node_accounts,node_categories,node_recurring,node_recurrence toneAmber
class node_insights,node_insightsvm,node_plan,node_planvm,node_budgetmodel,node_goalmodel toneMint
class node_persistence,node_seed,node_reset toneRose
class node_today,node_todayvm,node_activity,node_activityvm,node_add,node_amountentry,node_categorypicker,node_addvm,node_settings toneIndigo
```

## Components

### App shell

- [App launch](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/App/MoneyLogApp.swift): `MoneyLog/App/MoneyLogApp.swift`
- [App router](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Shell/AppRouter.swift): `MoneyLog/Features/Shell/AppRouter.swift`
- [Tab navigation](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Shell/RootTabView.swift): `MoneyLog/Features/Shell/RootTabView.swift`
- [App container](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/App/AppContainer.swift): `MoneyLog/App/AppContainer.swift`

### Ledger core

- [Transaction repository](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Repositories/TransactionRepository.swift): `MoneyLog/Core/Repositories/TransactionRepository.swift`
- [Ledger records](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/TransactionRecord.swift): `MoneyLog/Core/Models/TransactionRecord.swift`
- [Money values](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Money/Money.swift): `MoneyLog/Core/Money/Money.swift`
- [Accounts](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/Account.swift): `MoneyLog/Core/Models/Account.swift`
- [Categories](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/TransactionCategory.swift): `MoneyLog/Core/Models/TransactionCategory.swift`
- [Recurring rules](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/RecurringTransaction.swift): `MoneyLog/Core/Models/RecurringTransaction.swift`
- [Recurrence engine](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Services/RecurrenceEngine.swift): `MoneyLog/Core/Services/RecurrenceEngine.swift`

### Planning and insights

- [Monthly insights](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Insights/InsightsView.swift): `MoneyLog/Features/Insights/InsightsView.swift`
- [Insights view model](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Insights/InsightsViewModel.swift): `MoneyLog/Features/Insights/InsightsViewModel.swift`
- [Budgets and goals](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Plan/PlanView.swift): `MoneyLog/Features/Plan/PlanView.swift`
- [Plan view model](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Plan/PlanViewModel.swift): `MoneyLog/Features/Plan/PlanViewModel.swift`
- [Budget model](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/Budget.swift): `MoneyLog/Core/Models/Budget.swift`
- [Savings goals](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Models/SavingsGoal.swift): `MoneyLog/Core/Models/SavingsGoal.swift`

### Local data

- [SwiftData store](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Persistence/PersistenceController.swift): `MoneyLog/Core/Persistence/PersistenceController.swift`
- [Starter data](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Persistence/SeedDataService.swift): `MoneyLog/Core/Persistence/SeedDataService.swift`
- [Data reset](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Core/Persistence/DataResetService.swift): `MoneyLog/Core/Persistence/DataResetService.swift`

### Screen experience

- [Today dashboard](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Today/TodayView.swift): `MoneyLog/Features/Today/TodayView.swift`
- [Today view model](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Today/TodayViewModel.swift): `MoneyLog/Features/Today/TodayViewModel.swift`
- [Activity history](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Activity/ActivityView.swift): `MoneyLog/Features/Activity/ActivityView.swift`
- [Activity view model](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Activity/ActivityViewModel.swift): `MoneyLog/Features/Activity/ActivityViewModel.swift`
- [Transaction editor](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/AddTransactionView.swift): `MoneyLog/Features/AddTransaction/AddTransactionView.swift`
- [Amount entry](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/AmountEntry.swift): `MoneyLog/Features/AddTransaction/AmountEntry.swift`
- [Category picker](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/CategoryPickerSheet.swift): `MoneyLog/Features/AddTransaction/CategoryPickerSheet.swift`
- [Add view model](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/AddTransaction/AddTransactionViewModel.swift): `MoneyLog/Features/AddTransaction/AddTransactionViewModel.swift`
- [Settings](https://github.com/siva-sundar-08/moneylog/blob/main/MoneyLog/Features/Settings/SettingsView.swift): `MoneyLog/Features/Settings/SettingsView.swift`

### Other components

- **User**

## Connections

- User → Today dashboard: opens
- User → App router: taps add
- App router → Transaction editor: presents sheet (evidence: `MoneyLog/Features/AddTransaction/AddTransactionView.swift`)
- User → Amount entry: enters amount
- Amount entry → Money values: builds value
- User → Category picker: chooses category
- User → Transaction editor: saves
- Transaction editor → Add view model: submits (evidence: `MoneyLog/Features/AddTransaction/AddTransactionView.swift`)
- Add view model → Transaction repository: requests save
- Transaction repository → Ledger records: writes record (evidence: `MoneyLog/Core/Repositories/TransactionRepository.swift`)
- Transaction repository → Accounts: validates account (evidence: `MoneyLog/Core/Repositories/TransactionRepository.swift`)
- Transaction repository → Categories: validates category (evidence: `MoneyLog/Core/Repositories/TransactionRepository.swift`)
- Add view model → App router: bumps version
- App router → Today dashboard: signals reload
- App router → Activity history: signals reload (evidence: `MoneyLog/Features/Activity/ActivityView.swift`)
- App router → Monthly insights: signals reload (evidence: `MoneyLog/Features/Insights/InsightsView.swift`)
- Today dashboard → Today view model: uses model
- Activity history → Activity view model: uses model (evidence: `MoneyLog/Features/Activity/ActivityView.swift`)
- Monthly insights → Insights view model: uses model (evidence: `MoneyLog/Features/Insights/InsightsView.swift`)
- Budgets and goals → Plan view model: uses model
- App container → Transaction repository: configures (evidence: `MoneyLog/App/AppContainer.swift`)
- App container → Accounts: configures (evidence: `MoneyLog/App/AppContainer.swift`)
- App container → Categories: configures (evidence: `MoneyLog/App/AppContainer.swift`)
- App container → Starter data: seeds at launch (evidence: `MoneyLog/App/AppContainer.swift`)
- App container → Recurrence engine: processes due rules (evidence: `MoneyLog/App/AppContainer.swift`)
- Recurrence engine → Recurring rules: reads rules (evidence: `MoneyLog/Core/Services/RecurrenceEngine.swift`)
- Recurrence engine → Ledger records: creates transactions (evidence: `MoneyLog/Core/Services/RecurrenceEngine.swift`)
- App launch → App container: initializes
- App launch → Tab navigation: presents app
- Tab navigation → Today dashboard: shows screen
- Tab navigation → Activity history: shows screen
- Tab navigation → Monthly insights: shows screen
- Tab navigation → Budgets and goals: shows screen
- Tab navigation → Settings: shows screen
- App container → SwiftData store: owns store
- App container → Data reset: delegates erase (evidence: `MoneyLog/App/AppContainer.swift`)
- App container → Budget model: provides budgets
- App container → Savings goals: provides goals
