README.md

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

## نظرة عامة

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

## 📱 **التطبيق متاح الآن كـ:**
- **تطبيق أندرويد** (APK)
- **تطبيق iOS** (IPA)
- **تطبيق ويب** (PWA)
- **تطبيق سطح المكتب** (عبر Electron)

## المحافظ المدعومة

التطبيق يدعم المحافظ الإلكترونية اليمنية التالية:

1. **جوالي (Jawali)** - من WeCash YE
2. **ONE Cash** - المحفظة الرقمية الأولى في اليمن
3. **Cash** - من Tamkeen Financial
4. **Jaib Digital Wallet** - من AHD Financial
5. **mFloos** - من Alkuraimi Islamic Microfinance Bank
6. **Mobile Money Wallet** - من CAC Bank

## الميزات الرئيسية

### 🔐 نظام أمان متقدم
- تسجيل دخول برقم الهاتف ورمز PIN
- مصادقة بيومترية (بصمة الإصبع)
- حماية من المحاولات المتكررة
- جلسات آمنة مع انتهاء صلاحية تلقائي

### 💸 إدارة المحافظ
- عرض جميع المحافظ في واجهة موحدة
- عرض الأرصدة الإجمالية والفردية
- تحديث الأرصدة في الوقت الفعلي
- إخفاء/إظهار الأرصدة للخصوصية

### 🔄 التحويلات والمدفوعات
- تحويل الأموال بين المحافظ المختلفة
- دفع الفواتير (كهرباء، مياه، إنترنت)
- شحن أرصدة الهواتف
- مسح رموز QR للدفع

### 📱 واجهة مستخدم عصرية
- تصميم متجاوب يعمل على جميع الأجهزة
- واجهة باللغة العربية مع دعم RTL
- رسوم متحركة سلسة
- تجربة مستخدم بديهية

### 🔔 نظام إشعارات متطور
- إشعارات فورية للمعاملات
- تنبيهات أمنية
- إشعارات النظام
- إدارة الإشعارات المقروءة وغير المقروءة

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

### Frontend Framework
- **Ionic 7** - إطار عمل التطبيقات الهجينة
- **Angular 17** - إطار عمل الواجهة الأمامية
- **TypeScript** - لغة البرمجة الأساسية
- **SCSS** - معالج CSS المتقدم

### Mobile Development
- **Capacitor 5** - منصة التطبيقات الأصلية
- **Cordova Plugins** - الوصول لميزات الجهاز
- **PWA** - تطبيق ويب تقدمي

### Backend & Storage
- **Ionic Storage** - تخزين البيانات المحلية
- **RxJS** - إدارة البيانات التفاعلية
- **HTTP Client** - التواصل مع APIs

### UI/UX
- **Ionic Components** - مكونات واجهة المستخدم
- **Ionicons** - مكتبة الأيقونات
- **Google Fonts** - خط Tajawal العربي
- **CSS Animations** - الرسوم المتحركة

### Development Tools
- **Angular CLI** - أدوات التطوير
- **Capacitor CLI** - أدوات البناء للجوال
- **ESLint** - فحص جودة الكود
- **Prettier** - تنسيق الكود

## هيكل المشروع

```
almada/
├── src/                           # مجلد المصدر الرئيسي
│   ├── app/                       # تطبيق Angular
│   │   ├── pages/                 # صفحات التطبيق
│   │   │   ├── login/             # صفحة تسجيل الدخول
│   │   │   ├── home/              # الصفحة الرئيسية
│   │   │   ├── wallets/           # صفحة المحافظ
│   │   │   ├── transfer/          # صفحة التحويلات
│   │   │   └── ...                # باقي الصفحات
│   │   ├── services/              # الخدمات
│   │   │   ├── auth.service.ts    # خدمة المصادقة
│   │   │   ├── wallet.service.ts  # خدمة المحافظ
│   │   │   └── ...                # باقي الخدمات
│   │   ├── guards/                # حراس الحماية
│   │   └── components/            # المكونات المشتركة
│   ├── assets/                    # الملفات الثابتة
│   ├── theme/                     # ملفات الثيم
│   └── environments/              # إعدادات البيئة
├── android/                       # مشروع الأندرويد
├── ios/                          # مشروع iOS
├── capacitor.config.ts           # إعدادات Capacitor
├── ionic.config.json             # إعدادات Ionic
├── angular.json                  # إعدادات Angular
├── package.json                  # تبعيات المشروع
├── BUILD_INSTRUCTIONS.md         # تعليمات البناء
└── README.md                     # هذا الملف
```

