الدرس 28 · الوحدة 12: استخدام مستندات المواصفات في التطوير والتنفيذ

إدارة التغيير وتحديث المستندات

كيف تستقبل التغييرات بعد الاعتماد، وتحلل أثرها، وتبقي المستندات مطابقة للنظام؟ ⏱ نحو 45 دقيقة.

بعد هذا الدرس ستستطيع أن:

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

١التغيير ليس مشكلة؛ التغيير غير المُدار هو المشكلة

بعد الاعتماد ستأتي تغييرات حتمًا: العميل يرى النظام فيتذكر ما نسيه، والأنظمة تتغير، والفريق يكتشف ما لم يُتوقع. من الخطة: «تحديث المستندات وتوثيق التغييرات في حالة التعديلات أو التحسينات». نقبل التغيير، لكن عبر طريق واحد معروف:

diagram.mmd

stateDiagram-v2  [*] --> مقدَّم : العميل أو الفريق يقدّم الطلب  مقدَّم --> قيد_التحليل : تسجيل ورقم CR  قيد_التحليل --> بانتظار_القرار : تحليل الأثر  بانتظار_القرار --> معتمد : موافقة العميل على الأثر  بانتظار_القرار --> مرفوض : الأثر لا يبرره  بانتظار_القرار --> مؤجل : لمرحلة لاحقة  معتمد --> منفّذ : تحديث المستندات ثم الكود  منفّذ --> [*]  مرفوض --> [*]  مؤجل --> [*]

لا يدخل التغيير الكود قبل أن يمر بتحليل الأثر وقرار العميل، ولا يُنفّذ قبل تحديث المستندات. هكذا يبقى خط الأساس صحيحًا دائمًا.

٢طلب التغيير وتحليل الأثر

🔄 CR-07 · تقرير الحضور للمدربيننموذج طلب تغيير

المقدِّم والتاريخ: أ. فهد · 2026-12-14 (أصلها الملاحظة C-4)
الوصف: يريد المركز تقريرًا بنسبة حضور كل متدرب، يراه المدرب لدوراته والمدير لكل الدورات.
السبب: لائحة جديدة: لا تُصدر الشهادة لمن قل حضوره عن 75%.
الأثر على المستندات: SRS: متطلب جديد FR-16 وقاعدة BR-07 · المستند التقني: جدول ونقطة نهاية · مصفوفة الصلاحيات: report:attendance
الأثر على الجهد والموعد: 4 أيام عمل؛ يتأخر الإطلاق 4 أيام أو تؤجل ميزة «تذكير قبل الدورة» (Could)
المخاطر: بيانات حضور غير مكتملة للدورات الجارية حاليًّا
القرار: معتمد مع تأجيل «التذكير» · توقيع أ. فهد · 2026-12-16

تحليل الأثر يستخدم مصفوفة التتبع من الدرس السابق: نتبع التغيير من المتطلب إلى كل ما يتأثر به في التصميم والكود والاختبار:

تتبع أثر طلب التغيير: من المتطلب الجديد إلى كل ما سيتغير.

٣تحديث المستندات: الإصدار وسجل التغييرات

نوع التغيير	مثال	الإصدار
تصحيح أو توضيح لا يغير السلوك	إعادة صياغة تعريف	1.1 → 1.1.1
إضافة أو تعديل متطلب ضمن النطاق	CR-07 تقرير الحضور	1.1 → 1.2
تغيير كبير في النطاق أو مرحلة جديدة	تطبيق الجوال والشهادات	1.x → 2.0

📜 سجل التغييرات CHANGELOG

1.2 · 2026-12-16

أُضيف: FR-16 تقرير الحضور، و BR-07 حد الحضور 75% (CR-07).
أُضيف: صلاحية report:attendance للمدرب (دوراته) والمدير.
أُجّل: FR-09 تذكير قبل الدورة إلى 1.3.

1.1 · 2026-11-30

أُضيف: FR-15 قائمة الانتظار (CR-05).

٤خاتمة المقرر: المشروع

تطلب الخطة مشروعًا تطبق فيه المقرر كله: تحليل نظام، وتصميمه، وتوثيقه، ثم بناء تطبيق MVC (مثل Laravel أو Django) منه، مع دراسة حالة لتطبيق موجود. هذه خريطة ما صنعته في «دورات»، وهي نفسها قائمة مخرجات مشروعك:

مخرجات مشروع المقرر: كل فرع وحدة أو أكثر من الوحدات التي درستها.

