12.3 النماذج

هذه النماذج نقاط بداية جاهزة للنسخ واللصق. ارفع أي نموذج لويكيك، أو مستودعك، أو نظام تذاكرك واملأ العناصر النائبة بين الأقواس. تشرح الملاحظات المائلة والتعليقات المضمَّنة ما ينتمي لكل قسم؛ احذفها بمجرد ملء القسم. أبقِ النماذج خفيفة: نموذج أسرع للتخطي منه للإكمال لن يُستخدَم. كيّف العناوين والأقسام لمؤسستك، لكن صُن قصد كل جزء.

بضع أعراف مستخدَمة أدناه:

• النص بين [أقواس مربعة] عنصر نائب لاستبداله.
• النص بـمائل أو <!-- تعليقات --> إرشاد للحذف.
• أبقِ المستند المُنجَز قصيرًا بقدر ما يمكن بينما لا يزال يجيب عن أسئلته.

سجل قرار الهندسة المعمارية (ADR)

# ADR [NNNN]: [عنوان قصير للقرار]

- الحالة: [مقترَح | مقبول | مُهمَل | مُستبدَل بـADR-XXXX]
- التاريخ: [YYYY-MM-DD]
- الحاسمون: [أسماء أو أدوار]
- المُستشارون: [أسماء أو أدوار]

## السياق

<!-- ما المشكلة، أو القوة، أو القيد الذي يدفع هذا القرار؟
     اذكر الحقائق والمتطلبات بحياد. اشمل فقط ما يحتاجه
     قارئ مستقبلي لفهم لماذا كان القرار ضروريًا. -->

## القرار

<!-- اذكر الخيار في جملة أو جملتين واضحتين: "سنفعل ..." -->

## البدائل المعتبَرة

<!-- اسرد الخيارات الواقعية التي وزنتها ولماذا اختير كل واحد
     أو لم يُختَر. ينبغي أن يظهر بديلان على الأقل هنا. -->

- الخيار أ: [ملخص]؛ رُفِض لأن [سبب].
- الخيار ب: [ملخص]؛ رُفِض لأن [سبب].
- الخيار المُختار: [ملخص]؛ اختير لأن [سبب].

## العواقب

<!-- نتائج صادقة للقرار، الجيدة والسيئة معًا. -->

- إيجابية: [الفوائد المكتسَبة]
- سلبية: [التكاليف، أو المخاطر، أو القيود المقبولة]
- متابعة: [ترحيلات، أو عمل جديد، أو قرارات يُطلِقها هذا]

## ذو صلة

<!-- روابط لADRs سابقة، أو RFCs، أو تذاكر، أو مستندات ذات صلة. -->

RFC / مستند تصميم

# RFC: [العنوان]

- المؤلف (المؤلفون): [أسماء]
- الحالة: [مسودة | قيد المراجعة | مقبول | مرفوض | مُنفَّذ]
- المراجعون: [أسماء أو أدوار]
- أُنشِئ: [YYYY-MM-DD]
- آخر تحديث: [YYYY-MM-DD]
- التذكرة / التتبع: [رابط]

## الملخص

<!-- فقرة واحدة: ماذا يقترح هذا ولماذا يهم. ينبغي أن
     يستوعب القارئ الجوهر من هذا القسم وحده. -->

## المشكلة والدافع

<!-- أي مشكلة نحلها؟ من المتأثر؟ ماذا يحدث إن لم نفعل شيئًا؟
     اشمل الخلفية والقيود ذات الصلة. -->

## الأهداف وغير الأهداف

- الأهداف: [كيف يبدو النجاح، قابل للقياس حيث يمكن]
- غير الأهداف: [خارج النطاق صراحة، لمنع زحف النطاق]

## التصميم المقترَح

<!-- جوهر المستند. صف النهج، والهندسة المعمارية، ونموذج البيانات،
     والواجهات، والتدفقات الرئيسية. استخدم مخططات حيث توضّح.
     اشرح كيف يعمل، لا ما هو فقط. -->

## البدائل المعتبَرة

