# emmanueldav/cashipaymentapp architecture

> Architecture diagram of the GitHub repository emmanueldav/cashipaymentapp, 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/emmanueldav/cashipaymentapp
- Repository: https://github.com/emmanueldav/cashipaymentapp

## Overview

Cashi Payments is a Kotlin Multiplatform app for submitting payments and viewing transaction history. The main workflow is a user entering recipient, amount, and currency; shared presentation logic validates and submits the payment to a backend, then records it in the platform repository. Android presents the Compose send and history screens and uses Firestore for live history; iOS has a Swift shell and a documented in-memory repository stand-in. Relationships rely on the README workflow and architecture, indexed references, and the excerpts shown; unsampled platform wiring is not expanded.

Main entry points: [`sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentViewmodel.kt`](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentViewmodel.kt) (Payment view model), [`androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt`](https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt) (Send screen), [`sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.kt`](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.kt) (Platform repository declaration), [`sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/repositories/PaymentRepository.kt`](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/repositories/PaymentRepository.kt) (Payment repository contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client UI"]
  node_android_shell["Android app shell<br/>[MainActivity.kt]"]
  node_send_screen["Send screen<br/>[PaymentScreen.kt]"]
  node_history_screen["History screen<br/>[HistoryScreen.kt]"]
  node_amount_format["Amount input formatting"]
  node_ios_shell["iOS app shell<br/>[ContentView.swift]"]
end

subgraph group_shared["Shared payment logic"]
  node_viewmodel["Payment view model"]
  node_ui_state["Form and history state<br/>[PaymentUiState.kt]"]
  node_validator["Payment validation"]
  node_money["Minor-unit formatting<br/>[MoneyFormat.kt]"]
  node_payment_model["Payment and currency models<br/>[Payment.kt]"]
end

subgraph group_network["Backend submission"]
  node_payment_request["Payment request DTO<br/>[PaymentRequest.kt]"]
  node_api_client["Payment API client"]
end

subgraph group_persistence["Transaction history"]
  node_repository_contract["Payment repository contract"]
  node_repository_expect["Platform repository declaration"]
  node_android_repository["Android Firestore repository"]
  node_ios_repository["iOS in-memory repository"]
end

node_payer(("Payment user"))
node_backend["Payment backend"]
node_firestore[("Firestore")]

node_payer -->|"enters payment"| node_send_screen
node_android_shell -->|"routes to"| node_send_screen
node_android_shell -->|"routes to"| node_history_screen
node_send_screen -->|"sends form actions"| node_viewmodel
node_send_screen -->|"formats amount input"| node_amount_format
node_send_screen -->|"formats displayed amount"| node_money
node_viewmodel -->|"updates state"| node_ui_state
node_viewmodel -->|"validates fields"| node_validator
node_viewmodel -->|"parses amount"| node_money
node_viewmodel -->|"creates request"| node_payment_request
node_viewmodel -->|"submits payment"| node_api_client
node_api_client -->|"posts payment"| node_backend
node_viewmodel -->|"builds payment record"| node_payment_model
node_viewmodel -->|"records and observes"| node_repository_contract
node_repository_expect -->|"implements per platform"| node_repository_contract
node_repository_expect -->|"has Android actual"| node_android_repository
node_repository_expect -->|"has iOS actual"| node_ios_repository
node_android_repository -->|"writes and listens"| node_firestore
node_repository_contract -->|"streams transactions"| node_viewmodel
node_viewmodel -->|"provides live state"| node_history_screen
node_ios_shell -.->|"uses shared logic"| node_viewmodel
node_ios_repository -.->|"uses memory stand-in"| node_firestore

click node_android_shell "https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/MainActivity.kt"
click node_send_screen "https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt"
click node_history_screen "https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/HistoryScreen.kt"
click node_amount_format "https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/ThousandsSeparatorTransformation.kt"
click node_ios_shell "https://github.com/emmanueldav/cashipaymentapp/blob/main/iosApp/iosApp/ContentView.swift"
click node_viewmodel "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentViewmodel.kt"
click node_ui_state "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentUiState.kt"
click node_validator "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/validation/PaymentValidator.kt"
click node_money "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/money/MoneyFormat.kt"
click node_payment_model "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/models/Payment.kt"
click node_payment_request "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/dto/PaymentRequest.kt"
click node_api_client "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/network/PaymentApiClient.kt"
click node_repository_contract "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/repositories/PaymentRepository.kt"
click node_repository_expect "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.kt"
click node_android_repository "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/androidMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.android.kt"
click node_ios_repository "https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/iosMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.ios.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_android_shell,node_send_screen,node_history_screen,node_amount_format,node_ios_shell,node_payer toneBlue
class node_viewmodel,node_ui_state,node_validator,node_money,node_payment_model,node_firestore toneAmber
class node_payment_request,node_api_client toneMint
class node_repository_contract,node_repository_expect,node_android_repository,node_ios_repository toneRose
class node_backend toneIndigo
```

## Components

### Client UI

- [Android app shell](https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/MainActivity.kt): `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/MainActivity.kt`
- [Send screen](https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt): `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt`
- [History screen](https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/HistoryScreen.kt): `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/HistoryScreen.kt`
- [Amount input formatting](https://github.com/emmanueldav/cashipaymentapp/blob/main/androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/ThousandsSeparatorTransformation.kt): `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/ThousandsSeparatorTransformation.kt`
- [iOS app shell](https://github.com/emmanueldav/cashipaymentapp/blob/main/iosApp/iosApp/ContentView.swift): `iosApp/iosApp/ContentView.swift`

### Shared payment logic

- [Payment view model](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentViewmodel.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentViewmodel.kt`
- [Form and history state](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentUiState.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentUiState.kt`
- [Payment validation](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/validation/PaymentValidator.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/validation/PaymentValidator.kt`
- [Minor-unit formatting](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/money/MoneyFormat.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/money/MoneyFormat.kt`
- [Payment and currency models](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/models/Payment.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/models/Payment.kt`

### Backend submission

- [Payment request DTO](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/dto/PaymentRequest.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/dto/PaymentRequest.kt`
- [Payment API client](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/network/PaymentApiClient.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/network/PaymentApiClient.kt`

### Transaction history

- [Payment repository contract](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/repositories/PaymentRepository.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/domain/repositories/PaymentRepository.kt`
- [Platform repository declaration](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.kt): `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.kt`
- [Android Firestore repository](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/androidMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.android.kt): `sharedLogic/src/androidMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.android.kt`
- [iOS in-memory repository](https://github.com/emmanueldav/cashipaymentapp/blob/main/sharedLogic/src/iosMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.ios.kt): `sharedLogic/src/iosMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.ios.kt`

### Other components

- **Payment user**
- **Payment backend**
- **Firestore**

## Connections

- Payment user → Send screen: enters payment (evidence: `README.md`)
- Android app shell → Send screen: routes to (evidence: `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/MainActivity.kt`)
- Android app shell → History screen: routes to (evidence: `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/MainActivity.kt`)
- Send screen → Payment view model: sends form actions (evidence: `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt`)
- Send screen → Amount input formatting: formats amount input (evidence: `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt`)
- Send screen → Minor-unit formatting: formats displayed amount (evidence: `androidApp/src/main/kotlin/com/emmanueliyke/cashipaymentapp/ui/PaymentScreen.kt`)
- Payment view model → Form and history state: updates state (evidence: `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/presentation/PaymentViewmodel.kt`)
- Payment view model → Payment validation: validates fields (evidence: `README.md`)
- Payment view model → Minor-unit formatting: parses amount (evidence: `README.md`)
- Payment view model → Payment request DTO: creates request (evidence: `README.md`)
- Payment view model → Payment API client: submits payment (evidence: `README.md`)
- Payment API client → Payment backend: posts payment (evidence: `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/network/PaymentApiClient.kt`)
- Payment view model → Payment and currency models: builds payment record (evidence: `README.md`)
- Payment view model → Payment repository contract: records and observes (evidence: `README.md`)
- Platform repository declaration → Payment repository contract: implements per platform (evidence: `sharedLogic/src/commonMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.kt`)
- Platform repository declaration → Android Firestore repository: has Android actual (evidence: `sharedLogic/src/androidMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.android.kt`)
- Platform repository declaration → iOS in-memory repository: has iOS actual (evidence: `README.md`)
- Android Firestore repository → Firestore: writes and listens (evidence: `sharedLogic/src/androidMain/kotlin/com/emmanueliyke/cashipaymentapp/data/FirebasePaymentRepository.android.kt`)
- Payment repository contract → Payment view model: streams transactions (evidence: `README.md`)
- Payment view model → History screen: provides live state (evidence: `README.md`)
- iOS app shell → Payment view model: uses shared logic
- iOS in-memory repository → Firestore: uses memory stand-in (evidence: `README.md`)
