# cjmaybe/nexpay architecture

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

- Interactive diagram: https://gitdiagram.com/cjmaybe/nexpay
- Repository: https://github.com/cjmaybe/nexpay

## Overview

Arivon UPI is an offline-first Android assistant for making *99# UPI payments over cellular USSD, including QR import, dual-SIM selection, session guidance, and local transaction history. The main flow is QR or manual payee entry, validation, USSD execution and response handling, then session status and transaction persistence. Separate branches cover balance enquiry, accessibility-assisted menu navigation, history export, onboarding, and settings. Sampled code confirms the core execution and storage links; some feature details are documented in the README but their implementations were not sampled.

Main entry points: [`app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/RealUssdManager.kt) (USSD manager), [`app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt) (App navigation), [`app/src/main/java/com/arivon/upi/data/TransactionRepository.kt`](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/TransactionRepository.kt) (Transaction repository), [`app/src/main/java/com/arivon/upi/util/UpiParser.kt`](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/UpiParser.kt) (UPI parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App and payment entry"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavHost.kt]"]
  node_home["Home screen<br/>[HomeScreen.kt]"]
  node_homevm["Home state<br/>[HomeViewModel.kt]"]
  node_qr["QR scanner<br/>[QRScannerScreen.kt]"]
  node_paymententry["Payment entry"]
  node_parser["UPI parser<br/>[UpiParser.kt]"]
  node_paymentvm["Payment state"]
end

subgraph group_ussd["USSD transaction"]
  node_session["Session screen<br/>[SessionScreen.kt]"]
  node_ussdmanager["USSD manager<br/>[RealUssdManager.kt]"]
  node_sessionstate["Session state"]
  node_sim["SIM manager<br/>[SimManager.kt]"]
  node_accessibility["USSD accessibility"]
  node_responseparser["Response parser"]
end