<!-- نهج أخرى ولماذا لم تُختَر. تُظهر للقارئ أن
     مساحة التصميم استُكشِفت. -->

## الأثر والمخاطر

- الأمان والخصوصية: [الآثار والتخفيفات]
- الأداء والمقياس: [الحمل والسلوك المتوقَّعان]
- قابلية التشغيل: [المراقبة، وأنماط الفشل، والنشر، والتراجع]
- التكلفة: [أثر البنية التحتية أو الترخيص]
- التوافق الخلفي: [الترحيل والإهمال]

## خطة الاختبار والنشر

<!-- كيف سيُتحقَّق من التغيير ويُصدَر بأمان. -->

## أسئلة مفتوحة

<!-- قضايا غير محلولة تريد من المراجعين وزنها. -->

ما بعد الوفاة / مراجعة الحادث (بلا لوم)

# ما بعد الوفاة: [عنوان الحادث]

- معرّف الحادث: [ID]
- تاريخ الحادث: [YYYY-MM-DD]
- المؤلفون: [أسماء]
- الحالة: [مسودة | نهائي]
- الحدة: [SEV1 | SEV2 | SEV3]

> هذه المراجعة بلا لوم. نركّز على الأنظمة والعوامل
> المساهمة، لا الأفراد. الهدف التعلم ومنع التكرار.

## الملخص

<!-- جملتان أو ثلاث: ماذا حدث، والأثر، والحل،
     قابلة للقراءة من غير خبير. -->

## الأثر

- المدة: [وقت البداية لوقت الاستعادة، بالمنطقة الزمنية]
- المستخدمون المتأثرون: [النطاق والعدد]
- الأثر التجاري: [الإيراد، أو SLA، أو السمعة، أو غير ذلك]

## الجدول الزمني

<!-- تسلسل وقائعي ومُختوم بالوقت للأحداث. اشمل الكشف،
     والتصعيد، والأفعال الرئيسية، والاستعادة. -->

- [HH:MM] [حدث]
- [HH:MM] [حدث]

## العوامل المساهمة

<!-- سلسلة الظروف التي أدت للحادث. فضّل
     "عوامل مساهمة" على سبب جذري واحد. -->

## الكشف والاستجابة

- كيف اكتُشِف؟ [تنبيه، أو تقرير عميل، وما شابه]
- ماذا ساعد الاستجابة؟
- ماذا أبطأ الاستجابة؟

## ما نجح

<!-- اعترف بالأفعال والضمانات الفعّالة التي نجحت. -->

## عناصر الفعل

<!-- محددة، ومملوكة، ومؤرَّخة. عالج الوقاية، والكشف،
     والتخفيف. تتبّعها في المتراكم العادي. -->

| الفعل | المالك | تاريخ الاستحقاق | النوع (وقاية/كشف/تخفيف) | التذكرة |
|--------|-------|----------|--------------------------------|--------|
| [فعل] | [اسم] | [تاريخ] | [نوع] | [رابط] |

## الدروس المستفادة

<!-- ما ينبغي أن تأخذه المؤسسة الأوسع. -->

نموذج التهديد (قائم على STRIDE)

# نموذج التهديد: [اسم النظام أو الميزة]

- المؤلف (المؤلفون): [أسماء]
- التاريخ: [YYYY-MM-DD]
- المراجعون: [جهة اتصال الأمان، والملاك]
- النطاق: [ما المُغطَّى وما ليس]

## نظرة عامة على النظام

<!-- وصف موجز للنظام، وغرضه، ومستخدميه. -->

## الأصول

<!-- ما يستحق الحماية: البيانات، وبيانات الاعتماد، والوظيفة،
     والسمعة. لاحظ حساسية كل واحد. -->

## حدود الثقة وتدفق البيانات

<!-- صف أو خطّط المكونات، ومخازن البيانات، والكيانات الخارجية،
     والحدود حيث تتغير الثقة. -->

## التهديدات (STRIDE)

<!-- لكل عنصر، اعتبر فئات STRIDE. سجّل كل
     تهديد معقول، ومخاطرته، والتخفيف أو المخاطرة المقبولة. -->

