📱 Mobile Native Architecture

WealthFam Mobile (Android) is the primary real-time ingestion sensor for the ecosystem. It is engineered to capture, hash, and transmit financial alerts with absolute reliability and minimal battery impact.

---

⚡ Native Ingestion Lifecycle

The app utilizes a dual-layer approach for SMS capture, integrating Flutter with low-level Android background services.

graph TD
    subgraph "Android Operating System"
        INTENT[SMS Intent Received]
    end

    subgraph "Native Layer (Java/Kotlin)"
        LISTENER[SMS Broadcast Receiver]
        LOCAL_HASH[MD5 Device Hashing]
    end

    subgraph "Flutter Layer (Dart)"
        VM[Background Dart VM]
        CLIENT[REST API Client]
    end

    INTENT --> LISTENER
    LISTENER --> LOCAL_HASH
    LOCAL_HASH --> VM
    VM --> CLIENT
    CLIENT -->|POST /ingest| BACKEND[FastAPI Backend]

---

🛡️ Secure Capture & Permissions

To maintain a Precision audit trail, the app requires specific high-privileged permissions:

• RECEIVE_SMS: High-reliability real-time listener.
• READ_SMS: Used for historical sync and bulk scanning of older records.
• WAKE_LOCK: Ensures the ingestion service completes the hash-and-send cycle even if the device enters deep sleep.

---

🔒 Security Principles

1. Local ID Generator: Every transaction is assigned a unique UUIDv4 on the device before transmission.
2. Privacy Masking: Personal identifiers (like full account numbers or OTPs) are filtered out at the native layer using strict regex ignore-patterns.
3. Encrypted Transport: All data transmitted to the backend uses TLS 1.3 with pinned certificates (in production).

---

🛠️ Development Setup

Detailed setup for Flutter and Android SDKs can be found in the Master Setup Guide.

---

*Real-time Awareness · Native Performance · Privacy Sovereignty*