4.1 KiB
4.1 KiB
App Internals
Documentation for app-specific logic — UI flows, routing decisions, and business rules implemented in the Android client.
UI Flows
| Document | Description |
|---|---|
| 00 — App Overview | MainActivity routing, HomeActivity, navigation modes, autolock, global session state |
| 01 — Onboarding | Language selection, security setup (PIN/pattern), appearance configuration |
| 02 — Lock Screen | LockActivity, PIN/pattern/biometric unlock, brute-force protection |
| 03 — Login | Bank selection, credential entry, MIB/BML/Fahipay login flows, multi-profile support |
| 04 — Accounts | Account list grouped display, AccountsAdapter, profile images, quick-transfer shortcut |
| 05 — Account History | Paginated transaction history, search, infinite scroll |
| 06 — Transfer History | Multi-bank merged transfer history, parallel loading |
| 07 — Transfer | Recipient lookup, transfer type picker, MIB/BML/Fahipay transfers, Fahipay payouts, Dhiraagu Reload by BML card, QR, biometric gate, BML OTP |
| 08 — Contacts | Contact list, add/edit/delete, categories, contact picker sheet |
| 09 — Activities | Local transfer log, TransferReceiptFragment, share/save receipt |
| 10 — OTP Screen | TOTP display, real-time countdown, enrolled bank authenticators |
| 11 — PayMV QR Screen | Generate receive-payment QR, BML/Fahipay card rendering, vertical reference text (Fahipay QRs WIP) |
| 12 — BML QR Pay | (Stub — see Transfer Flows for the live BML QR merchant flow) |
| 13 — Financing | MIB promotional deals, BML loans, BML foreign spend limits |
| 14 — Settings | Settings hub: Logins (drag to reorder), Appearance, Privacy & Security, Notifications, Storage, About |
| 15 — Settings: Security | Change lock method, biometrics, auto-lock timeout, screenshots |
| 16 — Settings: Appearance | Navigation mode, slot drag-reorder, theme, accent colour, language |
| 17 — Settings: Storage | Single "Clear All Caches" button |
| 21 — Dashboard | Aggregate balances, card stack, attention row, foreign limits, integrated QR launcher |
| 22 — Cards | Unified MIB + BML card stack, tap-to-pay launcher, freeze/unfreeze, manage mode |
| 23 — Tap to Pay | BML HCE service, single-use wallet token, EMV mag-stripe APDU flow |
| 24 — Notifications | Foreground polling service, per-bank channels, in-app sheet |
| 25 — QR Scanner | Full-screen CameraX scanner, gallery picker, zoom, torch |
| 26 — Circular Nav | Radial 4-slot wheel UI with lock centre |
| 27 — Settings: Notifications | Opt-in flow: permission → battery opt → service start |
| 28 — Settings: About | Version, T&Cs, donate buttons |
| 29 — Card Verification & Merchant Card Pay | NFC/manual card verification + card-only BML merchant payment (links and carrier services), return to merchant |
Reference
| Document | Description |
|---|---|
| 18 — PayMV QR Format | Decimal TLV encoding, all tags, CRC-16, per-bank references, real samples, Fahipay WIP, parsing reference |
| 19 — Parsers | Account display parser architecture — how raw bank API data is normalised into a unified AccountListDisplay model |
| 20 — Transfer Flows | TransferFragment entry points, recipient lookup, transfer type picker, Fahipay services, carrier services by BML card, routing, rejected combinations, BML business OTP flow, BML QR merchant payments |
| AI Security Audit | Full source security audit — credential storage, network layer, manifest, data privacy |