الدرس 23 · الوحدة 10: إنشاء مستندات دقيقة للمواصفات الوظيفية والتقنية

كتابة مستند المواصفات الوظيفية

كيف تكتب المتطلبات الوظيفية في المستند بصياغة موحدة دقيقة، منظمة حسب الميزات؟ ⏱ نحو 45 دقيقة.

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

تصوغ المتطلبات بقوالب EARS الخمسة.
تفصل قواعد العمل عن المتطلبات وتحيل إليها.
تنظم المتطلبات حسب الميزة بقالب موحد وترقيم ثابت.
تكتب قسمًا كاملًا من SRS بالإحالات والمتطلبات والقواعد ومعايير القبول.

١قالب ثابت لكل جملة متطلب

في الدرس 5 تعلمنا صفات المتطلب الجيد. هنا نكتب عشرات المتطلبات في مستند واحد، فنحتاج صياغة موحدة يقرؤها الجميع بالطريقة نفسها. قوالب EARS (Easy Approach to Requirements Syntax) طريقة شائعة بسيطة، فيها خمسة أنماط:

النمط	القالب	مثال من «دورات»
عام دائمًا	يجب أن [النظام] [يفعل].	يجب أن يعرض النظام عدد المقاعد المتاحة لكل دورة.
عند حدث	عندما [حدث]، يجب أن [النظام] [يفعل].	عندما يُعتمد طلب، يجب أن يرسل النظام رسالة للمتدرب خلال دقيقة.
أثناء حالة	أثناء [حالة]، يجب أن [النظام] [يفعل].	أثناء الصيانة المجدولة، يجب أن يعرض النظام صفحة «تحت الصيانة» بموعد العودة.
حالة غير مرغوبة	إذا [ظرف خاطئ]، فإن النظام يجب أن [يفعل].	إذا فشل الدفع، فإن النظام يجب أن يلغي حجز المقعد بعد 15 دقيقة.
ميزة اختيارية	حيث [الميزة مفعّلة]، يجب أن [النظام] [يفعل].	حيث يُفعَّل كود الخصم، يجب أن يعرض النظام السعر بعد الخصم قبل الدفع.

فائدة القالب: يجبرك على ذكر الشرط والفاعل والفعل، فتقل الجمل الغامضة، ويسهل على المختبر تحويل كل جملة إلى حالة اختبار.

٢قواعد العمل: منفصلة عن المتطلبات

قاعدة العمل Business Rule سياسة من سياسات المركز، تبقى صحيحة حتى لو لم يوجد نظام: «لا يُقبل في الدورة من هو دون 18 سنة»، «يُسترد المبلغ كاملًا إن أُلغي التسجيل قبل البداية بثلاثة أيام». نكتبها في قسم مستقل بمعرّف BR-، وتحيل إليها المتطلبات:

📏 قواعد العمل

المعرّف	القاعدة	المصدر
BR-01	لا يسجّل المتدرب في دورتين متزامنتين.	لائحة المركز
BR-02	يُسترد المبلغ كاملًا إن أُلغي التسجيل قبل البداية بثلاثة أيام، ونصفه قبل يوم.	أ. فهد، اجتماع 2026-10-24
BR-03	الحد الأدنى لانعقاد الدورة 8 متدربين.	لائحة المركز

٣تنظيم القسم حسب الميزة

لا تسرد مئة متطلب في قائمة واحدة. اجمعها حسب الميزة، ولكل ميزة القالب نفسه، حتى يجد القارئ ما يبحث عنه:

🧩 3.2 التسجيل في الدوراتقالب الميزة

الوصف

يتيح للمتدرب التسجيل في دورة متاحة ودفع رسومها. الأولوية: Must

الإحالات

حالة الاستخدام UC-02، القصص US-01, US-02، القواعد BR-01, BR-02

المتطلبات

FR-02.1 يجب أن يعرض النظام المقاعد المتاحة لكل دورة.
FR-02.2 عندما يضغط المتدرب «سجّل»، يجب أن يحجز النظام المقعد 15 دقيقة.
FR-02.3 إذا كان المتدرب مسجلًا في دورة متزامنة، فإن النظام يجب أن يرفض التسجيل ويذكر السبب (BR-01).
FR-02.4 إذا فشل الدفع، فإن النظام يجب أن يلغي الحجز بعد 15 دقيقة.

