الدرس 4 · الوحدة 2: دراسة متطلبات العميل وتحويلها إلى مواصفات دقيقة ومفصلة

توثيق المتطلبات وترتيب أولوياتها

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

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

توثّق المتطلب في بطاقة بحقول ثابتة: المعرّف، والوصف، والمصدر، والأولوية، ومعيار القبول، والحالة.
تكتب قصص مستخدم بقالب «بصفتي… أريد… حتى…».
تصوغ معايير قبول قابلة للاختبار.
ترتّب أولويات المتطلبات بـ MoSCoW وبمقارنة القيمة بالجهد.

١من الملاحظات إلى سجل المتطلبات

الملاحظات والخريطة الذهنية تساعدانك أنت، لكن الفريق والعميل يحتاجان سجلًّا موحّدًا: كل متطلب في بطاقة بالحقول نفسها، يمكن الإشارة إليه برقمه طوال المشروع.

🗂️ FR-03 · عرض المقاعد المتاحةبطاقة متطلب

المعرّف: FR-03 (لا يتغير ولا يُعاد استخدامه)
الوصف: يعرض النظام لكل دورة عدد المقاعد المتاحة محدّثًا لحظة فتح الصفحة.
المصدر: مقابلة أ. نورة (التسجيل) 2026-10-19 + ملاحظة يوم التسجيل
صاحب المصلحة: المتدرب، وموظفة التسجيل
الأولوية: Must · ضروري
معيار القبول: عند اكتمال مقاعد دورة، يظهر «مكتملة» ويختفي زر التسجيل.
الحالة: قيد المراجعة

الحقل	لماذا هو مهم؟
المعرّف	يُشار إليه في التصميم والكود والاختبار (التتبع)
المصدر	تعرف من تسأل عند الغموض أو التعارض
الأولوية	تحدد ما يُبنى أولًا إن ضاق الوقت
معيار القبول	يحوّل المتطلب إلى شيء يمكن اختباره: نجح أو لم ينجح
الحالة	يتابع رحلة المتطلب من الاقتراح حتى الاختبار

دورة حياة المتطلب: لا يدخل التطوير إلا بعد اعتماد العميل.

٢قصة المستخدم: المتطلب بلغة المستخدم

قصة المستخدم User Story جملة قصيرة تكتب المتطلب من وجهة نظر من يستفيد منه، بقالب ثابت:

📌 قالب قصة المستخدم

بصفتي [الدور]، أريد [ما يريد فعله]، حتى [الفائدة التي يحققها].

المعرّف	القصة
US-01	بصفتي متدربًا، أريد أن أرى المقاعد المتاحة في كل دورة، حتى لا أتصل بالمركز لأسأل.
US-02	بصفتي موظفة تسجيل، أريد اعتماد عدة طلبات بضغطة واحدة، حتى أنجز طلبات الصباح بسرعة.
US-03	بصفتي مدربًا، أريد رؤية قائمة المسجلين قبل الدورة بيوم، حتى أجهّز المواد بالعدد المناسب.

✗ ضعيف

📌 قصة ضعيفة

النظام يحتوي صفحة تقارير.

✓ أفضل

📌 قصة جيدة

بصفتي مدير المركز، أريد تقريرًا شهريًّا بالإيرادات لكل دورة، حتى أقرر أي الدورات أكررها.

الجزء «حتى…» أهم مما يبدو: يشرح السبب، فيختار المطور الحل المناسب، ويُسأل عنه عند ترتيب الأولويات.

٣معايير القبول: متى نعتبر القصة منجزة؟

القصة وحدها مفتوحة للتفسير. معايير القبول Acceptance Criteria تحدد بدقة ما سيُختبر. صيغة شائعة: عندما [الموقف]، إذا [الفعل]، فإن [النتيجة المتوقعة].

✅ معايير قبول US-01

عندما تكون في الدورة مقاعد متاحة، فإن الصفحة تعرض عددها وزر «سجّل».
عندما تكتمل المقاعد، فإن الصفحة تعرض «مكتملة» ولا يظهر زر التسجيل.
إذا سجّل متدرب آخر في اللحظة نفسها على آخر مقعد، فإن النظام يقبل أول طلب فقط ويعتذر للثاني.

٤ترتيب الأولويات: MoSCoW

لن يتسع الوقت والميزانية لكل شيء. أسلوب MoSCoW يصنّف كل متطلب في واحدة من أربع فئات، ويُتفق عليها مع العميل لا يقررها المحلل وحده:

الفئة	المعنى	مثال من «دورات»
Must ضروري	بدونه لا يعمل النظام أو لا يحقق هدفه	التسجيل، وعرض المقاعد المتاحة
Should مهم	مهم لكن يمكن الإطلاق بدونه مؤقتًا	الدفع الإلكتروني (يبقى الدفع في المركز مؤقتًا)
Could مرغوب	تحسين جميل إن بقي وقت	تذكير قبل الدورة برسالة نصية
Won't (الآن)	متفق على تأجيله لمرحلة لاحقة	الشهادات الإلكترونية

