تطوير Android

// Android Jetpack Compose .cursorrules

// إشعار المرونة

// ملاحظة: هذا هيكل مشروع مقترح، ولكن يرجى الحفاظ على المرونة والتكيف مع هيكل المشروع الحالي.
// إذا اتبع المشروع طريقة تنظيم مختلفة، يرجى عدم فرض هذه الأنماط الهيكلية.
// أثناء تطبيق أفضل ممارسات Jetpack Compose، ركز على الحفاظ على الاتساق مع معمارية المشروع الحالية.

// معمارية المشروع وأفضل الممارسات

const androidJetpackComposeBestPractices = [
"التكيف مع معمارية المشروع الحالية مع الحفاظ على مبادئ نظافة الكود",
"اتباع إرشادات Material Design 3 والمكونات",
"تنفيذ معمارية نظيفة مع طبقة مجال وطبقة بيانات وطبقة عرض",
"استخدام Kotlin Coroutines و Flow للعمليات غير المتزامنة",
"استخدام Hilt للحقن بالاعتماد",
"اتباع التدفق الأحادي للبيانات لـ ViewModel وحالة واجهة المستخدم",
"استخدام Compose Navigation لإدارة الشاشة",
"تنفيذ رفع الحالة المناسب وتجميع المكونات",
];

// هيكل المجلدات

// ملاحظة: هذا هيكل مرجعي. يرجى التكيف مع تنظيم المشروع الحالي

const projectStructure = `app/
  src/
    main/
      java/com/package/
        data/
          repository/
          datasource/
          models/
        domain/
          usecases/
          models/
          repository/
        presentation/
          screens/
          components/
          theme/
          viewmodels/
        di/
        utils/
      res/
        values/
        drawable/
        mipmap/
    test/
    androidTest/`;

// إرشادات Compose UI

const composeGuidelines = `

1. استخدام مناسب لـ remember و derivedStateOf
2. تنفيذ تحسينات إعادة التركيب المناسبة
3. استخدام ترتيب مناسب لعلامات Compose
4. اتباع قواعد التسمية للوظائف القابلة للتركيب
5. تنفيذ ملاحظات المعاينة المناسبة
6. استخدام MutableState للإدارة المناسبة للحالة
7. تنفيذ معالجة الأخطاء والحالات التحميل المناسبة
8. استخدام MaterialTheme للسمة المناسبة
9. اتباع إرشادات إمكانية الوصول
10. تنفيذ أنماط الرسوم المتحركة المناسبة
    `;

// إرشادات الاختبار

const testingGuidelines = `

1. كتابة اختبارات وحدة لـ ViewModels و UseCases
2. استخدام إطار اختبار Compose لاختبارات واجهة المستخدم
3. استخدام مستودعات وهمية للاختبار
4. تنفيذ تغطية اختبار مناسبة
5. استخدام جدولة اختبارات Coroutines المناسبة
   `;

// إرشادات الأداء

const performanceGuidelines = `

1. استخدام مفاتيح مناسبة لتقليل إعادة التركيب إلى الحد الأدنى
2. تنفيذ التحميل الكسول باستخدام LazyColumn و LazyRow المناسب
3. تنفيذ تحميل الصور بكفاءة
4. استخدام إدارة الحالة المناسبة لمنع التحديثات غير الضرورية
5. اتباع الإدراك المناسب للدورة الحياتية
6. تنفيذ إدارة الذاكرة المناسبة
7. استخدام المعالجة الخلفية المناسبة
   `;