Communicating Software Architecture using arc42 Framework with Ashraf Foad - Part 2
Chapters
- مقدمة ومراجعة الأقسام الأولى من arc42
- Building Block View: تقسيم النظام وتوثيق مكوناته
- Runtime View: توضيح التفاعلات أثناء التشغيل
- Deployment View: توزيع المكونات على الخوادم
- Cross-cutting Concepts: توثيق الأنماط والمفاهيم المشتركة
- التشغيل والمراقبة والتوسع منذ مرحلة التصميم
- ADR: توثيق القرارات المعمارية ومناقشتها مع الفريق
- متطلبات الجودة وسيناريوهات اختبارها
- تسجيل المخاطر والديون التقنية وأسئلة التطبيق
- تحديث التوثيق وتقسيمه في الأنظمة الكبيرة
- أدوار المعماريين وعلاقة arc42 بـ TOGAF
- تكامل arc42 مع C4 وADR وعلاقته بنمذجة التهديدات
- استخدام الذكاء الاصطناعي في أقسام arc42
- البدء بالتوثيق تدريجياً وإدارة ضغط العمل
- المراجع وخطط المحتوى القادم ونصائح ختامية
About this episode
كيف تجعل وثائق المعمارية أداة يستخدمها الفريق يوميًا، لا مجرد ملف يُسلَّم في نهاية المشروع؟ في الجزء الثاني من بودكاست AskDeveloper عن إطار arc42، يستكمل محمد الشريف الحوار مع المهندس أشرف فؤاد حول توثيق معمارية البرمجيات والتواصل بشأنها. ينتقل النقاش من تفكيك النظام إلى مكونات وربط الرسومات بالكود، إلى توضيح تفاعلات التشغيل وتوزيع المكونات على الخوادم وأثر ذلك في الجلسات والتخزين المؤقت والتوسع. ويشرح أشرف توثيق المفاهيم المشتركة، وسجلات القرارات المعمارية، وسيناريوهات الجودة، والمخاطر والديون التقنية، مع أمثلة من العمل توضح تكلفة غياب التوثيق. يناقش الحوار أيضًا تكامل arc42 مع C4 وADR، وكيف يمكن للذكاء الاصطناعي المساعدة في إعداد المسودات والرسومات والمقارنات، دون الاستغناء عن المراجعة البشرية. وتختتم الحلقة بنصائح للبدء تدريجيًا واختيار مستوى التفاصيل الذي يخدم احتياجات الفريق.
Discussion highlights
- عرض مكونات النظام في Building Block View: مستويات التفصيل، والتمييز بين الصندوق الأسود والصندوق الأبيض، وربط الرسومات بالحزم البرمجية.
- توثيق تفاعلات التشغيل باستخدام مخططات التسلسل والأنشطة والتعاون، واختيار الرسم الأنسب للجمهور.
- أهمية Deployment View لفهم توزيع المكونات على الخوادم، وإدارة الجلسات والتخزين المؤقت في الأنظمة متعددة العقد.
- توثيق المفاهيم المشتركة: أنماط المعمارية، وتخزين البيانات، والتحقق من المدخلات، ومعالجة الأخطاء، والمصادقة والصلاحيات.
- التخطيط للتشغيل منذ التصميم: التسجيل والتتبع ومعرّفات الربط، والمراقبة، والتوسع، والتعافي من الكوارث.
More from this conversation
- سجلات القرارات المعمارية ADR: توضيح السياق والبدائل ومزاياها وعيوبها، وإشراك الفريق، وتسجيل القرار وتبعاته.
- تحويل أهداف الجودة إلى سيناريوهات قابلة للاختبار والقياس، وتوضيح الفرق بين اختبارات الحمل واختبارات الإجهاد.
- تسجيل المخاطر والديون التقنية مع أسبابها وأولوياتها وتبعياتها وجهد معالجتها والإصدار المستهدف للإصلاح.
- تكامل قالب arc42 مع نموذج C4 وسجلات ADR، والفرق بين مخطط السياق ونمذجة التهديدات.
- استخدام الذكاء الاصطناعي في مسودات التوثيق والرسومات ومقارنة البدائل، وحدود استنتاج سياق الأعمال من الكود، وأهمية المراجعة والتحديث التدريجي.