ولترتيب المتطلبات داخل الفئة الواحدة قارن القيمة للمستخدم بـالجهد لتنفيذها:

diagram.mmd

quadrantChart  title القيمة مقابل الجهد  x-axis "جهد قليل" --> "جهد كبير"  y-axis "قيمة قليلة" --> "قيمة كبيرة"  quadrant-1 "مشاريع كبيرة: خطّط"  quadrant-2 "مكاسب سريعة: ابدأ بها"  quadrant-3 "ثانوية: لاحقًا"  quadrant-4 "مُكلفة: تجنّبها"  "عرض المقاعد المتاحة": [0.2, 0.9]  "الدفع الإلكتروني": [0.75, 0.85]  "تذكير قبل الدورة": [0.25, 0.45]  "تطبيق جوال أصلي": [0.9, 0.3]

«عرض المقاعد المتاحة» قيمة عالية بجهد قليل: مكسب سريع نبدأ به. و«تطبيق جوال أصلي» جهد كبير بقيمة أقل مما ظنّ العميل، بعد أن عرفنا أن المشكلة الحقيقية هي المقاعد.

توقّع وتحقّق

في قالب قصة المستخدم، ماذا يوضح الجزء «حتى…»؟

أي معيار قبول يمكن اختباره؟

رقم محدد يمكن قياسه.

الشهادات الإلكترونية اتُّفق على تأجيلها للمرحلة الثانية. فئتها في MoSCoW:

متطلب قيمته عالية وجهده قليل:

الخلاصة

سجل المتطلبات: بطاقة لكل متطلب بمعرّف ثابت يُشار إليه حتى الاختبار.
قصة المستخدم: بصفتي [دور]، أريد [فعل]، حتى [فائدة].
معايير القبول: عندما… فإن…، قابلة للاختبار، بلا كلمات غامضة.
MoSCoW: Must ضروري، Should مهم، Could مرغوب، Won't مؤجل، ويُتفق عليها مع العميل.
داخل الفئة: ابدأ بالمكاسب السريعة (قيمة عالية وجهد قليل).

تحدٍّ تصميمي: قصص مستخدمي «دورات» وأولوياتها

متوسط

من خريطة متطلبات الدرس السابق، اكتب قصص المستخدمين ومعايير قبول أهمها، ثم صنّفها بـ MoSCoW.

المطلوب:

أربع قصص على الأقل، كل قصة في سطر يبدأ بمعرّفها (مثل US-01) وفيها: بصفتي … أريد … حتى …
ثلاثة أدوار مختلفة على الأقل في القصص.
معياران للقبول على الأقل لأول قصة، بصيغة: عندما … فإن …
تصنيف MoSCoW لكل قصة في سطر: المعرّف ثم الفئة، باستخدام فئتين مختلفتين على الأقل.

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

أربع قصص على الأقل
كل قصة تبدأ بمعرّف US-رقم
كل قصة فيها «بصفتي»
كل قصة فيها «أريد»
كل قصة فيها الفائدة «حتى/لكي»
ثلاثة أدوار مختلفة على الأقل
معياران للقبول بصيغة عندما … فإن
لا كلمات غامضة في المعايير (سريع، سهل، جميل، مناسب)
كل سطر أولوية: معرّف ثم فئة MoSCoW
فئتان مختلفتان على الأقل في الأولويات

💡 تلميح 1

اكتب كل قصة في سطر واحد كاملة: المعرّف، ثم بصفتي، ثم أريد، ثم حتى.

💡 تلميح 2

المعيار يصف موقفًا ونتيجة يمكن رؤيتها: «عندما تكتمل المقاعد، فإن زر التسجيل يختفي».

💡 تلميح 3

لا تجعل كل القصص Must؛ اسأل نفسك: هل يتوقف العمل بدونها في الإطلاق الأول؟

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

قصص المستخدم (كل قصة في سطر): US-01: بصفتي متدربًا، أريد أن أرى المقاعد المتاحة، حتى لا أتصل بالمركز.
US-02: بصفتي متدربًا، أريد الدفع إلكترونيًّا، حتى أؤكد تسجيلي فورًا.
US-03: بصفتي موظفة تسجيل، أريد اعتماد عدة طلبات معًا، حتى أنجز عملي أسرع.
US-04: بصفتي مدربًا، أريد رؤية قائمة المسجلين، حتى أجهّز المواد.
US-05: بصفتي مدير المركز، أريد تقرير الإيرادات الشهري، حتى أقرر الدورات المكررة.
معايير قبول القصة الأولى (كل معيار في سطر): عندما تكون في الدورة مقاعد متاحة، فإن الصفحة تعرض عددها وزر التسجيل.
عندما تكتمل المقاعد، فإن الصفحة تعرض «مكتملة» ويختفي زر التسجيل.
الأولويات (كل سطر: المعرّف: الفئة): US-01: Must
US-02: Should
US-03: Must
US-04: Could
US-05: Should

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

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