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

مع نمو التطبيق تتفكك الشيفرة دون بنية. يشرح هذا المقال تنظيم المجلدات حسب الميزة، وطبقات الواجهة والحالة والمستودع ومصدر البيانات، ومبادئ قابلية الاختبار بلغة بسيطة.

3 دقيقة قراءة54 مشاهدة
العمارة النظيفة في فلاتر: بنية المجلدات والطبقات للمشاريع الكبيرة

التطبيقات الصغيرة تتسع لبضعة ملفات. لكن حين يكبر التطبيق ويعمل عليه عدة أشخاص، يصبح كل تغيير بسيط مخاطرة دون بنية. العمارة النظيفة تعني أن لكل جزء من الشيفرة مسؤولية واحدة واضحة.

#بنية المجلدات: الميزة أولًا

بدل التجميع حسب نوع الملف (كل العناصر معًا، وكل النماذج معًا)، جمّع حسب الميزة:

lib/
  core/            # shared: network, theme, utils
  features/
    auth/
      data/        # api + repository implementation
      domain/      # models + repository interface
      presentation/# screens, widgets, controllers
    courses/
      data/
      domain/
      presentation/
  main.dart

الفائدة: للعمل على ميزة تبحث في مجلد واحد، ويصبح حذف ميزة أو نقلها سهلًا.

#أربع طبقات بمسؤوليات واضحة

  • الواجهة (العناصر): تعرض فقط وتسلّم أحداث المستخدم إلى المتحكّم. بلا منطق عمل.
  • الحالة / المتحكّم: يحفظ حالة الشاشة ويحصل على البيانات من المستودع (Riverpod أو Bloc أو ChangeNotifier).
  • المستودع (Repository): البوابة الوحيدة إلى البيانات لبقية التطبيق. لا يعرف هل البيانات من الشبكة أم من قاعدة بيانات محلية.
  • مصدر البيانات: العمل الفعلي مع الواجهة البرمجية أو التخزين المحلي.

#مستودع خلف واجهة (Interface)

abstract class CourseRepository {
  Future<List<Course>> fetchCourses();
}

class ApiCourseRepository implements CourseRepository {
  ApiCourseRepository(this._api);
  final CourseApi _api;

  @override
  Future<List<Course>> fetchCourses() => _api.getCourses();
}

لماذا واجهة؟ في الاختبارات تضع FakeCourseRepository وتختبر سلوك الشاشة دون إنترنت.

#حقن الاعتماديات (DI)

يجب ألا تبني الأصناف اعتمادياتها بنفسها؛ بل تستلمها. عبر المُنشئات أو Riverpod:

final courseRepositoryProvider = Provider<CourseRepository>(
  (ref) => ApiCourseRepository(ref.watch(courseApiProvider)),
);

#نماذج غير قابلة للتغيير

عرّف النماذج بحقول final ومُنشئات const، وأنشئ نسخة جديدة لتغيير أي شيء (copyWith). هذا يقضي على الأخطاء الناتجة عن التغيير الخفي.

#قواعد تحافظ على سلامة البنية

  • العناصر لا تستدعي HTTP مباشرة أبدًا.
  • الطبقة الأدنى لا تستورد طبقة أعلى أبدًا (طبقة domain لا تعرف شيئًا عن طبقة العرض).
  • لكل ملف سبب واحد للتغيير.

#لا تبالغ

تطبيق من ثلاث شاشات لا يحتاج إلى أربع طبقات. ابدأ ببساطة وأضف الطبقات عندما تشعر بالحاجة. يجب أن تمنحك العمارة سرعة لا أن تبطئك.

إذا خرجت بشيء واحد فليكن: افصل الواجهة عن المنطق والبيانات. وكل شيء آخر يبدأ من هنا.

هل تحتاج إلى تطبيق أو موقع؟

يبني فريق فست فلاتر تطبيقات أندرويد وiOS والويب وسطح المكتب والمواقع بفلاتر: تقدير فوري بالدولار، ودفع على مراحل، والشيفرة المصدرية كاملة.