| # محفظتي الموحدة - تطبيق المحافظ الإلكترونية اليمنية الموحد | |
| ## نظرة عامة | |
| **محفظتي الموحدة** هو تطبيق جوال متطور مبني بتقنية 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 في المستودع أو التواصل مع فريق التطوير. | |
| --- | |
| **شكراً لاستخدام محفظتي الموحدة! 🚀** | |