# snnn-011/nano-money architecture

> Architecture diagram of the GitHub repository snnn-011/nano-money, 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/snnn-011/nano-money
- Repository: https://github.com/snnn-011/nano-money

## Overview

Nano Money is an Android personal-finance app whose primary workflow turns chat text or a receipt photo into a checked transaction that can be reviewed alongside budgets and financial summaries. The app also supports CSV/PDF exchange, deleted-record recovery, and cross-device synchronization. Its Gemini proxy authenticates requests, validates and rate-limits them, then forwards them to Gemini with model fallbacks. App-level relationships below follow README statements; source excerpts directly support the proxy’s validation, rate-limit, and forwarding relationships. Most Android implementation files were not sampled.

Main entry points: [`app/src/main/java/com/example/data/FinancialRecordRepository.kt`](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/FinancialRecordRepository.kt) (Financial records), [`cloudflare-worker/src/worker.js`](https://github.com/snnn-011/nano-money/blob/main/cloudflare-worker/src/worker.js) (Gemini proxy), [`app/src/main/java/com/example/MainActivity.kt`](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/MainActivity.kt) (Nano Money app), [`app/src/main/java/com/example/ui/chat/ChatScreen.kt`](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/chat/ChatScreen.kt) (AI chat and receipts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android finance app"]
  node_android["Nano Money app<br/>[MainActivity.kt]"]
  node_chat["AI chat and receipts<br/>[ChatScreen.kt]"]
  node_transaction_ui["Transaction entry"]
  node_dashboard["Dashboard and budgets<br/>[BerandaTab.kt]"]
  node_analysis["Financial analysis<br/>[AnalysisTab.kt]"]
  node_calendar["Calendar trends<br/>[CalendarScreen.kt]"]
  node_export["Export and trash<br/>[EksporImporTab.kt]"]
end

subgraph group_domain["Transaction processing"]
  node_ai_parsing["AI transaction parsing"]
  node_receipt_parsing["Receipt parsing"]
  node_correction["Deterministic correction"]
  node_csv_import["CSV import"]
end

subgraph group_data["Storage and sync"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_records["Financial records"]
  node_budgets["Category budgets"]
  node_sync["Cloud synchronization<br/>[SyncManager.kt]"]
  node_firebase["Firebase services"]
end

subgraph group_proxy["Gemini edge proxy"]
  node_proxy_worker["Gemini proxy<br/>[worker.js]"]
  node_request_rules["Request and quota rules<br/>[ratelimit.js]"]
end

node_user(("Finance user"))
node_kv[("Cloudflare KV")]
node_gemini["Gemini API"]
node_jwks["Google token keys"]

node_user -->|"uses"| node_android
node_android -->|"opens chat"| node_chat
node_chat -->|"submits text"| node_ai_parsing
node_chat -->|"submits photo"| node_receipt_parsing
node_ai_parsing -->|"checks result"| node_correction
node_receipt_parsing -->|"checks result"| node_correction
node_correction -->|"records transaction"| node_records
node_transaction_ui -.->|"manages transactions"| node_records
node_records -.->|"persists records"| node_database
node_dashboard -->|"shows limits"| node_budgets
node_dashboard -.->|"summarizes transactions"| node_records
node_analysis -.->|"analyzes finances"| node_records
node_calendar -.->|"shows trends"| node_records
node_export -->|"exports or restores"| node_records
node_export -->|"imports CSV"| node_csv_import
node_csv_import -.->|"imports records"| node_records
node_sync -->|"syncs records"| node_firebase
node_android -->|"requests Gemini"| node_proxy_worker
node_proxy_worker -->|"validates and limits"| node_request_rules
node_proxy_worker -->|"verifies tokens"| node_jwks
node_proxy_worker -->|"updates quota"| node_kv
node_proxy_worker -->|"forwards request"| node_gemini

click node_android "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/MainActivity.kt"
click node_chat "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/chat/ChatScreen.kt"
click node_transaction_ui "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/transaction/TransaksiBaruTab.kt"
click node_dashboard "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/home/BerandaTab.kt"
click node_analysis "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/analysis/AnalysisTab.kt"
click node_calendar "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/calendar/CalendarScreen.kt"
click node_export "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/export/EksporImporTab.kt"
click node_ai_parsing "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/TransactionParserUseCase.kt"
click node_receipt_parsing "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/ReceiptParserUseCase.kt"
click node_correction "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/TransactionCorrector.kt"
click node_csv_import "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/CsvImportUseCase.kt"
click node_database "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/AppDatabase.kt"
click node_records "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/FinancialRecordRepository.kt"
click node_budgets "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/CategoryBudgetRepository.kt"
click node_sync "https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/sync/SyncManager.kt"
click node_proxy_worker "https://github.com/snnn-011/nano-money/blob/main/cloudflare-worker/src/worker.js"
click node_request_rules "https://github.com/snnn-011/nano-money/blob/main/cloudflare-worker/src/ratelimit.js"

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_android,node_chat,node_transaction_ui,node_dashboard,node_analysis,node_calendar,node_export,node_user toneBlue
class node_ai_parsing,node_receipt_parsing,node_correction,node_csv_import,node_kv toneAmber
class node_database,node_records,node_budgets,node_sync,node_firebase,node_gemini toneMint
class node_proxy_worker,node_request_rules toneRose
class node_jwks toneIndigo
```

## Components

### Android finance app

- [Nano Money app](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/MainActivity.kt): `app/src/main/java/com/example/MainActivity.kt`
- [AI chat and receipts](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/chat/ChatScreen.kt): `app/src/main/java/com/example/ui/chat/ChatScreen.kt`
- [Transaction entry](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/transaction/TransaksiBaruTab.kt): `app/src/main/java/com/example/ui/transaction/TransaksiBaruTab.kt`
- [Dashboard and budgets](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/home/BerandaTab.kt): `app/src/main/java/com/example/ui/home/BerandaTab.kt`
- [Financial analysis](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/analysis/AnalysisTab.kt): `app/src/main/java/com/example/ui/analysis/AnalysisTab.kt`
- [Calendar trends](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/calendar/CalendarScreen.kt): `app/src/main/java/com/example/ui/calendar/CalendarScreen.kt`
- [Export and trash](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/ui/export/EksporImporTab.kt): `app/src/main/java/com/example/ui/export/EksporImporTab.kt`

### Transaction processing

- [AI transaction parsing](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/TransactionParserUseCase.kt): `app/src/main/java/com/example/domain/TransactionParserUseCase.kt`
- [Receipt parsing](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/ReceiptParserUseCase.kt): `app/src/main/java/com/example/domain/ReceiptParserUseCase.kt`
- [Deterministic correction](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/TransactionCorrector.kt): `app/src/main/java/com/example/domain/TransactionCorrector.kt`
- [CSV import](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/domain/CsvImportUseCase.kt): `app/src/main/java/com/example/domain/CsvImportUseCase.kt`

### Storage and sync

- [Room database](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/AppDatabase.kt): `app/src/main/java/com/example/data/AppDatabase.kt`
- [Financial records](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/FinancialRecordRepository.kt): `app/src/main/java/com/example/data/FinancialRecordRepository.kt`
- [Category budgets](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/CategoryBudgetRepository.kt): `app/src/main/java/com/example/data/CategoryBudgetRepository.kt`
- [Cloud synchronization](https://github.com/snnn-011/nano-money/blob/main/app/src/main/java/com/example/data/sync/SyncManager.kt): `app/src/main/java/com/example/data/sync/SyncManager.kt`
- **Firebase services**

### Gemini edge proxy

- [Gemini proxy](https://github.com/snnn-011/nano-money/blob/main/cloudflare-worker/src/worker.js): `cloudflare-worker/src/worker.js`
- [Request and quota rules](https://github.com/snnn-011/nano-money/blob/main/cloudflare-worker/src/ratelimit.js): `cloudflare-worker/src/ratelimit.js`

### Other components

- **Finance user**
- **Cloudflare KV**
- **Gemini API**
- **Google token keys**

## Connections

- Finance user → Nano Money app: uses (evidence: `README.md`)
- Nano Money app → AI chat and receipts: opens chat (evidence: `README.md`)
- AI chat and receipts → AI transaction parsing: submits text (evidence: `README.md`)
- AI chat and receipts → Receipt parsing: submits photo (evidence: `README.md`)
- AI transaction parsing → Deterministic correction: checks result (evidence: `README.md`)
- Receipt parsing → Deterministic correction: checks result (evidence: `README.md`)
- Deterministic correction → Financial records: records transaction (evidence: `README.md`)
- Transaction entry → Financial records: manages transactions
- Financial records → Room database: persists records
- Dashboard and budgets → Category budgets: shows limits (evidence: `README.md`)
- Dashboard and budgets → Financial records: summarizes transactions
- Financial analysis → Financial records: analyzes finances
- Calendar trends → Financial records: shows trends
- Export and trash → Financial records: exports or restores (evidence: `README.md`)
- Export and trash → CSV import: imports CSV (evidence: `README.md`)
- CSV import → Financial records: imports records
- Cloud synchronization → Firebase services: syncs records (evidence: `README.md`)
- Nano Money app → Gemini proxy: requests Gemini (evidence: `README.md`)
- Gemini proxy → Request and quota rules: validates and limits (evidence: `cloudflare-worker/src/worker.js`)
- Gemini proxy → Google token keys: verifies tokens (evidence: `cloudflare-worker/src/worker.js`)
- Gemini proxy → Cloudflare KV: updates quota (evidence: `cloudflare-worker/src/worker.js`)
- Gemini proxy → Gemini API: forwards request (evidence: `cloudflare-worker/src/worker.js`)