## كيفية التشغيل

### 1. تشغيل للتطوير

```bash
# استنساخ المشروع
git clone [repository-url]
cd almada

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

# تشغيل خادم التطوير
ionic serve

# فتح المتصفح على
http://localhost:8100
```

### 2. بناء التطبيق للجوال

```bash
# بناء المشروع
ionic build --prod

# إضافة منصة الأندرويد
ionic cap add android

# إضافة منصة iOS
ionic cap add ios

# بناء APK للأندرويد
ionic cap build android

# بناء IPA لـ iOS
ionic cap build ios
```

### 3. تشغيل على الأجهزة

```bash
# تشغيل على الأندرويد
ionic cap run android

# تشغيل على iOS
ionic cap run ios

# تشغيل في المتصفح مع إعادة التحميل
ionic serve --lab
```

راجع ملف [BUILD_INSTRUCTIONS.md](BUILD_INSTRUCTIONS.md) للتفاصيل الكاملة.

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

للاختبار، يمكن استخدام البيانات التالية:

- **رقم الهاتف**: أي رقم يمني صحيح (9 أرقام)
- **رمز PIN**: أي رمز من 4-6 أرقام
- **مثال**: 777123456 / 1234

## الاستخدام

### تسجيل الدخول
1. أدخل رقم الهاتف (9 أرقام)
2. أدخل رمز PIN (4-6 أرقام)
3. أو استخدم المصادقة البيومترية

### إدارة المحافظ
- عرض جميع المحافظ والأرصدة
- تحديث الأرصدة
- إخفاء/إظهار الأرصدة

### التحويلات
1. اختر المحفظة المرسلة
2. أدخل تفاصيل التحويل
3. أكد بـ PIN

### الإشعارات
- عرض الإشعارات من الأيقونة في الأعلى
- وضع علامة مقروء
- حذف الإشعارات

## الأمان

التطبيق يتضمن عدة طبقات أمان:

- **تشفير البيانات**: جميع البيانات الحساسة مشفرة
- **جلسات آمنة**: انتهاء صلاحية تلقائي للجلسات
- **حماية من الهجمات**: حماية من المحاولات المتكررة
- **مصادقة متعددة**: PIN + بصمة
- **تخزين آمن**: استخدام Local Storage بشكل آمن

## ملاحظات مهمة

⚠️ **هذا تطبيق تجريبي لأغراض العرض فقط**

- جميع البيانات والمعاملات محاكاة
- لا يؤثر على الحسابات الحقيقية
- البيانات محفوظة محلياً في المتصفح
- يتطلب متصفح حديث للمصادقة البيومترية

## التطوير المستقبلي

### الميزات المخطط لها
- [ ] دعم المزيد من المحافظ
- [ ] تطبيق جوال أصلي
- [ ] تكامل مع APIs الحقيقية
- [ ] نظام إحصائيات متقدم
- [ ] دعم العملات المتعددة
- [ ] نظام النسخ الاحتياطي

### التحسينات التقنية
- [ ] PWA (Progressive Web App)
- [ ] وضع عدم الاتصال
- [ ] تحسين الأداء
- [ ] اختبارات تلقائية
- [ ] CI/CD Pipeline

## المساهمة

نرحب بالمساهمات! يرجى:

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

## الترخيص

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

## التواصل

**المدى للخدمات البرمجية التسويقية والإعلانية**
- المدير العام: المهندس/ محمد المرتضى
- © 2025 جميع الحقوق محفوظة

## الدعم

للدعم التقني أو الاستفسارات، يرجى فتح issue في المستودع أو التواصل مع فريق التطوير.

---

**شكراً لاستخدام محفظتي الموحدة! 🚀**