Mustaafaasayed/Fintrack

The Automated Credit & Cashflow Manager for Egypt & MENA. An Android-first, privacy-centric financial engine that eliminates manual entry through secure on-device SMS parsing, accounting-grade reconciliation, and 55-day credit cycle intelligence 📊 FlousLek (فلوس لك) The Automated Credit & Cashflow Manager for Egypt & MENA FlousLek is an Android-first personal finance and credit management application built specifically to map real, fragmented financial behavior in Egypt and the MENA region. It completely eliminates the absolute friction of manual expense trackers by securely capturing, parsing, and reconciling institutional bank and wallet SMS text notifications locally and 100% on-device. Unlike generic global budgeting apps that break when faced with complex local financial flows, FlousLek acts as a quiet financial companion that handles the chaos of mixed Arabic/English transaction receipts, maps rolling 55-day credit card grace periods, and automatically reconciles multi-account transfers to prevent double-counting. 🚀 The Core Moat & Problem Solved Zero manual data entry friction: The application captures transactional data automatically via native on-device SMS interceptors. Manual adjustments serve exclusively as fallback options. True Credit Cycle Modeling: Models custom rolling statement closures and grace periods (the local 55-day banking rule) to calculate precise interest-free deadlines instead of treating transactions uniformly. Double-Counting Prevention: An accounting-grade internal transfer engine automatically identifies asynchronous multi-wallet flows (e.g., InstaPay cross-bank card payments or ATM cash routing) to avoid inflating monthly spending reports. Offline Sovereign Privacy: 100% local processing. No user financial payloads, plain text messages, or balance statistics ever leave the physical hardware. 🛠️ The Architecture & Tech Strategy This MVP repo follows a strict, PM-driven Vibe Coding blueprint designed for rapid, highly stable iterative growth with AI coding assistants (e.g., Cursor, Claude, Windsurf). Frontend UI Framework: Flutter (Multiplatform UI engine configured for light/dark responsive scaling). Native Integration Sub-Module: Kotlin Android Native platform channels t …