معمارية البرمجيات / التطور: السعة والانتقال والتحقق والمراجعة / الدرس 17
احفظ القرارات والمخاطر والدين التقني بوضوح
أنشئ سجلات قرار موجزة ورتّب الدين المعماري وفق عواقب مرصودة ومحفزات مراجعة.
في هذه الصفحة
أهداف الدرس
- سجّل البدائل والتكاليف المقبولة دون إعادة كتابة التاريخ.
- افصل عدم اليقين والدين المتعمد والعيوب والتحسين العادي.
فسّر ملاءمة الاختيار لسياقه
يحفظ سجل القرار السياق والبدائل والاختيار والعواقب. يساعد القائم بالصيانة على فهم سبب نقل الإشعارات إلى عامل، والوعد الذي بقي، وحالات الفشل المقبولة. ركزه على اختيار مؤثر واحد بدلا من يوميات مشروع. ويمكنه ربط الرسوم والأدلة دون تكرارها. السؤال المهم ليس اكتمال كل عنوان ممكن في قالب، بل قدرة القارئ على تقييم السبب وحدوده.
استبدل القرار بسجل جديد بدلا من محو سببه
عند تغير الظروف علّم القرار السابق بأنه مستبدل واربط البديل. احفظ سياقه الأصلي لفهم الشيفرة والترحيلات التاريخية. قد ينعكس فصل بررته فرق مستقلة بعد توحد الملكية، ولا يمحو ذلك الأدلة السابقة. ميّز المقترح والمقبول والمرفوض والمستبدل. يتضمن السجل كلفة ومُحفّز مراجعة. حالته بيانات وثيقة افتراضية، لا إذن نشر أو ادعاء بموافقة فريق حقيقي.
id: ADR-007
status: accepted in the fictional design
decision: process notifications in a separate worker
context: provider waiting must not occupy booking request resources
alternative: synchronous notification inside booking request
accepted_cost: durable delivery state and duplicate handling
review_when: workflow ownership or completion requirements change
يربط السجل الاختيار باهتمام ملموس ويعترف بالكلفة. يربط السجل الفعلي أدلته ومراجعيه وفق مسار المؤسسة.
عبّر عن الخطر كعدم يقين ذي عاقبة
لا يفيد قول قد يرفض المزود الاندفاع إلا بفهم عدم اليقين والأثر والاستجابة. سجّل السيناريو والدليل والمالك ومحفز التحقيق أو التخفيف. تجنب احتمالات دقيقة بلا أساس. العيب فشل مثبت مقابل مطلب، وقد لا يقع الخطر. لا تُخف افتراضا غير مدعوم في نثر متفائل. قد تقلل مهمة جمع دليل صغيرة الغموض أكثر من إعادة تصميم كبيرة قبل فهم آلية الفشل.
صِف الفائدة المدفوعة على الاختصار
يفيد مصطلح الدين التقني عندما ينشئ تصميم سريع كلفة مستقبلية مستمرة. قد يسرع جدول فهرس مشترك الانتقال ويحتاج إصدارات منسقة وتحققا مكررا. سجّل السبب والفائدة المرصودة وخيار السداد والمالك وشروط جدواه. ليس كل أسلوب مكروه دينا، ولا يلزم السداد الفوري لكل دين. رتّب العواقب كالحوادث وتأخر التعديل والتعرض الأمني. يفصل السجل كلفة تنسيق مرصودة عن توقع غير مقاس ويحدد الدليل التالي.
{"item":"shared catalog write path","reason":"temporary migration overlap","observed_cost":"two policy fixes required coordinated edits","owner":"catalog boundary owner","next_step":"identify remaining direct writers","repayment_trigger":"migration parity and single-writer checks pass"}
الإصلاحان دليل افتراضي داخل المثال. يتجنب السجل ادعاء وفر مالي أو موعد بلا أساس قياس.
راجع عند تغير ذي معنى بدلا من إجراء شكلي
تشمل المحفزات حملا متغيرا ونقل ملكية وإيقاف اعتمادية واستثناءات متكررة وصعوبة حماية قيد. راجع السيناريو والقرار المعنيين، لا كل رسم بجدول اعتباطي. اختم بنتيجة مسجلة: إبقاء أو جمع دليل أو تعديل أو استبدال، ومالك للباقي. أبق المخاطر ظاهرة دون عرضها كإصلاح منجز. هذا درس ممارسة تحريري لا يحدث إدارة مشروع أو موافقات أو بنية أو اتصالات خارجية.
الأخطاء الشائعة وإصلاحها
يُعدل قرار قديم لإظهار أن الجديد كان مقصودا دائما.
- لماذا يحدث؟
- عومل السبب التاريخي كشيء يمكن حذفه.
- كيف تصلحه؟
- احفظ القديم واربط قرارا بديلا.
- كيف تتجنب تكراره؟
- استخدم حالات صريحة لدورة القرار.
تسمى كل رغبة تنظيف دينا عاجلا.
- لماذا يحدث؟
- لم توصف عاقبة مستمرة أو دليل أولوية.
- كيف تصلحه؟
- اذكر الفائدة الملموسة وقارنها بالعمل الآخر.
- كيف تتجنب تكراره؟
- اشترط مالكا وكلفة مرصودة وسبب سداد.
يصف سجل الخطر التخفيف المخطط مكتملا.
- لماذا يحدث؟
- دُمج القصد بالتحقق.
- كيف تصلحه؟
- افصل الإجراء المخطط والضابط المنفذ والدليل المثبت.
- كيف تتجنب تكراره؟
- أغلق الخطر وفق معايير إتمامه المعلنة.
اختبر فهمك
1. لا يحب الفريق تسمية الوحدات. هل يكفي ذلك لتبرير سداد دين معماري؟
اعرض الحل المشروح
لا. حدّد هل تسبب التسمية أخطاء تنقل أو صعوبة تعلم أو تعديلات متكررة وقارن الفائدة بكلفة النقل. قد يكون تنظيفا عاديا لا دينا مؤثرا. استخدم دليلا وجهدا متناسبا بدل إلحاح مبني على تفضيل.
2. ماذا يحدث عند تحقق مُحفّز مراجعة قرار العامل؟
اعرض الحل المشروح
أعد فحص الاهتمام الأصلي ومتطلبات الإنجاز والملكية والكلفة المرصودة. يطلب المحفز تقييما لا عكسا آليا. أبق القرار إذا دعمه الدليل أو أنشئ بديلا بمقايضات وخطة انتقال. سجّل مهام الأدلة المفتوحة صراحة.
أهم ما تعلمته
- يفسر تاريخ القرار القيود وتحدد الأدلة الحالية التغييرات المقبلة.
- يحتاج الدين والخطر عواقب ومالكين وحالة صادقة.