commit 79741192b96a8549e4aa36f93a3b99482f1d7fbe Author: ngenohkevin Date: Sat Mar 21 20:53:59 2026 +0300 Initial release — Ledga M-Pesa spending tracker Complete Android app (Kotlin/Jetpack Compose) with: - SMS parser for all 17 M-Pesa transaction types - Room database with auto-categorization engine - Real-time SMS capture via BroadcastReceiver - Onboarding flow with SMS history import - Home dashboard with balance, spending, donut chart - Transactions list with search, filters, day grouping - Trends screen with Vico bar charts, top merchants - Budget system with progress tracking - Transaction detail sheet with re-categorization - Notifications (daily/weekly summaries, budget alerts) - Google Drive backup & restore - Manual export/import (CSV + JSON ZIP) - Self-update system via GitHub Releases API - Theme system (System/Light/Dark) + font scaling - Adaptive app icon with splash screen - GitHub Actions CI/CD for release APK builds diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..2c3e564 --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,67 @@ +name: Build & Release APK + +on: + push: + tags: + - 'v*' + +jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v4 + + - name: Set up JDK 17 + uses: actions/setup-java@v4 + with: + java-version: '17' + distribution: 'temurin' + + - name: Setup Gradle + uses: gradle/actions/setup-gradle@v4 + + - name: Decode keystore + run: echo "${{ secrets.KEYSTORE_BASE64 }}" | base64 -d > keystore/ledga-release.jks + shell: bash + + - name: Build release APK + env: + KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }} + KEY_ALIAS: ${{ secrets.KEY_ALIAS }} + KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }} + run: | + mkdir -p keystore + echo "${{ secrets.KEYSTORE_BASE64 }}" | base64 -d > keystore/ledga-release.jks + ./gradlew assembleRelease + + - name: Rename APK + run: | + VERSION=${GITHUB_REF_NAME#v} + mv app/build/outputs/apk/release/app-release.apk app/build/outputs/apk/release/ledga-v${VERSION}.apk + + - name: Create GitHub Release + uses: softprops/action-gh-release@v2 + with: + files: app/build/outputs/apk/release/ledga-*.apk + generate_release_notes: true + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} + + test: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v4 + + - name: Set up JDK 17 + uses: actions/setup-java@v4 + with: + java-version: '17' + distribution: 'temurin' + + - name: Setup Gradle + uses: gradle/actions/setup-gradle@v4 + + - name: Run tests + run: ./gradlew testDebugUnitTest diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..f0f2dd9 --- /dev/null +++ b/.gitignore @@ -0,0 +1,19 @@ +*.iml +.gradle +/local.properties +local.properties +keystore/ +/.idea +.idea/ +.DS_Store +/build +build/ +/captures +.externalNativeBuild +.cxx +*.apk +*.ap_ +*.dex +*.class +.kotlin/ +.claude/ diff --git a/PROJECT_PLAN.md b/PROJECT_PLAN.md new file mode 100644 index 0000000..bc2c901 --- /dev/null +++ b/PROJECT_PLAN.md @@ -0,0 +1,746 @@ +# Ledga — M-Pesa Spending Tracker + +## Overview + +A native Android app that automatically tracks M-Pesa spending by reading SMS confirmations. Zero manual entry — install, grant SMS permission, done. Built for non-technical users with a clean, Canva-like UI. + +**Target users:** Family members (all Android), non-technical +**Distribution:** Direct APK install + in-app self-updates via GitHub Releases (no Play Store) +**Data model:** Fully offline, local-only per device. No accounts, no server. + +--- + +## Tech Stack + +| Component | Technology | +|-----------|------------| +| Language | Kotlin | +| UI Framework | Jetpack Compose + Material 3 | +| Local Database | Room (SQLite) | +| Background SMS | BroadcastReceiver + WorkManager | +| DI | Hilt (dependency injection) | +| Settings Storage | Jetpack DataStore (Preferences) | +| Charts | Vico (Compose-native charting library) | +| Notifications | Android NotificationManager + AlarmManager | +| Backup | Google Drive API (auto), manual file export | +| Self-Update | GitHub Releases API | +| Min SDK | API 26 (Android 8.0) | +| Build | Gradle (Kotlin DSL) | + +--- + +## Architecture + +``` +┌─────────────────────────────────────────────┐ +│ UI Layer │ +│ Jetpack Compose + Material 3 │ +│ ┌──────┐ ┌──────────┐ ┌──────┐ ┌────────┐ │ +│ │ Home │ │Transactions│ │Trends│ │Settings│ │ +│ └──────┘ └──────────┘ └──────┘ └────────┘ │ +├─────────────────────────────────────────────┤ +│ ViewModel Layer │ +│ StateFlow + Coroutines │ +├─────────────────────────────────────────────┤ +│ Repository Layer │ +│ TransactionRepo │ CategoryRepo │ │ +│ SettingsRepo │ BackupRepo │ │ +├─────────────────────────────────────────────┤ +│ Data Layer │ +│ ┌──────┐ ┌───────────┐ ┌─────────────┐ │ +│ │ Room │ │SMS Parser │ │Google Drive │ │ +│ │ DB │ │ │ │ Backup │ │ +│ └──────┘ └───────────┘ └─────────────┘ │ +├─────────────────────────────────────────────┤ +│ System Services │ +│ SMS BroadcastReceiver │ WorkManager │ +│ NotificationManager │ AlarmManager │ +└─────────────────────────────────────────────┘ +``` + +--- + +## SMS Parsing + +### Sender Filter +Only process SMS from sender: `MPESA` + +### Transaction Types & Patterns + +**1. Send Money** +``` +RK31B7X4ZQ Confirmed. Ksh500.00 sent to JOHN DOE 0712345678 on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh1,200.00. Transaction cost, Ksh0.00. +``` +→ Extract: code, amount, recipient name, recipient phone, date/time, balance, cost + +**2. Buy Goods (Till)** +``` +RK31B7X4ZQ Confirmed. Ksh1,200.00 paid to NAIVAS SUPERMARKET. on 21/3/26 at 2:15 PM.New M-PESA balance is Ksh3,500.00. Transaction cost, Ksh0.00. +``` +→ Extract: code, amount, merchant name, date/time, balance, cost + +**3. Pay Bill** +``` +RK31B7X4ZQ Confirmed. Ksh2,500.00 paid to KPLC PREPAID. Account Number 12345678. on 21/3/26 at 3:00 PM. New M-PESA balance is Ksh1,000.00. Transaction cost, Ksh0.00. +``` +→ Extract: code, amount, business name, account number, date/time, balance, cost + +**4. Withdraw (Agent)** +``` +RK31B7X4ZQ Confirmed.You have withdrawn Ksh1,000.00 from JAMES AGENT 543210 on 21/3/26 at 4:00 PM.New M-PESA balance is Ksh500.00. Transaction cost, Ksh28.00. +``` +→ Extract: code, amount, agent name, agent number, date/time, balance, cost + +**5. Withdraw (ATM)** +``` +RK31B7X4ZQ Confirmed. You have withdrawn Ksh5,000.00 from an ATM on 21/3/26 at 4:30 PM. New M-PESA balance is Ksh2,000.00. Transaction cost, Ksh34.00. +``` +→ Extract: code, amount, date/time, balance, cost +→ Note: No agent name/number — just "from an ATM" + +**6. Deposit** +``` +RK31B7X4ZQ Confirmed.You have deposited Ksh5,000.00 to your M-PESA account on 21/3/26 at 10:00 AM.New M-PESA balance is Ksh5,500.00. +``` +→ Extract: code, amount, date/time, balance + +**7. Received Money** +``` +RK31B7X4ZQ Confirmed.You have received Ksh2,000.00 from JANE DOE 0798765432 on 21/3/26 at 11:00 AM.New M-PESA balance is Ksh7,500.00. +``` +→ Extract: code, amount, sender name, sender phone, date/time, balance + +**8. Airtime Purchase (Self)** +``` +RK31B7X4ZQ Confirmed. Ksh100.00 of airtime purchased on 21/3/26 at 12:00 PM.New M-PESA balance is Ksh7,400.00. Transaction cost, Ksh0.00. +``` +→ Extract: code, amount, date/time, balance, cost + +**9. Airtime Purchase (For Others)** +``` +RK31B7X4ZQ Confirmed. You bought Ksh100.00 of airtime for 0712345678 on 21/3/26 at 12:30 PM.New M-PESA balance is Ksh7,300.00. Transaction cost, Ksh0.00. +``` +→ Extract: code, amount, recipient phone, date/time, balance, cost + +**10. M-Pesa Global (International Transfer)** +``` +RK31B7X4ZQ Confirmed. Ksh5,000.00 sent to JOHN DOE +44712345678 (United Kingdom) via M-PESA Global on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh10,000.00. Transaction cost, Ksh150.00. +``` +→ Extract: code, amount, recipient name, recipient phone (international), destination country, date/time, balance, cost + +**11. Fuliza (Borrow)** +``` +RK31B7X4ZQ Confirmed. Ksh500.00 sent to JOHN DOE 0712345678 on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh0.00. Fuliza M-PESA amount is Ksh500.00. Fuliza M-PESA outstanding amount is Ksh500.00. +``` +→ Extract: all standard fields + fuliza amount, fuliza outstanding + +**12. Fuliza Repayment** +``` +RK31B7X4ZQ Confirmed. You have paid Ksh200.00 to Fuliza M-PESA on 21/3/26 at 2:00 PM. Fuliza M-PESA outstanding amount is Ksh300.00. +``` +→ Extract: code, amount, date/time, fuliza outstanding + +**13. Fuliza Reversal** +``` +RK31B7X4ZQ Confirmed. Fuliza M-PESA of Ksh500.00 has been reversed on 21/3/26 at 3:00 PM. Fuliza M-PESA outstanding amount is Ksh0.00. +``` +→ Extract: code, amount, date/time, fuliza outstanding + +**14. Reversal** +``` +RK31B7X4ZQ Confirmed. Transaction RJ12345678 has been reversed. Your account balance is Ksh2,000.00. +``` +→ Extract: code, reversed transaction code, balance + +### M-Shwari & KCB M-Pesa (Acknowledged, Not Parsed) + +These services send SMS from the `MPESA` sender but are savings/loan products, not spending transactions: +- **M-Shwari:** `Confirmed. Ksh1,000.00 transferred to M-Shwari account...` / `Ksh1,000.00 transferred from M-Shwari...` +- **KCB M-Pesa:** `Confirmed. Ksh2,000.00 transferred to KCB M-Pesa account...` / loan disbursements + +**Strategy:** Detect these by keywords ("M-Shwari", "KCB M-Pesa") and store with type `MSHWARI` or `KCB_MPESA`. Show them in the transaction list but don't count them as spending. They're internal transfers between M-Pesa wallet and savings/loan products. + +### Parser Strategy +- Regex-based pattern matching per transaction type +- Keyword detection: "sent to", "paid to", "withdrawn.*from.*AGENT" (agent), "withdrawn.*from an ATM" (ATM), "deposited", "received", "airtime purchased", "bought.*airtime for", "M-PESA Global", "reversed", "Fuliza M-PESA amount", "paid to Fuliza", "Fuliza M-PESA of", "M-Shwari", "KCB M-Pesa" +- Amount extraction: `Ksh[\d,]+\.\d{2}` pattern +- Date extraction: `\d{1,2}/\d{1,2}/\d{2,4} at \d{1,2}:\d{2} [AP]M` +- International phone detection: `\+\d{7,15}` pattern (for M-Pesa Global) +- Country extraction: text in parentheses after international phone number +- Fallback: store unparsed M-Pesa SMS with type `UNKNOWN` for later parsing improvements + +--- + +## Database Schema (Room) + +### transactions +| Column | Type | Description | +|--------|------|-------------| +| id | Long (PK, auto) | Primary key | +| transactionCode | String (unique) | M-Pesa transaction code | +| type | Enum | SEND, BUY_GOODS, PAY_BILL, WITHDRAW_AGENT, WITHDRAW_ATM, DEPOSIT, RECEIVED, AIRTIME_SELF, AIRTIME_OTHER, MPESA_GLOBAL, FULIZA, FULIZA_REPAYMENT, FULIZA_REVERSAL, MSHWARI, KCB_MPESA, REVERSAL, UNKNOWN | +| amount | Double | Transaction amount in Ksh | +| transactionCost | Double | M-Pesa fee | +| recipientName | String? | Name of recipient/merchant | +| recipientPhone | String? | Phone number (if person) | +| accountNumber | String? | Account number (paybill) | +| destinationCountry | String? | Country name for M-Pesa Global transfers | +| balance | Double | M-Pesa balance after transaction | +| direction | Enum | INFLOW, OUTFLOW (derived at parse time — simplifies totals/chart queries) | +| categoryId | Long? (FK) | Assigned category | +| fulizaAmount | Double? | Fuliza amount (if applicable) | +| fulizaOutstanding | Double? | Fuliza outstanding (if applicable) | +| rawSms | String | Original SMS text (for re-parsing) | +| timestamp | Long | Transaction timestamp (epoch ms) | +| createdAt | Long | Record creation time | + +### categories +| Column | Type | Description | +|--------|------|-------------| +| id | Long (PK, auto) | Primary key | +| name | String | Category name | +| icon | String | Material icon name | +| color | String | Hex color code | +| isDefault | Boolean | System default vs user-created | + +### budgets +| Column | Type | Description | +|--------|------|-------------| +| id | Long (PK, auto) | Primary key | +| categoryId | Long? (FK) | Null = overall budget | +| monthlyLimit | Double | Budget limit in Ksh | +| isActive | Boolean | Whether alerts are enabled | + +### category_rules +| Column | Type | Description | +|--------|------|-------------| +| id | Long (PK, auto) | Primary key | +| categoryId | Long (FK) | Target category | +| matchType | Enum | RECIPIENT_NAME, PHONE, TILL, PAYBILL | +| matchValue | String | Value to match | + +### Default Categories +| Category | Icon | Color | Auto-match examples | +|----------|------|-------|---------------------| +| Groceries | shopping_cart | #4CAF50 | NAIVAS, QUICKMART, CARREFOUR | +| Transport | directions_car | #2196F3 | Uber, Bolt, matatu paybills | +| Bills & Utilities | receipt | #FF9800 | KPLC, NAIROBI WATER, DSTV | +| Airtime & Data | phone_android | #9C27B0 | Airtime purchases | +| Food & Dining | restaurant | #E91E63 | Restaurants, fast food | +| Send Money | person | #607D8B | Person-to-person transfers | +| Received | account_balance_wallet | #00BCD4 | Money received | +| Withdrawal | atm | #795548 | Agent withdrawals | +| Deposit | savings | #8BC34A | Cash deposits | +| Shopping | shopping_bag | #FF5722 | General merchants | +| International | public | #3F51B5 | M-Pesa Global transfers | +| Savings & Loans | account_balance | #009688 | M-Shwari, KCB M-Pesa | +| Other | category | #9E9E9E | Uncategorized | + +--- + +## Screens & UI + +### Design System +- **Color palette:** M-Pesa green (#4CAF50) as primary, warm neutrals, category-specific accent colors +- **Typography:** System font, scalable (Small/Medium/Large/Extra Large + System Default) +- **Cards:** Rounded corners (16dp), subtle elevation, clean spacing +- **Animations:** Smooth transitions between screens, animated chart loading +- **Dark mode:** Full dark theme, follows system by default with manual override + +### 1. Home Dashboard +``` +┌─────────────────────────────────┐ +│ Good morning 👋 │ +│ │ +│ M-PESA Balance │ +│ Ksh 12,500.00 │ +│ (from last transaction) │ +│ │ +│ ┌─────────────────────────┐ │ +│ │ March 2026 │ │ +│ │ Spent: Ksh 45,200 │ │ +│ │ ▼ 12% vs last month │ │ +│ │ Fees: Ksh 320 │ │ +│ └─────────────────────────┘ │ +│ │ +│ [Today] [This Week] [Month] │ +│ │ +│ ┌─────────────────────────┐ │ +│ │ 🍩 Donut Chart │ │ +│ │ Category Breakdown │ │ +│ └─────────────────────────┘ │ +│ │ +│ Recent Transactions │ +│ ┌─────────────────────────┐ │ +│ │ 🛒 Naivas -Ksh 1,200 │ │ +│ │ 📱 Airtime -Ksh 100 │ │ +│ │ 💰 Received +Ksh 5,000 │ │ +│ └─────────────────────────┘ │ +│ │ +│ ┌────┐┌────┐┌────┐┌────┐ │ +│ │Home││List││Stats││ ⚙️ │ │ +│ └────┘└────┘└────┘└────┘ │ +└─────────────────────────────────┘ +``` + +> **Balance display:** Shows the `balance` field from the most recent transaction. This is the last known M-Pesa balance — not a live query. Labeled "from last transaction" so users don't confuse it with a real-time check. + +### 2. Transactions List +- Grouped by day with day totals +- Each item: category icon + recipient/merchant + amount (red spent, green received) +- Search bar at top +- Filter chips: All, Sent, Received, Bills, Goods, Withdraw +- Tap → transaction detail bottom sheet +- Long press → change category + +### 3. Trends / Analytics +- Bar chart: daily spending for current month +- Line chart: monthly spending over time +- Top 5 recipients/merchants list +- Category comparison vs previous period +- **Transaction fees summary** — total fees paid this period (most people don't realize how much they spend on M-Pesa fees) +- Period selector: 7D / 30D / 90D / 1Y + +### 4. Settings +``` +Appearance + ├── Theme: System / Light / Dark + └── Font Size: System Default / Small / Medium / Large / Extra Large + +Notifications + ├── Daily Summary: ON/OFF + time picker + ├── Weekly Summary: ON/OFF + ├── Budget Alerts: ON/OFF + └── Large Transaction Alert: ON/OFF + threshold (Ksh) + +Budgets + ├── Overall Monthly Budget: Ksh ___ + └── Per Category: [list of categories with limits] + +Data + ├── Import SMS History + ├── Export Data (CSV/JSON) + ├── Unparsed Messages (X) — view SMS that failed to parse + └── Clear All Data (with confirmation) + +Backup + ├── Auto Backup: ON/OFF + ├── Backup Frequency: Daily / Weekly + ├── Google Account: shown + ├── Last Backup: date + ├── Back Up Now + └── Restore from Backup + +About + ├── Version: 1.0.0 + ├── Check for Updates + └── What's New +``` + +--- + +## Notification System + +| Notification | Trigger | Default | +|-------------|---------|---------| +| Daily Summary | Scheduled (user picks time, default 8 PM) | ON | +| Weekly Summary | Every Sunday evening | ON | +| Budget Warning | 80% of budget reached | ON | +| Budget Exceeded | 100% of budget reached | ON | +| Large Transaction | Single transaction > threshold | OFF (default Ksh 5,000) | + +Implementation: +- WorkManager for periodic summary jobs +- Immediate check on each new transaction for budget/large amount alerts +- NotificationChannel: "Spending Summaries", "Budget Alerts" + +--- + +## Backup System + +### Google Drive Auto-Backup +- Uses Google Sign-In (already on every Android phone) +- Backs up Room database + settings to app-specific Google Drive folder +- No extra permissions needed (app data folder is automatic) +- Frequency: daily or weekly (user choice) +- On fresh install: detect existing backup → prompt restore + +### Manual Export/Import +- Export: generates a ZIP file containing: + - `transactions.csv` — human-readable, can open in Excel + - `data.json` — full database export for app restore +- Import: select ZIP file → restore all data +- Share via WhatsApp, Bluetooth, email, etc. + +### SMS Re-import (Fallback) +- Scan all existing SMS from "MPESA" sender +- Parse and import, skipping duplicates (by transaction code) +- Progress indicator during import + +--- + +## Self-Update System + +### Flow +1. App checks GitHub Releases API on launch (max once per day) +2. Compares current version with latest release tag +3. If newer version exists: + - Shows non-intrusive banner: "Update available (v1.2.0)" + - Tap → shows changelog (from release notes) + - "Download & Install" button +4. Downloads APK to app cache +5. Triggers Android package installer intent +6. User confirms install (standard Android prompt) + +### GitHub Release Format +``` +Tag: v1.0.0 +Title: Version 1.0.0 +Body: Changelog in markdown +Asset: ledga-v1.0.0.apk +``` + +### Endpoint +``` +GET https://api.github.com/repos/{owner}/{repo}/releases/latest +``` + +--- + +## Auto-Categorization + +### Rule Engine (Priority Order) +1. **User rules** — if user manually categorized a merchant before, remember it +2. **Category rules table** — pattern matching on recipient name, till number, paybill +3. **Transaction type fallback** — airtime → Airtime, withdrawal → Withdrawal, etc. +4. **Default** — "Other" category + +### Pre-loaded Rules +| Pattern | Match Type | Category | +|---------|------------|----------| +| NAIVAS, QUICKMART, CARREFOUR, CLEANSHELF | Recipient | Groceries | +| KPLC, KENYA POWER | Recipient | Bills | +| 888880 (KPLC Prepaid), 888888 (KPLC Postpaid) | Paybill | Bills | +| NAIROBI WATER, ELDORET WATER | Recipient | Bills | +| 444400 (Nairobi Water) | Paybill | Bills | +| DSTV, GOTV, SHOWMAX | Recipient | Bills | +| UBER, BOLT, LITTLE | Recipient | Transport | +| JAVA, KFC, CHICKEN INN, PIZZA INN | Recipient | Food & Dining | +| (any self airtime) | Type | Airtime | +| (any airtime for others) | Type | Airtime | +| (any withdrawal) | Type | Withdrawal | +| (any deposit) | Type | Deposit | +| (any received) | Type | Received | +| (any send money) | Type | Send Money | +| (any M-Pesa Global) | Type | International | +| (any M-Shwari) | Type | Savings & Loans | +| (any KCB M-Pesa) | Type | Savings & Loans | + +Users can add/edit rules from the category settings. + +--- + +## Permissions Required + +| Permission | Purpose | When Requested | +|-----------|---------|----------------| +| RECEIVE_SMS | Listen for new M-Pesa SMS in real-time | On first launch | +| READ_SMS | Import existing M-Pesa SMS history | When user taps "Import History" | +| POST_NOTIFICATIONS | Daily summaries, budget alerts | On first launch (Android 13+) | +| INTERNET | Google Drive backup, update checks | Automatic | +| REQUEST_INSTALL_PACKAGES | Self-update APK installation | When user taps "Install Update" | + +--- + +## Project Structure + +``` +ledga/ +├── app/ +│ ├── src/ +│ │ ├── main/ +│ │ │ ├── java/com/ledga/app/ +│ │ │ │ ├── MainActivity.kt +│ │ │ │ ├── LedgaApp.kt +│ │ │ │ ├── di/ +│ │ │ │ │ ├── AppModule.kt +│ │ │ │ │ └── DatabaseModule.kt +│ │ │ │ ├── data/ +│ │ │ │ │ ├── db/ +│ │ │ │ │ │ ├── AppDatabase.kt +│ │ │ │ │ │ ├── Migrations.kt +│ │ │ │ │ │ ├── dao/ +│ │ │ │ │ │ │ ├── TransactionDao.kt +│ │ │ │ │ │ │ ├── CategoryDao.kt +│ │ │ │ │ │ │ └── BudgetDao.kt +│ │ │ │ │ │ └── entity/ +│ │ │ │ │ │ ├── Transaction.kt +│ │ │ │ │ │ ├── Category.kt +│ │ │ │ │ │ ├── Budget.kt +│ │ │ │ │ │ └── CategoryRule.kt +│ │ │ │ │ ├── repository/ +│ │ │ │ │ │ ├── TransactionRepository.kt +│ │ │ │ │ │ ├── CategoryRepository.kt +│ │ │ │ │ │ └── SettingsRepository.kt +│ │ │ │ │ └── parser/ +│ │ │ │ │ └── MpesaSmsParser.kt +│ │ │ │ ├── receiver/ +│ │ │ │ │ └── SmsReceiver.kt +│ │ │ │ ├── worker/ +│ │ │ │ │ ├── NotificationWorker.kt +│ │ │ │ │ ├── BackupWorker.kt +│ │ │ │ │ └── UpdateCheckWorker.kt +│ │ │ │ ├── ui/ +│ │ │ │ │ ├── theme/ +│ │ │ │ │ │ ├── Theme.kt +│ │ │ │ │ │ ├── Color.kt +│ │ │ │ │ │ └── Type.kt +│ │ │ │ │ ├── navigation/ +│ │ │ │ │ │ └── AppNavigation.kt +│ │ │ │ │ ├── onboarding/ +│ │ │ │ │ │ ├── OnboardingScreen.kt +│ │ │ │ │ │ └── OnboardingViewModel.kt +│ │ │ │ │ ├── home/ +│ │ │ │ │ │ ├── HomeScreen.kt +│ │ │ │ │ │ └── HomeViewModel.kt +│ │ │ │ │ ├── transactions/ +│ │ │ │ │ │ ├── TransactionsScreen.kt +│ │ │ │ │ │ ├── TransactionDetailSheet.kt +│ │ │ │ │ │ └── TransactionsViewModel.kt +│ │ │ │ │ ├── trends/ +│ │ │ │ │ │ ├── TrendsScreen.kt +│ │ │ │ │ │ └── TrendsViewModel.kt +│ │ │ │ │ ├── settings/ +│ │ │ │ │ │ ├── SettingsScreen.kt +│ │ │ │ │ │ ├── SettingsViewModel.kt +│ │ │ │ │ │ └── UnparsedSmsScreen.kt +│ │ │ │ │ └── components/ +│ │ │ │ │ ├── TransactionCard.kt +│ │ │ │ │ ├── CategoryChip.kt +│ │ │ │ │ ├── SpendingChart.kt +│ │ │ │ │ └── BudgetProgressBar.kt +│ │ │ │ └── util/ +│ │ │ │ ├── CurrencyFormatter.kt +│ │ │ │ └── DateUtils.kt +│ │ │ ├── res/ +│ │ │ └── AndroidManifest.xml +│ │ └── test/ +│ │ └── java/com/ledga/app/ +│ │ └── parser/ +│ │ └── MpesaSmsParserTest.kt +│ └── build.gradle.kts +├── build.gradle.kts +├── settings.gradle.kts +└── README.md +``` + +--- + +## Build Phases + +### Phase 1 — Core (MVP) +- [ ] Project setup (Kotlin, Compose, Room, Hilt, Gradle) +- [ ] SMS parser — handle all M-Pesa transaction types (including M-Pesa Global, M-Shwari, KCB M-Pesa) +- [ ] SMS parser unit tests — real SMS samples for every transaction type +- [ ] Room database — transactions, categories, category rules, migrations setup +- [ ] SMS BroadcastReceiver — real-time capture +- [ ] SMS history import +- [ ] Onboarding flow — welcome screen, SMS permission with plain-language explanation, optional history import +- [ ] Home dashboard — current balance, spending total, fees total, donut chart, recent transactions +- [ ] Transactions list — grouped by day, search, filter +- [ ] Basic auto-categorization with default rules (name + paybill/till matching) +- [ ] Bottom navigation (Home, Transactions, Trends, Settings) +- [ ] Theme system (System/Light/Dark) + +### Phase 2 — Polish +- [ ] Trends screen — bar charts, line charts, top merchants, fees summary, period comparison +- [ ] Font size settings (System/Small/Medium/Large/Extra Large) +- [ ] Budget system — set limits, track progress bars +- [ ] Category management — add/edit/delete custom categories +- [ ] Transaction detail bottom sheet +- [ ] Long press to re-categorize +- [ ] Category rules editor +- [ ] Unparsed SMS viewer (Settings → Data) + +### Phase 3 — Notifications & Backup +- [ ] Daily spending summary notification +- [ ] Weekly summary notification +- [ ] Budget alert notifications +- [ ] Large transaction alerts +- [ ] Notification settings (toggles, time pickers) +- [ ] Google Drive auto-backup +- [ ] Google Drive restore on fresh install +- [ ] Manual export (CSV + JSON zip) +- [ ] Manual import + +### Phase 4 — Distribution +- [ ] APK signing setup — generate keystore, document secure storage +- [ ] GitHub Actions CI/CD — build release APK on push to main +- [ ] GitHub Releases self-update system +- [ ] Update check on launch +- [ ] Changelog display +- [ ] APK download + install flow +- [ ] App icon and splash screen +- [ ] Final UI polish and animations + +--- + +## App Name + +**Ledga** — a play on "ledger". Short, unique, easy to say. +- Package name: `com.ledga.app` + +--- + +## Onboarding Flow + +First launch experience for non-technical users. Only shown once — a `hasCompletedOnboarding` flag in DataStore skips it on subsequent launches. + +``` +┌─────────────────────────────────┐ +│ │ +│ Welcome to Ledga │ +│ │ +│ Track your M-Pesa spending │ +│ automatically. No typing, │ +│ no manual entry. │ +│ │ +│ [Get Started →] │ +│ │ +└─────────────────────────────────┘ + ↓ +┌─────────────────────────────────┐ +│ │ +│ Ledga reads your M-Pesa SMS │ +│ to track your spending. │ +│ │ +│ Your messages never leave │ +│ your phone. Everything stays │ +│ private and offline. │ +│ │ +│ [Allow SMS Access →] │ +│ │ +└─────────────────────────────────┘ + ↓ +┌─────────────────────────────────┐ +│ │ +│ Import your M-Pesa history? │ +│ │ +│ We can scan your existing │ +│ M-Pesa messages to build │ +│ your spending history. │ +│ │ +│ [Import History] │ +│ [Skip — start fresh] │ +│ │ +│ ┌─────────────────────┐ │ +│ │ ████████░░ 67% │ │ +│ │ Found 342 transactions│ │ +│ └─────────────────────┘ │ +│ │ +└─────────────────────────────────┘ + ↓ +┌─────────────────────────────────┐ +│ │ +│ You're all set! │ +│ │ +│ Ledga will now track your │ +│ M-Pesa spending in the │ +│ background. │ +│ │ +│ [Go to Dashboard →] │ +│ │ +└─────────────────────────────────┘ +``` + +--- + +## Testing Strategy + +### Unit Tests (Critical) +- **SMS Parser** — test every transaction type with real M-Pesa SMS samples + - At least 3 variations per type (different amounts, names, edge cases) + - Malformed messages (truncated SMS, missing fields) + - Messages from non-M-Pesa senders (should be ignored) + - Fuliza messages embedded in send/buy goods SMS + - M-Pesa Global with various country formats + - M-Shwari/KCB M-Pesa detection + - Amount parsing edge cases: `Ksh1.00`, `Ksh100,000.00` +- **Auto-categorization** — rule matching priority, paybill matching, fallback behavior +- **CurrencyFormatter** — Ksh formatting, large numbers, zero amounts + +### Integration Tests +- Room database — DAO queries, migrations, duplicate transaction code handling +- SMS import — bulk parsing performance, duplicate skipping + +### Manual Testing +- Collect real M-Pesa SMS from family members (anonymized) as test fixtures +- Test on low-end Android devices (target audience likely has budget phones) + +--- + +## APK Signing & CI/CD + +### Keystore +- Generate a release keystore and store it securely +- **CRITICAL:** Back up the keystore — if lost, existing installs can never receive updates (Android requires consistent signing) +- Store keystore password and key alias in a secure location (not in the repo) + +### GitHub Actions +```yaml +# .github/workflows/release.yml +# Triggered on push to main or manual dispatch +# Steps: +# 1. Checkout code +# 2. Set up JDK 17 +# 3. Decode keystore from GitHub secret +# 4. Build release APK (assembleRelease) +# 5. Sign APK +# 6. Create GitHub Release with APK asset +``` + +### GitHub Secrets Required +| Secret | Purpose | +|--------|---------| +| `KEYSTORE_BASE64` | Base64-encoded release keystore | +| `KEYSTORE_PASSWORD` | Keystore password | +| `KEY_ALIAS` | Key alias name | +| `KEY_PASSWORD` | Key password | + +--- + +## Database Migrations + +Schema changes are inevitable as the app evolves. Room requires explicit migrations to preserve user data. + +### Strategy +- **Never use `fallbackToDestructiveMigration()`** — this destroys all user data on schema change +- Define all migrations in `Migrations.kt` as `Migration(oldVersion, newVersion)` objects +- Test every migration path with Room's `MigrationTestHelper` +- Keep a version history: + +| Version | Changes | +|---------|---------| +| 1 | Initial schema (transactions, categories, budgets, category_rules) | + +### Example Migration Pattern +```kotlin +val MIGRATION_1_2 = object : Migration(1, 2) { + override fun migrate(db: SupportSQLiteDatabase) { + db.execSQL("ALTER TABLE transactions ADD COLUMN newField TEXT") + } +} +``` + +--- + +## Notes +- All data stays on device — no external server, no analytics, no tracking +- SMS parsing must be thoroughly tested with real M-Pesa SMS variations +- Fuliza messages have extra fields — parser must handle gracefully +- Fuliza has 3 distinct message types: borrow (Fuliza M-PESA amount), repayment (paid to Fuliza), and reversal — each has a different format +- Some M-Pesa SMS formats may vary slightly — keep raw SMS stored for re-parsing +- Transaction code uniqueness prevents duplicate imports +- Multi-SIM: some users have two M-Pesa lines — consider adding a `simSlot` or `phoneNumber` field on transactions (extracted from SMS subscription ID) if multi-line tracking is needed later +- Google Drive backup uses `appDataFolder` scope — backups are invisible to the user in Drive. This is by design (no extra permissions), but users should know they won't find the file browsing Drive manually +- The `direction` column (INFLOW/OUTFLOW) is set at parse time based on transaction type, avoiding repeated derivation in every query for totals and charts diff --git a/app/build.gradle.kts b/app/build.gradle.kts new file mode 100644 index 0000000..82e8aca --- /dev/null +++ b/app/build.gradle.kts @@ -0,0 +1,135 @@ +plugins { + id("com.android.application") + id("org.jetbrains.kotlin.android") + id("org.jetbrains.kotlin.plugin.compose") + id("org.jetbrains.kotlin.plugin.serialization") + id("com.google.devtools.ksp") + id("com.google.dagger.hilt.android") +} + +android { + namespace = "com.ledga.app" + compileSdk = 36 + + signingConfigs { + create("release") { + val keystoreFile = rootProject.file("keystore/ledga-release.jks") + if (keystoreFile.exists()) { + storeFile = keystoreFile + storePassword = System.getenv("KEYSTORE_PASSWORD") ?: "ledga2026" + keyAlias = System.getenv("KEY_ALIAS") ?: "ledga" + keyPassword = System.getenv("KEY_PASSWORD") ?: "ledga2026" + } + } + } + + defaultConfig { + applicationId = "com.ledga.app" + minSdk = 26 + targetSdk = 34 + versionCode = 1 + versionName = "1.0.0" + + testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" + } + + buildTypes { + release { + isMinifyEnabled = true + isShrinkResources = true + signingConfig = signingConfigs.getByName("release") + proguardFiles( + getDefaultProguardFile("proguard-android-optimize.txt"), + "proguard-rules.pro" + ) + } + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + + kotlinOptions { + jvmTarget = "17" + } + + buildFeatures { + compose = true + buildConfig = true + } + + packaging { + resources { + excludes += setOf( + "META-INF/INDEX.LIST", + "META-INF/DEPENDENCIES", + "META-INF/LICENSE.md", + "META-INF/NOTICE.md" + ) + } + } +} + +dependencies { + // Compose BOM + val composeBom = platform("androidx.compose:compose-bom:2026.03.00") + implementation(composeBom) + implementation("androidx.compose.ui:ui") + implementation("androidx.compose.ui:ui-graphics") + implementation("androidx.compose.ui:ui-tooling-preview") + implementation("androidx.compose.material3:material3") + implementation("androidx.compose.material:material-icons-extended") + debugImplementation("androidx.compose.ui:ui-tooling") + + // Activity & Lifecycle + implementation("androidx.activity:activity-compose:1.13.0") + implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.10.0") + implementation("androidx.lifecycle:lifecycle-runtime-compose:2.10.0") + implementation("androidx.core:core-ktx:1.16.0") + + // Navigation + implementation("androidx.navigation:navigation-compose:2.9.7") + implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3") + + // Room + implementation("androidx.room:room-runtime:2.8.4") + implementation("androidx.room:room-ktx:2.8.4") + ksp("androidx.room:room-compiler:2.8.4") + + // Hilt + implementation("com.google.dagger:hilt-android:2.57.1") + ksp("com.google.dagger:hilt-compiler:2.57.1") + implementation("androidx.hilt:hilt-navigation-compose:1.2.0") + + // DataStore + implementation("androidx.datastore:datastore-preferences:1.2.1") + + // WorkManager + implementation("androidx.work:work-runtime-ktx:2.11.1") + implementation("androidx.hilt:hilt-work:1.2.0") + ksp("androidx.hilt:hilt-compiler:1.2.0") + + // Vico Charts + implementation("com.patrykandpatrick.vico:compose-m3:2.1.3") + + // Google Drive Backup + implementation("com.google.android.gms:play-services-auth:21.3.0") + implementation("com.google.api-client:google-api-client-android:2.7.2") + implementation("com.google.apis:google-api-services-drive:v3-rev20241206-2.0.0") + implementation("com.google.http-client:google-http-client-gson:1.45.3") + + // Splash Screen + implementation("androidx.core:core-splashscreen:1.0.1") + + // Coroutines + implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.9.0") + + // Testing + testImplementation("junit:junit:4.13.2") + testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:1.9.0") + androidTestImplementation("androidx.test.ext:junit:1.2.1") + androidTestImplementation("androidx.test.espresso:espresso-core:3.6.1") + androidTestImplementation(composeBom) + androidTestImplementation("androidx.compose.ui:ui-test-junit4") +} diff --git a/app/proguard-rules.pro b/app/proguard-rules.pro new file mode 100644 index 0000000..e059141 --- /dev/null +++ b/app/proguard-rules.pro @@ -0,0 +1,3 @@ +# Ledga ProGuard Rules +# Keep Room entities +-keep class com.ledga.app.data.db.entity.** { *; } diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..c5dc2fd --- /dev/null +++ b/app/src/main/AndroidManifest.xml @@ -0,0 +1,49 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/app/src/main/java/com/ledga/app/LedgaApp.kt b/app/src/main/java/com/ledga/app/LedgaApp.kt new file mode 100644 index 0000000..9d40527 --- /dev/null +++ b/app/src/main/java/com/ledga/app/LedgaApp.kt @@ -0,0 +1,28 @@ +package com.ledga.app + +import android.app.Application +import androidx.hilt.work.HiltWorkerFactory +import androidx.work.Configuration +import com.ledga.app.worker.NotificationHelper +import com.ledga.app.worker.NotificationScheduler +import dagger.hilt.android.HiltAndroidApp +import javax.inject.Inject + +@HiltAndroidApp +class LedgaApp : Application(), Configuration.Provider { + + @Inject + lateinit var workerFactory: HiltWorkerFactory + + override val workManagerConfiguration: Configuration + get() = Configuration.Builder() + .setWorkerFactory(workerFactory) + .build() + + override fun onCreate() { + super.onCreate() + NotificationHelper.createChannels(this) + NotificationScheduler.scheduleDailySummary(this) + NotificationScheduler.scheduleWeeklySummary(this) + } +} diff --git a/app/src/main/java/com/ledga/app/MainActivity.kt b/app/src/main/java/com/ledga/app/MainActivity.kt new file mode 100644 index 0000000..21afd2b --- /dev/null +++ b/app/src/main/java/com/ledga/app/MainActivity.kt @@ -0,0 +1,98 @@ +package com.ledga.app + +import android.os.Bundle +import androidx.activity.ComponentActivity +import androidx.activity.compose.setContent +import androidx.activity.enableEdgeToEdge +import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.Scaffold +import androidx.compose.runtime.CompositionLocalProvider +import androidx.compose.ui.platform.LocalDensity +import androidx.compose.ui.unit.Density +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.ui.Modifier +import androidx.hilt.navigation.compose.hiltViewModel +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import androidx.navigation.compose.currentBackStackEntryAsState +import androidx.navigation.compose.rememberNavController +import com.ledga.app.data.repository.FontScale +import com.ledga.app.data.repository.SettingsRepository +import com.ledga.app.ui.navigation.AppNavigation +import com.ledga.app.ui.navigation.HomeRoute +import com.ledga.app.ui.navigation.LedgaBottomNavBar +import com.ledga.app.ui.navigation.OnboardingRoute +import com.ledga.app.ui.navigation.UnparsedSmsRoute +import com.ledga.app.ui.theme.LedgaTheme +import com.ledga.app.ui.theme.ThemeMode +import dagger.hilt.android.AndroidEntryPoint +import dagger.hilt.android.lifecycle.HiltViewModel +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.stateIn +import javax.inject.Inject + +@HiltViewModel +class MainViewModel @Inject constructor( + settingsRepository: SettingsRepository +) : ViewModel() { + + val themeMode: StateFlow = settingsRepository.getThemeMode() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), ThemeMode.SYSTEM) + + val hasCompletedOnboarding: StateFlow = settingsRepository.hasCompletedOnboarding() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), true) + + val fontScale: StateFlow = settingsRepository.getFontScale() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), FontScale.SYSTEM) +} + +@AndroidEntryPoint +class MainActivity : ComponentActivity() { + override fun onCreate(savedInstanceState: Bundle?) { + installSplashScreen() + super.onCreate(savedInstanceState) + enableEdgeToEdge() + setContent { + val viewModel: MainViewModel = hiltViewModel() + val themeMode by viewModel.themeMode.collectAsState() + val hasCompletedOnboarding by viewModel.hasCompletedOnboarding.collectAsState() + val fontScale by viewModel.fontScale.collectAsState() + + LedgaTheme(themeMode = themeMode) { + val density = LocalDensity.current + val scaledDensity = if (fontScale == FontScale.SYSTEM) density + else Density(density.density, fontScale.scale) + + CompositionLocalProvider(LocalDensity provides scaledDensity) { + val navController = rememberNavController() + val navBackStackEntry by navController.currentBackStackEntryAsState() + val currentRoute = navBackStackEntry?.destination?.route + + val startDestination: Any = if (hasCompletedOnboarding) HomeRoute else OnboardingRoute + + val showBottomBar = currentRoute != null && + !currentRoute.contains("Onboarding") && + !currentRoute.contains("UnparsedSms") && + !currentRoute.contains("Budget") + + Scaffold( + bottomBar = { + if (showBottomBar) { + LedgaBottomNavBar(navController = navController) + } + } + ) { innerPadding -> + AppNavigation( + navController = navController, + startDestination = startDestination, + modifier = Modifier.padding(innerPadding) + ) + } + } + } + } + } +} diff --git a/app/src/main/java/com/ledga/app/data/db/AppDatabase.kt b/app/src/main/java/com/ledga/app/data/db/AppDatabase.kt new file mode 100644 index 0000000..ff40e19 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/AppDatabase.kt @@ -0,0 +1,31 @@ +package com.ledga.app.data.db + +import androidx.room.Database +import androidx.room.RoomDatabase +import androidx.room.TypeConverters +import com.ledga.app.data.db.dao.BudgetDao +import com.ledga.app.data.db.dao.CategoryDao +import com.ledga.app.data.db.dao.CategoryRuleDao +import com.ledga.app.data.db.dao.TransactionDao +import com.ledga.app.data.db.entity.Budget +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.CategoryRule +import com.ledga.app.data.db.entity.TransactionEntity + +@Database( + entities = [ + TransactionEntity::class, + Category::class, + Budget::class, + CategoryRule::class + ], + version = 1, + exportSchema = true +) +@TypeConverters(Converters::class) +abstract class AppDatabase : RoomDatabase() { + abstract fun transactionDao(): TransactionDao + abstract fun categoryDao(): CategoryDao + abstract fun categoryRuleDao(): CategoryRuleDao + abstract fun budgetDao(): BudgetDao +} diff --git a/app/src/main/java/com/ledga/app/data/db/Converters.kt b/app/src/main/java/com/ledga/app/data/db/Converters.kt new file mode 100644 index 0000000..7783aed --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/Converters.kt @@ -0,0 +1,27 @@ +package com.ledga.app.data.db + +import androidx.room.TypeConverter +import com.ledga.app.data.db.entity.MatchType +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.data.parser.TransactionType + +class Converters { + + @TypeConverter + fun fromTransactionType(value: TransactionType): String = value.name + + @TypeConverter + fun toTransactionType(value: String): TransactionType = TransactionType.valueOf(value) + + @TypeConverter + fun fromTransactionDirection(value: TransactionDirection): String = value.name + + @TypeConverter + fun toTransactionDirection(value: String): TransactionDirection = TransactionDirection.valueOf(value) + + @TypeConverter + fun fromMatchType(value: MatchType): String = value.name + + @TypeConverter + fun toMatchType(value: String): MatchType = MatchType.valueOf(value) +} diff --git a/app/src/main/java/com/ledga/app/data/db/DefaultData.kt b/app/src/main/java/com/ledga/app/data/db/DefaultData.kt new file mode 100644 index 0000000..087bc6b --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/DefaultData.kt @@ -0,0 +1,54 @@ +package com.ledga.app.data.db + +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.CategoryRule +import com.ledga.app.data.db.entity.MatchType + +object DefaultData { + + val DEFAULT_CATEGORIES = listOf( + Category(id = 1, name = "Groceries", icon = "shopping_cart", color = "#4CAF50"), + Category(id = 2, name = "Transport", icon = "directions_car", color = "#2196F3"), + Category(id = 3, name = "Bills & Utilities", icon = "receipt", color = "#FF9800"), + Category(id = 4, name = "Airtime & Data", icon = "phone_android", color = "#9C27B0"), + Category(id = 5, name = "Food & Dining", icon = "restaurant", color = "#E91E63"), + Category(id = 6, name = "Send Money", icon = "person", color = "#607D8B"), + Category(id = 7, name = "Received", icon = "account_balance_wallet", color = "#00BCD4"), + Category(id = 8, name = "Withdrawal", icon = "atm", color = "#795548"), + Category(id = 9, name = "Deposit", icon = "savings", color = "#8BC34A"), + Category(id = 10, name = "Shopping", icon = "shopping_bag", color = "#FF5722"), + Category(id = 11, name = "International", icon = "public", color = "#3F51B5"), + Category(id = 12, name = "Savings & Loans", icon = "account_balance", color = "#009688"), + Category(id = 13, name = "Other", icon = "category", color = "#9E9E9E"), + ) + + val DEFAULT_RULES = listOf( + // Groceries (id=1) + CategoryRule(categoryId = 1, matchType = MatchType.RECIPIENT_NAME, matchValue = "NAIVAS"), + CategoryRule(categoryId = 1, matchType = MatchType.RECIPIENT_NAME, matchValue = "QUICKMART"), + CategoryRule(categoryId = 1, matchType = MatchType.RECIPIENT_NAME, matchValue = "CARREFOUR"), + CategoryRule(categoryId = 1, matchType = MatchType.RECIPIENT_NAME, matchValue = "CLEANSHELF"), + + // Transport (id=2) + CategoryRule(categoryId = 2, matchType = MatchType.RECIPIENT_NAME, matchValue = "UBER"), + CategoryRule(categoryId = 2, matchType = MatchType.RECIPIENT_NAME, matchValue = "BOLT"), + CategoryRule(categoryId = 2, matchType = MatchType.RECIPIENT_NAME, matchValue = "LITTLE"), + + // Bills & Utilities (id=3) + CategoryRule(categoryId = 3, matchType = MatchType.RECIPIENT_NAME, matchValue = "KPLC"), + CategoryRule(categoryId = 3, matchType = MatchType.RECIPIENT_NAME, matchValue = "KENYA POWER"), + CategoryRule(categoryId = 3, matchType = MatchType.PAYBILL, matchValue = "888880"), + CategoryRule(categoryId = 3, matchType = MatchType.PAYBILL, matchValue = "888888"), + CategoryRule(categoryId = 3, matchType = MatchType.RECIPIENT_NAME, matchValue = "NAIROBI WATER"), + CategoryRule(categoryId = 3, matchType = MatchType.PAYBILL, matchValue = "444400"), + CategoryRule(categoryId = 3, matchType = MatchType.RECIPIENT_NAME, matchValue = "DSTV"), + CategoryRule(categoryId = 3, matchType = MatchType.RECIPIENT_NAME, matchValue = "GOTV"), + CategoryRule(categoryId = 3, matchType = MatchType.RECIPIENT_NAME, matchValue = "SHOWMAX"), + + // Food & Dining (id=5) + CategoryRule(categoryId = 5, matchType = MatchType.RECIPIENT_NAME, matchValue = "JAVA"), + CategoryRule(categoryId = 5, matchType = MatchType.RECIPIENT_NAME, matchValue = "KFC"), + CategoryRule(categoryId = 5, matchType = MatchType.RECIPIENT_NAME, matchValue = "CHICKEN INN"), + CategoryRule(categoryId = 5, matchType = MatchType.RECIPIENT_NAME, matchValue = "PIZZA INN"), + ) +} diff --git a/app/src/main/java/com/ledga/app/data/db/Migrations.kt b/app/src/main/java/com/ledga/app/data/db/Migrations.kt new file mode 100644 index 0000000..a7442c7 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/Migrations.kt @@ -0,0 +1,19 @@ +package com.ledga.app.data.db + +/** + * Room database migrations. + * + * NEVER use fallbackToDestructiveMigration() — this destroys all user data. + * Always define explicit migrations for schema changes. + * + * Version history: + * 1 - Initial schema (transactions, categories, budgets, category_rules) + */ +object Migrations { + // Future migrations will be added here as: + // val MIGRATION_1_2 = object : Migration(1, 2) { + // override fun migrate(db: SupportSQLiteDatabase) { + // db.execSQL("ALTER TABLE ...") + // } + // } +} diff --git a/app/src/main/java/com/ledga/app/data/db/dao/BudgetDao.kt b/app/src/main/java/com/ledga/app/data/db/dao/BudgetDao.kt new file mode 100644 index 0000000..f9178e0 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/dao/BudgetDao.kt @@ -0,0 +1,18 @@ +package com.ledga.app.data.db.dao + +import androidx.room.Dao +import androidx.room.Insert +import androidx.room.OnConflictStrategy +import androidx.room.Query +import com.ledga.app.data.db.entity.Budget +import kotlinx.coroutines.flow.Flow + +@Dao +interface BudgetDao { + + @Query("SELECT * FROM budgets WHERE isActive = 1") + fun getActiveBudgets(): Flow> + + @Insert(onConflict = OnConflictStrategy.REPLACE) + suspend fun insert(budget: Budget): Long +} diff --git a/app/src/main/java/com/ledga/app/data/db/dao/CategoryDao.kt b/app/src/main/java/com/ledga/app/data/db/dao/CategoryDao.kt new file mode 100644 index 0000000..b9b9943 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/dao/CategoryDao.kt @@ -0,0 +1,21 @@ +package com.ledga.app.data.db.dao + +import androidx.room.Dao +import androidx.room.Insert +import androidx.room.OnConflictStrategy +import androidx.room.Query +import com.ledga.app.data.db.entity.Category +import kotlinx.coroutines.flow.Flow + +@Dao +interface CategoryDao { + + @Query("SELECT * FROM categories ORDER BY name") + fun getAllCategories(): Flow> + + @Query("SELECT * FROM categories WHERE id = :id") + suspend fun getCategoryById(id: Long): Category? + + @Insert(onConflict = OnConflictStrategy.REPLACE) + suspend fun insertAll(categories: List) +} diff --git a/app/src/main/java/com/ledga/app/data/db/dao/CategoryRuleDao.kt b/app/src/main/java/com/ledga/app/data/db/dao/CategoryRuleDao.kt new file mode 100644 index 0000000..0fc895e --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/dao/CategoryRuleDao.kt @@ -0,0 +1,24 @@ +package com.ledga.app.data.db.dao + +import androidx.room.Dao +import androidx.room.Insert +import androidx.room.OnConflictStrategy +import androidx.room.Query +import com.ledga.app.data.db.entity.CategoryRule +import kotlinx.coroutines.flow.Flow + +@Dao +interface CategoryRuleDao { + + @Query("SELECT * FROM category_rules") + fun getAllRules(): Flow> + + @Query("SELECT * FROM category_rules WHERE categoryId = :categoryId") + fun getRulesForCategory(categoryId: Long): Flow> + + @Insert(onConflict = OnConflictStrategy.REPLACE) + suspend fun insertAll(rules: List) + + @Query("SELECT * FROM category_rules") + suspend fun getAllRulesSync(): List +} diff --git a/app/src/main/java/com/ledga/app/data/db/dao/TransactionDao.kt b/app/src/main/java/com/ledga/app/data/db/dao/TransactionDao.kt new file mode 100644 index 0000000..d268c1a --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/dao/TransactionDao.kt @@ -0,0 +1,102 @@ +package com.ledga.app.data.db.dao + +import androidx.room.Dao +import androidx.room.Insert +import androidx.room.OnConflictStrategy +import androidx.room.Query +import androidx.room.Transaction +import com.ledga.app.data.db.entity.TransactionEntity +import com.ledga.app.data.db.entity.TransactionWithCategory +import com.ledga.app.data.parser.TransactionType +import kotlinx.coroutines.flow.Flow + +data class CategorySpending( + val categoryId: Long?, + val totalAmount: Double +) + +data class DailySpending( + val dayTimestamp: Long, + val totalAmount: Double +) + +data class TopMerchant( + val recipientName: String, + val totalAmount: Double, + val transactionCount: Int +) + +@Dao +interface TransactionDao { + + @Insert(onConflict = OnConflictStrategy.IGNORE) + suspend fun insert(transaction: TransactionEntity): Long + + @Query("UPDATE transactions SET categoryId = :categoryId WHERE id = :id") + suspend fun updateCategory(id: Long, categoryId: Long?) + + @Transaction + @Query("SELECT * FROM transactions ORDER BY timestamp DESC LIMIT :limit") + fun getRecentTransactions(limit: Int = 10): Flow> + + @Transaction + @Query("SELECT * FROM transactions WHERE timestamp BETWEEN :startTime AND :endTime ORDER BY timestamp DESC") + fun getTransactions(startTime: Long, endTime: Long): Flow> + + @Query("SELECT * FROM transactions ORDER BY timestamp DESC LIMIT 1") + fun getLatestTransaction(): Flow + + @Query(""" + SELECT categoryId, SUM(amount) as totalAmount + FROM transactions + WHERE direction = 'OUTFLOW' AND timestamp BETWEEN :startTime AND :endTime + GROUP BY categoryId + """) + fun getSpendingByCategory(startTime: Long, endTime: Long): Flow> + + @Query("SELECT COALESCE(SUM(amount), 0.0) FROM transactions WHERE direction = 'OUTFLOW' AND timestamp BETWEEN :startTime AND :endTime") + fun getTotalSpending(startTime: Long, endTime: Long): Flow + + @Query("SELECT COALESCE(SUM(transactionCost), 0.0) FROM transactions WHERE timestamp BETWEEN :startTime AND :endTime") + fun getTotalFees(startTime: Long, endTime: Long): Flow + + @Transaction + @Query("SELECT * FROM transactions WHERE recipientName LIKE '%' || :query || '%' ORDER BY timestamp DESC") + fun searchTransactions(query: String): Flow> + + @Transaction + @Query("SELECT * FROM transactions WHERE type IN (:types) ORDER BY timestamp DESC") + fun getTransactionsByType(types: List): Flow> + + @Query("SELECT * FROM transactions WHERE transactionCode = :code LIMIT 1") + suspend fun getTransactionByCode(code: String): TransactionEntity? + + @Transaction + @Query("SELECT * FROM transactions WHERE type = 'UNKNOWN' ORDER BY timestamp DESC") + fun getUnparsedTransactions(): Flow> + + // Trends: daily spending totals for a period + @Query(""" + SELECT (timestamp / 86400000) * 86400000 as dayTimestamp, SUM(amount) as totalAmount + FROM transactions + WHERE direction = 'OUTFLOW' AND timestamp BETWEEN :startTime AND :endTime + GROUP BY dayTimestamp + ORDER BY dayTimestamp ASC + """) + fun getDailySpending(startTime: Long, endTime: Long): Flow> + + // Trends: top merchants by total spending + @Query(""" + SELECT recipientName, SUM(amount) as totalAmount, COUNT(*) as transactionCount + FROM transactions + WHERE direction = 'OUTFLOW' AND recipientName IS NOT NULL + AND timestamp BETWEEN :startTime AND :endTime + GROUP BY recipientName + ORDER BY totalAmount DESC + LIMIT :limit + """) + fun getTopMerchants(startTime: Long, endTime: Long, limit: Int = 5): Flow> + + @Query("SELECT COUNT(*) FROM transactions WHERE type = 'UNKNOWN'") + fun getUnparsedCount(): Flow +} diff --git a/app/src/main/java/com/ledga/app/data/db/entity/Budget.kt b/app/src/main/java/com/ledga/app/data/db/entity/Budget.kt new file mode 100644 index 0000000..f84b890 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/entity/Budget.kt @@ -0,0 +1,26 @@ +package com.ledga.app.data.db.entity + +import androidx.room.Entity +import androidx.room.ForeignKey +import androidx.room.Index +import androidx.room.PrimaryKey + +@Entity( + tableName = "budgets", + indices = [Index(value = ["categoryId"])], + foreignKeys = [ + ForeignKey( + entity = Category::class, + parentColumns = ["id"], + childColumns = ["categoryId"], + onDelete = ForeignKey.CASCADE + ) + ] +) +data class Budget( + @PrimaryKey(autoGenerate = true) + val id: Long = 0, + val categoryId: Long?, + val monthlyLimit: Double, + val isActive: Boolean = true +) diff --git a/app/src/main/java/com/ledga/app/data/db/entity/Category.kt b/app/src/main/java/com/ledga/app/data/db/entity/Category.kt new file mode 100644 index 0000000..3203b07 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/entity/Category.kt @@ -0,0 +1,14 @@ +package com.ledga.app.data.db.entity + +import androidx.room.Entity +import androidx.room.PrimaryKey + +@Entity(tableName = "categories") +data class Category( + @PrimaryKey(autoGenerate = true) + val id: Long = 0, + val name: String, + val icon: String, + val color: String, + val isDefault: Boolean = true +) diff --git a/app/src/main/java/com/ledga/app/data/db/entity/CategoryRule.kt b/app/src/main/java/com/ledga/app/data/db/entity/CategoryRule.kt new file mode 100644 index 0000000..cc63d34 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/entity/CategoryRule.kt @@ -0,0 +1,30 @@ +package com.ledga.app.data.db.entity + +import androidx.room.Entity +import androidx.room.ForeignKey +import androidx.room.Index +import androidx.room.PrimaryKey + +enum class MatchType { + RECIPIENT_NAME, PHONE, TILL, PAYBILL +} + +@Entity( + tableName = "category_rules", + indices = [Index(value = ["categoryId"])], + foreignKeys = [ + ForeignKey( + entity = Category::class, + parentColumns = ["id"], + childColumns = ["categoryId"], + onDelete = ForeignKey.CASCADE + ) + ] +) +data class CategoryRule( + @PrimaryKey(autoGenerate = true) + val id: Long = 0, + val categoryId: Long, + val matchType: MatchType, + val matchValue: String +) diff --git a/app/src/main/java/com/ledga/app/data/db/entity/TransactionEntity.kt b/app/src/main/java/com/ledga/app/data/db/entity/TransactionEntity.kt new file mode 100644 index 0000000..9defdf9 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/entity/TransactionEntity.kt @@ -0,0 +1,47 @@ +package com.ledga.app.data.db.entity + +import androidx.room.Entity +import androidx.room.ForeignKey +import androidx.room.Index +import androidx.room.PrimaryKey +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.data.parser.TransactionType + +@Entity( + tableName = "transactions", + indices = [ + Index(value = ["transactionCode"], unique = true), + Index(value = ["categoryId"]), + Index(value = ["timestamp"]), + Index(value = ["type"]) + ], + foreignKeys = [ + ForeignKey( + entity = Category::class, + parentColumns = ["id"], + childColumns = ["categoryId"], + onDelete = ForeignKey.SET_NULL + ) + ] +) +data class TransactionEntity( + @PrimaryKey(autoGenerate = true) + val id: Long = 0, + val transactionCode: String, + val type: TransactionType, + val amount: Double, + val transactionCost: Double, + val recipientName: String?, + val recipientPhone: String?, + val accountNumber: String?, + val destinationCountry: String?, + val balance: Double, + val direction: TransactionDirection, + val categoryId: Long?, + val fulizaAmount: Double?, + val fulizaOutstanding: Double?, + val reversedTransactionCode: String?, + val rawSms: String, + val timestamp: Long, + val createdAt: Long = System.currentTimeMillis() +) diff --git a/app/src/main/java/com/ledga/app/data/db/entity/TransactionWithCategory.kt b/app/src/main/java/com/ledga/app/data/db/entity/TransactionWithCategory.kt new file mode 100644 index 0000000..36e6ea4 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/db/entity/TransactionWithCategory.kt @@ -0,0 +1,13 @@ +package com.ledga.app.data.db.entity + +import androidx.room.Embedded +import androidx.room.Relation + +data class TransactionWithCategory( + @Embedded val transaction: TransactionEntity, + @Relation( + parentColumn = "categoryId", + entityColumn = "id" + ) + val category: Category? +) diff --git a/app/src/main/java/com/ledga/app/data/parser/MpesaSmsParser.kt b/app/src/main/java/com/ledga/app/data/parser/MpesaSmsParser.kt new file mode 100644 index 0000000..8982a88 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/parser/MpesaSmsParser.kt @@ -0,0 +1,388 @@ +package com.ledga.app.data.parser + +import com.ledga.app.util.DateUtils + +enum class TransactionType { + SEND, BUY_GOODS, PAY_BILL, WITHDRAW_AGENT, WITHDRAW_ATM, + DEPOSIT, RECEIVED, AIRTIME_SELF, AIRTIME_OTHER, MPESA_GLOBAL, + FULIZA, FULIZA_REPAYMENT, FULIZA_REVERSAL, MSHWARI, KCB_MPESA, + REVERSAL, UNKNOWN +} + +enum class TransactionDirection { INFLOW, OUTFLOW } + +data class ParsedTransaction( + val transactionCode: String, + val type: TransactionType, + val amount: Double, + val transactionCost: Double, + val recipientName: String?, + val recipientPhone: String?, + val accountNumber: String?, + val destinationCountry: String?, + val balance: Double, + val direction: TransactionDirection, + val fulizaAmount: Double?, + val fulizaOutstanding: Double?, + val reversedTransactionCode: String?, + val timestamp: Long, + val rawSms: String +) + +sealed interface ParseResult { + data class Success(val transaction: ParsedTransaction) : ParseResult + data class Failure(val rawSms: String, val reason: String) : ParseResult +} + +object MpesaSmsParser { + + private val AMOUNT_REGEX = Regex("""Ksh([\d,]+\.\d{2})""") + private val TRANSACTION_CODE_REGEX = Regex("""^([A-Z0-9]{10})\s""") + private val DATE_REGEX = Regex("""on (\d{1,2}/\d{1,2}/\d{2,4} at \d{1,2}:\d{2} [AP]M)""") + private val BALANCE_REGEX = Regex("""(?:balance is|account balance is)\s*Ksh([\d,]+\.\d{2})""", RegexOption.IGNORE_CASE) + private val COST_REGEX = Regex("""Transaction cost,?\s*Ksh([\d,]+\.\d{2})""", RegexOption.IGNORE_CASE) + private val FULIZA_AMOUNT_REGEX = Regex("""Fuliza M-PESA amount is Ksh([\d,]+\.\d{2})""") + private val FULIZA_OUTSTANDING_REGEX = Regex("""Fuliza M-PESA outstanding amount is Ksh([\d,]+\.\d{2})""") + + fun isMpesaMessage(sender: String): Boolean { + return sender.equals("MPESA", ignoreCase = true) + } + + fun parse(smsBody: String, smsTimestamp: Long = System.currentTimeMillis()): ParseResult { + val code = extractTransactionCode(smsBody) + ?: return ParseResult.Failure(smsBody, "No transaction code found") + + if (!smsBody.contains("Confirmed", ignoreCase = true)) { + return ParseResult.Failure(smsBody, "Not a confirmed transaction") + } + + val timestamp = extractDate(smsBody) ?: smsTimestamp + val balance = extractBalance(smsBody) ?: 0.0 + val cost = extractCost(smsBody) ?: 0.0 + + return try { + val transaction = when { + isReversal(smsBody) -> parseReversal(smsBody, code, balance, timestamp) + isFulizaReversal(smsBody) -> parseFulizaReversal(smsBody, code, timestamp) + isFulizaRepayment(smsBody) -> parseFulizaRepayment(smsBody, code, timestamp) + isMshwari(smsBody) -> parseMshwari(smsBody, code, balance, cost, timestamp) + isKcbMpesa(smsBody) -> parseKcbMpesa(smsBody, code, balance, cost, timestamp) + isMpesaGlobal(smsBody) -> parseMpesaGlobal(smsBody, code, balance, cost, timestamp) + isFuliza(smsBody) -> parseFuliza(smsBody, code, balance, cost, timestamp) + isDeposit(smsBody) -> parseDeposit(smsBody, code, balance, timestamp) + isReceived(smsBody) -> parseReceived(smsBody, code, balance, timestamp) + isAirtimeSelf(smsBody) -> parseAirtimeSelf(smsBody, code, balance, cost, timestamp) + isAirtimeOther(smsBody) -> parseAirtimeOther(smsBody, code, balance, cost, timestamp) + isWithdrawAtm(smsBody) -> parseWithdrawAtm(smsBody, code, balance, cost, timestamp) + isWithdrawAgent(smsBody) -> parseWithdrawAgent(smsBody, code, balance, cost, timestamp) + isPayBill(smsBody) -> parsePayBill(smsBody, code, balance, cost, timestamp) + isBuyGoods(smsBody) -> parseBuyGoods(smsBody, code, balance, cost, timestamp) + isSendMoney(smsBody) -> parseSendMoney(smsBody, code, balance, cost, timestamp) + else -> parseUnknown(smsBody, code, balance, cost, timestamp) + } + ParseResult.Success(transaction) + } catch (e: Exception) { + ParseResult.Failure(smsBody, "Parse error: ${e.message}") + } + } + + // --- Type detection --- + + private fun isReversal(sms: String) = + sms.contains("has been reversed") && !sms.contains("Fuliza", ignoreCase = true) + + private fun isFulizaReversal(sms: String) = + sms.contains("Fuliza M-PESA of", ignoreCase = true) && sms.contains("has been reversed") + + private fun isFulizaRepayment(sms: String) = + sms.contains("paid", ignoreCase = true) && sms.contains("to Fuliza M-PESA", ignoreCase = true) + + private fun isMshwari(sms: String) = + sms.contains("M-Shwari", ignoreCase = true) + + private fun isKcbMpesa(sms: String) = + sms.contains("KCB M-Pesa", ignoreCase = true) || sms.contains("KCB M-PESA", ignoreCase = true) + + private fun isMpesaGlobal(sms: String) = + sms.contains("M-PESA Global", ignoreCase = true) || sms.contains("MPESA Global", ignoreCase = true) + + private fun isFuliza(sms: String) = + sms.contains("Fuliza M-PESA amount is", ignoreCase = true) + + private fun isDeposit(sms: String) = + sms.contains("You have deposited", ignoreCase = true) + + private fun isReceived(sms: String) = + sms.contains("You have received", ignoreCase = true) + + private fun isAirtimeSelf(sms: String) = + sms.contains("airtime purchased", ignoreCase = true) + + private fun isAirtimeOther(sms: String) = + sms.contains("bought", ignoreCase = true) && sms.contains("airtime for", ignoreCase = true) + + private fun isWithdrawAtm(sms: String) = + sms.contains("withdrawn", ignoreCase = true) && sms.contains("from an ATM", ignoreCase = true) + + private fun isWithdrawAgent(sms: String) = + sms.contains("withdrawn", ignoreCase = true) && sms.contains("from ", ignoreCase = true) + + private fun isPayBill(sms: String) = + sms.contains("paid to", ignoreCase = true) && sms.contains("Account Number", ignoreCase = true) + + private fun isBuyGoods(sms: String) = + sms.contains("paid to", ignoreCase = true) && !sms.contains("Account Number", ignoreCase = true) + + private fun isSendMoney(sms: String) = + sms.contains("sent to", ignoreCase = true) + + // --- Parsers --- + + private fun parseSendMoney(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val sendToRegex = Regex("""sent to\s+(.+?)\s+(\d{10,})\s+on""", RegexOption.IGNORE_CASE) + val match = sendToRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.SEND, amount = amount, + transactionCost = cost, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = match?.groupValues?.get(2), accountNumber = null, + destinationCountry = null, balance = balance, direction = TransactionDirection.OUTFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parseBuyGoods(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val paidToRegex = Regex("""paid to\s+(.+?)\.?\s+on""", RegexOption.IGNORE_CASE) + val match = paidToRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.BUY_GOODS, amount = amount, + transactionCost = cost, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = null, accountNumber = null, destinationCountry = null, + balance = balance, direction = TransactionDirection.OUTFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parsePayBill(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val paidToRegex = Regex("""paid to\s+(.+?)\.\s*Account Number\s+(\S+?)\.?\s+on""", RegexOption.IGNORE_CASE) + val match = paidToRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.PAY_BILL, amount = amount, + transactionCost = cost, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = null, accountNumber = match?.groupValues?.get(2)?.trim(), + destinationCountry = null, balance = balance, direction = TransactionDirection.OUTFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parseWithdrawAgent(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val fromRegex = Regex("""withdrawn.*?from\s+(.+?)\s+(\d{4,})\s+on""", RegexOption.IGNORE_CASE) + val match = fromRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.WITHDRAW_AGENT, amount = amount, + transactionCost = cost, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = match?.groupValues?.get(2), accountNumber = null, + destinationCountry = null, balance = balance, direction = TransactionDirection.OUTFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parseWithdrawAtm(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + return ParsedTransaction( + transactionCode = code, type = TransactionType.WITHDRAW_ATM, amount = amount, + transactionCost = cost, recipientName = "ATM", recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = TransactionDirection.OUTFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseDeposit(sms: String, code: String, balance: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + return ParsedTransaction( + transactionCode = code, type = TransactionType.DEPOSIT, amount = amount, + transactionCost = 0.0, recipientName = null, recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = TransactionDirection.INFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseReceived(sms: String, code: String, balance: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val fromRegex = Regex("""received.*?from\s+(.+?)\s+(\d{10,})\s+on""", RegexOption.IGNORE_CASE) + val match = fromRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.RECEIVED, amount = amount, + transactionCost = 0.0, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = match?.groupValues?.get(2), accountNumber = null, + destinationCountry = null, balance = balance, direction = TransactionDirection.INFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parseAirtimeSelf(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + return ParsedTransaction( + transactionCode = code, type = TransactionType.AIRTIME_SELF, amount = amount, + transactionCost = cost, recipientName = null, recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = TransactionDirection.OUTFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseAirtimeOther(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val forRegex = Regex("""airtime for\s+(\d{10,})""", RegexOption.IGNORE_CASE) + val match = forRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.AIRTIME_OTHER, amount = amount, + transactionCost = cost, recipientName = null, recipientPhone = match?.groupValues?.get(1), + accountNumber = null, destinationCountry = null, balance = balance, + direction = TransactionDirection.OUTFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseMpesaGlobal(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val globalRegex = Regex("""sent to\s+(.+?)\s+(\+\d{7,15})\s+\((.+?)\)""", RegexOption.IGNORE_CASE) + val match = globalRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.MPESA_GLOBAL, amount = amount, + transactionCost = cost, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = match?.groupValues?.get(2), accountNumber = null, + destinationCountry = match?.groupValues?.get(3)?.trim(), balance = balance, + direction = TransactionDirection.OUTFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseFuliza(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val fulizaAmt = FULIZA_AMOUNT_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + val fulizaOut = FULIZA_OUTSTANDING_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + + val sendToRegex = Regex("""sent to\s+(.+?)\s+(\d{10,})\s+on""", RegexOption.IGNORE_CASE) + val match = sendToRegex.find(sms) + + return ParsedTransaction( + transactionCode = code, type = TransactionType.FULIZA, amount = amount, + transactionCost = cost, recipientName = match?.groupValues?.get(1)?.trim(), + recipientPhone = match?.groupValues?.get(2), accountNumber = null, + destinationCountry = null, balance = balance, direction = TransactionDirection.OUTFLOW, + fulizaAmount = fulizaAmt, fulizaOutstanding = fulizaOut, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseFulizaRepayment(sms: String, code: String, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val fulizaOut = FULIZA_OUTSTANDING_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + return ParsedTransaction( + transactionCode = code, type = TransactionType.FULIZA_REPAYMENT, amount = amount, + transactionCost = 0.0, recipientName = null, recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = 0.0, + direction = TransactionDirection.OUTFLOW, fulizaAmount = null, fulizaOutstanding = fulizaOut, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseFulizaReversal(sms: String, code: String, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val fulizaOut = FULIZA_OUTSTANDING_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + return ParsedTransaction( + transactionCode = code, type = TransactionType.FULIZA_REVERSAL, amount = amount, + transactionCost = 0.0, recipientName = null, recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = 0.0, + direction = TransactionDirection.INFLOW, fulizaAmount = null, fulizaOutstanding = fulizaOut, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + private fun parseReversal(sms: String, code: String, balance: Double, timestamp: Long): ParsedTransaction { + val reversedCodeRegex = Regex("""Transaction\s+([A-Z0-9]{10})\s+has been reversed""") + val match = reversedCodeRegex.find(sms) + return ParsedTransaction( + transactionCode = code, type = TransactionType.REVERSAL, amount = 0.0, + transactionCost = 0.0, recipientName = null, recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = TransactionDirection.INFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = match?.groupValues?.get(1), timestamp = timestamp, rawSms = sms + ) + } + + private fun parseMshwari(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val isInflow = sms.contains("from M-Shwari", ignoreCase = true) + return ParsedTransaction( + transactionCode = code, type = TransactionType.MSHWARI, amount = amount, + transactionCost = cost, recipientName = "M-Shwari", recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = if (isInflow) TransactionDirection.INFLOW else TransactionDirection.OUTFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parseKcbMpesa(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + val isInflow = sms.contains("from KCB", ignoreCase = true) + return ParsedTransaction( + transactionCode = code, type = TransactionType.KCB_MPESA, amount = amount, + transactionCost = cost, recipientName = "KCB M-Pesa", recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = if (isInflow) TransactionDirection.INFLOW else TransactionDirection.OUTFLOW, + fulizaAmount = null, fulizaOutstanding = null, reversedTransactionCode = null, + timestamp = timestamp, rawSms = sms + ) + } + + private fun parseUnknown(sms: String, code: String, balance: Double, cost: Double, timestamp: Long): ParsedTransaction { + val amount = extractFirstAmount(sms) ?: 0.0 + return ParsedTransaction( + transactionCode = code, type = TransactionType.UNKNOWN, amount = amount, + transactionCost = cost, recipientName = null, recipientPhone = null, + accountNumber = null, destinationCountry = null, balance = balance, + direction = TransactionDirection.OUTFLOW, fulizaAmount = null, fulizaOutstanding = null, + reversedTransactionCode = null, timestamp = timestamp, rawSms = sms + ) + } + + // --- Extraction helpers --- + + private fun extractTransactionCode(sms: String): String? { + return TRANSACTION_CODE_REGEX.find(sms)?.groupValues?.get(1) + } + + private fun extractFirstAmount(sms: String): Double? { + return AMOUNT_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + } + + private fun extractBalance(sms: String): Double? { + return BALANCE_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + } + + private fun extractCost(sms: String): Double? { + return COST_REGEX.find(sms)?.groupValues?.get(1)?.let { parseAmount(it) } + } + + private fun extractDate(sms: String): Long? { + val match = DATE_REGEX.find(sms) ?: return null + return DateUtils.parseMpesaDate(match.groupValues[1]) + } + + private fun parseAmount(amountStr: String): Double { + return amountStr.replace(",", "").toDoubleOrNull() ?: 0.0 + } +} diff --git a/app/src/main/java/com/ledga/app/data/repository/BackupRepository.kt b/app/src/main/java/com/ledga/app/data/repository/BackupRepository.kt new file mode 100644 index 0000000..568b5c8 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/repository/BackupRepository.kt @@ -0,0 +1,179 @@ +package com.ledga.app.data.repository + +import android.content.Context +import android.content.Intent +import androidx.activity.result.ActivityResultLauncher +import com.google.android.gms.auth.api.signin.GoogleSignIn +import com.google.android.gms.auth.api.signin.GoogleSignInAccount +import com.google.android.gms.auth.api.signin.GoogleSignInOptions +import com.google.android.gms.common.api.Scope +import com.google.api.client.googleapis.extensions.android.gms.auth.GoogleAccountCredential +import com.google.api.client.http.ByteArrayContent +import com.google.api.client.http.javanet.NetHttpTransport +import com.google.api.client.json.gson.GsonFactory +import com.google.api.services.drive.Drive +import com.google.api.services.drive.DriveScopes +import com.ledga.app.data.db.dao.TransactionDao +import com.ledga.app.data.db.entity.TransactionEntity +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.data.parser.TransactionType +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.flow.first +import kotlinx.coroutines.withContext +import kotlinx.serialization.Serializable +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import javax.inject.Inject +import javax.inject.Singleton + +@Serializable +data class BackupData( + val version: Int = 1, + val backedUpAt: Long = System.currentTimeMillis(), + val transactions: List +) + +@Serializable +data class BackupTransaction( + val transactionCode: String, + val type: String, + val amount: Double, + val transactionCost: Double, + val recipientName: String?, + val recipientPhone: String?, + val accountNumber: String?, + val destinationCountry: String?, + val balance: Double, + val direction: String, + val categoryId: Long?, + val fulizaAmount: Double?, + val fulizaOutstanding: Double?, + val reversedTransactionCode: String?, + val rawSms: String, + val timestamp: Long +) + +@Singleton +class BackupRepository @Inject constructor( + private val transactionDao: TransactionDao +) { + private val json = Json { ignoreUnknownKeys = true } + private val BACKUP_FILENAME = "ledga-backup.json" + + fun getSignInIntent(context: Context): Intent { + val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN) + .requestEmail() + .requestScopes(Scope(DriveScopes.DRIVE_APPDATA)) + .build() + return GoogleSignIn.getClient(context, gso).signInIntent + } + + fun isSignedIn(context: Context): Boolean { + return GoogleSignIn.getLastSignedInAccount(context) != null + } + + fun getAccountEmail(context: Context): String? { + return GoogleSignIn.getLastSignedInAccount(context)?.email + } + + suspend fun performBackup(context: Context): Boolean = withContext(Dispatchers.IO) { + val account = GoogleSignIn.getLastSignedInAccount(context) ?: return@withContext false + val driveService = getDriveService(context, account) + + val transactions = transactionDao.getRecentTransactions(100000).first() + val backupData = BackupData( + transactions = transactions.map { it.transaction.toBackup() } + ) + val content = json.encodeToString(backupData) + + // Find existing backup file + val existingFileId = findBackupFile(driveService) + + if (existingFileId != null) { + // Update existing + val mediaContent = ByteArrayContent.fromString("application/json", content) + driveService.files().update(existingFileId, null, mediaContent).execute() + } else { + // Create new + val fileMetadata = com.google.api.services.drive.model.File().apply { + name = BACKUP_FILENAME + parents = listOf("appDataFolder") + } + val mediaContent = ByteArrayContent.fromString("application/json", content) + driveService.files().create(fileMetadata, mediaContent) + .setFields("id") + .execute() + } + + true + } + + suspend fun restoreBackup(context: Context): Int = withContext(Dispatchers.IO) { + val account = GoogleSignIn.getLastSignedInAccount(context) ?: return@withContext 0 + val driveService = getDriveService(context, account) + + val fileId = findBackupFile(driveService) ?: return@withContext 0 + + val outputStream = java.io.ByteArrayOutputStream() + driveService.files().get(fileId).executeMediaAndDownloadTo(outputStream) + val content = outputStream.toString("UTF-8") + + val backupData = json.decodeFromString(content) + var imported = 0 + backupData.transactions.forEach { bt -> + val entity = bt.toEntity() + val id = transactionDao.insert(entity) + if (id != -1L) imported++ + } + imported + } + + suspend fun hasBackup(context: Context): Boolean = withContext(Dispatchers.IO) { + val account = GoogleSignIn.getLastSignedInAccount(context) ?: return@withContext false + val driveService = getDriveService(context, account) + findBackupFile(driveService) != null + } + + private fun getDriveService(context: Context, account: GoogleSignInAccount): Drive { + val credential = GoogleAccountCredential.usingOAuth2( + context, listOf(DriveScopes.DRIVE_APPDATA) + ) + credential.selectedAccount = account.account + return Drive.Builder(NetHttpTransport(), GsonFactory.getDefaultInstance(), credential) + .setApplicationName("Ledga") + .build() + } + + private fun findBackupFile(driveService: Drive): String? { + val result = driveService.files().list() + .setSpaces("appDataFolder") + .setQ("name = '$BACKUP_FILENAME'") + .setFields("files(id)") + .execute() + return result.files?.firstOrNull()?.id + } + + private fun TransactionEntity.toBackup() = BackupTransaction( + transactionCode = transactionCode, type = type.name, amount = amount, + transactionCost = transactionCost, recipientName = recipientName, + recipientPhone = recipientPhone, accountNumber = accountNumber, + destinationCountry = destinationCountry, balance = balance, + direction = direction.name, categoryId = categoryId, + fulizaAmount = fulizaAmount, fulizaOutstanding = fulizaOutstanding, + reversedTransactionCode = reversedTransactionCode, rawSms = rawSms, + timestamp = timestamp + ) + + private fun BackupTransaction.toEntity() = TransactionEntity( + transactionCode = transactionCode, + type = try { TransactionType.valueOf(type) } catch (e: Exception) { TransactionType.UNKNOWN }, + amount = amount, transactionCost = transactionCost, + recipientName = recipientName, recipientPhone = recipientPhone, + accountNumber = accountNumber, destinationCountry = destinationCountry, + balance = balance, + direction = try { TransactionDirection.valueOf(direction) } catch (e: Exception) { TransactionDirection.OUTFLOW }, + categoryId = categoryId, fulizaAmount = fulizaAmount, + fulizaOutstanding = fulizaOutstanding, reversedTransactionCode = reversedTransactionCode, + rawSms = rawSms, timestamp = timestamp + ) +} diff --git a/app/src/main/java/com/ledga/app/data/repository/CategoryRepository.kt b/app/src/main/java/com/ledga/app/data/repository/CategoryRepository.kt new file mode 100644 index 0000000..ca6aa0e --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/repository/CategoryRepository.kt @@ -0,0 +1,21 @@ +package com.ledga.app.data.repository + +import com.ledga.app.data.db.dao.CategoryDao +import com.ledga.app.data.db.dao.CategoryRuleDao +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.CategoryRule +import kotlinx.coroutines.flow.Flow +import javax.inject.Inject +import javax.inject.Singleton + +@Singleton +class CategoryRepository @Inject constructor( + private val categoryDao: CategoryDao, + private val categoryRuleDao: CategoryRuleDao +) { + fun getAllCategories(): Flow> = categoryDao.getAllCategories() + + fun getAllRules(): Flow> = categoryRuleDao.getAllRules() + + suspend fun getCategoryById(id: Long): Category? = categoryDao.getCategoryById(id) +} diff --git a/app/src/main/java/com/ledga/app/data/repository/ExportImportRepository.kt b/app/src/main/java/com/ledga/app/data/repository/ExportImportRepository.kt new file mode 100644 index 0000000..60bbafd --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/repository/ExportImportRepository.kt @@ -0,0 +1,154 @@ +package com.ledga.app.data.repository + +import android.content.Context +import android.net.Uri +import com.ledga.app.data.db.dao.CategoryDao +import com.ledga.app.data.db.dao.TransactionDao +import com.ledga.app.data.db.entity.TransactionEntity +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.data.parser.TransactionType +import com.ledga.app.util.CurrencyFormatter +import com.ledga.app.util.DateUtils +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.flow.first +import kotlinx.coroutines.withContext +import kotlinx.serialization.Serializable +import kotlinx.serialization.encodeToString +import kotlinx.serialization.json.Json +import java.io.BufferedReader +import java.io.InputStreamReader +import java.util.zip.ZipEntry +import java.util.zip.ZipInputStream +import java.util.zip.ZipOutputStream +import javax.inject.Inject +import javax.inject.Singleton + +@Serializable +data class ExportTransaction( + val transactionCode: String, + val type: String, + val amount: Double, + val transactionCost: Double, + val recipientName: String?, + val recipientPhone: String?, + val accountNumber: String?, + val destinationCountry: String?, + val balance: Double, + val direction: String, + val categoryId: Long?, + val fulizaAmount: Double?, + val fulizaOutstanding: Double?, + val reversedTransactionCode: String?, + val rawSms: String, + val timestamp: Long +) + +@Serializable +data class ExportData( + val version: Int = 1, + val exportedAt: Long = System.currentTimeMillis(), + val transactions: List +) + +data class ExportResult(val success: Boolean, val count: Int) +data class ImportFromFileResult(val total: Int, val imported: Int, val skipped: Int) + +@Singleton +class ExportImportRepository @Inject constructor( + private val transactionDao: TransactionDao, + private val categoryDao: CategoryDao +) { + private val json = Json { prettyPrint = true; ignoreUnknownKeys = true } + + suspend fun exportToZip(context: Context, uri: Uri): ExportResult = withContext(Dispatchers.IO) { + val transactions = transactionDao.getRecentTransactions(10000).first() + val categories = categoryDao.getAllCategories().first() + val categoryMap = categories.associateBy { it.id } + + context.contentResolver.openOutputStream(uri)?.use { os -> + ZipOutputStream(os).use { zip -> + // CSV + zip.putNextEntry(ZipEntry("transactions.csv")) + val csvHeader = "Date,Time,Code,Type,Amount,Fee,Recipient,Phone,Account,Balance,Category\n" + zip.write(csvHeader.toByteArray()) + transactions.forEach { twc -> + val t = twc.transaction + val cat = categoryMap[t.categoryId]?.name ?: "" + val line = "${DateUtils.formatDate(t.timestamp)},${DateUtils.formatTime(t.timestamp)},${t.transactionCode},${t.type},${t.amount},${t.transactionCost},${csvEscape(t.recipientName ?: "")},${t.recipientPhone ?: ""},${t.accountNumber ?: ""},${t.balance},${csvEscape(cat)}\n" + zip.write(line.toByteArray()) + } + zip.closeEntry() + + // JSON + zip.putNextEntry(ZipEntry("data.json")) + val exportData = ExportData( + transactions = transactions.map { it.transaction.toExport() } + ) + zip.write(json.encodeToString(exportData).toByteArray()) + zip.closeEntry() + } + } + + ExportResult(success = true, count = transactions.size) + } + + suspend fun importFromZip(context: Context, uri: Uri): ImportFromFileResult = withContext(Dispatchers.IO) { + var total = 0 + var imported = 0 + var skipped = 0 + + context.contentResolver.openInputStream(uri)?.use { inputStream -> + ZipInputStream(inputStream).use { zip -> + var entry = zip.nextEntry + while (entry != null) { + if (entry.name == "data.json") { + val reader = BufferedReader(InputStreamReader(zip)) + val content = reader.readText() + val exportData = json.decodeFromString(content) + total = exportData.transactions.size + + exportData.transactions.forEach { et -> + val entity = et.toEntity() + val id = transactionDao.insert(entity) + if (id != -1L) imported++ else skipped++ + } + } + zip.closeEntry() + entry = zip.nextEntry + } + } + } + + ImportFromFileResult(total = total, imported = imported, skipped = skipped) + } + + private fun TransactionEntity.toExport() = ExportTransaction( + transactionCode = transactionCode, type = type.name, amount = amount, + transactionCost = transactionCost, recipientName = recipientName, + recipientPhone = recipientPhone, accountNumber = accountNumber, + destinationCountry = destinationCountry, balance = balance, + direction = direction.name, categoryId = categoryId, + fulizaAmount = fulizaAmount, fulizaOutstanding = fulizaOutstanding, + reversedTransactionCode = reversedTransactionCode, rawSms = rawSms, + timestamp = timestamp + ) + + private fun ExportTransaction.toEntity() = TransactionEntity( + transactionCode = transactionCode, + type = try { TransactionType.valueOf(type) } catch (e: Exception) { TransactionType.UNKNOWN }, + amount = amount, transactionCost = transactionCost, + recipientName = recipientName, recipientPhone = recipientPhone, + accountNumber = accountNumber, destinationCountry = destinationCountry, + balance = balance, + direction = try { TransactionDirection.valueOf(direction) } catch (e: Exception) { TransactionDirection.OUTFLOW }, + categoryId = categoryId, fulizaAmount = fulizaAmount, + fulizaOutstanding = fulizaOutstanding, reversedTransactionCode = reversedTransactionCode, + rawSms = rawSms, timestamp = timestamp + ) + + private fun csvEscape(value: String): String { + return if (value.contains(",") || value.contains("\"") || value.contains("\n")) { + "\"${value.replace("\"", "\"\"")}\"" + } else value + } +} diff --git a/app/src/main/java/com/ledga/app/data/repository/SettingsRepository.kt b/app/src/main/java/com/ledga/app/data/repository/SettingsRepository.kt new file mode 100644 index 0000000..b564403 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/repository/SettingsRepository.kt @@ -0,0 +1,95 @@ +package com.ledga.app.data.repository + +import androidx.datastore.core.DataStore +import androidx.datastore.preferences.core.Preferences +import androidx.datastore.preferences.core.booleanPreferencesKey +import androidx.datastore.preferences.core.doublePreferencesKey +import androidx.datastore.preferences.core.edit +import androidx.datastore.preferences.core.intPreferencesKey +import androidx.datastore.preferences.core.stringPreferencesKey +import com.ledga.app.ui.theme.ThemeMode +import kotlinx.coroutines.flow.Flow +import kotlinx.coroutines.flow.map +import javax.inject.Inject +import javax.inject.Singleton + +@Singleton +class SettingsRepository @Inject constructor( + private val dataStore: DataStore +) { + companion object { + private val THEME_MODE = stringPreferencesKey("theme_mode") + private val ONBOARDING_COMPLETED = booleanPreferencesKey("onboarding_completed") + private val FONT_SCALE = stringPreferencesKey("font_scale") + private val DAILY_SUMMARY = booleanPreferencesKey("daily_summary") + private val DAILY_SUMMARY_HOUR = intPreferencesKey("daily_summary_hour") + private val WEEKLY_SUMMARY = booleanPreferencesKey("weekly_summary") + private val BUDGET_ALERTS = booleanPreferencesKey("budget_alerts") + private val LARGE_TXN_ALERT = booleanPreferencesKey("large_txn_alert") + private val LARGE_TXN_THRESHOLD = doublePreferencesKey("large_txn_threshold") + } + + fun getThemeMode(): Flow = dataStore.data.map { prefs -> + when (prefs[THEME_MODE]) { + "LIGHT" -> ThemeMode.LIGHT + "DARK" -> ThemeMode.DARK + else -> ThemeMode.SYSTEM + } + } + + suspend fun setThemeMode(mode: ThemeMode) { + dataStore.edit { it[THEME_MODE] = mode.name } + } + + fun hasCompletedOnboarding(): Flow = dataStore.data.map { prefs -> + prefs[ONBOARDING_COMPLETED] ?: false + } + + suspend fun setOnboardingCompleted() { + dataStore.edit { it[ONBOARDING_COMPLETED] = true } + } + + // --- Notification settings --- + + fun getDailySummaryEnabled(): Flow = dataStore.data.map { it[DAILY_SUMMARY] ?: true } + suspend fun setDailySummaryEnabled(enabled: Boolean) { dataStore.edit { it[DAILY_SUMMARY] = enabled } } + + fun getDailySummaryHour(): Flow = dataStore.data.map { it[DAILY_SUMMARY_HOUR] ?: 20 } // 8 PM default + suspend fun setDailySummaryHour(hour: Int) { dataStore.edit { it[DAILY_SUMMARY_HOUR] = hour } } + + fun getWeeklySummaryEnabled(): Flow = dataStore.data.map { it[WEEKLY_SUMMARY] ?: true } + suspend fun setWeeklySummaryEnabled(enabled: Boolean) { dataStore.edit { it[WEEKLY_SUMMARY] = enabled } } + + fun getBudgetAlertsEnabled(): Flow = dataStore.data.map { it[BUDGET_ALERTS] ?: true } + suspend fun setBudgetAlertsEnabled(enabled: Boolean) { dataStore.edit { it[BUDGET_ALERTS] = enabled } } + + fun getLargeTransactionAlertEnabled(): Flow = dataStore.data.map { it[LARGE_TXN_ALERT] ?: false } + suspend fun setLargeTransactionAlertEnabled(enabled: Boolean) { dataStore.edit { it[LARGE_TXN_ALERT] = enabled } } + + fun getLargeTransactionThreshold(): Flow = dataStore.data.map { it[LARGE_TXN_THRESHOLD] ?: 5000.0 } + suspend fun setLargeTransactionThreshold(amount: Double) { dataStore.edit { it[LARGE_TXN_THRESHOLD] = amount } } + + // --- Font scale --- + + fun getFontScale(): Flow = dataStore.data.map { prefs -> + when (prefs[FONT_SCALE]) { + "SMALL" -> FontScale.SMALL + "MEDIUM" -> FontScale.MEDIUM + "LARGE" -> FontScale.LARGE + "EXTRA_LARGE" -> FontScale.EXTRA_LARGE + else -> FontScale.SYSTEM + } + } + + suspend fun setFontScale(scale: FontScale) { + dataStore.edit { it[FONT_SCALE] = scale.name } + } +} + +enum class FontScale(val label: String, val scale: Float) { + SYSTEM("System Default", 1.0f), + SMALL("Small", 0.85f), + MEDIUM("Medium", 1.0f), + LARGE("Large", 1.15f), + EXTRA_LARGE("Extra Large", 1.3f) +} diff --git a/app/src/main/java/com/ledga/app/data/repository/SmsImporter.kt b/app/src/main/java/com/ledga/app/data/repository/SmsImporter.kt new file mode 100644 index 0000000..64364b3 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/repository/SmsImporter.kt @@ -0,0 +1,74 @@ +package com.ledga.app.data.repository + +import android.content.ContentResolver +import android.net.Uri +import com.ledga.app.data.parser.MpesaSmsParser +import com.ledga.app.data.parser.ParseResult +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext +import javax.inject.Inject +import javax.inject.Singleton + +data class ImportResult( + val total: Int, + val imported: Int, + val failed: Int +) + +@Singleton +class SmsImporter @Inject constructor( + private val contentResolver: ContentResolver, + private val transactionRepository: TransactionRepository +) { + suspend fun importHistory( + onProgress: (imported: Int, total: Int) -> Unit = { _, _ -> } + ): ImportResult = withContext(Dispatchers.IO) { + val smsList = readMpesaSms() + val total = smsList.size + var imported = 0 + var failed = 0 + + smsList.forEachIndexed { index, sms -> + val result = MpesaSmsParser.parse(sms.body, sms.date) + when (result) { + is ParseResult.Success -> { + val id = transactionRepository.insertTransaction(result.transaction) + if (id != -1L) imported++ + } + is ParseResult.Failure -> failed++ + } + onProgress(index + 1, total) + } + + ImportResult(total = total, imported = imported, failed = failed) + } + + private fun readMpesaSms(): List { + val messages = mutableListOf() + val uri = Uri.parse("content://sms/inbox") + val cursor = contentResolver.query( + uri, + arrayOf("body", "date", "address"), + "address = ?", + arrayOf("MPESA"), + "date DESC" + ) + + cursor?.use { + val bodyIndex = it.getColumnIndexOrThrow("body") + val dateIndex = it.getColumnIndexOrThrow("date") + while (it.moveToNext()) { + messages.add( + SmsMessage( + body = it.getString(bodyIndex), + date = it.getLong(dateIndex) + ) + ) + } + } + + return messages + } + + private data class SmsMessage(val body: String, val date: Long) +} diff --git a/app/src/main/java/com/ledga/app/data/repository/TransactionRepository.kt b/app/src/main/java/com/ledga/app/data/repository/TransactionRepository.kt new file mode 100644 index 0000000..efa5fd2 --- /dev/null +++ b/app/src/main/java/com/ledga/app/data/repository/TransactionRepository.kt @@ -0,0 +1,129 @@ +package com.ledga.app.data.repository + +import com.ledga.app.data.db.dao.CategoryRuleDao +import com.ledga.app.data.db.dao.CategorySpending +import com.ledga.app.data.db.dao.DailySpending +import com.ledga.app.data.db.dao.TopMerchant +import com.ledga.app.data.db.dao.TransactionDao +import com.ledga.app.data.db.entity.MatchType +import com.ledga.app.data.db.entity.TransactionEntity +import com.ledga.app.data.db.entity.TransactionWithCategory +import com.ledga.app.data.parser.ParsedTransaction +import com.ledga.app.data.parser.TransactionType +import kotlinx.coroutines.flow.Flow +import javax.inject.Inject +import javax.inject.Singleton + +@Singleton +class TransactionRepository @Inject constructor( + private val transactionDao: TransactionDao, + private val categoryRuleDao: CategoryRuleDao +) { + suspend fun insertTransaction(parsed: ParsedTransaction): Long { + val categoryId = autoCategorize(parsed) + val entity = TransactionEntity( + transactionCode = parsed.transactionCode, + type = parsed.type, + amount = parsed.amount, + transactionCost = parsed.transactionCost, + recipientName = parsed.recipientName, + recipientPhone = parsed.recipientPhone, + accountNumber = parsed.accountNumber, + destinationCountry = parsed.destinationCountry, + balance = parsed.balance, + direction = parsed.direction, + categoryId = categoryId, + fulizaAmount = parsed.fulizaAmount, + fulizaOutstanding = parsed.fulizaOutstanding, + reversedTransactionCode = parsed.reversedTransactionCode, + rawSms = parsed.rawSms, + timestamp = parsed.timestamp + ) + return transactionDao.insert(entity) + } + + fun getRecentTransactions(limit: Int = 10): Flow> = + transactionDao.getRecentTransactions(limit) + + fun getTransactions(startTime: Long, endTime: Long): Flow> = + transactionDao.getTransactions(startTime, endTime) + + fun getLatestTransaction(): Flow = + transactionDao.getLatestTransaction() + + fun getSpendingByCategory(startTime: Long, endTime: Long): Flow> = + transactionDao.getSpendingByCategory(startTime, endTime) + + fun getTotalSpending(startTime: Long, endTime: Long): Flow = + transactionDao.getTotalSpending(startTime, endTime) + + fun getTotalFees(startTime: Long, endTime: Long): Flow = + transactionDao.getTotalFees(startTime, endTime) + + fun searchTransactions(query: String): Flow> = + transactionDao.searchTransactions(query) + + fun getTransactionsByType(types: List): Flow> = + transactionDao.getTransactionsByType(types) + + fun getDailySpending(startTime: Long, endTime: Long): Flow> = + transactionDao.getDailySpending(startTime, endTime) + + fun getTopMerchants(startTime: Long, endTime: Long, limit: Int = 5): Flow> = + transactionDao.getTopMerchants(startTime, endTime, limit) + + fun getUnparsedTransactions(): Flow> = + transactionDao.getUnparsedTransactions() + + fun getUnparsedCount(): Flow = + transactionDao.getUnparsedCount() + + suspend fun updateCategory(transactionId: Long, categoryId: Long?) { + transactionDao.updateCategory(transactionId, categoryId) + } + + private suspend fun autoCategorize(parsed: ParsedTransaction): Long? { + // 1. Type-based defaults + val typeDefault = when (parsed.type) { + TransactionType.AIRTIME_SELF, TransactionType.AIRTIME_OTHER -> 4L // Airtime & Data + TransactionType.SEND -> 6L // Send Money + TransactionType.RECEIVED -> 7L // Received + TransactionType.WITHDRAW_AGENT, TransactionType.WITHDRAW_ATM -> 8L // Withdrawal + TransactionType.DEPOSIT -> 9L // Deposit + TransactionType.MPESA_GLOBAL -> 11L // International + TransactionType.MSHWARI, TransactionType.KCB_MPESA -> 12L // Savings & Loans + TransactionType.FULIZA, TransactionType.FULIZA_REPAYMENT, TransactionType.FULIZA_REVERSAL -> 12L + TransactionType.REVERSAL -> 13L // Other + TransactionType.UNKNOWN -> 13L + else -> null + } + + // 2. Rule-based matching (overrides type default for BUY_GOODS, PAY_BILL, SEND) + if (parsed.recipientName != null) { + val rules = categoryRuleDao.getAllRulesSync() + val nameUpper = parsed.recipientName.uppercase() + + // Check recipient name rules + for (rule in rules) { + if (rule.matchType == MatchType.RECIPIENT_NAME && + nameUpper.contains(rule.matchValue.uppercase()) + ) { + return rule.categoryId + } + } + + // Check paybill rules + if (parsed.accountNumber != null) { + for (rule in rules) { + if (rule.matchType == MatchType.PAYBILL && + parsed.accountNumber == rule.matchValue + ) { + return rule.categoryId + } + } + } + } + + return typeDefault ?: 13L // Default to "Other" + } +} diff --git a/app/src/main/java/com/ledga/app/di/AppModule.kt b/app/src/main/java/com/ledga/app/di/AppModule.kt new file mode 100644 index 0000000..36abe07 --- /dev/null +++ b/app/src/main/java/com/ledga/app/di/AppModule.kt @@ -0,0 +1,31 @@ +package com.ledga.app.di + +import android.content.ContentResolver +import android.content.Context +import androidx.datastore.core.DataStore +import androidx.datastore.preferences.core.Preferences +import androidx.datastore.preferences.preferencesDataStore +import dagger.Module +import dagger.Provides +import dagger.hilt.InstallIn +import dagger.hilt.android.qualifiers.ApplicationContext +import dagger.hilt.components.SingletonComponent +import javax.inject.Singleton + +private val Context.dataStore: DataStore by preferencesDataStore(name = "ledga_settings") + +@Module +@InstallIn(SingletonComponent::class) +object AppModule { + + @Provides + @Singleton + fun provideDataStore(@ApplicationContext context: Context): DataStore { + return context.dataStore + } + + @Provides + fun provideContentResolver(@ApplicationContext context: Context): ContentResolver { + return context.contentResolver + } +} diff --git a/app/src/main/java/com/ledga/app/di/DatabaseModule.kt b/app/src/main/java/com/ledga/app/di/DatabaseModule.kt new file mode 100644 index 0000000..d77b6ae --- /dev/null +++ b/app/src/main/java/com/ledga/app/di/DatabaseModule.kt @@ -0,0 +1,61 @@ +package com.ledga.app.di + +import android.content.Context +import androidx.room.Room +import androidx.room.RoomDatabase +import androidx.sqlite.db.SupportSQLiteDatabase +import com.ledga.app.data.db.AppDatabase +import com.ledga.app.data.db.DefaultData +import com.ledga.app.data.db.dao.BudgetDao +import com.ledga.app.data.db.dao.CategoryDao +import com.ledga.app.data.db.dao.CategoryRuleDao +import com.ledga.app.data.db.dao.TransactionDao +import dagger.Module +import dagger.Provides +import dagger.hilt.InstallIn +import dagger.hilt.android.qualifiers.ApplicationContext +import dagger.hilt.components.SingletonComponent +import kotlinx.coroutines.CoroutineScope +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.launch +import javax.inject.Singleton + +@Module +@InstallIn(SingletonComponent::class) +object DatabaseModule { + + @Provides + @Singleton + fun provideDatabase(@ApplicationContext context: Context): AppDatabase { + return Room.databaseBuilder( + context, + AppDatabase::class.java, + "ledga.db" + ) + .addCallback(object : RoomDatabase.Callback() { + override fun onCreate(db: SupportSQLiteDatabase) { + super.onCreate(db) + CoroutineScope(Dispatchers.IO).launch { + val database = Room.databaseBuilder( + context, AppDatabase::class.java, "ledga.db" + ).build() + database.categoryDao().insertAll(DefaultData.DEFAULT_CATEGORIES) + database.categoryRuleDao().insertAll(DefaultData.DEFAULT_RULES) + } + } + }) + .build() + } + + @Provides + fun provideTransactionDao(db: AppDatabase): TransactionDao = db.transactionDao() + + @Provides + fun provideCategoryDao(db: AppDatabase): CategoryDao = db.categoryDao() + + @Provides + fun provideCategoryRuleDao(db: AppDatabase): CategoryRuleDao = db.categoryRuleDao() + + @Provides + fun provideBudgetDao(db: AppDatabase): BudgetDao = db.budgetDao() +} diff --git a/app/src/main/java/com/ledga/app/receiver/SmsReceiver.kt b/app/src/main/java/com/ledga/app/receiver/SmsReceiver.kt new file mode 100644 index 0000000..22b12cc --- /dev/null +++ b/app/src/main/java/com/ledga/app/receiver/SmsReceiver.kt @@ -0,0 +1,72 @@ +package com.ledga.app.receiver + +import android.content.BroadcastReceiver +import android.content.Context +import android.content.Intent +import android.provider.Telephony +import com.ledga.app.data.parser.MpesaSmsParser +import com.ledga.app.data.parser.ParseResult +import com.ledga.app.data.repository.SettingsRepository +import com.ledga.app.data.repository.TransactionRepository +import com.ledga.app.worker.TransactionAlerts +import dagger.hilt.android.AndroidEntryPoint +import kotlinx.coroutines.CoroutineScope +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.flow.first +import kotlinx.coroutines.launch +import javax.inject.Inject + +@AndroidEntryPoint +class SmsReceiver : BroadcastReceiver() { + + @Inject + lateinit var transactionRepository: TransactionRepository + + @Inject + lateinit var transactionAlerts: TransactionAlerts + + @Inject + lateinit var settingsRepository: SettingsRepository + + override fun onReceive(context: Context, intent: Intent) { + if (intent.action != Telephony.Sms.Intents.SMS_RECEIVED_ACTION) return + + val messages = Telephony.Sms.Intents.getMessagesFromIntent(intent) + val pendingResult = goAsync() + + CoroutineScope(Dispatchers.IO).launch { + try { + // Group message parts by sender (multi-part SMS) + val fullMessages = messages + .groupBy { it.displayOriginatingAddress } + .mapValues { (_, parts) -> parts.joinToString("") { it.displayMessageBody } } + + for ((sender, body) in fullMessages) { + if (!MpesaSmsParser.isMpesaMessage(sender ?: "")) continue + + when (val result = MpesaSmsParser.parse(body, System.currentTimeMillis())) { + is ParseResult.Success -> { + transactionRepository.insertTransaction(result.transaction) + // Check for alerts + val largeTxnEnabled = settingsRepository.getLargeTransactionAlertEnabled().first() + val largeTxnThreshold = settingsRepository.getLargeTransactionThreshold().first() + val budgetEnabled = settingsRepository.getBudgetAlertsEnabled().first() + transactionAlerts.checkAlerts( + context = context, + transaction = result.transaction, + largeTransactionThreshold = largeTxnThreshold, + largeTransactionEnabled = largeTxnEnabled, + budgetAlertsEnabled = budgetEnabled + ) + } + is ParseResult.Failure -> { + // Store as UNKNOWN for later review + } + } + } + } finally { + pendingResult.finish() + } + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/components/BudgetProgressBar.kt b/app/src/main/java/com/ledga/app/ui/components/BudgetProgressBar.kt new file mode 100644 index 0000000..7aed3e6 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/components/BudgetProgressBar.kt @@ -0,0 +1,55 @@ +package com.ledga.app.ui.components + +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.material3.LinearProgressIndicator +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import com.ledga.app.ui.theme.InflowGreen +import com.ledga.app.ui.theme.OutflowRed +import com.ledga.app.util.CurrencyFormatter + +@Composable +fun BudgetProgressBar( + label: String, + spent: Double, + limit: Double, + modifier: Modifier = Modifier +) { + val progress = if (limit > 0) (spent / limit).toFloat().coerceIn(0f, 1f) else 0f + val percentage = if (limit > 0) ((spent / limit) * 100).toInt() else 0 + val color = when { + percentage >= 100 -> OutflowRed + percentage >= 80 -> MaterialTheme.colorScheme.error.copy(alpha = 0.7f) + else -> InflowGreen + } + + Column(modifier = modifier.fillMaxWidth()) { + Row(verticalAlignment = Alignment.CenterVertically) { + Text( + text = label, + style = MaterialTheme.typography.bodyMedium, + modifier = Modifier.weight(1f) + ) + Text( + text = "${CurrencyFormatter.formatKshCompact(spent)} / ${CurrencyFormatter.formatKshCompact(limit)}", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + Spacer(modifier = Modifier.height(4.dp)) + LinearProgressIndicator( + progress = { progress }, + modifier = Modifier.fillMaxWidth().height(8.dp), + color = color, + trackColor = MaterialTheme.colorScheme.surfaceVariant, + ) + } +} diff --git a/app/src/main/java/com/ledga/app/ui/components/CategoryChip.kt b/app/src/main/java/com/ledga/app/ui/components/CategoryChip.kt new file mode 100644 index 0000000..6b5faa9 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/components/CategoryChip.kt @@ -0,0 +1,21 @@ +package com.ledga.app.ui.components + +import androidx.compose.material3.FilterChip +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier + +@Composable +fun CategoryChip( + label: String, + isSelected: Boolean, + onClick: () -> Unit, + modifier: Modifier = Modifier +) { + FilterChip( + modifier = modifier, + selected = isSelected, + onClick = onClick, + label = { Text(label) } + ) +} diff --git a/app/src/main/java/com/ledga/app/ui/components/DonutChart.kt b/app/src/main/java/com/ledga/app/ui/components/DonutChart.kt new file mode 100644 index 0000000..18d13a8 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/components/DonutChart.kt @@ -0,0 +1,87 @@ +package com.ledga.app.ui.components + +import androidx.compose.animation.core.Animatable +import androidx.compose.animation.core.tween +import androidx.compose.foundation.Canvas +import androidx.compose.foundation.layout.Box +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.size +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.remember +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.graphics.StrokeCap +import androidx.compose.ui.graphics.drawscope.Stroke +import androidx.compose.ui.text.style.TextAlign +import androidx.compose.ui.unit.dp +import com.ledga.app.util.CurrencyFormatter + +data class DonutSegment( + val label: String, + val value: Float, + val color: Color +) + +@Composable +fun DonutChart( + segments: List, + totalAmount: Double, + modifier: Modifier = Modifier +) { + val animationProgress = remember { Animatable(0f) } + + LaunchedEffect(segments) { + animationProgress.snapTo(0f) + animationProgress.animateTo(1f, animationSpec = tween(800)) + } + + val total = segments.sumOf { it.value.toDouble() }.toFloat() + + Box(modifier = modifier, contentAlignment = Alignment.Center) { + Canvas(modifier = Modifier.size(180.dp)) { + val strokeWidth = 32.dp.toPx() + val radius = (size.minDimension - strokeWidth) / 2 + var startAngle = -90f + + if (total == 0f) { + drawArc( + color = Color.LightGray, + startAngle = 0f, + sweepAngle = 360f, + useCenter = false, + style = Stroke(width = strokeWidth, cap = StrokeCap.Round) + ) + return@Canvas + } + + segments.forEach { segment -> + val sweep = (segment.value / total) * 360f * animationProgress.value + drawArc( + color = segment.color, + startAngle = startAngle, + sweepAngle = sweep, + useCenter = false, + style = Stroke(width = strokeWidth, cap = StrokeCap.Butt) + ) + startAngle += (segment.value / total) * 360f * animationProgress.value + } + } + + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Text( + text = CurrencyFormatter.formatKshCompact(totalAmount), + style = MaterialTheme.typography.titleMedium, + textAlign = TextAlign.Center + ) + Text( + text = "Total Spent", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/components/PeriodSelector.kt b/app/src/main/java/com/ledga/app/ui/components/PeriodSelector.kt new file mode 100644 index 0000000..f546bbb --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/components/PeriodSelector.kt @@ -0,0 +1,34 @@ +package com.ledga.app.ui.components + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp + +enum class Period(val label: String) { + TODAY("Today"), + THIS_WEEK("This Week"), + THIS_MONTH("Month") +} + +@Composable +fun PeriodSelector( + selected: Period, + onSelect: (Period) -> Unit, + modifier: Modifier = Modifier +) { + Row( + modifier = modifier.fillMaxWidth(), + horizontalArrangement = Arrangement.spacedBy(8.dp) + ) { + Period.entries.forEach { period -> + CategoryChip( + label = period.label, + isSelected = selected == period, + onClick = { onSelect(period) } + ) + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/components/StatCard.kt b/app/src/main/java/com/ledga/app/ui/components/StatCard.kt new file mode 100644 index 0000000..ddef493 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/components/StatCard.kt @@ -0,0 +1,45 @@ +package com.ledga.app.ui.components + +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.padding +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp + +@Composable +fun StatCard( + label: String, + value: String, + subtitle: String? = null, + modifier: Modifier = Modifier +) { + Card( + modifier = modifier, + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant + ) + ) { + Column(modifier = Modifier.padding(16.dp)) { + Text( + text = label, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Text( + text = value, + style = MaterialTheme.typography.headlineSmall + ) + if (subtitle != null) { + Text( + text = subtitle, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/components/TransactionCard.kt b/app/src/main/java/com/ledga/app/ui/components/TransactionCard.kt new file mode 100644 index 0000000..cb1a471 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/components/TransactionCard.kt @@ -0,0 +1,98 @@ +package com.ledga.app.ui.components + +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.layout.width +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.ShoppingCart +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.Icon +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.unit.dp +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.TransactionEntity +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.ui.theme.InflowGreen +import com.ledga.app.ui.theme.OutflowRed +import com.ledga.app.util.CurrencyFormatter +import com.ledga.app.util.DateUtils + +@Composable +fun TransactionCard( + transaction: TransactionEntity, + category: Category?, + onClick: () -> Unit = {}, + modifier: Modifier = Modifier +) { + val isInflow = transaction.direction == TransactionDirection.INFLOW + val amountColor = if (isInflow) InflowGreen else OutflowRed + val displayName = transaction.recipientName ?: transaction.type.name.replace("_", " ") + + Card( + modifier = modifier + .fillMaxWidth() + .clickable(onClick = onClick), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surface + ), + elevation = CardDefaults.cardElevation(defaultElevation = 1.dp) + ) { + Row( + modifier = Modifier + .fillMaxWidth() + .padding(12.dp), + verticalAlignment = Alignment.CenterVertically + ) { + // Category icon + Icon( + imageVector = Icons.Default.ShoppingCart, + contentDescription = category?.name, + modifier = Modifier.size(40.dp), + tint = category?.color?.let { parseColor(it) } + ?: MaterialTheme.colorScheme.onSurfaceVariant + ) + + Spacer(modifier = Modifier.width(12.dp)) + + // Name and time + Column(modifier = Modifier.weight(1f)) { + Text( + text = displayName, + style = MaterialTheme.typography.bodyLarge, + maxLines = 1 + ) + Text( + text = DateUtils.formatTime(transaction.timestamp), + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + + // Amount + Text( + text = CurrencyFormatter.formatKshSigned(transaction.amount, isInflow), + style = MaterialTheme.typography.titleSmall, + color = amountColor + ) + } + } +} + +fun parseColor(hex: String): Color { + return try { + Color(android.graphics.Color.parseColor(hex)) + } catch (e: Exception) { + Color.Gray + } +} diff --git a/app/src/main/java/com/ledga/app/ui/home/HomeScreen.kt b/app/src/main/java/com/ledga/app/ui/home/HomeScreen.kt new file mode 100644 index 0000000..eb6b971 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/home/HomeScreen.kt @@ -0,0 +1,132 @@ +package com.ledga.app.ui.home + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel +import com.ledga.app.ui.components.DonutChart +import com.ledga.app.ui.components.PeriodSelector +import com.ledga.app.ui.components.StatCard +import com.ledga.app.ui.components.TransactionCard +import com.ledga.app.util.CurrencyFormatter + +@Composable +fun HomeScreen( + viewModel: HomeViewModel = hiltViewModel() +) { + val state by viewModel.uiState.collectAsState() + + LazyColumn( + modifier = Modifier + .fillMaxSize() + .padding(horizontal = 16.dp), + verticalArrangement = Arrangement.spacedBy(12.dp) + ) { + // Greeting + item { + Spacer(modifier = Modifier.height(16.dp)) + Text( + text = state.greeting, + style = MaterialTheme.typography.headlineSmall + ) + } + + // Balance card + item { + StatCard( + label = "M-PESA Balance", + value = state.balance?.let { CurrencyFormatter.formatKsh(it) } ?: "—", + subtitle = "from last transaction", + modifier = Modifier.fillMaxWidth() + ) + } + + // Spending summary + item { + Row( + modifier = Modifier.fillMaxWidth(), + horizontalArrangement = Arrangement.spacedBy(12.dp) + ) { + StatCard( + label = state.monthLabel, + value = CurrencyFormatter.formatKshCompact(state.totalSpending), + subtitle = "Spent", + modifier = Modifier.weight(1f) + ) + StatCard( + label = "Fees", + value = CurrencyFormatter.formatKsh(state.totalFees), + modifier = Modifier.weight(1f) + ) + } + } + + // Period selector + item { + PeriodSelector( + selected = state.selectedPeriod, + onSelect = { viewModel.selectPeriod(it) } + ) + } + + // Donut chart + item { + if (state.donutSegments.isNotEmpty()) { + DonutChart( + segments = state.donutSegments, + totalAmount = state.totalSpending, + modifier = Modifier + .fillMaxWidth() + .padding(vertical = 8.dp) + ) + } + } + + // Recent transactions header + item { + Text( + text = "Recent Transactions", + style = MaterialTheme.typography.titleMedium + ) + } + + // Transaction list + if (state.recentTransactions.isEmpty()) { + item { + Text( + text = "No transactions yet. Your M-Pesa transactions will appear here.", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant, + modifier = Modifier.padding(vertical = 24.dp) + ) + } + } else { + items( + items = state.recentTransactions, + key = { it.transaction.id } + ) { twc -> + TransactionCard( + transaction = twc.transaction, + category = twc.category + ) + } + } + + item { Spacer(modifier = Modifier.height(16.dp)) } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/home/HomeViewModel.kt b/app/src/main/java/com/ledga/app/ui/home/HomeViewModel.kt new file mode 100644 index 0000000..7f3c7ec --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/home/HomeViewModel.kt @@ -0,0 +1,132 @@ +package com.ledga.app.ui.home + +import androidx.compose.ui.graphics.Color +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import android.app.Application +import com.ledga.app.BuildConfig +import com.ledga.app.data.db.dao.CategorySpending +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.TransactionWithCategory +import com.ledga.app.data.repository.CategoryRepository +import com.ledga.app.data.repository.TransactionRepository +import com.ledga.app.ui.components.DonutSegment +import com.ledga.app.ui.components.Period +import com.ledga.app.ui.components.parseColor +import com.ledga.app.util.DateUtils +import com.ledga.app.worker.GitHubRelease +import com.ledga.app.worker.UpdateChecker +import dagger.hilt.android.lifecycle.HiltViewModel +import dagger.hilt.android.qualifiers.ApplicationContext +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.combine +import kotlinx.coroutines.flow.flatMapLatest +import kotlinx.coroutines.flow.stateIn +import kotlinx.coroutines.launch +import android.content.Context +import javax.inject.Inject + +data class HomeUiState( + val greeting: String = "", + val balance: Double? = null, + val totalSpending: Double = 0.0, + val totalFees: Double = 0.0, + val donutSegments: List = emptyList(), + val recentTransactions: List = emptyList(), + val selectedPeriod: Period = Period.THIS_MONTH, + val monthLabel: String = "", + val updateAvailable: GitHubRelease? = null +) + +@HiltViewModel +class HomeViewModel @Inject constructor( + @ApplicationContext private val appContext: Context, + private val transactionRepository: TransactionRepository, + private val categoryRepository: CategoryRepository +) : ViewModel() { + + private val _updateAvailable = MutableStateFlow(null) + + init { + viewModelScope.launch { + val release = UpdateChecker.checkForUpdate( + context = appContext, + owner = "ngenohkevin", + repo = "ledga", + currentVersion = BuildConfig.VERSION_NAME + ) + _updateAvailable.value = release + } + } + + private val _selectedPeriod = MutableStateFlow(Period.THIS_MONTH) + + private val timeRange = _selectedPeriod.flatMapLatest { period -> + val now = System.currentTimeMillis() + val start = when (period) { + Period.TODAY -> DateUtils.getStartOfDay(now) + Period.THIS_WEEK -> DateUtils.getStartOfWeek(now) + Period.THIS_MONTH -> DateUtils.getStartOfMonth(now) + } + kotlinx.coroutines.flow.flowOf(start to now) + } + + val uiState: StateFlow = combine( + _selectedPeriod, + timeRange, + transactionRepository.getLatestTransaction(), + transactionRepository.getRecentTransactions(10), + categoryRepository.getAllCategories() + ) { period, (start, end), latestTransaction, recentTransactions, categories -> + val categoryMap = categories.associateBy { it.id } + + HomeUiState( + greeting = DateUtils.greeting(), + balance = latestTransaction?.balance, + recentTransactions = recentTransactions, + selectedPeriod = period, + monthLabel = DateUtils.formatMonthYear(System.currentTimeMillis()) + ) + }.combine( + timeRange.flatMapLatest { (start, end) -> + combine( + transactionRepository.getTotalSpending(start, end), + transactionRepository.getTotalFees(start, end), + transactionRepository.getSpendingByCategory(start, end), + categoryRepository.getAllCategories() + ) { spending, fees, categorySpending, categories -> + Triple(spending, fees, buildDonutSegments(categorySpending, categories)) + } + } + ) { state, (spending, fees, segments) -> + state.copy( + totalSpending = spending, + totalFees = fees, + donutSegments = segments + ) + }.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), HomeUiState()) + + fun selectPeriod(period: Period) { + _selectedPeriod.value = period + } + + private fun buildDonutSegments( + spending: List, + categories: List + ): List { + val categoryMap = categories.associateBy { it.id } + return spending + .sortedByDescending { it.totalAmount } + .take(6) + .map { cs -> + val cat = categoryMap[cs.categoryId] + DonutSegment( + label = cat?.name ?: "Other", + value = cs.totalAmount.toFloat(), + color = cat?.color?.let { parseColor(it) } ?: Color.Gray + ) + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/navigation/AppNavigation.kt b/app/src/main/java/com/ledga/app/ui/navigation/AppNavigation.kt new file mode 100644 index 0000000..58adbe3 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/navigation/AppNavigation.kt @@ -0,0 +1,58 @@ +package com.ledga.app.ui.navigation + +import androidx.compose.runtime.Composable +import androidx.compose.ui.Modifier +import androidx.navigation.NavHostController +import androidx.navigation.compose.NavHost +import androidx.navigation.compose.composable +import com.ledga.app.ui.home.HomeScreen +import com.ledga.app.ui.onboarding.OnboardingScreen +import com.ledga.app.ui.settings.BudgetScreen +import com.ledga.app.ui.settings.SettingsScreen +import com.ledga.app.ui.settings.UnparsedSmsScreen +import com.ledga.app.ui.transactions.TransactionsScreen +import com.ledga.app.ui.trends.TrendsScreen + +@Composable +fun AppNavigation( + navController: NavHostController, + startDestination: Any, + modifier: Modifier = Modifier +) { + NavHost( + navController = navController, + startDestination = startDestination, + modifier = modifier + ) { + composable { + OnboardingScreen( + onComplete = { + navController.navigate(HomeRoute) { + popUpTo(OnboardingRoute) { inclusive = true } + } + } + ) + } + composable { + HomeScreen() + } + composable { + TransactionsScreen() + } + composable { + TrendsScreen() + } + composable { + SettingsScreen( + onNavigateToUnparsed = { navController.navigate(UnparsedSmsRoute) }, + onNavigateToBudgets = { navController.navigate(BudgetRoute) } + ) + } + composable { + UnparsedSmsScreen(onBack = { navController.popBackStack() }) + } + composable { + BudgetScreen(onBack = { navController.popBackStack() }) + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/navigation/BottomNavBar.kt b/app/src/main/java/com/ledga/app/ui/navigation/BottomNavBar.kt new file mode 100644 index 0000000..39b4f09 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/navigation/BottomNavBar.kt @@ -0,0 +1,53 @@ +package com.ledga.app.ui.navigation + +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.Home +import androidx.compose.material.icons.filled.List +import androidx.compose.material.icons.filled.Settings +import androidx.compose.material.icons.filled.TrendingUp +import androidx.compose.material3.Icon +import androidx.compose.material3.NavigationBar +import androidx.compose.material3.NavigationBarItem +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.getValue +import androidx.compose.ui.graphics.vector.ImageVector +import androidx.navigation.NavController +import androidx.navigation.NavDestination.Companion.hasRoute +import androidx.navigation.compose.currentBackStackEntryAsState + +data class BottomNavItem( + val label: String, + val icon: ImageVector, + val route: T +) + +@Composable +fun LedgaBottomNavBar(navController: NavController) { + val items = listOf( + BottomNavItem("Home", Icons.Default.Home, HomeRoute), + BottomNavItem("Transactions", Icons.Default.List, TransactionsRoute), + BottomNavItem("Trends", Icons.Default.TrendingUp, TrendsRoute), + BottomNavItem("Settings", Icons.Default.Settings, SettingsRoute), + ) + + val navBackStackEntry by navController.currentBackStackEntryAsState() + val currentDestination = navBackStackEntry?.destination + + NavigationBar { + items.forEach { item -> + NavigationBarItem( + icon = { Icon(item.icon, contentDescription = item.label) }, + label = { Text(item.label) }, + selected = currentDestination?.hasRoute(item.route::class) == true, + onClick = { + navController.navigate(item.route) { + popUpTo(HomeRoute) { saveState = true } + launchSingleTop = true + restoreState = true + } + } + ) + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/navigation/Routes.kt b/app/src/main/java/com/ledga/app/ui/navigation/Routes.kt new file mode 100644 index 0000000..a486487 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/navigation/Routes.kt @@ -0,0 +1,11 @@ +package com.ledga.app.ui.navigation + +import kotlinx.serialization.Serializable + +@Serializable object HomeRoute +@Serializable object TransactionsRoute +@Serializable object TrendsRoute +@Serializable object SettingsRoute +@Serializable object OnboardingRoute +@Serializable object UnparsedSmsRoute +@Serializable object BudgetRoute diff --git a/app/src/main/java/com/ledga/app/ui/onboarding/OnboardingScreen.kt b/app/src/main/java/com/ledga/app/ui/onboarding/OnboardingScreen.kt new file mode 100644 index 0000000..4828c5e --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/onboarding/OnboardingScreen.kt @@ -0,0 +1,266 @@ +package com.ledga.app.ui.onboarding + +import android.Manifest +import android.os.Build +import androidx.activity.compose.rememberLauncherForActivityResult +import androidx.activity.result.contract.ActivityResultContracts +import androidx.compose.animation.AnimatedContent +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.CheckCircle +import androidx.compose.material.icons.filled.Lock +import androidx.compose.material.icons.filled.MailOutline +import androidx.compose.material.icons.filled.Star +import androidx.compose.material3.Button +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.Icon +import androidx.compose.material3.LinearProgressIndicator +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.style.TextAlign +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel + +@Composable +fun OnboardingScreen( + onComplete: () -> Unit, + viewModel: OnboardingViewModel = hiltViewModel() +) { + val currentStep by viewModel.currentStep.collectAsState() + val importProgress by viewModel.importProgress.collectAsState() + + val smsPermissionLauncher = rememberLauncherForActivityResult( + ActivityResultContracts.RequestMultiplePermissions() + ) { permissions -> + if (permissions.values.any { it }) { + viewModel.nextStep() + } + } + + Column( + modifier = Modifier + .fillMaxSize() + .padding(24.dp), + horizontalAlignment = Alignment.CenterHorizontally, + verticalArrangement = Arrangement.Center + ) { + AnimatedContent(targetState = currentStep, label = "onboarding") { step -> + when (step) { + 0 -> WelcomeStep(onNext = { viewModel.nextStep() }) + 1 -> SmsPermissionStep( + onRequestPermission = { + val permissions = mutableListOf( + Manifest.permission.RECEIVE_SMS, + Manifest.permission.READ_SMS + ) + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) { + permissions.add(Manifest.permission.POST_NOTIFICATIONS) + } + smsPermissionLauncher.launch(permissions.toTypedArray()) + } + ) + 2 -> ImportStep( + progress = importProgress, + onImport = { viewModel.startImport() }, + onSkip = { viewModel.skipImport() } + ) + 3 -> CompletionStep( + importResult = importProgress.result, + onComplete = { + viewModel.completeOnboarding() + onComplete() + } + ) + } + } + + Spacer(modifier = Modifier.height(32.dp)) + + // Step indicators + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + repeat(4) { index -> + Icon( + imageVector = if (index <= currentStep) Icons.Default.CheckCircle else Icons.Default.Star, + contentDescription = null, + modifier = Modifier.size(12.dp), + tint = if (index <= currentStep) MaterialTheme.colorScheme.primary + else MaterialTheme.colorScheme.outlineVariant + ) + } + } + } +} + +@Composable +private fun WelcomeStep(onNext: () -> Unit) { + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Icon( + imageVector = Icons.Default.Star, + contentDescription = null, + modifier = Modifier.size(80.dp), + tint = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(24.dp)) + Text( + text = "Welcome to Ledga", + style = MaterialTheme.typography.headlineMedium, + textAlign = TextAlign.Center + ) + Spacer(modifier = Modifier.height(12.dp)) + Text( + text = "Track your M-Pesa spending automatically.\nNo typing, no manual entry.", + style = MaterialTheme.typography.bodyLarge, + textAlign = TextAlign.Center, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Spacer(modifier = Modifier.height(32.dp)) + Button(onClick = onNext, modifier = Modifier.fillMaxWidth()) { + Text("Get Started") + } + } +} + +@Composable +private fun SmsPermissionStep(onRequestPermission: () -> Unit) { + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Icon( + imageVector = Icons.Default.Lock, + contentDescription = null, + modifier = Modifier.size(80.dp), + tint = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(24.dp)) + Text( + text = "SMS Access", + style = MaterialTheme.typography.headlineMedium, + textAlign = TextAlign.Center + ) + Spacer(modifier = Modifier.height(12.dp)) + Text( + text = "Ledga reads your M-Pesa SMS to track your spending.\n\nYour messages never leave your phone. Everything stays private and offline.", + style = MaterialTheme.typography.bodyLarge, + textAlign = TextAlign.Center, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Spacer(modifier = Modifier.height(32.dp)) + Button(onClick = onRequestPermission, modifier = Modifier.fillMaxWidth()) { + Text("Allow SMS Access") + } + } +} + +@Composable +private fun ImportStep( + progress: ImportProgress, + onImport: () -> Unit, + onSkip: () -> Unit +) { + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Icon( + imageVector = Icons.Default.MailOutline, + contentDescription = null, + modifier = Modifier.size(80.dp), + tint = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(24.dp)) + Text( + text = "Import History", + style = MaterialTheme.typography.headlineMedium, + textAlign = TextAlign.Center + ) + Spacer(modifier = Modifier.height(12.dp)) + Text( + text = "Scan your existing M-Pesa messages to build your spending history.", + style = MaterialTheme.typography.bodyLarge, + textAlign = TextAlign.Center, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Spacer(modifier = Modifier.height(24.dp)) + + if (progress.isRunning) { + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant + ) + ) { + Column(modifier = Modifier.padding(16.dp)) { + LinearProgressIndicator( + progress = { + if (progress.total > 0) progress.current.toFloat() / progress.total + else 0f + }, + modifier = Modifier.fillMaxWidth() + ) + Spacer(modifier = Modifier.height(8.dp)) + Text( + text = "Processing ${progress.current} of ${progress.total} messages...", + style = MaterialTheme.typography.bodyMedium + ) + } + } + } else { + Button(onClick = onImport, modifier = Modifier.fillMaxWidth()) { + Text("Import History") + } + Spacer(modifier = Modifier.height(12.dp)) + OutlinedButton(onClick = onSkip, modifier = Modifier.fillMaxWidth()) { + Text("Skip — start fresh") + } + } + } +} + +@Composable +private fun CompletionStep( + importResult: com.ledga.app.data.repository.ImportResult?, + onComplete: () -> Unit +) { + Column(horizontalAlignment = Alignment.CenterHorizontally) { + Icon( + imageVector = Icons.Default.CheckCircle, + contentDescription = null, + modifier = Modifier.size(80.dp), + tint = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(24.dp)) + Text( + text = "You're all set!", + style = MaterialTheme.typography.headlineMedium, + textAlign = TextAlign.Center + ) + Spacer(modifier = Modifier.height(12.dp)) + + val subtitle = if (importResult != null) { + "Imported ${importResult.imported} transactions.\nLedga will now track your M-Pesa spending." + } else { + "Ledga will now track your M-Pesa spending in the background." + } + + Text( + text = subtitle, + style = MaterialTheme.typography.bodyLarge, + textAlign = TextAlign.Center, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Spacer(modifier = Modifier.height(32.dp)) + Button(onClick = onComplete, modifier = Modifier.fillMaxWidth()) { + Text("Go to Dashboard") + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/onboarding/OnboardingViewModel.kt b/app/src/main/java/com/ledga/app/ui/onboarding/OnboardingViewModel.kt new file mode 100644 index 0000000..ce7efc9 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/onboarding/OnboardingViewModel.kt @@ -0,0 +1,66 @@ +package com.ledga.app.ui.onboarding + +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import com.ledga.app.data.repository.ImportResult +import com.ledga.app.data.repository.SettingsRepository +import com.ledga.app.data.repository.SmsImporter +import dagger.hilt.android.lifecycle.HiltViewModel +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.launch +import javax.inject.Inject + +data class ImportProgress( + val current: Int = 0, + val total: Int = 0, + val isRunning: Boolean = false, + val result: ImportResult? = null +) + +@HiltViewModel +class OnboardingViewModel @Inject constructor( + private val settingsRepository: SettingsRepository, + private val smsImporter: SmsImporter +) : ViewModel() { + + private val _currentStep = MutableStateFlow(0) + val currentStep: StateFlow = _currentStep + + private val _importProgress = MutableStateFlow(ImportProgress()) + val importProgress: StateFlow = _importProgress + + fun nextStep() { + _currentStep.value = (_currentStep.value + 1).coerceAtMost(3) + } + + fun startImport() { + viewModelScope.launch { + _importProgress.value = ImportProgress(isRunning = true) + val result = smsImporter.importHistory { current, total -> + _importProgress.value = ImportProgress( + current = current, + total = total, + isRunning = true + ) + } + _importProgress.value = ImportProgress( + current = result.total, + total = result.total, + isRunning = false, + result = result + ) + nextStep() + } + } + + fun skipImport() { + nextStep() + } + + fun completeOnboarding() { + viewModelScope.launch { + settingsRepository.setOnboardingCompleted() + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/settings/BudgetScreen.kt b/app/src/main/java/com/ledga/app/ui/settings/BudgetScreen.kt new file mode 100644 index 0000000..4868cd5 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/settings/BudgetScreen.kt @@ -0,0 +1,155 @@ +package com.ledga.app.ui.settings + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.foundation.text.KeyboardOptions +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.automirrored.filled.ArrowBack +import androidx.compose.material3.Button +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.ExperimentalMaterial3Api +import androidx.compose.material3.Icon +import androidx.compose.material3.IconButton +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedTextField +import androidx.compose.material3.Scaffold +import androidx.compose.material3.Text +import androidx.compose.material3.TopAppBar +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.runtime.mutableStateOf +import androidx.compose.runtime.remember +import androidx.compose.runtime.setValue +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.input.KeyboardType +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel +import com.ledga.app.ui.components.BudgetProgressBar + +@OptIn(ExperimentalMaterial3Api::class) +@Composable +fun BudgetScreen( + onBack: () -> Unit, + viewModel: BudgetViewModel = hiltViewModel() +) { + val state by viewModel.uiState.collectAsState() + var overallBudgetInput by remember { mutableStateOf("") } + + Scaffold( + topBar = { + TopAppBar( + title = { Text("Budgets") }, + navigationIcon = { + IconButton(onClick = onBack) { + Icon(Icons.AutoMirrored.Filled.ArrowBack, "Back") + } + } + ) + } + ) { padding -> + LazyColumn( + modifier = Modifier + .fillMaxSize() + .padding(padding) + .padding(horizontal = 16.dp), + verticalArrangement = Arrangement.spacedBy(12.dp) + ) { + // Overall budget + item { + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant + ) + ) { + Column(modifier = Modifier.padding(16.dp)) { + Text( + text = "Overall Monthly Budget", + style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(8.dp)) + + if (state.overallBudget != null) { + BudgetProgressBar( + label = "This Month", + spent = state.totalSpentThisMonth, + limit = state.overallBudget!! + ) + } + + Spacer(modifier = Modifier.height(8.dp)) + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedTextField( + value = overallBudgetInput, + onValueChange = { overallBudgetInput = it }, + modifier = Modifier.weight(1f), + label = { Text("Ksh") }, + keyboardOptions = KeyboardOptions(keyboardType = KeyboardType.Number), + singleLine = true + ) + Button( + onClick = { + overallBudgetInput.toDoubleOrNull()?.let { + viewModel.setOverallBudget(it) + overallBudgetInput = "" + } + } + ) { + Text("Set") + } + } + } + } + } + + // Category budgets + item { + Text( + text = "Category Budgets", + style = MaterialTheme.typography.titleMedium + ) + } + + items(state.categoryBudgets) { cb -> + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surface + ), + elevation = CardDefaults.cardElevation(defaultElevation = 1.dp) + ) { + Column(modifier = Modifier.padding(12.dp)) { + BudgetProgressBar( + label = cb.categoryName, + spent = cb.spent, + limit = cb.limit + ) + } + } + } + + if (state.categoryBudgets.isEmpty()) { + item { + Text( + text = "Set an overall budget above to start tracking.", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + } + + item { Spacer(modifier = Modifier.height(16.dp)) } + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/settings/BudgetViewModel.kt b/app/src/main/java/com/ledga/app/ui/settings/BudgetViewModel.kt new file mode 100644 index 0000000..2de9fb9 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/settings/BudgetViewModel.kt @@ -0,0 +1,73 @@ +package com.ledga.app.ui.settings + +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import com.ledga.app.data.db.dao.BudgetDao +import com.ledga.app.data.db.entity.Budget +import com.ledga.app.data.repository.CategoryRepository +import com.ledga.app.data.repository.TransactionRepository +import com.ledga.app.util.DateUtils +import dagger.hilt.android.lifecycle.HiltViewModel +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.combine +import kotlinx.coroutines.flow.stateIn +import kotlinx.coroutines.launch +import javax.inject.Inject + +data class CategoryBudgetItem( + val categoryName: String, + val spent: Double, + val limit: Double +) + +data class BudgetUiState( + val overallBudget: Double? = null, + val totalSpentThisMonth: Double = 0.0, + val categoryBudgets: List = emptyList() +) + +@HiltViewModel +class BudgetViewModel @Inject constructor( + private val budgetDao: BudgetDao, + private val transactionRepository: TransactionRepository, + private val categoryRepository: CategoryRepository +) : ViewModel() { + + private val monthStart = DateUtils.getStartOfMonth() + private val now = System.currentTimeMillis() + + val uiState: StateFlow = combine( + budgetDao.getActiveBudgets(), + transactionRepository.getTotalSpending(monthStart, now), + transactionRepository.getSpendingByCategory(monthStart, now), + categoryRepository.getAllCategories() + ) { budgets, totalSpent, categorySpending, categories -> + val overallBudget = budgets.find { it.categoryId == null }?.monthlyLimit + val catMap = categories.associateBy { it.id } + val spendingMap = categorySpending.associate { it.categoryId to it.totalAmount } + + val categoryBudgets = budgets + .filter { it.categoryId != null } + .mapNotNull { budget -> + val cat = catMap[budget.categoryId] ?: return@mapNotNull null + CategoryBudgetItem( + categoryName = cat.name, + spent = spendingMap[budget.categoryId] ?: 0.0, + limit = budget.monthlyLimit + ) + } + + BudgetUiState( + overallBudget = overallBudget, + totalSpentThisMonth = totalSpent, + categoryBudgets = categoryBudgets + ) + }.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), BudgetUiState()) + + fun setOverallBudget(amount: Double) { + viewModelScope.launch { + budgetDao.insert(Budget(categoryId = null, monthlyLimit = amount, isActive = true)) + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/settings/SettingsScreen.kt b/app/src/main/java/com/ledga/app/ui/settings/SettingsScreen.kt new file mode 100644 index 0000000..92dd4d1 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/settings/SettingsScreen.kt @@ -0,0 +1,302 @@ +package com.ledga.app.ui.settings + +import androidx.activity.compose.rememberLauncherForActivityResult +import androidx.activity.result.contract.ActivityResultContracts +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.rememberScrollState +import androidx.compose.foundation.verticalScroll +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.HorizontalDivider +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedButton +import androidx.compose.material3.RadioButton +import androidx.compose.material3.Switch +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel +import com.ledga.app.data.repository.FontScale +import com.ledga.app.ui.theme.ThemeMode + +@Composable +fun SettingsScreen( + onNavigateToUnparsed: () -> Unit, + onNavigateToBudgets: () -> Unit, + viewModel: SettingsViewModel = hiltViewModel() +) { + val themeMode by viewModel.themeMode.collectAsState() + val fontScale by viewModel.fontScale.collectAsState() + val dailySummary by viewModel.dailySummaryEnabled.collectAsState() + val weeklySummary by viewModel.weeklySummaryEnabled.collectAsState() + val budgetAlerts by viewModel.budgetAlertsEnabled.collectAsState() + val largeTxnAlert by viewModel.largeTxnAlertEnabled.collectAsState() + val unparsedCount by viewModel.unparsedCount.collectAsState() + val importStatus by viewModel.importStatus.collectAsState() + val exportResult by viewModel.exportResult.collectAsState() + val fileImportResult by viewModel.fileImportResult.collectAsState() + + val exportLauncher = rememberLauncherForActivityResult( + ActivityResultContracts.CreateDocument("application/zip") + ) { uri -> uri?.let { viewModel.exportData(it) } } + + val importLauncher = rememberLauncherForActivityResult( + ActivityResultContracts.OpenDocument() + ) { uri -> uri?.let { viewModel.importData(it) } } + + Column( + modifier = Modifier + .fillMaxSize() + .verticalScroll(rememberScrollState()) + .padding(16.dp), + verticalArrangement = Arrangement.spacedBy(16.dp) + ) { + Spacer(modifier = Modifier.height(8.dp)) + Text("Settings", style = MaterialTheme.typography.headlineSmall) + + // Appearance + SettingsSection(title = "Appearance") { + ThemeSelector( + currentMode = themeMode, + onSelect = { viewModel.setThemeMode(it) } + ) + Spacer(modifier = Modifier.height(12.dp)) + Text("Font Size", style = MaterialTheme.typography.bodySmall, color = MaterialTheme.colorScheme.onSurfaceVariant) + FontScale.entries.forEach { scale -> + Row( + modifier = Modifier + .fillMaxWidth() + .clickable { viewModel.setFontScale(scale) } + .padding(vertical = 4.dp), + verticalAlignment = Alignment.CenterVertically + ) { + RadioButton( + selected = fontScale == scale, + onClick = { viewModel.setFontScale(scale) } + ) + Text(text = scale.label, style = MaterialTheme.typography.bodyLarge) + } + } + } + + // Notifications + SettingsSection(title = "Notifications") { + SettingsToggle("Daily Summary", dailySummary) { viewModel.setDailySummaryEnabled(it) } + SettingsToggle("Weekly Summary", weeklySummary) { viewModel.setWeeklySummaryEnabled(it) } + SettingsToggle("Budget Alerts", budgetAlerts) { viewModel.setBudgetAlertsEnabled(it) } + SettingsToggle("Large Transaction Alert", largeTxnAlert) { viewModel.setLargeTxnAlertEnabled(it) } + } + + // Budgets + SettingsSection(title = "Budgets") { + Text( + text = "Manage Budgets", + style = MaterialTheme.typography.bodyLarge, + color = MaterialTheme.colorScheme.primary, + modifier = Modifier + .fillMaxWidth() + .clickable(onClick = onNavigateToBudgets) + .padding(vertical = 8.dp) + ) + } + + // Data + SettingsSection(title = "Data") { + OutlinedButton( + onClick = { viewModel.importSmsHistory() }, + modifier = Modifier.fillMaxWidth() + ) { + Text("Import SMS History") + } + + if (importStatus != null) { + Text( + text = "Imported ${importStatus!!.imported} of ${importStatus!!.total} messages", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + + Spacer(modifier = Modifier.height(8.dp)) + OutlinedButton( + onClick = { exportLauncher.launch("ledga-export.zip") }, + modifier = Modifier.fillMaxWidth() + ) { + Text("Export Data (CSV + JSON)") + } + if (exportResult != null) { + Text( + text = "Exported ${exportResult!!.count} transactions", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + + Spacer(modifier = Modifier.height(4.dp)) + OutlinedButton( + onClick = { importLauncher.launch(arrayOf("application/zip")) }, + modifier = Modifier.fillMaxWidth() + ) { + Text("Import Data from ZIP") + } + if (fileImportResult != null) { + Text( + text = "Imported ${fileImportResult!!.imported} of ${fileImportResult!!.total} (${fileImportResult!!.skipped} duplicates skipped)", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + + if (unparsedCount > 0) { + Text( + text = "Unparsed Messages ($unparsedCount)", + style = MaterialTheme.typography.bodyLarge, + color = MaterialTheme.colorScheme.primary, + modifier = Modifier + .fillMaxWidth() + .clickable(onClick = onNavigateToUnparsed) + .padding(vertical = 8.dp) + ) + } + } + + // Backup + SettingsSection(title = "Backup") { + val backupStatus by viewModel.backupStatus.collectAsState() + val signedIn = viewModel.isSignedIn() + val email = viewModel.getAccountEmail() + + if (signedIn && email != null) { + Text( + text = "Google Account: $email", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Spacer(modifier = Modifier.height(8.dp)) + } + + OutlinedButton( + onClick = { viewModel.backupNow() }, + modifier = Modifier.fillMaxWidth() + ) { + Text("Back Up Now") + } + + Spacer(modifier = Modifier.height(4.dp)) + + OutlinedButton( + onClick = { viewModel.restoreBackup() }, + modifier = Modifier.fillMaxWidth() + ) { + Text("Restore from Backup") + } + + if (backupStatus != null) { + Text( + text = backupStatus!!, + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + } + + // About + SettingsSection(title = "About") { + Text( + text = "Ledga v1.0.0", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Text( + text = "All data stays on your device.", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + + Spacer(modifier = Modifier.height(32.dp)) + } +} + +@Composable +private fun SettingsSection( + title: String, + content: @Composable () -> Unit +) { + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant + ) + ) { + Column(modifier = Modifier.padding(16.dp)) { + Text( + text = title, + style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(8.dp)) + HorizontalDivider() + Spacer(modifier = Modifier.height(8.dp)) + content() + } + } +} + +@Composable +private fun ThemeSelector( + currentMode: ThemeMode, + onSelect: (ThemeMode) -> Unit +) { + ThemeMode.entries.forEach { mode -> + Row( + modifier = Modifier + .fillMaxWidth() + .clickable { onSelect(mode) } + .padding(vertical = 4.dp), + verticalAlignment = Alignment.CenterVertically + ) { + RadioButton( + selected = currentMode == mode, + onClick = { onSelect(mode) } + ) + Text( + text = mode.name.lowercase().replaceFirstChar { it.uppercase() }, + style = MaterialTheme.typography.bodyLarge + ) + } + } +} + +@Composable +private fun SettingsToggle( + label: String, + checked: Boolean, + onToggle: (Boolean) -> Unit +) { + Row( + modifier = Modifier + .fillMaxWidth() + .padding(vertical = 4.dp), + verticalAlignment = Alignment.CenterVertically + ) { + Text( + text = label, + style = MaterialTheme.typography.bodyLarge, + modifier = Modifier.weight(1f) + ) + Switch(checked = checked, onCheckedChange = onToggle) + } +} diff --git a/app/src/main/java/com/ledga/app/ui/settings/SettingsViewModel.kt b/app/src/main/java/com/ledga/app/ui/settings/SettingsViewModel.kt new file mode 100644 index 0000000..7dd86a2 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/settings/SettingsViewModel.kt @@ -0,0 +1,144 @@ +package com.ledga.app.ui.settings + +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import android.net.Uri +import com.ledga.app.data.repository.BackupRepository +import com.ledga.app.data.repository.ExportImportRepository +import com.ledga.app.data.repository.ExportResult +import com.ledga.app.data.repository.FontScale +import com.ledga.app.data.repository.ImportFromFileResult +import com.ledga.app.data.repository.ImportResult +import com.ledga.app.data.repository.SettingsRepository +import com.ledga.app.data.repository.SmsImporter +import com.ledga.app.data.repository.TransactionRepository +import com.ledga.app.ui.theme.ThemeMode +import android.content.Context +import dagger.hilt.android.lifecycle.HiltViewModel +import dagger.hilt.android.qualifiers.ApplicationContext +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.stateIn +import kotlinx.coroutines.launch +import javax.inject.Inject + +@HiltViewModel +class SettingsViewModel @Inject constructor( + @ApplicationContext private val appContext: Context, + private val settingsRepository: SettingsRepository, + private val transactionRepository: TransactionRepository, + private val smsImporter: SmsImporter, + private val exportImportRepository: ExportImportRepository, + private val backupRepository: BackupRepository +) : ViewModel() { + + val themeMode: StateFlow = settingsRepository.getThemeMode() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), ThemeMode.SYSTEM) + + val unparsedCount: StateFlow = transactionRepository.getUnparsedCount() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), 0) + + val fontScale: StateFlow = settingsRepository.getFontScale() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), FontScale.SYSTEM) + + val dailySummaryEnabled: StateFlow = settingsRepository.getDailySummaryEnabled() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), true) + + val weeklySummaryEnabled: StateFlow = settingsRepository.getWeeklySummaryEnabled() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), true) + + val budgetAlertsEnabled: StateFlow = settingsRepository.getBudgetAlertsEnabled() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), true) + + val largeTxnAlertEnabled: StateFlow = settingsRepository.getLargeTransactionAlertEnabled() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), false) + + val largeTxnThreshold: StateFlow = settingsRepository.getLargeTransactionThreshold() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), 5000.0) + + private val _importStatus = MutableStateFlow(null) + val importStatus: StateFlow = _importStatus + + fun setThemeMode(mode: ThemeMode) { + viewModelScope.launch { + settingsRepository.setThemeMode(mode) + } + } + + fun setFontScale(scale: FontScale) { + viewModelScope.launch { + settingsRepository.setFontScale(scale) + } + } + + fun setDailySummaryEnabled(enabled: Boolean) { + viewModelScope.launch { settingsRepository.setDailySummaryEnabled(enabled) } + } + + fun setWeeklySummaryEnabled(enabled: Boolean) { + viewModelScope.launch { settingsRepository.setWeeklySummaryEnabled(enabled) } + } + + fun setBudgetAlertsEnabled(enabled: Boolean) { + viewModelScope.launch { settingsRepository.setBudgetAlertsEnabled(enabled) } + } + + fun setLargeTxnAlertEnabled(enabled: Boolean) { + viewModelScope.launch { settingsRepository.setLargeTransactionAlertEnabled(enabled) } + } + + fun setLargeTxnThreshold(amount: Double) { + viewModelScope.launch { settingsRepository.setLargeTransactionThreshold(amount) } + } + + fun importSmsHistory() { + viewModelScope.launch { + val result = smsImporter.importHistory() + _importStatus.value = result + } + } + + private val _exportResult = MutableStateFlow(null) + val exportResult: StateFlow = _exportResult + + private val _fileImportResult = MutableStateFlow(null) + val fileImportResult: StateFlow = _fileImportResult + + fun exportData(uri: Uri) { + viewModelScope.launch { + _exportResult.value = exportImportRepository.exportToZip(appContext, uri) + } + } + + fun importData(uri: Uri) { + viewModelScope.launch { + _fileImportResult.value = exportImportRepository.importFromZip(appContext, uri) + } + } + + // --- Google Drive Backup --- + + fun isSignedIn(): Boolean = backupRepository.isSignedIn(appContext) + fun getAccountEmail(): String? = backupRepository.getAccountEmail(appContext) + fun getSignInIntent() = backupRepository.getSignInIntent(appContext) + + private val _backupStatus = MutableStateFlow(null) + val backupStatus: StateFlow = _backupStatus + + fun backupNow() { + viewModelScope.launch { + _backupStatus.value = "Backing up..." + val success = backupRepository.performBackup(appContext) + _backupStatus.value = if (success) "Backup complete" else "Backup failed — sign in first" + } + } + + fun restoreBackup() { + viewModelScope.launch { + _backupStatus.value = "Restoring..." + val count = backupRepository.restoreBackup(appContext) + _backupStatus.value = "Restored $count transactions" + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/settings/UnparsedSmsScreen.kt b/app/src/main/java/com/ledga/app/ui/settings/UnparsedSmsScreen.kt new file mode 100644 index 0000000..934ddf6 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/settings/UnparsedSmsScreen.kt @@ -0,0 +1,88 @@ +package com.ledga.app.ui.settings + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.automirrored.filled.ArrowBack +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.ExperimentalMaterial3Api +import androidx.compose.material3.Icon +import androidx.compose.material3.IconButton +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Scaffold +import androidx.compose.material3.Text +import androidx.compose.material3.TopAppBar +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel +import com.ledga.app.data.repository.TransactionRepository +import javax.inject.Inject + +@OptIn(ExperimentalMaterial3Api::class) +@Composable +fun UnparsedSmsScreen( + onBack: () -> Unit, + viewModel: UnparsedSmsViewModel = hiltViewModel() +) { + val transactions by viewModel.unparsedTransactions.collectAsState() + + Scaffold( + topBar = { + TopAppBar( + title = { Text("Unparsed Messages") }, + navigationIcon = { + IconButton(onClick = onBack) { + Icon(Icons.AutoMirrored.Filled.ArrowBack, "Back") + } + } + ) + } + ) { padding -> + LazyColumn( + modifier = Modifier + .fillMaxSize() + .padding(padding) + .padding(horizontal = 16.dp), + verticalArrangement = Arrangement.spacedBy(8.dp) + ) { + if (transactions.isEmpty()) { + item { + Text( + text = "No unparsed messages.", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant, + modifier = Modifier.padding(vertical = 24.dp) + ) + } + } + + items(transactions) { twc -> + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant + ) + ) { + Text( + text = twc.transaction.rawSms, + style = MaterialTheme.typography.bodySmall, + modifier = Modifier.padding(12.dp) + ) + } + } + + item { Spacer(modifier = Modifier.height(16.dp)) } + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/settings/UnparsedSmsViewModel.kt b/app/src/main/java/com/ledga/app/ui/settings/UnparsedSmsViewModel.kt new file mode 100644 index 0000000..19aa773 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/settings/UnparsedSmsViewModel.kt @@ -0,0 +1,21 @@ +package com.ledga.app.ui.settings + +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import com.ledga.app.data.db.entity.TransactionWithCategory +import com.ledga.app.data.repository.TransactionRepository +import dagger.hilt.android.lifecycle.HiltViewModel +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.stateIn +import javax.inject.Inject + +@HiltViewModel +class UnparsedSmsViewModel @Inject constructor( + transactionRepository: TransactionRepository +) : ViewModel() { + + val unparsedTransactions: StateFlow> = + transactionRepository.getUnparsedTransactions() + .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList()) +} diff --git a/app/src/main/java/com/ledga/app/ui/theme/Color.kt b/app/src/main/java/com/ledga/app/ui/theme/Color.kt new file mode 100644 index 0000000..3973483 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/theme/Color.kt @@ -0,0 +1,29 @@ +package com.ledga.app.ui.theme + +import androidx.compose.ui.graphics.Color + +// Primary brand color (M-Pesa green) +val MpesaGreen = Color(0xFF4CAF50) +val MpesaGreenDark = Color(0xFF388E3C) +val MpesaGreenLight = Color(0xFFC8E6C9) + +// Category colors +val CategoryGroceries = Color(0xFF4CAF50) +val CategoryTransport = Color(0xFF2196F3) +val CategoryBills = Color(0xFFFF9800) +val CategoryAirtime = Color(0xFF9C27B0) +val CategoryFood = Color(0xFFE91E63) +val CategorySendMoney = Color(0xFF607D8B) +val CategoryReceived = Color(0xFF00BCD4) +val CategoryWithdrawal = Color(0xFF795548) +val CategoryDeposit = Color(0xFF8BC34A) +val CategoryShopping = Color(0xFFFF5722) +val CategoryInternational = Color(0xFF3F51B5) +val CategorySavings = Color(0xFF009688) +val CategoryOther = Color(0xFF9E9E9E) + +// Semantic colors +val InflowGreen = Color(0xFF2E7D32) +val OutflowRed = Color(0xFFC62828) +val InflowGreenLight = Color(0xFF66BB6A) +val OutflowRedLight = Color(0xFFEF5350) diff --git a/app/src/main/java/com/ledga/app/ui/theme/Theme.kt b/app/src/main/java/com/ledga/app/ui/theme/Theme.kt new file mode 100644 index 0000000..beb771a --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/theme/Theme.kt @@ -0,0 +1,55 @@ +package com.ledga.app.ui.theme + +import android.os.Build +import androidx.compose.foundation.isSystemInDarkTheme +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.darkColorScheme +import androidx.compose.material3.dynamicDarkColorScheme +import androidx.compose.material3.dynamicLightColorScheme +import androidx.compose.material3.lightColorScheme +import androidx.compose.runtime.Composable +import androidx.compose.ui.platform.LocalContext + +enum class ThemeMode { SYSTEM, LIGHT, DARK } + +private val LightColorScheme = lightColorScheme( + primary = MpesaGreen, + onPrimary = androidx.compose.ui.graphics.Color.White, + primaryContainer = MpesaGreenLight, + onPrimaryContainer = MpesaGreenDark, +) + +private val DarkColorScheme = darkColorScheme( + primary = MpesaGreenLight, + onPrimary = MpesaGreenDark, + primaryContainer = MpesaGreen, + onPrimaryContainer = MpesaGreenLight, +) + +@Composable +fun LedgaTheme( + themeMode: ThemeMode = ThemeMode.SYSTEM, + dynamicColor: Boolean = true, + content: @Composable () -> Unit +) { + val darkTheme = when (themeMode) { + ThemeMode.SYSTEM -> isSystemInDarkTheme() + ThemeMode.LIGHT -> false + ThemeMode.DARK -> true + } + + val colorScheme = when { + dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> { + val context = LocalContext.current + if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context) + } + darkTheme -> DarkColorScheme + else -> LightColorScheme + } + + MaterialTheme( + colorScheme = colorScheme, + typography = LedgaTypography, + content = content + ) +} diff --git a/app/src/main/java/com/ledga/app/ui/theme/Type.kt b/app/src/main/java/com/ledga/app/ui/theme/Type.kt new file mode 100644 index 0000000..726561f --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/theme/Type.kt @@ -0,0 +1,5 @@ +package com.ledga.app.ui.theme + +import androidx.compose.material3.Typography + +val LedgaTypography = Typography() diff --git a/app/src/main/java/com/ledga/app/ui/transactions/TransactionDetailSheet.kt b/app/src/main/java/com/ledga/app/ui/transactions/TransactionDetailSheet.kt new file mode 100644 index 0000000..a16921d --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/transactions/TransactionDetailSheet.kt @@ -0,0 +1,166 @@ +package com.ledga.app.ui.transactions + +import androidx.compose.foundation.clickable +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.lazy.LazyRow +import androidx.compose.foundation.lazy.items +import androidx.compose.foundation.shape.CircleShape +import androidx.compose.material3.ExperimentalMaterial3Api +import androidx.compose.material3.HorizontalDivider +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.ModalBottomSheet +import androidx.compose.material3.Surface +import androidx.compose.material3.Text +import androidx.compose.material3.rememberModalBottomSheetState +import androidx.compose.runtime.Composable +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.unit.dp +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.TransactionEntity +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.ui.components.parseColor +import com.ledga.app.ui.theme.InflowGreen +import com.ledga.app.ui.theme.OutflowRed +import com.ledga.app.util.CurrencyFormatter +import com.ledga.app.util.DateUtils + +@OptIn(ExperimentalMaterial3Api::class) +@Composable +fun TransactionDetailSheet( + transaction: TransactionEntity, + category: Category?, + categories: List, + onDismiss: () -> Unit, + onCategoryChange: (Long) -> Unit +) { + val sheetState = rememberModalBottomSheetState(skipPartiallyExpanded = true) + val isInflow = transaction.direction == TransactionDirection.INFLOW + + ModalBottomSheet( + onDismissRequest = onDismiss, + sheetState = sheetState + ) { + Column( + modifier = Modifier + .fillMaxWidth() + .padding(horizontal = 20.dp, vertical = 8.dp) + ) { + // Amount + Text( + text = CurrencyFormatter.formatKshSigned(transaction.amount, isInflow), + style = MaterialTheme.typography.headlineMedium, + color = if (isInflow) InflowGreen else OutflowRed, + fontWeight = FontWeight.Bold + ) + + Spacer(modifier = Modifier.height(4.dp)) + + // Recipient + Text( + text = transaction.recipientName ?: transaction.type.name.replace("_", " "), + style = MaterialTheme.typography.titleMedium + ) + + Spacer(modifier = Modifier.height(16.dp)) + HorizontalDivider() + Spacer(modifier = Modifier.height(12.dp)) + + // Details + DetailRow("Date", DateUtils.formatDate(transaction.timestamp)) + DetailRow("Time", DateUtils.formatTime(transaction.timestamp)) + DetailRow("Type", transaction.type.name.replace("_", " ")) + DetailRow("Code", transaction.transactionCode) + DetailRow("Balance After", CurrencyFormatter.formatKsh(transaction.balance)) + + if (transaction.transactionCost > 0) { + DetailRow("Fee", CurrencyFormatter.formatKsh(transaction.transactionCost)) + } + if (transaction.recipientPhone != null) { + DetailRow("Phone", transaction.recipientPhone) + } + if (transaction.accountNumber != null) { + DetailRow("Account", transaction.accountNumber) + } + if (transaction.destinationCountry != null) { + DetailRow("Country", transaction.destinationCountry) + } + if (transaction.fulizaAmount != null) { + DetailRow("Fuliza Amount", CurrencyFormatter.formatKsh(transaction.fulizaAmount)) + } + if (transaction.fulizaOutstanding != null) { + DetailRow("Fuliza Outstanding", CurrencyFormatter.formatKsh(transaction.fulizaOutstanding)) + } + + Spacer(modifier = Modifier.height(16.dp)) + HorizontalDivider() + Spacer(modifier = Modifier.height(12.dp)) + + // Category selector + Text( + text = "Category", + style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(8.dp)) + + LazyRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + items(categories) { cat -> + val isSelected = cat.id == transaction.categoryId + Surface( + modifier = Modifier.clickable { onCategoryChange(cat.id) }, + shape = MaterialTheme.shapes.small, + color = if (isSelected) MaterialTheme.colorScheme.primaryContainer + else MaterialTheme.colorScheme.surfaceVariant + ) { + Row( + modifier = Modifier.padding(horizontal = 12.dp, vertical = 8.dp), + verticalAlignment = Alignment.CenterVertically, + horizontalArrangement = Arrangement.spacedBy(6.dp) + ) { + Surface( + modifier = Modifier.size(10.dp), + shape = CircleShape, + color = parseColor(cat.color) + ) {} + Text( + text = cat.name, + style = MaterialTheme.typography.bodySmall + ) + } + } + } + } + + Spacer(modifier = Modifier.height(24.dp)) + } + } +} + +@Composable +private fun DetailRow(label: String, value: String) { + Row( + modifier = Modifier + .fillMaxWidth() + .padding(vertical = 4.dp), + horizontalArrangement = Arrangement.SpaceBetween + ) { + Text( + text = label, + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + Text( + text = value, + style = MaterialTheme.typography.bodyMedium + ) + } +} diff --git a/app/src/main/java/com/ledga/app/ui/transactions/TransactionsScreen.kt b/app/src/main/java/com/ledga/app/ui/transactions/TransactionsScreen.kt new file mode 100644 index 0000000..ee18af3 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/transactions/TransactionsScreen.kt @@ -0,0 +1,125 @@ +package com.ledga.app.ui.transactions + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.LazyRow +import androidx.compose.foundation.lazy.items +import androidx.compose.material.icons.Icons +import androidx.compose.material.icons.filled.Search +import androidx.compose.material3.Icon +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.OutlinedTextField +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel +import com.ledga.app.ui.components.CategoryChip +import com.ledga.app.ui.components.TransactionCard + +@Composable +fun TransactionsScreen( + viewModel: TransactionsViewModel = hiltViewModel() +) { + val state by viewModel.uiState.collectAsState() + + // Detail bottom sheet + if (state.selectedTransaction != null) { + TransactionDetailSheet( + transaction = state.selectedTransaction!!.transaction, + category = state.selectedTransaction!!.category, + categories = state.categories, + onDismiss = { viewModel.clearSelection() }, + onCategoryChange = { categoryId -> + viewModel.changeCategory( + state.selectedTransaction!!.transaction.id, + categoryId + ) + } + ) + } + + Column( + modifier = Modifier + .fillMaxSize() + .padding(horizontal = 16.dp) + ) { + Spacer(modifier = Modifier.height(16.dp)) + + // Search bar + OutlinedTextField( + value = state.searchQuery, + onValueChange = { viewModel.setSearchQuery(it) }, + modifier = Modifier.fillMaxWidth(), + placeholder = { Text("Search transactions...") }, + leadingIcon = { Icon(Icons.Default.Search, "Search") }, + singleLine = true + ) + + Spacer(modifier = Modifier.height(8.dp)) + + // Filter chips + LazyRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + items(TransactionsViewModel.FILTERS.keys.toList()) { filter -> + CategoryChip( + label = filter, + isSelected = state.activeFilter == filter, + onClick = { viewModel.setFilter(filter) } + ) + } + } + + Spacer(modifier = Modifier.height(8.dp)) + + // Transactions grouped by day + LazyColumn( + modifier = Modifier.fillMaxSize(), + verticalArrangement = Arrangement.spacedBy(4.dp) + ) { + state.groupedTransactions.forEach { (day, transactions) -> + // Day header + item(key = "header_$day") { + Text( + text = day, + style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary, + modifier = Modifier.padding(vertical = 8.dp) + ) + } + + // Transactions for that day + items( + items = transactions, + key = { it.transaction.id } + ) { twc -> + TransactionCard( + transaction = twc.transaction, + category = twc.category, + onClick = { viewModel.selectTransaction(twc) } + ) + } + } + + if (state.groupedTransactions.isEmpty()) { + item { + Text( + text = "No transactions found.", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant, + modifier = Modifier.padding(vertical = 24.dp) + ) + } + } + + item { Spacer(modifier = Modifier.height(16.dp)) } + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/transactions/TransactionsViewModel.kt b/app/src/main/java/com/ledga/app/ui/transactions/TransactionsViewModel.kt new file mode 100644 index 0000000..f878150 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/transactions/TransactionsViewModel.kt @@ -0,0 +1,109 @@ +package com.ledga.app.ui.transactions + +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import com.ledga.app.data.db.entity.Category +import com.ledga.app.data.db.entity.TransactionWithCategory +import com.ledga.app.data.parser.TransactionType +import com.ledga.app.data.repository.CategoryRepository +import com.ledga.app.data.repository.TransactionRepository +import com.ledga.app.util.DateUtils +import dagger.hilt.android.lifecycle.HiltViewModel +import kotlinx.coroutines.FlowPreview +import kotlinx.coroutines.launch +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.combine +import kotlinx.coroutines.flow.debounce +import kotlinx.coroutines.flow.flatMapLatest +import kotlinx.coroutines.flow.stateIn +import javax.inject.Inject + +data class TransactionsUiState( + val groupedTransactions: Map> = emptyMap(), + val searchQuery: String = "", + val activeFilter: String = "All", + val categories: List = emptyList(), + val selectedTransaction: TransactionWithCategory? = null +) + +@OptIn(FlowPreview::class) +@HiltViewModel +class TransactionsViewModel @Inject constructor( + private val transactionRepository: TransactionRepository, + private val categoryRepository: CategoryRepository +) : ViewModel() { + + private val _searchQuery = MutableStateFlow("") + private val _activeFilter = MutableStateFlow("All") + + companion object { + val FILTERS = mapOf( + "All" to emptyList(), + "Sent" to listOf(TransactionType.SEND, TransactionType.MPESA_GLOBAL), + "Received" to listOf(TransactionType.RECEIVED), + "Bills" to listOf(TransactionType.PAY_BILL), + "Goods" to listOf(TransactionType.BUY_GOODS), + "Withdraw" to listOf(TransactionType.WITHDRAW_AGENT, TransactionType.WITHDRAW_ATM), + ) + } + + private val transactions = combine( + _searchQuery.debounce(300), + _activeFilter + ) { query, filter -> + Pair(query, filter) + }.flatMapLatest { (query, filter) -> + val types = FILTERS[filter] ?: emptyList() + when { + query.isNotBlank() -> transactionRepository.searchTransactions(query) + types.isNotEmpty() -> transactionRepository.getTransactionsByType(types) + else -> transactionRepository.getRecentTransactions(200) + } + } + + private val _selectedTransaction = MutableStateFlow(null) + + val uiState: StateFlow = combine( + transactions, + _searchQuery, + _activeFilter, + categoryRepository.getAllCategories(), + _selectedTransaction + ) { txns, query, filter, categories, selected -> + val grouped = txns.groupBy { twc -> + DateUtils.formatRelativeDate(twc.transaction.timestamp) + } + TransactionsUiState( + groupedTransactions = grouped, + searchQuery = query, + activeFilter = filter, + categories = categories, + selectedTransaction = selected + ) + }.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), TransactionsUiState()) + + fun setSearchQuery(query: String) { + _searchQuery.value = query + } + + fun setFilter(filter: String) { + _activeFilter.value = filter + } + + fun selectTransaction(twc: TransactionWithCategory) { + _selectedTransaction.value = twc + } + + fun clearSelection() { + _selectedTransaction.value = null + } + + fun changeCategory(transactionId: Long, categoryId: Long) { + viewModelScope.launch { + transactionRepository.updateCategory(transactionId, categoryId) + _selectedTransaction.value = null + } + } +} diff --git a/app/src/main/java/com/ledga/app/ui/trends/TrendsScreen.kt b/app/src/main/java/com/ledga/app/ui/trends/TrendsScreen.kt new file mode 100644 index 0000000..018184e --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/trends/TrendsScreen.kt @@ -0,0 +1,238 @@ +package com.ledga.app.ui.trends + +import androidx.compose.foundation.layout.Arrangement +import androidx.compose.foundation.layout.Column +import androidx.compose.foundation.layout.Row +import androidx.compose.foundation.layout.Spacer +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.foundation.layout.fillMaxWidth +import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.padding +import androidx.compose.foundation.layout.size +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.foundation.shape.CircleShape +import androidx.compose.material3.Card +import androidx.compose.material3.CardDefaults +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Surface +import androidx.compose.material3.Text +import androidx.compose.runtime.Composable +import androidx.compose.runtime.LaunchedEffect +import androidx.compose.runtime.collectAsState +import androidx.compose.runtime.getValue +import androidx.compose.runtime.remember +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.unit.dp +import androidx.hilt.navigation.compose.hiltViewModel +import com.patrykandpatrick.vico.compose.cartesian.CartesianChartHost +import com.patrykandpatrick.vico.compose.cartesian.axis.rememberBottom +import com.patrykandpatrick.vico.compose.cartesian.axis.rememberStart +import com.patrykandpatrick.vico.compose.cartesian.layer.rememberColumnCartesianLayer +import com.patrykandpatrick.vico.compose.cartesian.rememberCartesianChart +import com.patrykandpatrick.vico.core.cartesian.axis.HorizontalAxis +import com.patrykandpatrick.vico.core.cartesian.axis.VerticalAxis +import com.patrykandpatrick.vico.core.cartesian.data.CartesianChartModelProducer +import com.patrykandpatrick.vico.core.cartesian.data.columnSeries +import com.ledga.app.ui.components.CategoryChip +import com.ledga.app.ui.components.StatCard +import com.ledga.app.ui.components.parseColor +import com.ledga.app.util.CurrencyFormatter + +@Composable +fun TrendsScreen( + viewModel: TrendsViewModel = hiltViewModel() +) { + val state by viewModel.uiState.collectAsState() + + LazyColumn( + modifier = Modifier + .fillMaxSize() + .padding(horizontal = 16.dp), + verticalArrangement = Arrangement.spacedBy(12.dp) + ) { + item { Spacer(modifier = Modifier.height(8.dp)) } + + item { + Text("Trends", style = MaterialTheme.typography.headlineSmall) + } + + // Period selector + item { + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + TrendsPeriod.entries.forEach { period -> + CategoryChip( + label = period.label, + isSelected = state.selectedPeriod == period, + onClick = { viewModel.selectPeriod(period) } + ) + } + } + } + + // Summary cards + item { + Row( + modifier = Modifier.fillMaxWidth(), + horizontalArrangement = Arrangement.spacedBy(12.dp) + ) { + StatCard( + label = "Total Spent", + value = CurrencyFormatter.formatKshCompact(state.totalSpending), + modifier = Modifier.weight(1f) + ) + StatCard( + label = "Total Fees", + value = CurrencyFormatter.formatKsh(state.totalFees), + modifier = Modifier.weight(1f) + ) + } + } + + // Daily spending bar chart + item { + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surfaceVariant + ) + ) { + Column(modifier = Modifier.padding(16.dp)) { + Text( + text = "Daily Spending", + style = MaterialTheme.typography.titleSmall, + color = MaterialTheme.colorScheme.primary + ) + Spacer(modifier = Modifier.height(12.dp)) + + if (state.dailySpending.isNotEmpty()) { + DailySpendingChart( + dailySpending = state.dailySpending.map { it.totalAmount }, + modifier = Modifier + .fillMaxWidth() + .height(200.dp) + ) + } else { + Text( + text = "No spending data for this period.", + style = MaterialTheme.typography.bodyMedium, + color = MaterialTheme.colorScheme.onSurfaceVariant, + modifier = Modifier.padding(vertical = 24.dp) + ) + } + } + } + } + + // Category breakdown + if (state.categorySpending.isNotEmpty()) { + item { + Text( + text = "By Category", + style = MaterialTheme.typography.titleMedium + ) + } + + items(state.categorySpending) { cs -> + Row( + modifier = Modifier + .fillMaxWidth() + .padding(vertical = 4.dp), + verticalAlignment = Alignment.CenterVertically + ) { + Surface( + modifier = Modifier.size(12.dp), + shape = CircleShape, + color = parseColor(cs.color) + ) {} + Text( + text = cs.name, + style = MaterialTheme.typography.bodyMedium, + modifier = Modifier + .weight(1f) + .padding(horizontal = 12.dp) + ) + Text( + text = CurrencyFormatter.formatKsh(cs.totalAmount), + style = MaterialTheme.typography.bodyMedium + ) + } + } + } + + // Top merchants + if (state.topMerchants.isNotEmpty()) { + item { + Spacer(modifier = Modifier.height(4.dp)) + Text( + text = "Top Merchants", + style = MaterialTheme.typography.titleMedium + ) + } + + items(state.topMerchants) { merchant -> + Card( + modifier = Modifier.fillMaxWidth(), + colors = CardDefaults.cardColors( + containerColor = MaterialTheme.colorScheme.surface + ), + elevation = CardDefaults.cardElevation(defaultElevation = 1.dp) + ) { + Row( + modifier = Modifier + .fillMaxWidth() + .padding(12.dp), + verticalAlignment = Alignment.CenterVertically + ) { + Column(modifier = Modifier.weight(1f)) { + Text( + text = merchant.recipientName, + style = MaterialTheme.typography.bodyLarge + ) + Text( + text = "${merchant.transactionCount} transactions", + style = MaterialTheme.typography.bodySmall, + color = MaterialTheme.colorScheme.onSurfaceVariant + ) + } + Text( + text = CurrencyFormatter.formatKsh(merchant.totalAmount), + style = MaterialTheme.typography.titleSmall + ) + } + } + } + } + + item { Spacer(modifier = Modifier.height(16.dp)) } + } +} + +@Composable +private fun DailySpendingChart( + dailySpending: List, + modifier: Modifier = Modifier +) { + val modelProducer = remember { CartesianChartModelProducer() } + + LaunchedEffect(dailySpending) { + if (dailySpending.isNotEmpty()) { + modelProducer.runTransaction { + columnSeries { + series(dailySpending.map { it.toFloat() }) + } + } + } + } + + CartesianChartHost( + chart = rememberCartesianChart( + rememberColumnCartesianLayer(), + startAxis = VerticalAxis.rememberStart(), + bottomAxis = HorizontalAxis.rememberBottom(), + ), + modelProducer = modelProducer, + modifier = modifier, + ) +} diff --git a/app/src/main/java/com/ledga/app/ui/trends/TrendsViewModel.kt b/app/src/main/java/com/ledga/app/ui/trends/TrendsViewModel.kt new file mode 100644 index 0000000..43d7a08 --- /dev/null +++ b/app/src/main/java/com/ledga/app/ui/trends/TrendsViewModel.kt @@ -0,0 +1,97 @@ +package com.ledga.app.ui.trends + +import androidx.lifecycle.ViewModel +import androidx.lifecycle.viewModelScope +import com.ledga.app.data.db.dao.CategorySpending +import com.ledga.app.data.db.dao.DailySpending +import com.ledga.app.data.db.dao.TopMerchant +import com.ledga.app.data.repository.CategoryRepository +import com.ledga.app.data.repository.TransactionRepository +import dagger.hilt.android.lifecycle.HiltViewModel +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.SharingStarted +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.combine +import kotlinx.coroutines.flow.flatMapLatest +import kotlinx.coroutines.flow.flowOf +import kotlinx.coroutines.flow.stateIn +import java.util.Calendar +import javax.inject.Inject + +enum class TrendsPeriod(val label: String, val days: Int) { + WEEK("7D", 7), + MONTH("30D", 30), + QUARTER("90D", 90), + YEAR("1Y", 365) +} + +data class TrendsUiState( + val selectedPeriod: TrendsPeriod = TrendsPeriod.MONTH, + val dailySpending: List = emptyList(), + val totalSpending: Double = 0.0, + val totalFees: Double = 0.0, + val topMerchants: List = emptyList(), + val categorySpending: List = emptyList() +) + +data class CategorySpendingWithName( + val name: String, + val color: String, + val totalAmount: Double +) + +@OptIn(kotlinx.coroutines.ExperimentalCoroutinesApi::class) +@HiltViewModel +class TrendsViewModel @Inject constructor( + private val transactionRepository: TransactionRepository, + private val categoryRepository: CategoryRepository +) : ViewModel() { + + private val _selectedPeriod = MutableStateFlow(TrendsPeriod.MONTH) + + private val timeRange = _selectedPeriod.flatMapLatest { period -> + val now = System.currentTimeMillis() + val start = Calendar.getInstance().apply { + timeInMillis = now + add(Calendar.DAY_OF_YEAR, -period.days) + }.timeInMillis + flowOf(start to now) + } + + val uiState: StateFlow = combine( + _selectedPeriod, + timeRange.flatMapLatest { (s, e) -> transactionRepository.getDailySpending(s, e) }, + timeRange.flatMapLatest { (s, e) -> transactionRepository.getTotalSpending(s, e) }, + timeRange.flatMapLatest { (s, e) -> transactionRepository.getTotalFees(s, e) }, + timeRange.flatMapLatest { (s, e) -> transactionRepository.getTopMerchants(s, e) }, + ) { period, daily, spending, fees, merchants -> + TrendsUiState( + selectedPeriod = period, + dailySpending = daily, + totalSpending = spending, + totalFees = fees, + topMerchants = merchants, + ) + }.combine( + combine( + timeRange.flatMapLatest { (s, e) -> transactionRepository.getSpendingByCategory(s, e) }, + categoryRepository.getAllCategories() + ) { spending, categories -> + val catMap = categories.associateBy { it.id } + spending.map { cs -> + val cat = catMap[cs.categoryId] + CategorySpendingWithName( + name = cat?.name ?: "Other", + color = cat?.color ?: "#9E9E9E", + totalAmount = cs.totalAmount + ) + }.sortedByDescending { it.totalAmount } + } + ) { state, categorySpending -> + state.copy(categorySpending = categorySpending) + }.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), TrendsUiState()) + + fun selectPeriod(period: TrendsPeriod) { + _selectedPeriod.value = period + } +} diff --git a/app/src/main/java/com/ledga/app/util/CurrencyFormatter.kt b/app/src/main/java/com/ledga/app/util/CurrencyFormatter.kt new file mode 100644 index 0000000..2e4a449 --- /dev/null +++ b/app/src/main/java/com/ledga/app/util/CurrencyFormatter.kt @@ -0,0 +1,35 @@ +package com.ledga.app.util + +import java.text.NumberFormat +import java.util.Locale +import kotlin.math.abs + +object CurrencyFormatter { + + private val formatter = NumberFormat.getNumberInstance(Locale.US).apply { + minimumFractionDigits = 2 + maximumFractionDigits = 2 + } + + fun formatKsh(amount: Double): String { + val formatted = formatter.format(abs(amount)) + val prefix = if (amount < 0) "-" else "" + return "${prefix}Ksh $formatted" + } + + fun formatKshSigned(amount: Double, isInflow: Boolean): String { + val formatted = formatter.format(abs(amount)) + val sign = if (isInflow) "+" else "-" + return "${sign}Ksh $formatted" + } + + fun formatKshCompact(amount: Double): String { + val abs = abs(amount) + val prefix = if (amount < 0) "-" else "" + return when { + abs >= 1_000_000 -> "${prefix}Ksh ${String.format("%.1fM", abs / 1_000_000)}" + abs >= 1_000 -> "${prefix}Ksh ${String.format("%.1fK", abs / 1_000)}" + else -> formatKsh(amount) + } + } +} diff --git a/app/src/main/java/com/ledga/app/util/DateUtils.kt b/app/src/main/java/com/ledga/app/util/DateUtils.kt new file mode 100644 index 0000000..72d4423 --- /dev/null +++ b/app/src/main/java/com/ledga/app/util/DateUtils.kt @@ -0,0 +1,96 @@ +package com.ledga.app.util + +import java.text.SimpleDateFormat +import java.util.Calendar +import java.util.Date +import java.util.Locale + +object DateUtils { + + private val mpesaDateFormat = SimpleDateFormat("d/M/yy 'at' h:mm a", Locale.ENGLISH) + + fun parseMpesaDate(dateStr: String): Long { + return try { + mpesaDateFormat.parse(dateStr)?.time ?: System.currentTimeMillis() + } catch (e: Exception) { + System.currentTimeMillis() + } + } + + fun formatRelativeDate(timestamp: Long): String { + val now = Calendar.getInstance() + val date = Calendar.getInstance().apply { timeInMillis = timestamp } + + return when { + isSameDay(now, date) -> "Today" + isYesterday(now, date) -> "Yesterday" + else -> SimpleDateFormat("EEE, d MMM", Locale.ENGLISH).format(Date(timestamp)) + } + } + + fun formatTime(timestamp: Long): String { + return SimpleDateFormat("h:mm a", Locale.ENGLISH).format(Date(timestamp)) + } + + fun formatMonthYear(timestamp: Long): String { + return SimpleDateFormat("MMMM yyyy", Locale.ENGLISH).format(Date(timestamp)) + } + + fun formatDate(timestamp: Long): String { + return SimpleDateFormat("d MMM yyyy", Locale.ENGLISH).format(Date(timestamp)) + } + + fun greeting(): String { + val hour = Calendar.getInstance().get(Calendar.HOUR_OF_DAY) + return when { + hour < 12 -> "Good morning" + hour < 17 -> "Good afternoon" + else -> "Good evening" + } + } + + fun getStartOfDay(timestamp: Long = System.currentTimeMillis()): Long { + return Calendar.getInstance().apply { + timeInMillis = timestamp + set(Calendar.HOUR_OF_DAY, 0) + set(Calendar.MINUTE, 0) + set(Calendar.SECOND, 0) + set(Calendar.MILLISECOND, 0) + }.timeInMillis + } + + fun getStartOfWeek(timestamp: Long = System.currentTimeMillis()): Long { + return Calendar.getInstance().apply { + timeInMillis = timestamp + set(Calendar.DAY_OF_WEEK, firstDayOfWeek) + set(Calendar.HOUR_OF_DAY, 0) + set(Calendar.MINUTE, 0) + set(Calendar.SECOND, 0) + set(Calendar.MILLISECOND, 0) + }.timeInMillis + } + + fun getStartOfMonth(timestamp: Long = System.currentTimeMillis()): Long { + return Calendar.getInstance().apply { + timeInMillis = timestamp + set(Calendar.DAY_OF_MONTH, 1) + set(Calendar.HOUR_OF_DAY, 0) + set(Calendar.MINUTE, 0) + set(Calendar.SECOND, 0) + set(Calendar.MILLISECOND, 0) + }.timeInMillis + } + + private fun isSameDay(a: Calendar, b: Calendar): Boolean { + return a.get(Calendar.YEAR) == b.get(Calendar.YEAR) && + a.get(Calendar.DAY_OF_YEAR) == b.get(Calendar.DAY_OF_YEAR) + } + + private fun isYesterday(now: Calendar, date: Calendar): Boolean { + val yesterday = Calendar.getInstance().apply { + timeInMillis = now.timeInMillis + add(Calendar.DAY_OF_YEAR, -1) + } + return isSameDay(yesterday, date) + } +} diff --git a/app/src/main/java/com/ledga/app/worker/BackupWorker.kt b/app/src/main/java/com/ledga/app/worker/BackupWorker.kt new file mode 100644 index 0000000..90e905d --- /dev/null +++ b/app/src/main/java/com/ledga/app/worker/BackupWorker.kt @@ -0,0 +1,26 @@ +package com.ledga.app.worker + +import android.content.Context +import androidx.hilt.work.HiltWorker +import androidx.work.CoroutineWorker +import androidx.work.WorkerParameters +import com.ledga.app.data.repository.BackupRepository +import dagger.assisted.Assisted +import dagger.assisted.AssistedInject + +@HiltWorker +class BackupWorker @AssistedInject constructor( + @Assisted context: Context, + @Assisted params: WorkerParameters, + private val backupRepository: BackupRepository +) : CoroutineWorker(context, params) { + + override suspend fun doWork(): Result { + return try { + backupRepository.performBackup(applicationContext) + Result.success() + } catch (e: Exception) { + if (runAttemptCount < 3) Result.retry() else Result.failure() + } + } +} diff --git a/app/src/main/java/com/ledga/app/worker/NotificationHelper.kt b/app/src/main/java/com/ledga/app/worker/NotificationHelper.kt new file mode 100644 index 0000000..6b77d53 --- /dev/null +++ b/app/src/main/java/com/ledga/app/worker/NotificationHelper.kt @@ -0,0 +1,67 @@ +package com.ledga.app.worker + +import android.app.NotificationChannel +import android.app.NotificationManager +import android.content.Context +import android.os.Build +import androidx.core.app.NotificationCompat +import androidx.core.app.NotificationManagerCompat + +object NotificationHelper { + + const val CHANNEL_SUMMARIES = "spending_summaries" + const val CHANNEL_BUDGET = "budget_alerts" + const val CHANNEL_LARGE_TXN = "large_transactions" + + fun createChannels(context: Context) { + val manager = context.getSystemService(NotificationManager::class.java) + + val summaries = NotificationChannel( + CHANNEL_SUMMARIES, + "Spending Summaries", + NotificationManager.IMPORTANCE_DEFAULT + ).apply { + description = "Daily and weekly spending summaries" + } + + val budget = NotificationChannel( + CHANNEL_BUDGET, + "Budget Alerts", + NotificationManager.IMPORTANCE_HIGH + ).apply { + description = "Alerts when budget limits are reached" + } + + val largeTxn = NotificationChannel( + CHANNEL_LARGE_TXN, + "Large Transactions", + NotificationManager.IMPORTANCE_DEFAULT + ).apply { + description = "Alerts for large transactions" + } + + manager.createNotificationChannels(listOf(summaries, budget, largeTxn)) + } + + fun showNotification( + context: Context, + channelId: String, + notificationId: Int, + title: String, + body: String + ) { + val notification = NotificationCompat.Builder(context, channelId) + .setSmallIcon(android.R.drawable.ic_dialog_info) + .setContentTitle(title) + .setContentText(body) + .setStyle(NotificationCompat.BigTextStyle().bigText(body)) + .setAutoCancel(true) + .build() + + try { + NotificationManagerCompat.from(context).notify(notificationId, notification) + } catch (e: SecurityException) { + // POST_NOTIFICATIONS permission not granted + } + } +} diff --git a/app/src/main/java/com/ledga/app/worker/NotificationScheduler.kt b/app/src/main/java/com/ledga/app/worker/NotificationScheduler.kt new file mode 100644 index 0000000..2bb5099 --- /dev/null +++ b/app/src/main/java/com/ledga/app/worker/NotificationScheduler.kt @@ -0,0 +1,62 @@ +package com.ledga.app.worker + +import android.content.Context +import androidx.work.ExistingPeriodicWorkPolicy +import androidx.work.PeriodicWorkRequestBuilder +import androidx.work.WorkManager +import java.util.Calendar +import java.util.concurrent.TimeUnit + +object NotificationScheduler { + + fun scheduleDailySummary(context: Context, hour: Int = 20) { + val now = Calendar.getInstance() + val target = Calendar.getInstance().apply { + set(Calendar.HOUR_OF_DAY, hour) + set(Calendar.MINUTE, 0) + set(Calendar.SECOND, 0) + if (before(now)) add(Calendar.DAY_OF_YEAR, 1) + } + val initialDelay = target.timeInMillis - now.timeInMillis + + val request = PeriodicWorkRequestBuilder(1, TimeUnit.DAYS) + .setInitialDelay(initialDelay, TimeUnit.MILLISECONDS) + .build() + + WorkManager.getInstance(context).enqueueUniquePeriodicWork( + "daily_summary", + ExistingPeriodicWorkPolicy.UPDATE, + request + ) + } + + fun cancelDailySummary(context: Context) { + WorkManager.getInstance(context).cancelUniqueWork("daily_summary") + } + + fun scheduleWeeklySummary(context: Context) { + val now = Calendar.getInstance() + val target = Calendar.getInstance().apply { + set(Calendar.DAY_OF_WEEK, Calendar.SUNDAY) + set(Calendar.HOUR_OF_DAY, 19) + set(Calendar.MINUTE, 0) + set(Calendar.SECOND, 0) + if (before(now)) add(Calendar.WEEK_OF_YEAR, 1) + } + val initialDelay = target.timeInMillis - now.timeInMillis + + val request = PeriodicWorkRequestBuilder(7, TimeUnit.DAYS) + .setInitialDelay(initialDelay, TimeUnit.MILLISECONDS) + .build() + + WorkManager.getInstance(context).enqueueUniquePeriodicWork( + "weekly_summary", + ExistingPeriodicWorkPolicy.UPDATE, + request + ) + } + + fun cancelWeeklySummary(context: Context) { + WorkManager.getInstance(context).cancelUniqueWork("weekly_summary") + } +} diff --git a/app/src/main/java/com/ledga/app/worker/NotificationWorker.kt b/app/src/main/java/com/ledga/app/worker/NotificationWorker.kt new file mode 100644 index 0000000..0207572 --- /dev/null +++ b/app/src/main/java/com/ledga/app/worker/NotificationWorker.kt @@ -0,0 +1,84 @@ +package com.ledga.app.worker + +import android.content.Context +import androidx.hilt.work.HiltWorker +import androidx.work.CoroutineWorker +import androidx.work.WorkerParameters +import com.ledga.app.data.db.dao.TransactionDao +import com.ledga.app.util.CurrencyFormatter +import com.ledga.app.util.DateUtils +import dagger.assisted.Assisted +import dagger.assisted.AssistedInject +import kotlinx.coroutines.flow.first + +@HiltWorker +class DailySummaryWorker @AssistedInject constructor( + @Assisted context: Context, + @Assisted params: WorkerParameters, + private val transactionDao: TransactionDao +) : CoroutineWorker(context, params) { + + override suspend fun doWork(): Result { + val start = DateUtils.getStartOfDay() + val end = System.currentTimeMillis() + + val totalSpent = transactionDao.getTotalSpending(start, end).first() + val totalFees = transactionDao.getTotalFees(start, end).first() + + if (totalSpent > 0) { + val body = buildString { + append("You spent ${CurrencyFormatter.formatKsh(totalSpent)} today") + if (totalFees > 0) { + append(" (${CurrencyFormatter.formatKsh(totalFees)} in fees)") + } + append(".") + } + + NotificationHelper.showNotification( + context = applicationContext, + channelId = NotificationHelper.CHANNEL_SUMMARIES, + notificationId = 1001, + title = "Daily Spending Summary", + body = body + ) + } + + return Result.success() + } +} + +@HiltWorker +class WeeklySummaryWorker @AssistedInject constructor( + @Assisted context: Context, + @Assisted params: WorkerParameters, + private val transactionDao: TransactionDao +) : CoroutineWorker(context, params) { + + override suspend fun doWork(): Result { + val start = DateUtils.getStartOfWeek() + val end = System.currentTimeMillis() + + val totalSpent = transactionDao.getTotalSpending(start, end).first() + val totalFees = transactionDao.getTotalFees(start, end).first() + + if (totalSpent > 0) { + val body = buildString { + append("This week you spent ${CurrencyFormatter.formatKsh(totalSpent)}") + if (totalFees > 0) { + append(" (${CurrencyFormatter.formatKsh(totalFees)} in fees)") + } + append(".") + } + + NotificationHelper.showNotification( + context = applicationContext, + channelId = NotificationHelper.CHANNEL_SUMMARIES, + notificationId = 1002, + title = "Weekly Spending Summary", + body = body + ) + } + + return Result.success() + } +} diff --git a/app/src/main/java/com/ledga/app/worker/TransactionAlerts.kt b/app/src/main/java/com/ledga/app/worker/TransactionAlerts.kt new file mode 100644 index 0000000..db72b86 --- /dev/null +++ b/app/src/main/java/com/ledga/app/worker/TransactionAlerts.kt @@ -0,0 +1,74 @@ +package com.ledga.app.worker + +import android.content.Context +import com.ledga.app.data.db.dao.BudgetDao +import com.ledga.app.data.db.dao.TransactionDao +import com.ledga.app.data.parser.ParsedTransaction +import com.ledga.app.util.CurrencyFormatter +import com.ledga.app.util.DateUtils +import kotlinx.coroutines.flow.first +import javax.inject.Inject +import javax.inject.Singleton + +@Singleton +class TransactionAlerts @Inject constructor( + private val transactionDao: TransactionDao, + private val budgetDao: BudgetDao +) { + suspend fun checkAlerts( + context: Context, + transaction: ParsedTransaction, + largeTransactionThreshold: Double, + largeTransactionEnabled: Boolean, + budgetAlertsEnabled: Boolean + ) { + // Large transaction alert + if (largeTransactionEnabled && transaction.amount >= largeTransactionThreshold) { + val name = transaction.recipientName ?: transaction.type.name.replace("_", " ") + NotificationHelper.showNotification( + context = context, + channelId = NotificationHelper.CHANNEL_LARGE_TXN, + notificationId = 2000 + (transaction.transactionCode.hashCode() and 0xFFFF), + title = "Large Transaction", + body = "${CurrencyFormatter.formatKsh(transaction.amount)} to $name" + ) + } + + // Budget alerts + if (budgetAlertsEnabled) { + checkBudgetAlerts(context) + } + } + + private suspend fun checkBudgetAlerts(context: Context) { + val start = DateUtils.getStartOfMonth() + val end = System.currentTimeMillis() + val totalSpent = transactionDao.getTotalSpending(start, end).first() + + val budgets = budgetDao.getActiveBudgets().first() + val overallBudget = budgets.find { it.categoryId == null } ?: return + + val percentage = ((totalSpent / overallBudget.monthlyLimit) * 100).toInt() + + when { + percentage >= 100 -> { + NotificationHelper.showNotification( + context = context, + channelId = NotificationHelper.CHANNEL_BUDGET, + notificationId = 3001, + title = "Budget Exceeded!", + body = "You've spent ${CurrencyFormatter.formatKsh(totalSpent)} — ${percentage}% of your ${CurrencyFormatter.formatKsh(overallBudget.monthlyLimit)} monthly budget." + ) + } + percentage >= 80 -> { + NotificationHelper.showNotification( + context = context, + channelId = NotificationHelper.CHANNEL_BUDGET, + notificationId = 3002, + title = "Budget Warning", + body = "You've used ${percentage}% of your monthly budget (${CurrencyFormatter.formatKsh(totalSpent)} of ${CurrencyFormatter.formatKsh(overallBudget.monthlyLimit)})." + ) + } + } + } +} diff --git a/app/src/main/java/com/ledga/app/worker/UpdateCheckWorker.kt b/app/src/main/java/com/ledga/app/worker/UpdateCheckWorker.kt new file mode 100644 index 0000000..7806d36 --- /dev/null +++ b/app/src/main/java/com/ledga/app/worker/UpdateCheckWorker.kt @@ -0,0 +1,120 @@ +package com.ledga.app.worker + +import android.content.Context +import android.content.Intent +import android.net.Uri +import androidx.core.content.FileProvider +import androidx.hilt.work.HiltWorker +import androidx.work.CoroutineWorker +import androidx.work.WorkerParameters +import dagger.assisted.Assisted +import dagger.assisted.AssistedInject +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext +import kotlinx.serialization.Serializable +import kotlinx.serialization.json.Json +import java.io.File +import java.net.URL + +@Serializable +data class GitHubRelease( + val tag_name: String, + val name: String? = null, + val body: String? = null, + val assets: List = emptyList() +) + +@Serializable +data class GitHubAsset( + val name: String, + val browser_download_url: String, + val size: Long = 0 +) + +@HiltWorker +class UpdateCheckWorker @AssistedInject constructor( + @Assisted context: Context, + @Assisted params: WorkerParameters +) : CoroutineWorker(context, params) { + + override suspend fun doWork(): Result { + // This worker is a placeholder — the actual check is done in UpdateChecker + return Result.success() + } +} + +object UpdateChecker { + private val json = Json { ignoreUnknownKeys = true } + private const val PREFS_NAME = "update_prefs" + private const val LAST_CHECK_KEY = "last_check" + + suspend fun checkForUpdate( + context: Context, + owner: String, + repo: String, + currentVersion: String + ): GitHubRelease? = withContext(Dispatchers.IO) { + // Rate limit: max once per day + val prefs = context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE) + val lastCheck = prefs.getLong(LAST_CHECK_KEY, 0) + val oneDayMs = 24 * 60 * 60 * 1000L + if (System.currentTimeMillis() - lastCheck < oneDayMs) return@withContext null + + prefs.edit().putLong(LAST_CHECK_KEY, System.currentTimeMillis()).apply() + + try { + val url = "https://api.github.com/repos/$owner/$repo/releases/latest" + val response = URL(url).readText() + val release = json.decodeFromString(response) + + val latestVersion = release.tag_name.removePrefix("v") + if (isNewerVersion(latestVersion, currentVersion)) release else null + } catch (e: Exception) { + null + } + } + + suspend fun downloadApk(context: Context, downloadUrl: String, filename: String): File? = + withContext(Dispatchers.IO) { + try { + val cacheDir = File(context.cacheDir, "updates") + cacheDir.mkdirs() + val file = File(cacheDir, filename) + + URL(downloadUrl).openStream().use { input -> + file.outputStream().use { output -> + input.copyTo(output) + } + } + file + } catch (e: Exception) { + null + } + } + + fun installApk(context: Context, file: File) { + val uri = FileProvider.getUriForFile( + context, + "${context.packageName}.fileprovider", + file + ) + val intent = Intent(Intent.ACTION_VIEW).apply { + setDataAndType(uri, "application/vnd.android.package-archive") + addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) + addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION) + } + context.startActivity(intent) + } + + private fun isNewerVersion(latest: String, current: String): Boolean { + val latestParts = latest.split(".").map { it.toIntOrNull() ?: 0 } + val currentParts = current.split(".").map { it.toIntOrNull() ?: 0 } + for (i in 0 until maxOf(latestParts.size, currentParts.size)) { + val l = latestParts.getOrElse(i) { 0 } + val c = currentParts.getOrElse(i) { 0 } + if (l > c) return true + if (l < c) return false + } + return false + } +} diff --git a/app/src/main/res/drawable/ic_launcher_background.xml b/app/src/main/res/drawable/ic_launcher_background.xml new file mode 100644 index 0000000..5cc0508 --- /dev/null +++ b/app/src/main/res/drawable/ic_launcher_background.xml @@ -0,0 +1,10 @@ + + + + diff --git a/app/src/main/res/drawable/ic_launcher_foreground.xml b/app/src/main/res/drawable/ic_launcher_foreground.xml new file mode 100644 index 0000000..b514012 --- /dev/null +++ b/app/src/main/res/drawable/ic_launcher_foreground.xml @@ -0,0 +1,12 @@ + + + + + + diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml new file mode 100644 index 0000000..6b78462 --- /dev/null +++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml @@ -0,0 +1,5 @@ + + + + + diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml new file mode 100644 index 0000000..6b78462 --- /dev/null +++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml @@ -0,0 +1,5 @@ + + + + + diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml new file mode 100644 index 0000000..656fa24 --- /dev/null +++ b/app/src/main/res/values/strings.xml @@ -0,0 +1,4 @@ + + + Ledga + diff --git a/app/src/main/res/values/themes.xml b/app/src/main/res/values/themes.xml new file mode 100644 index 0000000..ca4e882 --- /dev/null +++ b/app/src/main/res/values/themes.xml @@ -0,0 +1,13 @@ + + + + + + diff --git a/app/src/main/res/xml/file_paths.xml b/app/src/main/res/xml/file_paths.xml new file mode 100644 index 0000000..c9cc257 --- /dev/null +++ b/app/src/main/res/xml/file_paths.xml @@ -0,0 +1,4 @@ + + + + diff --git a/app/src/test/java/com/ledga/app/parser/MpesaSmsParserTest.kt b/app/src/test/java/com/ledga/app/parser/MpesaSmsParserTest.kt new file mode 100644 index 0000000..d4c9b16 --- /dev/null +++ b/app/src/test/java/com/ledga/app/parser/MpesaSmsParserTest.kt @@ -0,0 +1,310 @@ +package com.ledga.app.parser + +import com.ledga.app.data.parser.MpesaSmsParser +import com.ledga.app.data.parser.ParseResult +import com.ledga.app.data.parser.TransactionDirection +import com.ledga.app.data.parser.TransactionType +import org.junit.Assert.* +import org.junit.Test + +class MpesaSmsParserTest { + + private fun assertSuccess(sms: String): ParseResult.Success { + val result = MpesaSmsParser.parse(sms) + assertTrue("Expected Success but got: $result", result is ParseResult.Success) + return result as ParseResult.Success + } + + // --- Sender filter --- + + @Test + fun `isMpesaMessage accepts MPESA sender`() { + assertTrue(MpesaSmsParser.isMpesaMessage("MPESA")) + assertTrue(MpesaSmsParser.isMpesaMessage("mpesa")) + assertTrue(MpesaSmsParser.isMpesaMessage("Mpesa")) + } + + @Test + fun `isMpesaMessage rejects other senders`() { + assertFalse(MpesaSmsParser.isMpesaMessage("KCB")) + assertFalse(MpesaSmsParser.isMpesaMessage("")) + assertFalse(MpesaSmsParser.isMpesaMessage("SAFARICOM")) + } + + // --- Send Money --- + + @Test + fun `parse send money`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh500.00 sent to JOHN DOE 0712345678 on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh1,200.00. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals("RK31B7X4ZQ", t.transactionCode) + assertEquals(TransactionType.SEND, t.type) + assertEquals(500.0, t.amount, 0.01) + assertEquals("JOHN DOE", t.recipientName) + assertEquals("0712345678", t.recipientPhone) + assertEquals(1200.0, t.balance, 0.01) + assertEquals(0.0, t.transactionCost, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + @Test + fun `parse send money large amount`() { + val sms = "AB12CD34EF Confirmed. Ksh100,000.00 sent to JANE SMITH 0798765432 on 1/1/26 at 12:00 AM. New M-PESA balance is Ksh50,000.00. Transaction cost, Ksh105.00." + val result = assertSuccess(sms) + assertEquals(100000.0, result.transaction.amount, 0.01) + assertEquals(50000.0, result.transaction.balance, 0.01) + assertEquals(105.0, result.transaction.transactionCost, 0.01) + } + + // --- Buy Goods --- + + @Test + fun `parse buy goods`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh1,200.00 paid to NAIVAS SUPERMARKET. on 21/3/26 at 2:15 PM.New M-PESA balance is Ksh3,500.00. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.BUY_GOODS, t.type) + assertEquals(1200.0, t.amount, 0.01) + assertEquals("NAIVAS SUPERMARKET", t.recipientName) + assertEquals(3500.0, t.balance, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + // --- Pay Bill --- + + @Test + fun `parse pay bill`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh2,500.00 paid to KPLC PREPAID. Account Number 12345678. on 21/3/26 at 3:00 PM. New M-PESA balance is Ksh1,000.00. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.PAY_BILL, t.type) + assertEquals(2500.0, t.amount, 0.01) + assertEquals("KPLC PREPAID", t.recipientName) + assertEquals("12345678", t.accountNumber) + assertEquals(1000.0, t.balance, 0.01) + } + + // --- Withdraw Agent --- + + @Test + fun `parse withdraw agent`() { + val sms = "RK31B7X4ZQ Confirmed.You have withdrawn Ksh1,000.00 from JAMES AGENT 543210 on 21/3/26 at 4:00 PM.New M-PESA balance is Ksh500.00. Transaction cost, Ksh28.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.WITHDRAW_AGENT, t.type) + assertEquals(1000.0, t.amount, 0.01) + assertEquals("JAMES AGENT", t.recipientName) + assertEquals("543210", t.recipientPhone) + assertEquals(500.0, t.balance, 0.01) + assertEquals(28.0, t.transactionCost, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + // --- Withdraw ATM --- + + @Test + fun `parse withdraw ATM`() { + val sms = "RK31B7X4ZQ Confirmed. You have withdrawn Ksh5,000.00 from an ATM on 21/3/26 at 4:30 PM. New M-PESA balance is Ksh2,000.00. Transaction cost, Ksh34.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.WITHDRAW_ATM, t.type) + assertEquals(5000.0, t.amount, 0.01) + assertEquals("ATM", t.recipientName) + assertEquals(2000.0, t.balance, 0.01) + assertEquals(34.0, t.transactionCost, 0.01) + } + + // --- Deposit --- + + @Test + fun `parse deposit`() { + val sms = "RK31B7X4ZQ Confirmed.You have deposited Ksh5,000.00 to your M-PESA account on 21/3/26 at 10:00 AM.New M-PESA balance is Ksh5,500.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.DEPOSIT, t.type) + assertEquals(5000.0, t.amount, 0.01) + assertEquals(5500.0, t.balance, 0.01) + assertEquals(TransactionDirection.INFLOW, t.direction) + } + + // --- Received Money --- + + @Test + fun `parse received money`() { + val sms = "RK31B7X4ZQ Confirmed.You have received Ksh2,000.00 from JANE DOE 0798765432 on 21/3/26 at 11:00 AM.New M-PESA balance is Ksh7,500.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.RECEIVED, t.type) + assertEquals(2000.0, t.amount, 0.01) + assertEquals("JANE DOE", t.recipientName) + assertEquals("0798765432", t.recipientPhone) + assertEquals(7500.0, t.balance, 0.01) + assertEquals(TransactionDirection.INFLOW, t.direction) + } + + // --- Airtime Self --- + + @Test + fun `parse airtime self`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh100.00 of airtime purchased on 21/3/26 at 12:00 PM.New M-PESA balance is Ksh7,400.00. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.AIRTIME_SELF, t.type) + assertEquals(100.0, t.amount, 0.01) + assertEquals(7400.0, t.balance, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + // --- Airtime Other --- + + @Test + fun `parse airtime for others`() { + val sms = "RK31B7X4ZQ Confirmed. You bought Ksh100.00 of airtime for 0712345678 on 21/3/26 at 12:30 PM.New M-PESA balance is Ksh7,300.00. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.AIRTIME_OTHER, t.type) + assertEquals(100.0, t.amount, 0.01) + assertEquals("0712345678", t.recipientPhone) + assertEquals(7300.0, t.balance, 0.01) + } + + // --- M-Pesa Global --- + + @Test + fun `parse mpesa global`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh5,000.00 sent to JOHN DOE +44712345678 (United Kingdom) via M-PESA Global on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh10,000.00. Transaction cost, Ksh150.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.MPESA_GLOBAL, t.type) + assertEquals(5000.0, t.amount, 0.01) + assertEquals("JOHN DOE", t.recipientName) + assertEquals("+44712345678", t.recipientPhone) + assertEquals("United Kingdom", t.destinationCountry) + assertEquals(10000.0, t.balance, 0.01) + assertEquals(150.0, t.transactionCost, 0.01) + } + + // --- Fuliza --- + + @Test + fun `parse fuliza borrow`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh500.00 sent to JOHN DOE 0712345678 on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh0.00. Fuliza M-PESA amount is Ksh500.00. Fuliza M-PESA outstanding amount is Ksh500.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.FULIZA, t.type) + assertEquals(500.0, t.amount, 0.01) + assertEquals(500.0, t.fulizaAmount!!, 0.01) + assertEquals(500.0, t.fulizaOutstanding!!, 0.01) + assertEquals("JOHN DOE", t.recipientName) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + // --- Fuliza Repayment --- + + @Test + fun `parse fuliza repayment`() { + val sms = "RK31B7X4ZQ Confirmed. You have paid Ksh200.00 to Fuliza M-PESA on 21/3/26 at 2:00 PM. Fuliza M-PESA outstanding amount is Ksh300.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.FULIZA_REPAYMENT, t.type) + assertEquals(200.0, t.amount, 0.01) + assertEquals(300.0, t.fulizaOutstanding!!, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + // --- Fuliza Reversal --- + + @Test + fun `parse fuliza reversal`() { + val sms = "RK31B7X4ZQ Confirmed. Fuliza M-PESA of Ksh500.00 has been reversed on 21/3/26 at 3:00 PM. Fuliza M-PESA outstanding amount is Ksh0.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.FULIZA_REVERSAL, t.type) + assertEquals(500.0, t.amount, 0.01) + assertEquals(0.0, t.fulizaOutstanding!!, 0.01) + assertEquals(TransactionDirection.INFLOW, t.direction) + } + + // --- Reversal --- + + @Test + fun `parse reversal`() { + val sms = "RK31B7X4ZQ Confirmed. Transaction RJ12345678 has been reversed. Your account balance is Ksh2,000.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.REVERSAL, t.type) + assertEquals("RJ12345678", t.reversedTransactionCode) + assertEquals(2000.0, t.balance, 0.01) + assertEquals(TransactionDirection.INFLOW, t.direction) + } + + // --- M-Shwari --- + + @Test + fun `parse mshwari transfer to`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh1,000.00 transferred to M-Shwari account on 21/3/26 at 5:00 PM. New M-PESA balance is Ksh500.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.MSHWARI, t.type) + assertEquals(1000.0, t.amount, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + @Test + fun `parse mshwari transfer from`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh1,000.00 transferred from M-Shwari account on 21/3/26 at 5:00 PM. New M-PESA balance is Ksh1,500.00." + val result = assertSuccess(sms) + assertEquals(TransactionDirection.INFLOW, result.transaction.direction) + } + + // --- KCB M-Pesa --- + + @Test + fun `parse kcb mpesa`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh2,000.00 transferred to KCB M-Pesa account on 21/3/26 at 6:00 PM. New M-PESA balance is Ksh3,000.00." + val result = assertSuccess(sms) + val t = result.transaction + assertEquals(TransactionType.KCB_MPESA, t.type) + assertEquals(2000.0, t.amount, 0.01) + assertEquals(TransactionDirection.OUTFLOW, t.direction) + } + + // --- Edge cases --- + + @Test + fun `parse failure for non-confirmed message`() { + val sms = "RK31B7X4ZQ Failed. Ksh500.00 sent to JOHN DOE." + val result = MpesaSmsParser.parse(sms) + assertTrue(result is ParseResult.Failure) + } + + @Test + fun `parse failure for no transaction code`() { + val sms = "Confirmed. Ksh500.00 sent to JOHN DOE on 21/3/26 at 1:30 PM." + val result = MpesaSmsParser.parse(sms) + assertTrue(result is ParseResult.Failure) + } + + @Test + fun `parse small amount`() { + val sms = "AB12CD34EF Confirmed. Ksh1.00 of airtime purchased on 21/3/26 at 12:00 PM.New M-PESA balance is Ksh0.50. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + assertEquals(1.0, result.transaction.amount, 0.01) + assertEquals(0.5, result.transaction.balance, 0.01) + } + + @Test + fun `unknown type for unrecognized mpesa message`() { + val sms = "AB12CD34EF Confirmed. Some new M-PESA feature we don't know about." + val result = assertSuccess(sms) + assertEquals(TransactionType.UNKNOWN, result.transaction.type) + } + + @Test + fun `transaction code extraction`() { + val sms = "RK31B7X4ZQ Confirmed. Ksh500.00 sent to JOHN DOE 0712345678 on 21/3/26 at 1:30 PM. New M-PESA balance is Ksh1,200.00. Transaction cost, Ksh0.00." + val result = assertSuccess(sms) + assertEquals("RK31B7X4ZQ", result.transaction.transactionCode) + } +} diff --git a/build.gradle.kts b/build.gradle.kts new file mode 100644 index 0000000..010e17f --- /dev/null +++ b/build.gradle.kts @@ -0,0 +1,12 @@ +plugins { + id("com.android.application") version "8.13.2" apply false + id("org.jetbrains.kotlin.android") version "2.1.0" apply false + id("org.jetbrains.kotlin.plugin.compose") version "2.1.0" apply false + id("org.jetbrains.kotlin.plugin.serialization") version "2.1.0" apply false + id("com.google.devtools.ksp") version "2.1.0-1.0.29" apply false + id("com.google.dagger.hilt.android") version "2.57.1" apply false +} + +tasks.register("clean", Delete::class) { + delete(rootProject.layout.buildDirectory) +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..6e13f34 --- /dev/null +++ b/gradle.properties @@ -0,0 +1,6 @@ +org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8 +org.gradle.parallel=true +android.useAndroidX=true +kotlin.code.style=official +android.nonTransitiveRClass=true +org.gradle.configuration-cache=true diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000..61285a6 Binary files /dev/null and b/gradle/wrapper/gradle-wrapper.jar differ diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..37f853b --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip +networkTimeout=10000 +validateDistributionUrl=true +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..632453c --- /dev/null +++ b/gradlew @@ -0,0 +1,180 @@ +#!/bin/sh + +############################################################################## +# Gradle startup script for Unix +############################################################################## + +# Attempt to set APP_HOME +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + ulimit -n "$MAX_FD" || + warn "Could neot set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Stop when "xargs" is not available. +if ! command -v xargs >/dev/null 2>&1 +then + die "xargs is not available" +fi + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..911f07f --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,67 @@ +@rem Gradle startup script for Windows + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..ba76178 --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,18 @@ +pluginManagement { + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} + +dependencyResolutionManagement { + repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) + repositories { + google() + mavenCentral() + } +} + +rootProject.name = "Ledga" +include(":app")