| التهديد | فئة STRIDE | العنصر المتأثر | المخاطرة (ن/م/ع) | التخفيف | الحالة |
|--------|-----------------|------------------|--------------|------------|--------|
| [تهديد] | انتحال | [عنصر] | [مخاطرة] | [ضابط] | [مفتوح/مخفَّف/مقبول] |
| [تهديد] | عبث | [عنصر] | [مخاطرة] | [ضابط] | [حالة] |
| [تهديد] | إنكار | [عنصر] | [مخاطرة] | [ضابط] | [حالة] |
| [تهديد] | كشف معلومات | [عنصر] | [مخاطرة] | [ضابط] | [حالة] |
| [تهديد] | حرمان خدمة | [عنصر] | [مخاطرة] | [ضابط] | [حالة] |
| [تهديد] | رفع امتياز | [عنصر] | [مخاطرة] | [ضابط] | [حالة] |

## الافتراضات والتبعيات

<!-- افتراضات أمان مُعتمَد عليها وضوابط خارجية موثوق بها. -->

## القضايا المفتوحة والمتابعة

<!-- تهديدات تحتاج عملًا إضافيًا، متتبَّعة كتذاكر. -->

كتيب التشغيل

# كتيب التشغيل: [اسم المهمة أو السيناريو]

- الخدمة: [اسم الخدمة]
- المالك: [الفريق]
- آخر مراجعة: [YYYY-MM-DD]
- التنبيهات ذات الصلة: [أسماء التنبيهات]

## الغرض

<!-- متى تُستخدَم كتيب التشغيل هذا وماذا يحقق. -->

## المتطلبات المسبقة

<!-- الوصول، والأدوات، والأذونات المطلوبة قبل البدء. -->

## الكشف / الأعراض

<!-- ماذا يلاحظ المشغّل: تنبيهات، وتوقيعات خطأ، ولوحات معلومات. -->

## التشخيص

<!-- فحوصات خطوة بخطوة لتأكيد المشكلة وتضييق السبب.
     اشمل الأوامر، أو الاستعلامات، أو روابط لوحة المعلومات الدقيقة. -->

1. [خطوة والنتيجة المتوقَّعة]
2. [خطوة والنتيجة المتوقَّعة]

## الحل

<!-- خطوات ملموسة ومُرتَّبة للإصلاح أو التخفيف. لاحظ أي خطوة
     محفوفة بالمخاطرة أو غير قابلة للعكس، وكيف تتحقق من النجاح. -->

1. [خطوة]
2. [تحقق من الاستعادة]

## التراجع

<!-- كيف تتراجع عن الأفعال إن جعل الحل الأمور أسوأ. -->

## التصعيد

<!-- من تتصل به ومتى تصعّد. المناوبة الثانوية، والفريق المالك،
     وجهات اتصال المورّد. -->

## المراجع

<!-- لوحات المعلومات، وكتيبات التشغيل ذات الصلة، ومستندات الهندسة المعمارية. -->

README الخدمة / مدخل كتالوج الخدمة

# [اسم الخدمة]

- الفريق المالك: [الفريق]
- المناوبة: [رابط الدوران]
- الدرجة / الحرجية: [الدرجة 1 | 2 | 3]
- المستودع: [رابط]
- الحالة: [نشط | مُهمَل]

## ماذا تفعل

<!-- فقرة واحدة عن مسؤولية الخدمة ومستهلكيها. -->

## الهندسة المعمارية

<!-- المكونات الرئيسية، والتبعيات (أعلى وأسفل المجرى)، ورابط
     لمستند التصميم أو المخطط. -->

## الواجهات

- واجهات برمجة التطبيقات / نقاط النهاية: [رابط للمواصفة]
- الأحداث المنشورة / المستهلَكة: [الموضوعات]
- مخازن البيانات: [قواعد البيانات، وذاكرات التخزين، والحاويات]

## وقت التشغيل والنشر

- البيئات: [تطوير، وتحضير، وإنتاج]
- كيفية النشر: [رابط خط الأنابيب والعملية]
- التهيئة وأعلام الميزات: [أين وكيف]