معايير القبول

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

قاعدة الترقيم	لماذا؟
FR-02.3: رقم الميزة ثم رقم المتطلب	يُعرف القسم من المعرّف نفسه
لا يُعاد استخدام رقم محذوف	المراجع القديمة في المحاضر والاختبارات تبقى صحيحة
المتطلب المحذوف يبقى بعلامة «ملغى»	يُعرف أنه أُلغي عمدًا لا سهوًا

توقّع وتحقّق

«عندما يُعتمد الطلب، يجب أن يرسل النظام رسالة» من أي نمط EARS؟

«لا يُقبل في الدورة من هو دون 18 سنة» تُكتب:

أي صياغة مناسبة لمتطلب ملزم؟

حُذف المتطلب FR-02.5. ماذا نفعل برقمه؟

الخلاصة

EARS: عام، وعند حدث (عندما)، وأثناء حالة (أثناء)، وغير مرغوب (إذا… فإن)، واختياري (حيث).
قواعد العمل BR سياسات مستقلة عن النظام، تُكتب مرة وتحيل إليها المتطلبات.
القسم لكل ميزة: الوصف والأولوية، والإحالات، والمتطلبات، ومعايير القبول.
الترقيم FR-الميزة.الرقم، ولا يُعاد استخدام رقم محذوف.
«يجب» للملزم، لا «يُفضّل» ولا «قد».

تحدٍّ تصميمي: قسم «اعتماد الطلبات» في SRS

متقدم

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

المطلوب:

إحالة إلى حالة استخدام أو قصة مستخدم (UC- أو US-).
أربعة متطلبات على الأقل بمعرّف FR-03.n، كل منها فيه «يجب»، ومنها متطلب واحد على الأقل بنمط «عندما» وآخر بنمط «إذا… فإن».
قاعدتا عمل على الأقل بمعرّف BR.
ثلاثة معايير قبول على الأقل بصيغة «عندما… فإن».
بلا كلمات «يُفضّل» أو «قد» أو «ربما».

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

إحالة إلى UC أو US
أربعة متطلبات على الأقل
كل متطلب بمعرّف FR-03.n
كل متطلب فيه «يجب»
متطلب بنمط «عندما»
متطلب بنمط «إذا… فإن»
قاعدتا عمل على الأقل
كل قاعدة بمعرّف BR
ثلاثة معايير قبول على الأقل
كل معيار بصيغة عندما… فإن
بلا «يُفضّل» أو «قد» أو «ربما» في المتطلبات

💡 تلميح 1

انسخ قالب القسم 3.2 من الدرس وعدّل محتواه.

💡 تلميح 2

المعطى «لا تعتمد الموظفة طلبًا قدّمته لنفسها» قاعدة عمل (فصل المهام)، والمتطلب يحيل إليها.

💡 تلميح 3

معيار القبول يصف ما يراه المستخدم: «عندما… فإن الحالة تصبح…».

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

الإحالات: UC-04 اعتماد طلب التسجيل، US-02، BR-04، BR-05
المتطلبات (كل متطلب في سطر): FR-03.1 يجب أن يعرض النظام لموظفة التسجيل قائمة الطلبات المعلقة مرتبة بالأقدم.
FR-03.2 يجب أن تتمكن موظفة التسجيل من اعتماد الطلب أو رفضه مع ذكر السبب.
FR-03.3 عندما يُعتمد الطلب أو يُرفض، يجب أن يرسل النظام إشعارًا للمتدرب خلال دقيقة.
FR-03.4 إذا كانت الدورة مكتملة، فإن النظام يجب أن يمنع الاعتماد ويعرض السبب (BR-05).
قواعد العمل: BR-04 لا تعتمد موظفة التسجيل طلبًا قدّمته لنفسها.
BR-05 لا يُعتمد طلب لدورة اكتملت مقاعدها.
معايير القبول: عندما تعتمد الموظفة طلبًا، فإن حالته تصبح «معتمد» ويصل المتدرب إشعار.
عندما ترفض الموظفة طلبًا بلا سبب، فإن النظام يمنع الرفض ويطلب السبب.
عندما تحاول الموظفة اعتماد طلب لدورة مكتملة، فإن النظام يعرض رسالة «الدورة مكتملة».

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

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