Raseed Guard

تطبيق تذكير بانتهاء الباقة والتنبؤ بنفاد الرصيد.

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

• تتبع تاريخ انتهاء الباقة
• تتبع الرصيد المتبقي
• تنبيهات ذكية عند قرب نفاد الرصيد
• واجهة عربية (RTL)
• يعمل بدون إنترنت (Offline-first)

بيئة التطوير

• Android Studio Iguana or later
• Kotlin 1.9+
• Jetpack Compose
• Java 17

تعليمات البناء والتشغيل

متطلبات النظام

لتشغيل المشروع وبناء ملف APK، تحتاج إلى تثبيت:

• JDK 17
• Android SDK (API Level 34)

البناء (في Android Studio)

1. افتح المشروع في Android Studio.
2. انتظر حتى تكتمل عملية Gradle Sync.
3. اضغط على زر التشغيل (Run) لتثبيت التطبيق على المحاكي أو الجهاز الحقيقي.

البناء (عبر سطر الأوامر)

ملاحظة: يتطلب هذا الأمر وجود Android SDK مثبتًا ومتغير ANDROID_HOME معدًا بشكل صحيح. لا يمكن تنفيذ هذا الأمر في بيئات لا تحتوي على Android SDK (مثل Jules).

./gradlew assembleDebug

CI Build

يستخدم المشروع GitHub Actions لبناء التطبيق واختباره تلقائيًا.

• يتم تشغيل الـ Workflow عند كل push أو pull_request على فروع main و feature/**.
• يقوم النظام ببناء نسخة Debug APK وتشغيل اختبارات الوحدة (Unit Tests).
• يمكن تحميل ملف الـ APK الناتج من تبويب "Actions" في GitHub تحت قسم "Artifacts".

ملاحظات الاختبار (Testing Notes)

تنبيه: اختبارات الوحدة (Unit Tests) تتطلب بيئة Android SDK لتشغيلها بنجاح. لا يمكن تشغيلها داخل بيئة Jules الحالية. يرجى تشغيلها محليًا أو في بيئة CI مجهزة.

./gradlew test

الهيكلية

يتبع المشروع معمارية Clean Architecture:

• core/: منطق الأعمال والنطاق (Domain).
• data/: طبقة البيانات (Repositories).
• ui/: واجهات المستخدم باستخدام Jetpack Compose.