## المراقبة

- لوحات المعلومات: [روابط]
- التنبيهات: [روابط]
- السجلات: [أين تجدها]
- SLOs: [رابط]

## العمليات

- كتيبات التشغيل: [روابط]
- المهام الشائعة: [التوسيع، وإعادة التشغيل، والاستكمال الخلفي]
- المشاكل والقيود المعروفة: [ملاحظات]

## البدء (للمساهمين الجدد)

<!-- كيفية البناء، والاختبار، والتشغيل محليًا. -->

## جهات الاتصال

- قناة Slack / الدردشة: [رابط]
- التصعيد: [المسار]

سياسة SLO / ميزانية الخطأ

# سياسة SLO وميزانية الخطأ: [اسم الخدمة أو الرحلة]

- المالك: [الفريق]
- تاريخ السريان: [YYYY-MM-DD]
- وتيرة المراجعة: [مثلًا ربع سنوية]

## مؤشرات مستوى الخدمة (SLIs)

<!-- عرّف كل SLI بدقة: الكمية المقاسة، وكيف تُقاس،
     ومن أين (مثاليًا من منظور المستخدم). -->

| SLI | التعريف | مصدر البيانات |
|-----|-----------|-------------|
| التوفر | [مثلًا طلبات ناجحة / إجمالي الطلبات] | [المصدر] |
| الكمون | [مثلًا نسبة الطلبات تحت X مللي ثانية] | [المصدر] |

## الأهداف (SLOs)

| SLI | الهدف | نافذة القياس |
|-----|--------|--------------------|
| التوفر | [مثلًا 99.9٪] | [مثلًا 28 يومًا متدحرجة] |
| الكمون | [مثلًا 95٪ تحت 300 مللي ثانية] | [28 يومًا متدحرجة] |

## ميزانية الخطأ

<!-- عدم الموثوقية المسموح: 100٪ ناقص الهدف، عبر
     النافذة. اذكر الميزانية بمصطلحات ملموسة (مثلًا دقائق/شهر). -->

- الميزانية: [البدل المُشتَق]

## السياسة حين تُستنفَد الميزانية

<!-- العواقب المتفَق عليها. اجعلها ملموسة وقابلة للفرض. -->

- [مثلًا جمّد إصدارات الميزات غير الحرجة حتى تتعافى الميزانية.]
- [مثلًا رتّب أولوية عمل الموثوقية في دورة التخطيط التالية.]
- [مثلًا صعّد لقيادة الهندسة إن خُرِقت نافذتان متتاليتان.]

## السياسة حين تكون الميزانية صحية

<!-- أي مخاطرة إضافية قد يتحملها الفريق، مثلًا عمليات نشر أسرع. -->

## التنبيه

<!-- تنبيهات ومعدل الاحتراق وعتبات مربوطة بهذا SLO. -->

مدخل سجل المخاطر

## المخاطرة: [عنوان مخاطرة قصير]

- معرّف المخاطرة: [ID]
- تاريخ الإثارة: [YYYY-MM-DD]
- المالك: [اسم أو دور مسؤول عن إدارة هذه المخاطرة]
- الفئة: [أمان | تشغيلي | امتثال | مالي | تسليم | مورّد]
- الحالة: [مفتوحة | قيد التخفيف | مقبولة | مُغلَقة]

### الوصف

<!-- اذكر المخاطرة كـ: سبب <- حدث <- عاقبة. ماذا يمكن
     أن يحدث، ولماذا يهم. -->

### التقييم

- الاحتمالية: [منخفضة | متوسطة | عالية]
- الأثر: [منخفض | متوسط | عالٍ]
- التصنيف الإجمالي: [مُشتَق من الاحتمالية × الأثر]

### الضوابط الحالية

<!-- ما يقلل هذه المخاطرة اليوم بالفعل. -->

### خطة التخفيف

<!-- الأفعال المخطَّطة لتقليل الاحتمالية أو الأثر، بمُلاك
     وتواريخ. إن قُبِلت المخاطرة، سجّل من قبلها ولماذا. -->

