Architecture Decision Record

Active theme: Light

← وثائق

كيف تبدأ باستخدام سجلات ADR

لتبدأ باستخدام سجلات ADR، ناقش مع زملائك في الفريق المجالات التالية.

تحديد القرارات:

  • ما مدى استعجال قرار البنية المعمارية (AD) وما مدى أهميته؟

  • هل يجب اتخاذه الآن، أم يمكن أن ينتظر حتى يُعرف المزيد؟

  • يمكن للخبرة الشخصية والجماعية، إضافةً إلى أساليب التصميم وممارساته المعترف بها، أن تساعد في تحديد القرارات.

  • من الأفضل الاحتفاظ بقائمة مهام للقرارات تكمّل قائمة مهام المنتج.

اتخاذ القرارات:

  • توجد تقنيات عديدة لاتخاذ القرارات، منها العامة ومنها الخاصة بالبنية المعمارية للبرمجيات، مثل رسم خرائط الحوار.

  • اتخاذ القرارات الجماعي موضوع بحثي نشط.

تنفيذ القرارات وإنفاذها:

  • تُستخدم قرارات AD في تصميم البرمجيات؛ ولذلك يجب إبلاغها إلى أصحاب المصلحة في النظام ممن يموّلونه ويطوّرونه ويشغّلونه، وأن يقبلوها.

  • أساليب الترميز الواضحة معماريًا ومراجعات الشيفرة التي تركّز على الاعتبارات والقرارات المعمارية ممارستان ذواتا صلة.

  • ويجب أيضًا (إعادة) النظر في قرارات AD عند تحديث نظام برمجي أثناء تطوره.

مشاركة القرارات (اختياري):

  • تتكرر كثير من قرارات AD عبر المشاريع.

  • ومن ثمّ يمكن لخبرات القرارات السابقة، الجيدة منها والسيئة، أن تكون أصولًا قيّمة قابلة لإعادة الاستخدام عند اعتماد استراتيجية صريحة لإدارة المعرفة.

توثيق القرارات:

  • توجد قوالب وأدوات كثيرة لتدوين القرارات.

  • انظر المجتمعات الرشيقة، مثل سجلات ADR لدى M. Nygard.

  • انظر عمليات هندسة البرمجيات وتصميم البنية المعمارية التقليدية، مثل تخطيطات الجداول التي اقترحتها IBM UMF وكلٌّ من Tyree وAkerman من CapitalOne.

لمزيد من المعلومات: