How cjmaybe/nexpay works
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: RealUssdManager.kt USSD manager · AppNavHost.kt App navigation · TransactionRepository.kt Transaction repository · UpiParser.kt UPI parser
Components 29
App and payment entry
- Main activity
app/src/main/java/com/arivon/upi/MainActivity.kt - App navigation
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - Home screen
app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt - Home state
app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt - QR scanner
app/src/main/java/com/arivon/upi/ui/screens/QRScannerScreen.kt - Payment entry
app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt - UPI parser
app/src/main/java/com/arivon/upi/util/UpiParser.kt - Payment state
app/src/main/java/com/arivon/upi/viewmodel/PaymentViewModel.kt
USSD transaction
- Session screen
app/src/main/java/com/arivon/upi/ui/screens/SessionScreen.kt - USSD manager
app/src/main/java/com/arivon/upi/service/RealUssdManager.kt - Session state
app/src/main/java/com/arivon/upi/model/UssdSessionState.kt - SIM manager
app/src/main/java/com/arivon/upi/util/SimManager.kt - USSD accessibility
app/src/main/java/com/arivon/upi/service/USSDAccessibilityService.kt - Response parser
app/src/main/java/com/arivon/upi/service/UssdResponseParser.kt
Local history
- History screen
app/src/main/java/com/arivon/upi/ui/screens/TransactionHistoryScreen.kt - History state
app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt - Transaction repository
app/src/main/java/com/arivon/upi/data/TransactionRepository.kt - Room database
app/src/main/java/com/arivon/upi/data/AppDatabase.kt - Transaction DAO
app/src/main/java/com/arivon/upi/data/TransactionDao.kt - Transaction record
app/src/main/java/com/arivon/upi/data/Transaction.kt - CSV export
app/src/main/java/com/arivon/upi/util/CsvExporter.kt
Setup and preferences
- Settings screen
app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt - Settings state
app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt - Theme system
app/src/main/java/com/arivon/upi/ui/theme/Theme.kt - Onboarding guide
app/src/main/java/com/arivon/upi/ui/screens/OnboardingScreen.kt - Manual dialing guide
app/src/main/java/com/arivon/upi/ui/screens/ManualUssdGuideScreen.kt
Other components
- User
- Phone dialer
- Device camera
Connections 37
- User → Main activity: opens app
app/src/main/java/com/arivon/upi/MainActivity.kt - Main activity → App navigation: hosts
app/src/main/java/com/arivon/upi/MainActivity.kt - App navigation → Home screen: routes to
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - App navigation → QR scanner: routes to
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - App navigation → Payment entry: routes to
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - App navigation → Session screen: routes to
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - App navigation → History screen: routes to
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - App navigation → Settings screen: routes to
app/src/main/java/com/arivon/upi/ui/navigation/AppNavHost.kt - QR scanner → Device camera: scans with
- QR scanner → UPI parser: validates QR data
app/src/main/java/com/arivon/upi/ui/screens/QRScannerScreen.kt - Payment entry → UPI parser: validates payee
app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt - Payment entry → Payment state: submits payment
app/src/main/java/com/arivon/upi/ui/screens/PaymentEntryScreen.kt - Home screen → Home state: reads state
app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt - Home screen → USSD manager: starts payment
app/src/main/java/com/arivon/upi/ui/screens/HomeScreen.kt - Payment state → USSD manager: starts payment
app/src/main/java/com/arivon/upi/viewmodel/PaymentViewModel.kt - Home state → UPI parser: validates payee
app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt - Home state → SIM manager: checks SIM status
app/src/main/java/com/arivon/upi/viewmodel/HomeViewModel.kt - USSD manager → SIM manager: checks readiness
app/src/main/java/com/arivon/upi/service/RealUssdManager.kt - USSD manager → UPI parser: builds dial string
app/src/main/java/com/arivon/upi/service/RealUssdManager.kt - USSD manager → Session state: updates state
app/src/main/java/com/arivon/upi/service/RealUssdManager.kt - USSD manager → Response parser: parses response
app/src/main/java/com/arivon/upi/service/RealUssdManager.kt - USSD manager → Transaction repository: records result
app/src/main/java/com/arivon/upi/service/RealUssdManager.kt - USSD manager → Phone dialer: dials fallback
- USSD accessibility → USSD manager: reports response
app/src/main/java/com/arivon/upi/service/USSDAccessibilityService.kt - Session screen → USSD manager: retries session
app/src/main/java/com/arivon/upi/ui/screens/SessionScreen.kt - History screen → History state: reads history
app/src/main/java/com/arivon/upi/ui/screens/TransactionHistoryScreen.kt - History state → Transaction repository: queries and exports
app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt - History state → CSV export: exports CSV
app/src/main/java/com/arivon/upi/viewmodel/HistoryViewModel.kt - Transaction repository → Transaction DAO: delegates queries
app/src/main/java/com/arivon/upi/data/TransactionRepository.kt - Room database → Transaction DAO: provides DAO
app/src/main/java/com/arivon/upi/data/AppDatabase.kt - Transaction DAO → Transaction record: stores records
app/src/main/java/com/arivon/upi/data/TransactionDao.kt - Settings screen → Settings state: updates preferences
app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt - Settings screen → Theme system: applies theme
app/src/main/java/com/arivon/upi/ui/screens/SettingsScreen.kt - Settings state → SIM manager: selects SIM
app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt - Settings state → Transaction repository: deletes history
app/src/main/java/com/arivon/upi/viewmodel/SettingsViewModel.kt - Onboarding guide → User: explains setup
- Manual dialing guide → User: guides dialing