engineernimona-cmyk/fintrack-ethiopia

S M S-based financial tracking app for Ethiopia # FinTrack Ethiopia — Production-Ready Fintech Platform A full-stack fintech application for automatic SMS-based financial tracking, AI-powered categorization, and multi-organization management. ## Architecture ``` fintrack/ ├── mobile/ # Flutter Android App ├── web/ # React.js Admin Dashboard ├── backend/ # Firebase Cloud Functions └── shared/ # Shared types and utilities ``` ## Stack | Layer | Technology | |----------|-----------------------------------| | Mobile | Flutter (Android) | | Web | React.js + TypeScript + Vite | | Backend | Firebase (Auth, Firestore, Functions) | | AI | Google Gemini API (SMS parsing) | | Charts | Recharts (web), fl_chart (mobile) | ## Features - 📱 SMS automation engine — auto-detects Ethiopian bank transactions - 🤖 AI fallback parsing via Gemini - 📊 Real-time dashboards (mobile + web) - 🏢 Multi-organization support with role-based access - 🌍 Localization: English, Amharic, Afaan Oromo - 🔒 Firestore security rules + data isolation - ⚡ Offline-first with background sync ## Quick Start ### Mobile (Flutter) ```bash cd mobile flutter pub get flutter run ``` ### Web (React) ```bash cd web npm install npm run dev ``` ### Backend (Firebase) ```bash cd backend npm install firebase deploy --only functions,firestore:rules ``` ## Environment Setup Copy `.env.example` to `.env` in each directory and fill in your Firebase credentials.