| الفعل | المالك | تاريخ الاستحقاق | الحالة |
|--------|-------|----------|--------|
| [فعل] | [اسم] | [تاريخ] | [حالة] |

### المراجعة

- تاريخ المراجعة التالي: [YYYY-MM-DD]
- القرار / الملاحظات: [أي موافقة قبول أو تغيير]

صفحة موجزة للمشروع / موجز المنتج

# [اسم المشروع أو المنتج]: صفحة موجزة

- الراعي: [اسم]
- القائد: [اسم]
- التاريخ: [YYYY-MM-DD]
- الحالة: [فكرة | مقبول | قيد التنفيذ | مشحون]

## المشكلة

<!-- فقرة واحدة: مشكلة العميل أو الأعمال، ودليل أنها
     حقيقية وتستحق الحل. -->

## الجمهور

<!-- من لديه هذه المشكلة ومن يستفيد من حلها. -->

## الحل المقترَح

<!-- وصف قصير لما سنبنيه أو نغيّره. أبقه على
     مستوى القصد، لا تفاصيل التنفيذ. -->

## لماذا الآن

<!-- السبب لفعل هذا الآن بدل لاحقًا. -->

## مقاييس النجاح

<!-- كيف سنعرف أنه نجح. فضّل نتائج قابلة للقياس. -->

- [مقياس وهدف]

## النطاق

- ضمن النطاق: [ماذا سنفعل]
- خارج النطاق: [ماذا لن نفعل]

## المخاطر والأسئلة المفتوحة

<!-- عدم اليقين والتبعيات الرئيسية. -->

## خطة تقريبية ومعالم

<!-- مراحل عالية المستوى وتوقيت تقريبي. -->

## التكلفة والموارد

<!-- الناس، والوقت، والميزانية المطلوبة. -->

ملاحظات تسليم المناوبة

# تسليم المناوبة: [YYYY-MM-DD]

- المغادر: [اسم]
- الوارد: [اسم]
- الخدمة (الخدمات): [أسماء]

## الحالة الإجمالية

<!-- سطر واحد: هادئة، أو صاخبة، أو مشكلة جارية. -->

## الحوادث المفتوحة

<!-- أي حوادث نشطة أو حُلَّت مؤخرًا يجب أن يعرفها
     المستجيب التالي، مع روابط. -->

- [حادث، وحالة، وماذا تبقّى]

## التغييرات الجارية أو المخطَّطة

<!-- نشرات، أو ترحيلات، أو نوافذ صيانة، أو تجارب
     جارية يمكن أن تسبب تنبيهات. -->

## التنبيهات الصاخبة أو المتقلبة

<!-- تنبيهات أُطلِقت ومعناها الحقيقي، بحيث لا يُضلَّل
     الشخص التالي. لاحظ أي إسكات مؤقت وانتهاء صلاحيته. -->

## عناصر للمراقبة

<!-- مقاييس أو أنظمة تتجه باتجاه مقلق. -->

## المتابعات المعلَّقة

<!-- مهام سُلِّمت للوردية التالية، بروابط للتذاكر. -->

## ملاحظات

<!-- أي شيء آخر مفيد: غرائب الوصول، ومشاكل الموردين، والسياق. -->

طلب تغيير (لتحكم تغيير منظَّم)

# طلب تغيير: [عنوان التغيير]

- معرّف التغيير: [ID]
- مقدّم الطلب: [اسم]
- تاريخ التقديم: [YYYY-MM-DD]
- النوع: [قياسي | عادي | طارئ]
- الأولوية: [منخفضة | متوسطة | عالية]
- الحالة: [مُقدَّم | مقبول | مرفوض | مُنفَّذ | مُغلَق]

## وصف التغيير

<!-- ماذا يتغير ولماذا. أشِر للتذكرة أو المتطلب. -->

## الأنظمة والمكونات المتأثرة

<!-- الخدمات، والبيانات، والبيئات، والمستخدمون المتأثرون. -->

## التبرير والأثر التجاري

<!-- سبب التغيير وأثر عدم فعله. -->

