كتابة سيناريوهات حالات الاستخدام

كتابة سيناريوهات حالات الاستخدام

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

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

لماذا النموذج الكامل المحكم؟

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

• الحالة الدقيقة التي يجب أن يكون النظام عليها قبل بدء حالة الاستخدام (الشروط المسبقة).
• تسلسل مُرقَّم من التفاعلات — السيناريو الرئيسي للنجاح (MSS) — يصف المخرج المثالي في المسار الأمثل.
• جميع طرق الانحراف الممكنة — الامتدادات (تُعرف أيضاً بالتدفقات البديلة والاستثنائية) — كل منها مرتبط بخطوة محددة في السيناريو الرئيسي.
• الشروط اللاحقة المضمونة (ما الذي يكون صحيحاً في النهاية).

بدون هذه التفاصيل، يتخذ المطورون افتراضات، وتفوت الاختبارات الحالات الحدية، ويفاجئ النظام النهائي أصحاب المصلحة.

النموذج الكامل المحكم

الأقسام المعيارية وغرض كل منها:

التتبع خلال مثال كامل: حجز موعد

تخيّل عيادة خاصة. يتصل المريض بمكتب الاستقبال، ويستخدم موظف الاستقبال نظام حجز العيادة لتسجيل الموعد. لنبنِ السيناريو الكامل.

إليك الآن السيناريو الكامل المحكم لحالة حجز موعد:

قراءة السيناريو: ملاحظات جوهرية

ادرس كيف يُبنى السيناريو:

• كل خطوة في السيناريو الرئيسي تفاعل واحد قابل للملاحظة — إما يفعل الفاعل شيئاً، أو يستجيب النظام. لا تكون الخطوات أفعالاً مركّبة (لا تكتب "يفعل الفاعل X وY وZ" في خطوة واحدة). إذا احتجت ثلاثة أشياء، اكتب ثلاث خطوات.
• الامتدادات تستخدم ترقيماً مركّباً — 3أ، 5أ، 7أ، 7ب. الرقم الأول هو خطوة السيناريو الرئيسي التي يمكن أن يقع فيها الانحراف. الحرف يُميّز الحالات المتعددة في نفس الخطوة. الإجراءات المتداخلة داخل الامتداد هي 3أ.1، 3أ.2، إلخ.
• كل امتداد يُحسم بشكل صريح — إما يستأنف عند خطوة سيناريو رئيسي محددة ("استئناف عند الخطوة 5") أو ينتهي بمخرج نجاح/فشل. ترك الامتداد دون حسم خطأ شائع في السيناريوهات المبتدئة.
• الشروط اللاحقة نتائج مضمونة، لا خطوات — تصف حالة العالم بعد النجاح، لا ما يفعله النظام. "إرسال رسالة تأكيد" هي شرط لاحق، لا "يرسل النظام رسالة" (تلك هي الخطوة 9).

مثال ثانٍ: إعادة كتاب (نظام مكتبة)

إليك سيناريو أقصر لكنه مكتمل لتعزيز النمط مع نطاق مختلف:

أخطاء شائعة يجب تجنبها

• كتابة خطوات واجهة مستخدم بدلاً من خطوات منطقية. "ينقر موظف الاستقبال على زر الحفظ الأزرق" هو مواصفة واجهة، لا خطوة حالة استخدام. اكتب "يحفظ موظف الاستقبال الموعد." سيُقرر التصميم أي زر يُستخدم.
• إهمال الشروط المسبقة. يفترض المطورون أنهم يستطيعون استدعاء حالة الاستخدام من أي حالة. الشروط المسبقة الصريحة تمنع هذا الافتراض وتكشف متطلبات المصادقة/التفويض المفقودة.
• الامتدادات غير المكتملة. امتداد يقول "يعرض النظام خطأ" بدون حسم ليس مكتملاً. يجب أن يُحدد كل امتداد أين يستأنف التنفيذ أو يؤكد انتهاء حالة الاستخدام.
• الخلط بين التدفقات البديلة والاستثنائية. التدفق البديل تغيير صالح لا يزال يُحقق الهدف (مثال: يدفع المريض نقداً بدلاً من البطاقة). التدفق الاستثنائي حالة خطأ تمنع الإتمام الطبيعي (مثال: انتهاء مهلة بوابة الدفع). كلاهما يستخدم نفس ترميز الامتداد، لكن فهم الفرق يساعدك على كتابة شروط لاحقة أكثر اكتمالاً.