Architecture Decision Record

Active theme: Light

← وثائق

من يستطيع إنشاء سجل ADR؟

فكّر في جوانب مثل أشخاص بعينهم، أو أدوار بعينها، أو فرق بعينها، أو أقسام بعينها؛ وفكّر أيضًا فيما إذا كان هناك أشخاص أو أدوار أو فرق أو أقسام يمكنها تكليف إنشاء سجل ADR، أي أن تطلب سجلًا يكتبه شخص آخر.

مثال على إجابة: يمكن لأي شخص في مؤسستنا قرأ صفحة README الخاصة بسجل قرار البنية المعمارية أن يقترح سجل ADR، أي أن يبدأ بكتابته ويشاركه مع الفريق.

ما الذي يبرّر إنشاء سجل ADR؟

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

مثال على إجابة: نريد إنشاء سجل ADR عندما نريد أن يفهم المطورون في المستقبل «لماذا» نفعل ما نفعله.

ما الذي يبرّر عدم إنشاء سجل ADR؟

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

مثال على إجابة: نريد تخطي سجل ADR عندما يكون القرار محدودًا في النطاق والوقت والمخاطر والتكلفة، أو مغطى بالفعل في مكان آخر.

ما دورة حياة سجل ADR؟

فكّر في جوانب مثل عملية الإنشاء، وعملية البحث، وعملية اتخاذ القرار، وعملية التنفيذ، وعملية الإنهاء. وفكّر في كيفية تتبّع دورة حياة السجل عبر الزمن، مثل كيفية نقل السجل من حالة إلى الحالة التالية، وكيفية إبلاغ أصحاب المصلحة بذلك.

مثال على إجابة: نريد أن يكون لسجل ADR خمس مراحل في دورة حياته: البدء ← البحث ← التقييم ← التنفيذ ← الصيانة ← الإنهاء.

ما معايير مراحل دورة حياة سجل ADR؟

فكّر في جوانب مثل معايير قبول السجل، أي كيف تعرف أنه جيد بما يكفي للانتقال من مرحلة في دورة الحياة إلى التالية؟ هل صيغت المشكلة بوضوح؟ هل نُظر في البدائل؟ هل المفاضلات مفهومة وموثقة بما يكفي؟ هل السياق ذو الصلة كله موجود؟ هل أصحاب المصلحة المعنيون كلهم مشاركون؟ هل أُدرجت كل الملاحظات؟

مثال على إجابة: نريد أن يصوّت أصحاب المصلحة على سجل ADR عندما يكون الفريق النشط قد 1) أكمل بحثه، 2) أكمل تقييمه، 3) نشر مقترح السجل على أصحاب المصلحة مع طلب تعليقات ومهلة أسبوع، 4) أدرج كل تعليقات أصحاب المصلحة وعالجها.

ما الأدوار والمسؤوليات المتفاعلة مع سجل ADR؟

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

مثال على إجابة: نريد أن يكون لكل سجل ADR دائمًا شخص اتصال أساسي وشخص اتصال ثانوي وفريق مسؤول؛ وهؤلاء مسؤولون عن الاتصالات والنشر والصيانة والمراجعة الدورية مرة في السنة على الأقل والإنهاء النهائي عند الحاجة.

كيف تتفاعل الحوكمة مع سجل ADR؟

فكّر في جوانب مثل طرائق العمل في مؤسستك، وأي احتياجات امتثال خاصة مثل الجوانب القانونية أو جوانب الموارد البشرية، وكيف تريد التعامل مع التوافق مقابل الخلاف مقابل التصعيد. هل هناك مجالات أو أشخاص أو فرق يمكن أن يكون لها تأثير أكبر من غيرها فيما يخص سجل ADR، كأن تستطيع اعتماده أو التصويت عليه أو نقضه؟

مثال على إجابة: تكون حوكمة سجل ADR بهذا الترتيب من الأولوية: الرئيس التنفيذي (CEO)، والمدير التقني (CTO)، والمدير القانوني (CLO)، والفريق الذي ينفّذ السجل، والخبراء في الفريق الأكثر معرفة بالسجل ADD. ولا يملك أحد غيرهم حوكمة ما لم ينص السجل على ذلك.

ما المبادئ المتفاعلة مع سجل ADR؟

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

مثال على إجابة: نستخدم مبادئ القيادة التالية: الانحياز إلى الفعل، والاختلاف ثم الالتزام (disagree-and-commit)، وكفاية تقديرات بنسبة 70% للقرارات التي يسهل التراجع عنها وعزلها، وطرائق العمل العلنية باستثناء المعلومات السرية كما هو موضح في اتفاقية السرية الخاصة بمؤسستنا.