## تقييم المخاطرة

- مستوى المخاطرة: [منخفض | متوسط | عالٍ]
- الأثر المحتمل إن فشل التغيير: [وصف]
- الأثر على الأمان، أو الخصوصية، أو الامتثال: [وصف]

## خطة التنفيذ

<!-- خطوات مُرتَّبة، والأطراف المسؤولة، والتوقيت. -->

## خطة الاختبار والتحقق

<!-- كيف سيُتحقَّق من النجاح قبل التغيير وبعده. -->

## خطة العودة / التراجع

<!-- كيف تعكس التغيير إن فشل، ووقت الاستعادة. -->

## الجدول

- النافذة المقترَحة: [البداية والنهاية، بالمنطقة الزمنية]
- التوقف المتوقَّع: [مدة أو لا شيء]

## الموافقات

| الدور | الاسم | القرار | التاريخ |
|------|------|----------|------|
| مالك التغيير | [اسم] | [قبول/رفض] | [تاريخ] |
| المراجع التقني | [اسم] | [قبول/رفض] | [تاريخ] |
| مجلس استشارة التغيير | [اسم] | [قبول/رفض] | [تاريخ] |

## مراجعة ما بعد التنفيذ

<!-- النتيجة، والمشاكل المواجَهة، وهل احتُجْت العودة. -->

مخطط تقييم أثر حماية البيانات (DPIA)

# تقييم أثر حماية البيانات: [اسم نشاط المعالجة]

- المُقيِّم: [اسم]
- التاريخ: [YYYY-MM-DD]
- المراجعون: [مسؤول حماية البيانات / جهة اتصال الخصوصية]
- الحالة: [مسودة | مُراجَع | مقبول]

## 1. وصف المعالجة

<!-- أي بيانات شخصية تُعالَج، وكيف، ومن، ولأي
     غرض. اشمل تدفقات البيانات من الجمع للحذف. -->

- أصحاب البيانات: [عمّن البيانات]
- فئات البيانات: [أنواع البيانات الشخصية، لاحظ أي فئات خاصة]
- الأغراض: [لماذا تُعالَج البيانات]
- المستلمون والمعالجون: [من يستلم أو يعالج البيانات]
- فترة الاحتفاظ: [كم تُحفَظ البيانات وطريقة الحذف]
- النقل الدولي: [الوجهات وآلية النقل]

## 2. الضرورة والتناسب

<!-- هل المعالجة ضرورية للغرض؟ هل هي الخيار الأقل
     تطفلًا؟ ما الأساس القانوني أو السلطة؟ -->

- الأساس القانوني / السلطة: [الأساس لكل غرض]
- تصغير البيانات: [لماذا كل حقل ضروري]
- تبرير الدقة والاحتفاظ: [ملاحظات]
- كيف تُدعَم حقوق صاحب البيانات: [الوصول، والحذف، وما شابه]

## 3. الاستشارة

<!-- أصحاب المصلحة، وحيث ذو صلة أصحاب البيانات، المُستشارون. -->

## 4. المخاطر على الأفراد

<!-- حدد مخاطر الخصوصية وصنّف كل واحدة. -->

| المخاطرة على الأفراد | الاحتمالية | الحدة | الإجمالي |
|---------------------|-----------|----------|---------|
| [مثلًا وصول غير مُصرَّح لبيانات حساسة] | [ن/م/ع] | [ن/م/ع] | [تصنيف] |

## 5. تدابير لتقليل المخاطرة

<!-- لكل مخاطرة، التخفيف والمخاطرة المتبقية بعده. -->

| المخاطرة | التدبير | المخاطرة المتبقية | مقبولة من |
|------|---------|---------------|-------------|
| [مخاطرة] | [ضابط] | [ن/م/ع] | [اسم] |

## 6. النتيجة والموافقة

- المخاطرة المتبقية مقبولة: [نعم | لا]
- التدابير مُوافَق عليها من: [اسم، دور]
- استشارة السلطة الإشرافية مطلوبة: [نعم | لا]
- تاريخ المراجعة: [YYYY-MM-DD]