subgraph group_history["Local history"]
  node_historyscreen["History screen"]
  node_historyvm["History state"]
  node_repository["Transaction repository"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_dao["Transaction DAO<br/>[TransactionDao.kt]"]
  node_transaction["Transaction record<br/>[Transaction.kt]"]
  node_csv["CSV export<br/>[CsvExporter.kt]"]
end

subgraph group_support["Setup and preferences"]
  node_settings["Settings screen<br/>[SettingsScreen.kt]"]
  node_settingsvm["Settings state"]
  node_theme["Theme system<br/>[Theme.kt]"]
  node_onboarding["Onboarding guide"]
  node_manualguide["Manual dialing guide"]
end

node_user(("User"))
node_dialer["Phone dialer"]
node_camera["Device camera"]

node_user -->|"opens app"| node_activity
node_activity -->|"hosts"| node_navigation
node_navigation -->|"routes to"| node_home
node_navigation -->|"routes to"| node_qr
node_navigation -->|"routes to"| node_paymententry
node_navigation -->|"routes to"| node_session
node_navigation -->|"routes to"| node_historyscreen
node_navigation -->|"routes to"| node_settings
node_qr -.->|"scans with"| node_camera
node_qr -->|"validates QR data"| node_parser
node_paymententry -->|"validates payee"| node_parser
node_paymententry -->|"submits payment"| node_paymentvm
node_home -->|"reads state"| node_homevm
node_home -->|"starts payment"| node_ussdmanager
node_paymentvm -->|"starts payment"| node_ussdmanager
node_homevm -->|"validates payee"| node_parser
node_homevm -->|"checks SIM status"| node_sim
node_ussdmanager -->|"checks readiness"| node_sim
node_ussdmanager -->|"builds dial string"| node_parser
node_ussdmanager -->|"updates state"| node_sessionstate
node_ussdmanager -->|"parses response"| node_responseparser
node_ussdmanager -->|"records result"| node_repository
node_ussdmanager -->|"dials fallback"| node_dialer
node_accessibility -->|"reports response"| node_ussdmanager
node_session -->|"retries session"| node_ussdmanager
node_historyscreen -->|"reads history"| node_historyvm
node_historyvm -->|"queries and exports"| node_repository
node_historyvm -->|"exports CSV"| node_csv
node_repository -->|"delegates queries"| node_dao
node_database -->|"provides DAO"| node_dao
node_dao -->|"stores records"| node_transaction
node_settings -->|"updates preferences"| node_settingsvm
node_settings -->|"applies theme"| node_theme
node_settingsvm -->|"selects SIM"| node_sim
node_settingsvm -->|"deletes history"| node_repository
node_onboarding -.->|"explains setup"| node_user
node_manualguide -.->|"guides dialing"| node_user

click node_activity "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/MainActivity.kt"
click node_navigation "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt"
click node_home "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt"
click node_homevm "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt"
click node_qr "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/QRScannerScreen.kt"
click node_paymententry "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt"
click node_parser "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/UpiParser.kt"
click node_paymentvm "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/PaymentViewModel.kt"
click node_session "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/SessionScreen.kt"
click node_ussdmanager "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/RealUssdManager.kt"
click node_sessionstate "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/model/UssdSessionState.kt"
click node_sim "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/SimManager.kt"
click node_accessibility "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/USSDAccessibilityService.kt"
click node_responseparser "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/UssdResponseParser.kt"
click node_historyscreen "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/TransactionHistoryScreen.kt"
click node_historyvm "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt"
click node_repository "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/TransactionRepository.kt"
click node_database "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/AppDatabase.kt"
click node_dao "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/TransactionDao.kt"
click node_transaction "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/Transaction.kt"
click node_csv "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/CsvExporter.kt"
click node_settings "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt"
click node_settingsvm "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt"
click node_theme "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/theme/Theme.kt"
click node_onboarding "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/OnboardingScreen.kt"
click node_manualguide "https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/ManualUssdGuideScreen.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_navigation,node_home,node_homevm,node_qr,node_paymententry,node_parser,node_paymentvm,node_user toneBlue
class node_session,node_ussdmanager,node_sessionstate,node_sim,node_accessibility,node_responseparser toneAmber
class node_historyscreen,node_historyvm,node_repository,node_database,node_dao,node_transaction,node_csv toneMint
class node_settings,node_settingsvm,node_theme,node_onboarding,node_manualguide toneRose
class node_dialer,node_camera toneIndigo
```

## Components

### App and payment entry

- [Main activity](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/MainActivity.kt): `app/src/main/java/com/arivon/upi/MainActivity.kt`
- [App navigation](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt): `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`
- [Home screen](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt`
- [Home state](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt): `app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt`
- [QR scanner](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/QRScannerScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/QRScannerScreen.kt`
- [Payment entry](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt`
- [UPI parser](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/UpiParser.kt): `app/src/main/java/com/arivon/upi/util/UpiParser.kt`
- [Payment state](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/PaymentViewModel.kt): `app/src/main/java/com/arivon/upi/viewmodel/PaymentViewModel.kt`

### USSD transaction

- [Session screen](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/SessionScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/SessionScreen.kt`
- [USSD manager](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/RealUssdManager.kt): `app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`
- [Session state](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/model/UssdSessionState.kt): `app/src/main/java/com/arivon/upi/model/UssdSessionState.kt`
- [SIM manager](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/SimManager.kt): `app/src/main/java/com/arivon/upi/util/SimManager.kt`
- [USSD accessibility](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/USSDAccessibilityService.kt): `app/src/main/java/com/arivon/upi/service/USSDAccessibilityService.kt`
- [Response parser](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/service/UssdResponseParser.kt): `app/src/main/java/com/arivon/upi/service/UssdResponseParser.kt`

### Local history

- [History screen](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/TransactionHistoryScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/TransactionHistoryScreen.kt`
- [History state](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt): `app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt`
- [Transaction repository](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/TransactionRepository.kt): `app/src/main/java/com/arivon/upi/data/TransactionRepository.kt`
- [Room database](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/AppDatabase.kt): `app/src/main/java/com/arivon/upi/data/AppDatabase.kt`
- [Transaction DAO](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/TransactionDao.kt): `app/src/main/java/com/arivon/upi/data/TransactionDao.kt`
- [Transaction record](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/data/Transaction.kt): `app/src/main/java/com/arivon/upi/data/Transaction.kt`
- [CSV export](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/util/CsvExporter.kt): `app/src/main/java/com/arivon/upi/util/CsvExporter.kt`

### Setup and preferences

- [Settings screen](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt`
- [Settings state](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt): `app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt`
- [Theme system](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/theme/Theme.kt): `app/src/main/java/com/arivon/upi/ui/theme/Theme.kt`
- [Onboarding guide](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/OnboardingScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/OnboardingScreen.kt`
- [Manual dialing guide](https://github.com/cjmaybe/nexpay/blob/main/app/src/main/java/com/arivon/upi/ui/screens/ManualUssdGuideScreen.kt): `app/src/main/java/com/arivon/upi/ui/screens/ManualUssdGuideScreen.kt`

### Other components

- **User**
- **Phone dialer**
- **Device camera**

## Connections

- User → Main activity: opens app (evidence: `app/src/main/java/com/arivon/upi/MainActivity.kt`)
- Main activity → App navigation: hosts (evidence: `app/src/main/java/com/arivon/upi/MainActivity.kt`)
- App navigation → Home screen: routes to (evidence: `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`)
- App navigation → QR scanner: routes to (evidence: `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`)
- App navigation → Payment entry: routes to (evidence: `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`)
- App navigation → Session screen: routes to (evidence: `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`)
- App navigation → History screen: routes to (evidence: `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`)
- App navigation → Settings screen: routes to (evidence: `app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt`)
- QR scanner → Device camera: scans with
- QR scanner → UPI parser: validates QR data (evidence: `app/src/main/java/com/arivon/upi/ui/screens/QRScannerScreen.kt`)
- Payment entry → UPI parser: validates payee (evidence: `app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt`)
- Payment entry → Payment state: submits payment (evidence: `app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt`)
- Home screen → Home state: reads state (evidence: `app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt`)
- Home screen → USSD manager: starts payment (evidence: `app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt`)
- Payment state → USSD manager: starts payment (evidence: `app/src/main/java/com/arivon/upi/viewmodel/PaymentViewModel.kt`)
- Home state → UPI parser: validates payee (evidence: `app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt`)
- Home state → SIM manager: checks SIM status (evidence: `app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt`)
- USSD manager → SIM manager: checks readiness (evidence: `app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`)
- USSD manager → UPI parser: builds dial string (evidence: `app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`)
- USSD manager → Session state: updates state (evidence: `app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`)
- USSD manager → Response parser: parses response (evidence: `app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`)
- USSD manager → Transaction repository: records result (evidence: `app/src/main/java/com/arivon/upi/service/RealUssdManager.kt`)
- USSD manager → Phone dialer: dials fallback
- USSD accessibility → USSD manager: reports response (evidence: `app/src/main/java/com/arivon/upi/service/USSDAccessibilityService.kt`)
- Session screen → USSD manager: retries session (evidence: `app/src/main/java/com/arivon/upi/ui/screens/SessionScreen.kt`)
- History screen → History state: reads history (evidence: `app/src/main/java/com/arivon/upi/ui/screens/TransactionHistoryScreen.kt`)
- History state → Transaction repository: queries and exports (evidence: `app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt`)
- History state → CSV export: exports CSV (evidence: `app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt`)
- Transaction repository → Transaction DAO: delegates queries (evidence: `app/src/main/java/com/arivon/upi/data/TransactionRepository.kt`)
- Room database → Transaction DAO: provides DAO (evidence: `app/src/main/java/com/arivon/upi/data/AppDatabase.kt`)
- Transaction DAO → Transaction record: stores records (evidence: `app/src/main/java/com/arivon/upi/data/TransactionDao.kt`)
- Settings screen → Settings state: updates preferences (evidence: `app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt`)
- Settings screen → Theme system: applies theme (evidence: `app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt`)
- Settings state → SIM manager: selects SIM (evidence: `app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt`)
- Settings state → Transaction repository: deletes history (evidence: `app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt`)
- Onboarding guide → User: explains setup
- Manual dialing guide → User: guides dialing
