How dilithegit/mahari works
Mahari is an offline-first Android M-Pesa finance app: SMS capture and backfill feed parsed, categorized transactions into local storage, which power dashboard, budget, search, and recap features. Sharing and privacy controls complement the core workflow; opt-in cloud sync sends structured transactions to a FastAPI service for encrypted storage and ML insights. The Android implementation was not excerpted, so its relationships below rely on README statements; backend call relationships are directly visible in the sampled backend source.
Main entry points: DashboardViewModel.kt Dashboard calculations · main.py Sync API · RecapMlEngine.kt On-device recap · MpesaParser.kt M-Pesa parser
Components 23
Transaction Capture
- SMS receiver
app/src/main/java/com/example/mahari/data/receiver/SmsReceiver.kt - SMS backfill
app/src/main/java/com/example/mahari/data/parser/SmsBackfillManager.kt - M-Pesa parser
app/src/main/java/com/example/mahari/data/parser/MpesaParser.kt - Transaction categorizer
app/src/main/java/com/example/mahari/data/categorizer/Categorizer.kt
Local Finance Data
- Transaction repository
app/src/main/java/com/example/mahari/data/repository/TransactionRepository.kt - Room database
app/src/main/java/com/example/mahari/data/db/MahariDatabase.kt
Financial Insights
- Budget engine
app/src/main/java/com/example/mahari/data/budget/BudgetEngine.kt - On-device recap
app/src/main/java/com/example/mahari/data/recap/RecapMlEngine.kt - Statistical recap
app/src/main/java/com/example/mahari/data/recap/StatisticalRecapEngine.kt - Financial score
app/src/main/java/com/example/mahari/data/recap/FinancialScoreEngine.kt
App Experience
- Dashboard
app/src/main/java/com/example/mahari/ui/dashboard/DashboardScreen.kt - Dashboard calculations
app/src/main/java/com/example/mahari/ui/dashboard/DashboardViewModel.kt - Transaction search
app/src/main/java/com/example/mahari/data/nlp/NlpSearchEngine.kt - Image sharing
app/src/main/java/com/example/mahari/ui/share/ShareDashboardDialog.kt - CSV export
app/src/main/java/com/example/mahari/data/export/CsvExporter.kt - App security
app/src/main/java/com/example/mahari/data/security/SecurityManager.kt
Optional Cloud
- Sync API
mahari_backend/main.py - Cloud ML analysis
mahari_backend/ml_engine.py - Encrypted file storage
mahari_backend/security.py
Other components
- Mahari user
- M-Pesa SMS
- Android device inbox
- Syncing device
Connections 22
- M-Pesa SMS → SMS receiver: delivers alert
README.md - Android device inbox → SMS backfill: provides SMS history
README.md - SMS receiver → M-Pesa parser: parses message
- SMS backfill → M-Pesa parser: parses history
README.md - M-Pesa parser → Transaction categorizer: categorizes transactions
README.md - Transaction categorizer → Transaction repository: records transactions
- Transaction repository → Room database: persists transactions
- Mahari user → Dashboard: views finances
README.md - Dashboard → Dashboard calculations: requests calculations
- Dashboard calculations → Transaction repository: loads transactions
- Dashboard calculations → Budget engine: calculates budgets
- Dashboard calculations → On-device recap: builds recap
- On-device recap → Statistical recap: uses statistics
- On-device recap → Financial score: calculates score
- Mahari user → Transaction search: searches transactions
README.md - Mahari user → Image sharing: shares dashboard
README.md - Mahari user → CSV export: exports data
- Mahari user → App security: authenticates
README.md - Syncing device → Sync API: syncs structured data
README.md - Sync API → Encrypted file storage: stores encrypted data
mahari_backend/main.py - Sync API → Cloud ML analysis: analyzes transactions
mahari_backend/main.py - Syncing device → Sync API: requests data deletion
README.md