المرحلة	المخرج	الدروس
1. التحليل	محاضر الاجتماعات، والقصص ومعايير القبول، وحالات الاستخدام، و DFD	1–7
2. التصميم	مخطط الأصناف و ERD، والتسلسل و API، والمعمارية و ADR، ومصفوفة الصلاحيات	8–21
3. التوثيق	SRS ومستند تقني معتمدان بسجل مراجعات	22–26
4. التنفيذ	تطبيق MVC يطابق المواصفات، ومصفوفة تتبع، وطلب تغيير واحد على الأقل مُدار	27–28

توقّع وتحقّق

ما الخطوة التي تسبق قرار العميل في طلب التغيير؟

إضافة متطلب ضمن النطاق للإصدار 1.1 تجعله:

ما الأداة التي يستخدمها تحليل الأثر لمعرفة ما يتأثر؟

ميزة «التوثيق ككود»:

الخلاصة

التغيير مرحب به عبر طريق واحد: طلب، فتحليل أثر، فقرار، فتحديث المستندات، فالتنفيذ.
تحليل الأثر يتبع التتبع: متطلب ← تصميم ← كود ← اختبار، ثم الجهد والموعد.
خيارات العميل: تأجيل، أو موارد، أو مقايضة.
الإصدار: 1.1.1 تصحيح، و1.2 تغيير ضمن النطاق، و2.0 تغيير كبير؛ مع سجل تغييرات واضح.
التوثيق ككود يبقي المستندات مطابقة للنظام.

تحدٍّ تصميمي: طلب تغيير: تذكير قبل الدورة

متقدم

طلب المركز إعادة ميزة «تذكير قبل الدورة برسالة نصية» التي أُجّلت، لأن نسبة الغياب في اليوم الأول عالية. اكتب طلب التغيير وتحليل أثره وتحديث سجل التغييرات للإصدار الحالي 1.2.

المطلوب:

رقم طلب CR ووصف وسبب.
أثر على ثلاثة عناصر على الأقل (كل عنصر في سطر) يذكر معرّفات: متطلب FR، ونقطة نهاية أو جدول، واختبار أو صلاحية.
أثر على الجهد بالأيام، وخياران على الأقل للعميل (تأجيل أو مقايضة أو موارد).
سطر في سجل التغييرات برقم الإصدار الجديد الصحيح (1.3) وما أُضيف.

✓ التحقق الآلي: يفحص المختبر بنية مستندك وصياغته (لا يحكم على جودة الفكرة؛ هذا دور معلمك)

رقم طلب CR
سبب الطلب
أثر على ثلاثة عناصر على الأقل
الأثر يذكر متطلبًا FR
الأثر يذكر نقطة نهاية أو جدولًا أو مهمة
الأثر يذكر اختبارًا أو صلاحية
الجهد بالأيام
خياران للعميل على الأقل
سجل التغييرات بالإصدار 1.3
لا يرقى إلى 2.0 (تغيير ضمن النطاق)
السجل يذكر ما أُضيف أو عُدّل مع رقم CR

💡 تلميح 1

ابدأ من مصفوفة التتبع: ما المتطلب؟ ما الذي يحققه في التصميم؟ ما الكود؟ ما الاختبار؟

💡 تلميح 2

تذكر خيارات العميل الثلاثة: تأجيل، أو موارد، أو مقايضة ميزة.

💡 تلميح 3

تغيير ضمن النطاق يرفع الرقم الثاني: من 1.2 إلى 1.3.

نموذج واحد من إجابات كثيرة صحيحة.

رقم الطلب والوصف والسبب: CR-08: إعادة ميزة التذكير برسالة نصية قبل الدورة بيوم.
السبب: نسبة الغياب في اليوم الأول تتجاوز 20%.
الأثر على المستندات والتصميم والكود والاختبار: SRS: تفعيل FR-09 وتعديل أولويتها من Could إلى Should.
المستند التقني: مهمة خلفية يومية وجدول reminders، وتكامل مع خدمة الرسائل.
الكود: مهمة مجدولة ترسل التذكيرات.
الاختبار: اختبار قبول AC-09.1 للإرسال قبل الدورة بيوم.
الأثر على الجهد وخيارات العميل: 3 أيام عمل.
الخيارات: تأجيل الإطلاق 3 أيام، أو تأجيل تقرير الإيرادات الشهري إلى 1.4.
سجل التغييرات: 1.3 · 2026-12-20 · أُضيف: FR-09 التذكير قبل الدورة (CR-08).

انتقل إلى تقييم الدرساختيار من متعدد، وصح وخطأ، وأكمل الفراغ، وتتبّع الناتج.ابدأ التقييم ←

📝 معلم؟ أرسل ملاحظة للمؤلف عن هذا الدرس