jolly26/DigitalEqub_android

Ethiopian app -traditional community money saving practice # Digital Equb (ዲጂታል ዕቁብ) - Android Manager Digital Equb is a local-first, privacy-focused Android application designed to modernize the management of Ethiopian Rotating Savings and Credit Associations (Equb). It eliminates the need for manual ledger books while ensuring full transparency and security between organizers and members. ## 🌟 Key Features - **Consensus-Based Management**: Dual-role system (Chairman & Co-Chair) ensuring data integrity through manual sync. - **Automated SMS Parsing**: Intelligent extraction of transaction details (Bank, Amount, Reference, Sender) from CBE, Telebirr, Dashen, and Awash SMS notifications. - **Role-Based Security**: PIN-protected access for Chairman and Co-Chair roles with audit trails for every action. - **Flexible Cycles**: Support for Weekly, Bi-weekly, and Monthly contribution cycles. - **Contribution Tracking**: Real-time status of members (Paid, Partial, Unpaid) with automated "nth contribution" acknowledgments. - **Third-Party Payments**: Support for recording payments made via relatives or anonymous sources. - **Offline First**: Entirely functional without an internet connection, storing all data securely in a local Room database. - **Audit Logging**: Immutable (local) logs of all administrative actions for transparency. ## 🏗️ System Design Principles ### 1. Offline-First Architecture The app follows a local-first philosophy. There is no central server. This ensures: - **Privacy**: Financial data never leaves the organizers' devices. - **Reliability**: Works in areas with poor or no connectivity. - **Cost**: No cloud hosting fees for the Equb group. ### 2. Consensus & Sync Model Data synchronization between the **Chairman (Master)** and **Co-Chair (Auditor)** happens via secure JSON export/import. The Co-Chair acts as a live backup and verifier. The app calculates "diffs" during import to show exactly what changed (new members, new payments, etc.). ### 3. MVVM Architecture - **View (Jetpack Compose)**: Declarati …