# haiqalharona/receipt-logging-app architecture

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

- Interactive diagram: https://gitdiagram.com/haiqalharona/receipt-logging-app
- Repository: https://github.com/haiqalharona/receipt-logging-app

## Overview

Receipt Logger (SancFund) is an offline-first Flutter app for capturing receipts, extracting transaction data with Gemini vision, and tracking spending. The principal workflow begins with a user scanning a receipt, then processes and stores the structured result locally for history, detail, and analytics views; backend and cloud services provide AI processing and sync. The README also documents authentication, subscriptions, local export, and staging update capabilities. Source excerpts cover platform scaffolding rather than Dart runtime code, so runtime relationships below rely on README statements; unsampled implementation details are not asserted.

Main entry points: [`lib/data/local/isar_service.dart`](https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/data/local/isar_service.dart) (Local Isar store), [`lib/ui/features/scanner`](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/scanner) (Receipt scanner), [`lib/ui`](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui) (Flutter app), [`lib/ui/features/edit_receipt`](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/edit_receipt) (Receipt editing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["Flutter app"]
  node_navigation["Navigation"]
end

subgraph group_receipts["Receipt workflow"]
  node_scanner["Receipt scanner"]
  node_receipt_edit["Receipt editing"]
  node_receipt_detail["Receipt detail"]
  node_history["Receipt history"]
  node_dashboard["Spending dashboard"]
  node_analytics["Spending analytics"]
  node_ai_assistant["AI assistant"]
end

subgraph group_services["Cloud services"]
  node_backend{{"FastAPI backend"}}
  node_gemini{{"Gemini vision AI"}}
  node_supabase[("Supabase sync")]
end

subgraph group_state["Local state"]
  node_isar[("Local Isar store<br/>[isar_service.dart]")]
  node_export["Data export"]
end

subgraph group_account["Account and delivery"]
  node_auth["Authentication"]
  node_cloud_auth["Cloud auth services<br/>[auth_service.dart]"]
  node_subscription["Subscriptions"]
  node_quota["Quota service<br/>[quota_service.dart]"]
  node_update["App update notice"]
  node_apk_portal["APK distribution"]
end

node_user(("Mobile user"))

node_user -->|"uses"| node_app
node_app -->|"routes through"| node_navigation
node_user -->|"scans receipt"| node_scanner
node_scanner -->|"submits receipt"| node_backend
node_backend -->|"extracts data"| node_gemini
node_scanner -->|"stores offline"| node_isar
node_user -->|"reviews result"| node_receipt_edit
node_receipt_edit -->|"saves receipt"| node_isar
node_user -->|"browses receipts"| node_history
node_history -->|"reads receipts"| node_isar
node_user -->|"opens receipt"| node_receipt_detail
node_receipt_detail -->|"reads receipt"| node_isar
node_user -->|"views spending"| node_dashboard
node_dashboard -->|"reads spending data"| node_isar
node_user -->|"views trends"| node_analytics
node_analytics -->|"reads spending data"| node_isar
node_user -->|"asks questions"| node_ai_assistant
node_ai_assistant -->|"requests AI service"| node_backend
node_isar -->|"exports local data"| node_export
node_user -->|"signs in"| node_auth
node_auth -->|"authenticates"| node_cloud_auth
node_cloud_auth -->|"uses cloud auth"| node_supabase
node_user -->|"manages plan"| node_subscription
node_subscription -->|"checks quota"| node_quota
node_quota -.->|"requests quota"| node_backend
node_isar -->|"syncs data"| node_supabase
node_user -->|"checks updates"| node_update
node_update -->|"checks releases"| node_apk_portal

click node_app "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui"
click node_navigation "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/core/router"
click node_scanner "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/scanner"
click node_receipt_edit "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/edit_receipt"
click node_receipt_detail "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/receipt_detail"
click node_history "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/history"
click node_dashboard "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/dashboard"
click node_analytics "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/analytics"
click node_ai_assistant "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/ai_assistant"
click node_isar "https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/data/local/isar_service.dart"
click node_export "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/data"
click node_auth "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/auth"
click node_cloud_auth "https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/cloud/services/auth_service.dart"
click node_subscription "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/subscription"
click node_quota "https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/cloud/services/quota_service.dart"
click node_update "https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/settings"
click node_apk_portal "https://github.com/haiqalharona/receipt-logging-app/tree/master/deploy/apk-server"

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,node_navigation,node_user toneBlue
class node_scanner,node_receipt_edit,node_receipt_detail,node_history,node_dashboard,node_analytics,node_ai_assistant toneAmber
class node_backend,node_gemini,node_supabase toneMint
class node_isar,node_export toneRose
class node_auth,node_cloud_auth,node_subscription,node_quota,node_update,node_apk_portal toneIndigo
```

## Components

### App experience

- [Flutter app](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui): `lib/ui`
- [Navigation](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/core/router): `lib/ui/core/router`

### Receipt workflow

- [Receipt scanner](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/scanner): `lib/ui/features/scanner`
- [Receipt editing](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/edit_receipt): `lib/ui/features/edit_receipt`
- [Receipt detail](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/receipt_detail): `lib/ui/features/receipt_detail`
- [Receipt history](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/history): `lib/ui/features/history`
- [Spending dashboard](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/dashboard): `lib/ui/features/dashboard`
- [Spending analytics](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/analytics): `lib/ui/features/analytics`
- [AI assistant](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/ai_assistant): `lib/ui/features/ai_assistant`

### Cloud services

- **FastAPI backend**
- **Gemini vision AI**
- **Supabase sync**

### Local state

- [Local Isar store](https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/data/local/isar_service.dart): `lib/data/local/isar_service.dart`
- [Data export](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/data): `lib/data`

### Account and delivery

- [Authentication](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/auth): `lib/ui/features/auth`
- [Cloud auth services](https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/cloud/services/auth_service.dart): `lib/cloud/services/auth_service.dart`
- [Subscriptions](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/subscription): `lib/ui/features/subscription`
- [Quota service](https://github.com/haiqalharona/receipt-logging-app/blob/master/lib/cloud/services/quota_service.dart): `lib/cloud/services/quota_service.dart`
- [App update notice](https://github.com/haiqalharona/receipt-logging-app/tree/master/lib/ui/features/settings): `lib/ui/features/settings`
- [APK distribution](https://github.com/haiqalharona/receipt-logging-app/tree/master/deploy/apk-server): `deploy/apk-server`

### Other components

- **Mobile user**

## Connections

- Mobile user → Flutter app: uses (evidence: `README.md`)
- Flutter app → Navigation: routes through (evidence: `README.md`)
- Mobile user → Receipt scanner: scans receipt (evidence: `README.md`)
- Receipt scanner → FastAPI backend: submits receipt (evidence: `README.md`)
- FastAPI backend → Gemini vision AI: extracts data (evidence: `README.md`)
- Receipt scanner → Local Isar store: stores offline (evidence: `README.md`)
- Mobile user → Receipt editing: reviews result (evidence: `README.md`)
- Receipt editing → Local Isar store: saves receipt (evidence: `README.md`)
- Mobile user → Receipt history: browses receipts (evidence: `README.md`)
- Receipt history → Local Isar store: reads receipts (evidence: `README.md`)
- Mobile user → Receipt detail: opens receipt (evidence: `README.md`)
- Receipt detail → Local Isar store: reads receipt (evidence: `README.md`)
- Mobile user → Spending dashboard: views spending (evidence: `README.md`)
- Spending dashboard → Local Isar store: reads spending data (evidence: `README.md`)
- Mobile user → Spending analytics: views trends (evidence: `README.md`)
- Spending analytics → Local Isar store: reads spending data (evidence: `README.md`)
- Mobile user → AI assistant: asks questions (evidence: `README.md`)
- AI assistant → FastAPI backend: requests AI service (evidence: `README.md`)
- Local Isar store → Data export: exports local data (evidence: `README.md`)
- Mobile user → Authentication: signs in (evidence: `README.md`)
- Authentication → Cloud auth services: authenticates (evidence: `README.md`)
- Cloud auth services → Supabase sync: uses cloud auth (evidence: `README.md`)
- Mobile user → Subscriptions: manages plan (evidence: `README.md`)
- Subscriptions → Quota service: checks quota (evidence: `README.md`)
- Quota service → FastAPI backend: requests quota
- Local Isar store → Supabase sync: syncs data (evidence: `README.md`)
- Mobile user → App update notice: checks updates (evidence: `README.md`)
- App update notice → APK distribution: checks releases (evidence: `README.md`)
