مرحباً بك في مشروع Nawajeth - Dental Clinic Manager، وهو تطبيق إدارة محلي (offline) يعمل على نظام Android، مخصص لإدارة العيادات السنية بشكل شامل ومهني.
هذا الدليل سيساعدك على فتح المشروع في Android Studio وتشغيله بنجاح.
- Android Studio Hedgehog (2023.1.1) أو أحدث
- JDK 17 أو أحدث
- الحد الأدنى لإصدار Android: API 23 (Android 6.0 Marshmallow)
- قم بفك ضغط ملف
nawajeth_android_project.zipفي المجلد الذي تريده - افتح Android Studio
- اختر "Open" من القائمة الرئيسية
- تصفح إلى المجلد الذي قمت بفك الضغط فيه واختر مجلد
nawajeth_android_project - انقر على "Open"
- انتظر حتى يكتمل استيراد المشروع وتحميل جميع التبعيات (قد يستغرق ذلك بضع دقائق)
المشروع مبني بهيكلية معمارية نظيفة (Clean Architecture) مع تقسيم الوحدات كالتالي:
- app: الوحدة الرئيسية التي تحتوي على نقطة الدخول للتطبيق
- core: تحتوي على المكونات المشتركة والأدوات المساعدة
- data: طبقة البيانات مع قاعدة البيانات Room والمستودعات
- domain: طبقة المنطق التجاري مع Use Cases والنماذج
- features: الميزات المختلفة للتطبيق (المرضى، مخطط الأسنان، الأعمال السنية، الدفعات، التقارير، الإعدادات)
- قم بتوصيل جهاز Android حقيقي أو تشغيل محاكي Android
- انقر على زر "Run" (الزر الأخضر) في شريط الأدوات
- اختر الجهاز الذي تريد تشغيل التطبيق عليه
- انتظر حتى يتم بناء وتثبيت التطبيق على الجهاز
- إدارة المرضى (إضافة، تعديل، حذف، بحث)
- مخطط تفاعلي للأسنان مع إمكانية الرسم اليدوي
- إدارة الأعمال السنية والدفعات
- تخصيص الرموز والأسعار
- تقارير دورية وشهرية
- نسخ احتياطي واستعادة البيانات
- دعم اللغتين العربية والإنجليزية
- دعم المظهر الفاتح والداكن
التطبيق يأتي بنسخة تجريبية محدودة بـ 10 مرضى كحد أقصى. لتفعيل النسخة الكاملة:
- انتقل إلى شاشة الإعدادات ثم "تفعيل التطبيق"
- انسخ رقم الجهاز الظاهر وأرسله للمطور
- أدخل رمز التفعيل الذي ستحصل عليه من المطور
المشروع يحتوي على مجموعة من الاختبارات الآلية للتحقق من صحة الوظائف الأساسية:
- اختبارات تقييد عدد المرضى في النسخة المجانية
- اختبارات نظام التفعيل
- اختبارات واجهة المستخدم
يمكن تشغيل الاختبارات من خلال النقر بزر الماوس الأيمن على مجلد androidTest واختيار "Run Tests"
- التطبيق يعمل بشكل كامل بدون اتصال بالإنترنت
- حجم التطبيق النهائي أقل من 30 ميجابايت
- التطبيق قابل للتوسع مستقبلاً (مثل المزامنة السحابية أو الطباعة)
إذا واجهتك أي مشكلة أو كان لديك أي استفسار، يرجى التواصل مع فريق الدعم الفني.