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

نظرة عامة

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

📱 التطبيق متاح الآن كـ:

تطبيق أندرويد (APK)
تطبيق iOS (IPA)
تطبيق ويب (PWA)
تطبيق سطح المكتب (عبر Electron)

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

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

جوالي (Jawali) - من WeCash YE
ONE Cash - المحفظة الرقمية الأولى في اليمن
Cash - من Tamkeen Financial
Jaib Digital Wallet - من AHD Financial
mFloos - من Alkuraimi Islamic Microfinance Bank
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. تشغيل للتطوير

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

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

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

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

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

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

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

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

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

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

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

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

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

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

راجع ملف BUILD_INSTRUCTIONS.md للتفاصيل الكاملة.

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

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

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

الاستخدام

إدارة المحافظ

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

التحويلات

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

الإشعارات

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

الأمان

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

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

ملاحظات مهمة

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

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

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

الميزات المخطط لها

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

التحسينات التقنية

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

المساهمة

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

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

الترخيص

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

التواصل

المدى للخدمات البرمجية التسويقية والإعلانية

المدير العام: المهندس/ محمد المرتضى

الدعم

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

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