# hangddev/wallets architecture

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

- Interactive diagram: https://gitdiagram.com/hangddev/wallets
- Repository: https://github.com/hangddev/wallets

## Overview

Wallets is an Android personal-finance app. The apparent user journey is authentication, then recording and reviewing transactions or borrowing/lending, with dashboard and report views for understanding finances. The tree also indicates category, wallet, and weekly-history views. Source excerpts and README content were not provided, so component links below are tentative (dashed); the tree alone does not verify runtime calls or data flow.

Main entry points: [`app/src/main/java/com/example/financemanager/ui/viewmodels/FinanceViewModel.kt`](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/viewmodels/FinanceViewModel.kt) (Finance state), [`app/src/main/java/com/example/financemanager/ui/components/BottomNavigationBar.kt`](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/components/BottomNavigationBar.kt) (Bottom navigation), [`app/src/main/java/com/example/financemanager/MainActivity.kt`](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/MainActivity.kt) (Main activity), [`app/src/main/java/com/example/financemanager/repository/FirebaseRepository.kt`](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/repository/FirebaseRepository.kt) (Firebase repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_authui["Sign-in screens<br/>[LoginScreen.kt]"]
  node_signup["Sign-up screen<br/>[SignUpScreen.kt]"]
  node_nav["Bottom navigation"]
end

subgraph group_finance["Finance workflows"]
  node_viewmodel["Finance state"]
  node_transaction["Transaction entry"]
  node_transactions["Transaction views"]
  node_category["Category view"]
  node_filtered["Filtered view"]
  node_wallet["Wallet view"]
  node_borrowentry["Borrow-lend entry"]
  node_receivables["Receivables"]
  node_repayables["Repayables"]
end

subgraph group_insights["Financial insights"]
  node_dashboard["Dashboard<br/>[DashboardScreen.kt]"]
  node_report["Financial report<br/>[ReportScreen.kt]"]
  node_weekly["Weekly history"]
  node_weeklydetail["Weekly detail"]
end

subgraph group_data["Identity and data"]
  node_authservice["Authentication service<br/>[AuthService.kt]"]
  node_repository["Firebase repository"]
  node_firebase[("Firebase")]
  node_models["Finance models<br/>[Transaction.kt]"]
end

node_user(("User"))

node_user -.->|"opens app"| node_activity
node_activity -.->|"shows"| node_authui
node_authui -.->|"authenticates"| node_authservice
node_signup -.->|"registers"| node_authservice
node_activity -.->|"offers navigation"| node_nav
node_nav -.->|"opens"| node_dashboard
node_nav -.->|"opens"| node_transactions
node_nav -.->|"opens"| node_borrowentry
node_nav -.->|"opens"| node_report
node_transaction -.->|"submits entry"| node_viewmodel
node_borrowentry -.->|"submits entry"| node_viewmodel
node_transactions -.->|"loads data"| node_viewmodel
node_category -.->|"loads data"| node_viewmodel
node_filtered -.->|"loads data"| node_viewmodel
node_wallet -.->|"loads data"| node_viewmodel
node_receivables -.->|"loads data"| node_viewmodel
node_repayables -.->|"loads data"| node_viewmodel
node_dashboard -.->|"loads summaries"| node_viewmodel
node_report -.->|"loads report"| node_viewmodel
node_weekly -.->|"loads history"| node_viewmodel
node_weeklydetail -.->|"loads detail"| node_viewmodel
node_viewmodel -.->|"requests data"| node_repository
node_repository -.->|"accesses data"| node_firebase
node_repository -.->|"uses records"| node_models

click node_activity "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/MainActivity.kt"
click node_authui "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/LoginScreen.kt"
click node_signup "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/SignUpScreen.kt"
click node_nav "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/components/BottomNavigationBar.kt"
click node_viewmodel "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/viewmodels/FinanceViewModel.kt"
click node_transaction "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/AddTransactionScreen.kt"
click node_transactions "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/TransactionsScreen.kt"
click node_category "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/CategoryTransactionsScreen.kt"
click node_filtered "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/FilteredTransactionsScreen.kt"
click node_wallet "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/WalletTransactionsScreen.kt"
click node_borrowentry "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/AddBorrowLendScreen.kt"
click node_receivables "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/ReceivablesScreen.kt"
click node_repayables "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/RepayablesScreen.kt"
click node_dashboard "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/DashboardScreen.kt"
click node_report "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/ReportScreen.kt"
click node_weekly "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/WeeklyHistoryScreen.kt"
click node_weeklydetail "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/WeeklySummaryDetailScreen.kt"
click node_authservice "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/service/AuthService.kt"
click node_repository "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/repository/FirebaseRepository.kt"
click node_models "https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/model/Transaction.kt"

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_activity,node_authui,node_signup,node_nav,node_user toneBlue
class node_viewmodel,node_transaction,node_transactions,node_category,node_filtered,node_wallet,node_borrowentry,node_receivables,node_repayables toneAmber
class node_dashboard,node_report,node_weekly,node_weeklydetail toneMint
class node_authservice,node_repository,node_firebase,node_models toneRose
```

## Components

### App entry

- [Main activity](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/MainActivity.kt): `app/src/main/java/com/example/financemanager/MainActivity.kt`
- [Sign-in screens](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/LoginScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/LoginScreen.kt`
- [Sign-up screen](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/SignUpScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/SignUpScreen.kt`
- [Bottom navigation](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/components/BottomNavigationBar.kt): `app/src/main/java/com/example/financemanager/ui/components/BottomNavigationBar.kt`

### Finance workflows

- [Finance state](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/viewmodels/FinanceViewModel.kt): `app/src/main/java/com/example/financemanager/ui/viewmodels/FinanceViewModel.kt`
- [Transaction entry](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/AddTransactionScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/AddTransactionScreen.kt`
- [Transaction views](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/TransactionsScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/TransactionsScreen.kt`
- [Category view](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/CategoryTransactionsScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/CategoryTransactionsScreen.kt`
- [Filtered view](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/FilteredTransactionsScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/FilteredTransactionsScreen.kt`
- [Wallet view](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/WalletTransactionsScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/WalletTransactionsScreen.kt`
- [Borrow-lend entry](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/AddBorrowLendScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/AddBorrowLendScreen.kt`
- [Receivables](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/ReceivablesScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/ReceivablesScreen.kt`
- [Repayables](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/RepayablesScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/RepayablesScreen.kt`

### Financial insights

- [Dashboard](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/DashboardScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/DashboardScreen.kt`
- [Financial report](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/ReportScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/ReportScreen.kt`
- [Weekly history](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/WeeklyHistoryScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/WeeklyHistoryScreen.kt`
- [Weekly detail](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/ui/screen/WeeklySummaryDetailScreen.kt): `app/src/main/java/com/example/financemanager/ui/screen/WeeklySummaryDetailScreen.kt`

### Identity and data

- [Authentication service](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/service/AuthService.kt): `app/src/main/java/com/example/financemanager/service/AuthService.kt`
- [Firebase repository](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/repository/FirebaseRepository.kt): `app/src/main/java/com/example/financemanager/repository/FirebaseRepository.kt`
- **Firebase**
- [Finance models](https://github.com/hangddev/wallets/blob/master/app/src/main/java/com/example/financemanager/model/Transaction.kt): `app/src/main/java/com/example/financemanager/model/Transaction.kt`

### Other components

- **User**

## Connections

- User → Main activity: opens app
- Main activity → Sign-in screens: shows
- Sign-in screens → Authentication service: authenticates
- Sign-up screen → Authentication service: registers
- Main activity → Bottom navigation: offers navigation
- Bottom navigation → Dashboard: opens
- Bottom navigation → Transaction views: opens
- Bottom navigation → Borrow-lend entry: opens
- Bottom navigation → Financial report: opens
- Transaction entry → Finance state: submits entry
- Borrow-lend entry → Finance state: submits entry
- Transaction views → Finance state: loads data
- Category view → Finance state: loads data
- Filtered view → Finance state: loads data
- Wallet view → Finance state: loads data
- Receivables → Finance state: loads data
- Repayables → Finance state: loads data
- Dashboard → Finance state: loads summaries
- Financial report → Finance state: loads report
- Weekly history → Finance state: loads history
- Weekly detail → Finance state: loads detail
- Finance state → Firebase repository: requests data
- Firebase repository → Firebase: accesses data
- Firebase repository → Finance models: uses records
