Skip to content

إجراء التشغيل القياسي: بنية المجالات المتطبقة

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

الهدف

جعل حدود المجالات صريحة بما يكفي حتى يتمكن الوكلاء من التحرك بسرعة دون تدهور هيكلي صامت.

النموذج المستهدف

ضمن مجال أعمال، فضِّل هذا التدفق الاتجاهي:

Types -> Config -> Repo -> Service -> Runtime -> UI

المخاوف المشتركة يجب أن تدخل من خلال موفّرين أو محوّلات صريحة. الأدوات المساعدة المشتركة تبقى خارج المجال وألا تتراكم فيها منطق المجال.

قائمة فحص الإعداد

  • عرِّف المجالات الحالية في ARCHITECTURE.md.
  • اكتب اتجاهات التبعية المسموح بها في ARCHITECTURE.md.
  • سجِّل الواجهات المشتركة مثل المصادقة وقياس الأداء وواجهات برمجة التطبيقات الخارجية.
  • أضف ملاحظة قصيرة واحدة لأكثر انتهاك حدود صعوبة حاليًا.
  • قرر ما يجب تفعيله آليًا بواسطة lint أو الاختبارات أو النصوص البرمجية.

إجراء التشغيل القياسي للتنفيذ

  1. ارسم خريطة قاعدة الكود إلى مجالات قبل لمس نمط التنفيذ.
  2. لكل مجال، حدد تسلسل الطبقات المسموح به.
  3. حدد جميع المخاوف المشتركة ووجهها عبر موفّرين أو محوّلات.
  4. انقل المنطق المشترك الغامض إما إلى المجال المالك أو إلى أدوات مساعدة عامة حقًا.
  5. وثِّق القواعد في ARCHITECTURE.md.
  6. أضف حاجزًا وقائيًا قابلًا للتنفيذ للانتهاك الأعلى تكلفة.
  7. حدِّث تسجيل الجودة بعد التغيير.

تعريف الإنجاز

  • يمكن لوكيل جديد معرفة أي طبقة تملك تغييرًا.
  • كود واجهة المستخدم لم يعد يصل إلى المستودع أو الآثار الجانبية الخارجية مباشرة.
  • المخاوف المشتركة لها نقاط دخول مسماة.
  • حد واحد مهم على الأقل مُفعَّل آليًا.

منتجات المستودع للتحديث

  • ARCHITECTURE.md
  • docs/QUALITY_SCORE.md
  • docs/design-docs/ عندما يتغير المنطق
  • docs/PLANS.md أو خطة التنفيذ النشطة