README_GITHUB.md

# 📱 محفظتي الموحدة - تطبيق المحافظ الإلكترونية اليمنية

[![🚀 Build APK](https://github.com/USERNAME/almada-unified-wallet/actions/workflows/build-apk.yml/badge.svg)](https://github.com/USERNAME/almada-unified-wallet/actions/workflows/build-apk.yml)
[![📱 Download APK](https://img.shields.io/badge/Download-APK-green.svg)](https://github.com/USERNAME/almada-unified-wallet/releases/latest)

## 🎯 **نظرة عامة**

**محفظتي الموحدة** هو تطبيق أندرويد متطور يجمع جميع المحافظ الإلكترونية اليمنية في واجهة موحدة، مما يتيح للمستخدمين إدارة جميع محافظهم من مكان واحد.

## 📱 **تحميل التطبيق**

### 🚀 **أحدث إصدار:**
[![📥 تحميل APK](https://img.shields.io/badge/تحميل-APK-blue.svg?style=for-the-badge)](https://github.com/USERNAME/almada-unified-wallet/releases/latest/download/app-debug.apk)

### 🔄 **البناء التلقائي:**
- يتم بناء APK تلقائياً عند كل تحديث
- متوفر في قسم [Actions](https://github.com/USERNAME/almada-unified-wallet/actions)
- تحميل مباشر من [Releases](https://github.com/USERNAME/almada-unified-wallet/releases)

## 🎯 **الميزات**

### ✅ **المتاحة حالياً:**
- 🔐 تسجيل دخول آمن برقم الهاتف + PIN
- 💳 عرض 6 محافظ يمنية رئيسية:
  - جوالي (Jawali)
  - ONE Cash
  - Cash
  - Aman
  - Tadawul
  - Al-Kuraimi
- 🏠 واجهة موحدة لجميع المحافظ
- 🌙 دعم الوضع الليلي
- 🔄 واجهة عربية كاملة (RTL)
- 📱 تصميم متجاوب لجميع أحجام الشاشات

### 🔄 **قيد التطوير:**
- 📨 قراءة رسائل SMS لاستخراج الأرصدة
- 👆 مصادقة بيومترية (بصمة/وجه)
- 🔔 إشعارات ذكية ومخصصة
- 📊 تحليل أنماط الإنفاق والتوفير
- 💰 اقتراحات التوفير الذكية

## 🔑 **بيانات التجربة**

للدخول إلى التطبيق:
- **رقم الهاتف:** `777123456`
- **رمز PIN:** `1234`

## 🛠️ **التقنيات المستخدمة**

- **Frontend:** HTML5, CSS3, JavaScript (ES6+)
- **Mobile Framework:** Capacitor 5
- **Build System:** Gradle
- **CI/CD:** GitHub Actions
- **Platform:** Android (API 24+)

## 📲 **التثبيت**

### **من GitHub Releases:**
1. اذهب إلى [Releases](https://github.com/USERNAME/almada-unified-wallet/releases)
2. حمل أحدث ملف APK
3. في الهاتف: فعل "مصادر غير معروفة"
4. ثبت التطبيق

### **من GitHub Actions:**
1. اذهب إلى [Actions](https://github.com/USERNAME/almada-unified-wallet/actions)
2. اختر آخر build ناجح
3. حمل APK من Artifacts

## 🏗️ **البناء المحلي**

```bash
# استنساخ المشروع
git clone https://github.com/USERNAME/almada-unified-wallet.git
cd almada-unified-wallet

# تثبيت التبعيات
npm install

# بناء للأندرويد
npx cap sync android
cd android
./gradlew assembleDebug
```

## 📊 **معلومات التطبيق**

| المعلومة | القيمة |
|---------|--------|
| **اسم التطبيق** | محفظتي الموحدة |
| **Package ID** | com.almada.unifiedwallet |
| **الإصدار** | 1.0.0 |
| **حجم APK** | ~15-20 MB |
| **الحد الأدنى** | Android 7.0 (API 24) |
| **اللغة** | العربية (RTL) |

## 🤝 **المساهمة**

نرحب بالمساهمات! يرجى:
1. Fork المشروع
2. إنشاء branch للميزة الجديدة
3. Commit التغييرات
4. Push إلى Branch
5. فتح Pull Request

## 📄 **الترخيص**

هذا المشروع مرخص تحت رخصة MIT - راجع ملف [LICENSE](LICENSE) للتفاصيل.

## 📞 **التواصل**

- **الشركة:** المدى للخدمات البرمجية التسويقية والإعلانية
- **الموقع:** https://almada.com
- **البريد الإلكتروني:** info@almada.com

## 🎉 **شكر خاص**

شكر خاص لجميع مطوري المحافظ الإلكترونية اليمنية والمجتمع التقني اليمني.

---

**🚀 مبروك! تطبيقك متاح للعالم!**

*Made with ❤️ in Yemen*