الفرق والمنتج الأدلة التقنية

من فكرة غامضة إلى متطلبات Requirements واضحة: خطوات وقوالب

ثماني خطوات بقوالب جاهزة تحول طلباً من سطر واحد إلى متطلبات Requirements واضحة يوقع عليها العميل ويبني عليها الفريق.

من فكرة غامضة إلى متطلبات Requirements واضحة: خطوات وقوالب

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

ستجد فيه ثماني خطوات بالترتيب، ولكل خطوة قالب في جدول تنسخه وتملؤه. وفي النهاية ستخرج بوثيقة من صفحة واحدة، وطريقة واضحة لاستقبال أي تغيير بعد التوقيع.

وسنستخدم مثالاً واحداً في كل الخطوات: عيادة أسنان فيها ثلاثة أطباء تطلب نظام حجز مواعيد. والعيادة والأسماء والأرقام مثال للتوضيح، أما القوالب فتصلح لأي مشروع.

والمفاهيم خلف هذه الخطوات، مثل الفرق بين الحاجة والحل وأنواع المتطلبات، شرحناها في مقال هندسة المتطلبات Requirements Engineering.

الخلاصة السريعة Quick Summary

💡
عدد الخطوات: ثمان، من الطلب الأول إلى التوقيع، ثم خطوات طلب التغيير بعده.
الوقت: المقابلات وحدها نحو يومين من وقت الفريق في مشروع صغير مثل مثالنا.
الناتج: وثيقة SRS من صفحة واحدة، وجداول للقصص والقواعد والمتطلبات غير الوظيفية، وقائمة مراجعة موقعة.
أهم قاعدة: لا تجب عن الأسئلة بالتخمين. اكتبها، ثم اسأل من يعرف.
بعد التوقيع: كل تغيير يسجل برقم، ويحلل أثره، ويقرره صاحب الصلاحية قبل أن يبدأ العمل عليه.

الخطوة 1: اكتب الأسئلة، ولا تجب عنها

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

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

الصورة التالية تبين الخطوات الثماني التي سنمشي عليها:

ثمانية مربعات مرقمة في صفين: الطلب، ثم المقابلات والملاحظة، ثم بيان المشكلة، ثم خريطة أصحاب المصلحة، ثم القصص ومعايير القبول، ثم المتطلبات غير الوظيفية والنطاق، ثم وثيقة SRS من صفحة، ثم المراجعة والتوقيع، وسهم متقطع من التوقيع إلى القصص لطلب تغيير لاحق
كل خطوة تنتج شيئاً مكتوباً يراجعه صاحب العمل قبل الخطوة التالية

الخطوة 2: خطط المقابلات Interviews واسأل الأسئلة الصحيحة

ما هي: جلسات قصيرة مع كل من له علاقة بالنظام، ومعها ملاحظة عمل الناس في مكانه.

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

الوقت: في مثالنا نحو يومين من وقت الفريق. وهذه الخطة:

منالطريقةالمدةماذا نريد أن نعرف
مالك العيادةمقابلة45 دقيقةالأهداف، ومقياس النجاح، والميزانية، والموعد، ومن يقرر
طبيب من كل تخصصمقابلة30 دقيقة لكل طبيبمدة كل نوع موعد، والراحة بين المواعيد، والإجازات
موظفتا الاستقبالملاحظة Observation نصف يوم، ثم مقابلة4 ساعات و30 دقيقةكيف يتم الحجز الآن فعلاً، والاستثناءات اليومية، وما يضيع وقتهن
خمسة مرضىمكالمة قصيرة10 دقائق لكل مريضكيف يفضلون الحجز، وما يزعجهم في الطريقة الحالية
المحاسبمقابلة20 دقيقةهل يرتبط الموعد بالفاتورة، وما التقارير التي يحتاجها
الوثائق الحاليةتحليل وثائق Document Analysisساعةملف Excel للمواعيد، ونموذج تسجيل المريض، وسياسة الإلغاء إن وجدت

قالب دليل المقابلة Interview Guide

هذا القالب أسئلة مفتوحة تطلب أمثلة حقيقية. وليس قائمة ميزات تسأل عنها «هل تريدونها؟»:

القسمالمدةالأسئلة
1. السياق5 دقائقصف لي يوم عملك العادي من أوله. ما الجزء من عملك الذي له علاقة بالمواعيد؟
2. الطريقة الحالية10 دقائقاحك لي عن آخر مرة حجزت فيها موعداً، خطوة بخطوة. أين تكتب الموعد الآن؟ أرني الملف إن أمكن. من غيرك يلمس هذه المعلومة؟
3. المشكلات10 دقائقما الذي يضيع وقتك أكثر شيء؟ احك لي عن آخر مرة حدث فيها خطأ في موعد. كم مرة يحدث هذا في الأسبوع؟
4. القواعد والاستثناءات10 دقائقما الذي لا يجب أن يحدث أبداً؟ ماذا تفعل إذا ألغى المريض متأخراً، أو لم يحضر؟ ماذا يحدث إذا غاب الطبيب فجأة؟
5. النجاح5 دقائقبعد ستة أشهر من التشغيل، كيف ستعرف أن النظام نجح؟ لو غيرت شيئاً واحداً فقط، ماذا سيكون؟
6. البيانات والقيود5 دقائقما البيانات التي تحتاجها عن المريض؟ وما الذي لا تحتاجه؟ هل يجب أن يتكامل مع نظام آخر، أو يلتزم بمتطلبات جهة ما؟
7. الإغلاقدقيقتانهل هناك شيء لم أسأل عنه؟ من غيرك يجب أن أكلمه؟ هل أرجع إليك بأسئلة لاحقاً؟
ملاحظات المقابلبعد المقابلةالكلمات كما قالها الشخص، والحلول التي اقترحها (نسأل عنها «لماذا؟»)، والأرقام التي ذكرها (نتحقق منها)

ثلاث ملاحظات على القالب:

  • «احك لي عن آخر مرة…» أهم سؤال. عندما يصف الناس عملهم بشكل عام، يصفون الطريقة الرسمية. وعندما يحكون عن مرة حقيقية، تظهر الاستثناءات والطرق المختصرة.
  • الحلول المقترحة تكتب منفصلة. لأن كل حل يقترحه الشخص نسأل خلفه «لماذا؟» حتى نصل إلى الحاجة، كما في الحاجة أم الحل.
  • كلمات الشخص كما قالها تدخل القاموس. إذا قالت موظفة الاستقبال «حجز مبدئي»، فهذا مصطلح له معنى في عملها ويجب أن نفهمه.

الخطوة 3: لخص الملاحظات في بيان المشكلة Problem Statement

ما هو: فقرة قصيرة تقول ما المشكلة، ومن يتأثر بها، وكيف نعرف أننا نجحنا، قبل أن تذكر أي حل.

لماذا يهم: لأنه يجمع الفريق والعميل على هدف واحد يقاس، ويمنع النقاش من القفز إلى الحلول.

أولاً نرتب ملاحظات المقابلات حسب مصدرها. هذه ملاحظات المثال بعد تنظيفها:

المصدرالملاحظات
الاستقبال (ملاحظة نصف يوم)الحجز في ملف Excel مشترك، وأحياناً يفتحه شخصان فيضيع تعديل أحدهما. معظم مكالمات الصباح لتغيير موعد أو إلغائه. عند غياب طبيب تتصل الموظفة بكل مرضاه واحداً واحداً. «حجز مبدئي» يعني موعداً لم يؤكده المريض، ويلغى إذا لم يؤكد قبل يوم
المالكالهدف تقليل المكالمات على الاستقبال، وتقليل المواعيد التي لا يحضر أصحابها. اقترح «تطبيق جوال»، وعندما سألناه لماذا قال: «المرضى يبغون يحجزون بالليل». ويجب أن يكون جاهزاً قبل موسم الإجازات
الأطباءمدة الموعد تختلف: كشف 30 دقيقة، تنظيف 45، علاج عصب 60. الطبيب يعرف مواعيد يومه من ورقة يطبعها الاستقبال صباحاً
المرضى4 من 5 يفضلون الحجز من الجوال دون اتصال. ومريضة قالت: «أبغى أعرف الأوقات الفاضية بدل ما أسأل وقت وقت»

ثم نكتب بيان المشكلة بهذا القالب. والعمود الأخير هو المثال بعد ملئه:

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

لاحظ أمرين في البيان:

  • لا يذكر «تطبيق جوال» مع أن المالك اقترحه. السؤال «لماذا؟» أظهر أن الحاجة هي الحجز في أي وقت من الجوال. وهذا يتحقق أيضاً بموقع يعمل جيداً على الجوال، والاختيار بينهما قرار كلفة يأتي لاحقاً.
  • القيمة الحالية فارغة. لا نخترع رقماً، بل نقيسه في أسبوع قبل البدء. فالهدف بلا قيمة بداية لا تعرف هل تحقق.

قاموس المصطلحات Glossary

مع البيان نبدأ قاموساً صغيراً. والفكرة أن الكلمة التي يقولها الاستقبال هي نفسها التي تظهر في الوثيقة وفي النظام، وتسمى اللغة المشتركة Ubiquitous Language:

المصطلح كما يقوله أهل العملالمصطلح الإنجليزيالتعريف
فترةSlotوقت بداية ونهاية عند طبيب معين، متاحة أو محجوزة
موعد أو حجزBookingفترة محجوزة لمريض واحد
حجز مبدئيTentative Bookingحجز لم يؤكده المريض، ويلغى تلقائياً إذا لم يؤكد قبل يوم
عدم حضورNo-showموعد مر وقته ولم يحضر المريض ولم يلغ
جدول اليومDay Scheduleكل مواعيد طبيب في يوم واحد مرتبة بالوقت

الخطوة 4: ارسم خريطة أصحاب المصلحة Stakeholder Map

ما هي: رسم يضع كل من ظهر في المقابلات على محورين: قوته في القرار Power، واهتمامه بالنظام Interest.

لماذا تهم: تعرف منها من تشركه في كل قرار، ومن تكتفي بإبلاغه، ومن قد تنساه.

شبكة من أربعة مربعات بمحور القوة في القرار ومحور الاهتمام بالنظام: نشركهم في كل قرار فيها مالك العيادة والطبيب المسؤول ومدير العيادة، ونعرض عليهم ما يخصهم فيها المحاسب ومسؤول الالتزام ومزود الاستضافة، ونسمعهم ونلاحظ عملهم فيها الاستقبال والأطباء والمرضى، ونتابعهم عند الحاجة فيها مزود الرسائل والدعم الفني وشركات التأمين
المرضى والاستقبال قوتهم في القرار أقل، لكنهم من سيستخدم النظام كل يوم

ثم نحول الخريطة إلى جدول يبقى مع الوثيقة، لأن الصورة تنسى والجدول يحدث:

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

الخطوة 5: اكتب قصص المستخدم User Stories وقواعد العمل Business Rules

ما هي: قصة المستخدم جملة من ثلاثة أجزاء: «بصفتي… أريد… حتى…». والجزء الأخير هو السبب، وهو أهم جزء.

لماذا تهم: كل قصة برقم وأولوية تصبح وحدة عمل واضحة يمكن تقديرها وتسليمها واختبارها.

ونعطي كل قصة أولوية بطريقة MoSCoW التي شرحناها في ترتيب الأولويات: Must لا بد منه، وShould مهم، وCould مرغوب، وWon't ليس هذه المرة:

الرقمالقصةالأولوية
US-01بصفتي مريضاً، أريد أن أرى الأوقات المتاحة لطبيب وأحجز أحدها، حتى لا أضطر للاتصال أثناء الدوامMust
US-02بصفتي مريضاً، أريد أن ألغي موعدي بنفسي، حتى يستفيد غيري من الوقت ولا أضطر للاتصالMust
US-03بصفتي موظفة استقبال، أريد أن أحجز لمريض يتصل بالهاتف من نفس الجدول، حتى لا يكون هناك جدولانMust
US-04بصفتي طبيباً، أريد أن أحدد ساعات عملي وإجازاتي، حتى لا يحجز أحد في وقت لست فيهMust
US-05بصفتي طبيباً، أريد أن أرى جدول يومي محدثاً على جوالي، حتى لا أعتمد على ورقة مطبوعةShould
US-06بصفتي مريضاً، أريد رسالة تذكير قبل موعدي بيوم، حتى لا أنسىShould
US-07بصفتي موظفة استقبال، أريد أن أنقل مواعيد طبيب غائب إلى طبيب آخر وأبلغ المرضى دفعة واحدة، حتى لا أتصل بكل مريضCould
US-08بصفتي مريضاً، أريد أن أدفع مقدماً عند الحجزWon't this time

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

الرقمالقاعدةالمصدر
BR-01لا تحجز الفترة الواحدة عند نفس الطبيب لأكثر من مريضالاستقبال والمالك
BR-02لا يقبل الحجز إذا بقي على الموعد أقل من ساعتينالأطباء
BR-03يسمح بالحجز حتى 30 يوماً قادمة فقطالمالك
BR-04يسمح للمريض بالإلغاء حتى 4 ساعات قبل الموعد، وبعدها بالاتصال فقطالمالك
BR-05مدة الموعد حسب نوعه: كشف 30 دقيقة، تنظيف 45، علاج عصب 60الأطباء

والقاعدة BR-01 هي نفس المشكلة التي وثقنا قرارها التقني في مثال منع الحجز المزدوج. المتطلب يقول ماذا يجب أن يكون صحيحاً، والقرار التقني يقول كيف ضمنه الفريق، وكلاهما يحمل نفس الرقم.

بطاقة القصة Story Card مع معايير القبول

القصة في الجدول سطر واحد. وقبل أن يبدأ الفريق العمل عليها، نكتبها كبطاقة كاملة في نظام إدارة المهام، مثل Taiga. وهذه بطاقة القصة US-01:

الحقلالمحتوى
العنوانUS-01: حجز موعد متاح عبر الإنترنت
الأولوية والحالةMust، جاهزة للعمل، الإصدار 1.0
القواعد المرتبطةBR-01، BR-02، BR-03، BR-05
القصةبصفتي مريضاً، أريد أن أرى الأوقات المتاحة لطبيب وأحجز أحدها، حتى لا أضطر للاتصال بالعيادة أثناء الدوام
معيار القبول 1 (BR-01)بفرض أن الفترة متاحة، عندما يحجزها المريض، يتأكد الحجز وتختفي الفترة من الأوقات المتاحة لغيره
معيار القبول 2 (BR-01)بفرض أن مريضاً حجز الفترة، عندما يحاول مريض آخر حجزها، يرفض الحجز برسالة «هذا الموعد لم يعد متاحاً»
معيار القبول 3 (BR-02)لا يقبل الحجز إذا بقي على الموعد أقل من ساعتين
معيار القبول 4 (BR-03)لا يقبل الحجز بعد 30 يوماً من اليوم
معيار القبول 5 (NFR-05)كل النصوص والرسائل بالعربية، والشاشة من اليمين إلى اليسار
خارج هذه القصةالدفع (US-08)، ورسالة التذكير (US-06)
جاهزة للعمل عندمامعايير القبول مكتوبة بأمثلة ووافق عليها المالك، وراجعت موظفة الاستقبال النموذج الأولي، وكل قاعدة مرتبطة لها رقم في الوثيقة

اكتب معايير القبول Acceptance Criteria بأمثلة وحدود

معايير القبول أقوى عندما تكتب بصيغة «بفرض… عندما… إذاً…» Given/When/Then مع قيم محددة. وأقوى الأمثلة هي التي تقع على الحدود Boundary Values، لأنها أكثر ما يختلف عليه الناس.

مثلاً قاعدة «لا حجز قبل الموعد بأقل من ساعتين». إذا كانت الساعة الآن 9:00 صباحاً، فهذه أمثلتها:

وقت الموعد المطلوبالنتيجة المتوقعةلماذا
اليوم 10:00يرفضبقيت ساعة واحدة، أقل من ساعتين
اليوم 11:00يقبلساعتان بالضبط
بعد 30 يوماً الساعة 9:00يقبل30 يوماً بالضبط (BR-03)
بعد 30 يوماً الساعة 10:00يرفضأكثر من 30 يوماً بساعة

هذا الجدول يجبرك على سؤال المالك: «ساعتين» تعني ساعتين أو أكثر؟ ويجبره على أن يجيب قبل البناء.

وفريق البرمجة يستطيع أن يحول هذه الأمثلة إلى اختبارات آلية تعمل مع كل تعديل، بصيغة اسمها Gherkin وأداة مثل behave. ودورك أنت أن تكون الأمثلة صحيحة ومعتمدة.

ولا تكتب بهذه الصيغة كل شيء. اكتب بها قواعد العمل التي لها أمثلة وحدود، مثل الحجز والإلغاء والأسعار والصلاحيات. واترك تفاصيل الشاشة مثل لون الزر للنموذج الأولي. ومكان هذه الاختبارات بين بقية الأنواع في اختبار القبول Acceptance Test.

الخطوة 6: اكتب المتطلبات غير الوظيفية Non-functional Requirements بالأرقام

ما هي: متطلبات تصف كيف يعمل النظام، وليس ماذا يفعل: السرعة، والتوافر، والأمان، والخصوصية، وسهولة الاستخدام.

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

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

الرقمالخاصيةالمتطلب القابل للقياسكيف نتحقق منه
NFR-01الأداء Performance95% من طلبات عرض الأوقات المتاحة تظهر في أقل من ثانية، عند 50 مستخدماً في نفس الوقتاختبار ضغط قبل الإطلاق، كما في اختبار الضغط Load Testing
NFR-02التوافر Availabilityيعمل 99.5% من الوقت كل شهر، والصيانة المخططة بين 1:00 و5:00 فجراً فقطمراقبة خارجية تسجل التوقف كل دقيقة
NFR-03النسخ الاحتياطي Backupلا نفقد أكثر من ساعة من الحجوزات، ونعيد الخدمة في أقل من 4 ساعاتتجربة استعادة كل ثلاثة أشهر، كما في قاعدة 3-2-1
NFR-04الأمن Securityكل حسابات الموظفين بتحقق ثنائي MFA، والمريض يرى ويعدل حجوزاته فقط، والنظام يحقق المستوى الثاني من معيار OWASP ASVSاختبارات صلاحيات ومراجعة، كما في مقال ASVS
NFR-05العربية والاتجاه RTLكل الشاشات والرسائل بالعربية ومن اليمين إلى اليسار، والتواريخ ميلادية مع الهجري بجانبها، والأوقات بتوقيت الرياضمراجعة الشاشات، وحالات اختبار للتاريخ كما في مقال التاريخ والوقت
NFR-06الخصوصية Privacyنجمع للحجز الاسم ورقم الجوال فقط، ولا نرسل تذكيراً إلا بموافقة صريحة يمكن سحبها، ونحذف بيانات الحجوزات بعد مدة الاحتفاظ التي تعتمدها العيادةمراجعة الحقول قبل الإطلاق، واختبار سحب الموافقة
NFR-07سجل التدقيق Audit Trailكل إنشاء وإلغاء وتعديل لموعد يسجل من فعله ومتى ومن أين، ولا يمكن تعديل السجلاختبار قبل الإطلاق، كما في مقال سجل التدقيق
NFR-08سهولة الاستخدام Usability4 من 5 مرضى يستخدمون النظام لأول مرة يكملون الحجز من الجوال في أقل من دقيقتين دون مساعدةجلسة مع خمسة مرضى على النموذج الأولي، ثم على النسخة التجريبية
NFR-09إمكانية الوصول Accessibilityشاشات المريض تحقق مستوى AA في معيار WCAG 2.2فحص آلي ثم مراجعة يدوية بقارئ الشاشة

ثلاث ملاحظات على الجدول:

  • كل متطلب له طريقة تحقق في نفس السطر. إذا لم تستطع أن تكتب طريقة التحقق، فالمتطلب ما زال غامضاً.
  • الخصوصية يراجعها مسؤول الالتزام. بيانات المرضى الصحية من البيانات الحساسة في نظام حماية البيانات الشخصية PDPL، ونصه في منصة حماية البيانات الشخصية. لذلك لا يكتب الفريق التقني هذا السطر وحده.
  • تفاصيل الأمن لا تكتب كلها هنا. نختار مستوى ASVS، ونكشف ما يخص تصميمنا بجلسة نمذجة التهديدات.

الخطوة 7: حدد خارج النطاق Out of Scope والافتراضات والقيود

لماذا تهم: أهم قسم يغفل عنه الناس هو ما لن نبنيه. كل شيء غير مكتوب كخارج النطاق، سيعتبره أحدهم داخل النطاق يوم التسليم.

خارج النطاق في الإصدار الأول من مثالنا:

  • الدفع الإلكتروني عند الحجز (US-08)، ويعاد النظر فيه بعد ثلاثة أشهر.
  • الربط مع شركات التأمين.
  • الملف الطبي والتشخيص والوصفات، فالنظام للمواعيد فقط.
  • أكثر من فرع للعيادة.
  • تطبيق جوال من المتجر، فالإصدار الأول موقع يعمل على الجوال.
  • نقل مواعيد طبيب غائب دفعة واحدة (US-07) إذا لم يتسع الوقت.

الافتراضات Assumptions: أشياء نعتبرها صحيحة ولم نتأكد منها. وكل افتراض معه من يتأكد منه ومتى، لأن الافتراض الذي لا يملكه أحد لا يتأكد منه أحد:

الرقمالافتراضمن يتأكدقبلإذا كان خطأ
A-01كل المرضى لديهم رقم جوال يستقبل الرسائلالاستقبال من ملف المرضىنهاية الأسبوع الأولنضيف البريد الإلكتروني كخيار
A-02ملف Excel الحالي يمكن نقله إلى النظام الجديد بأعمدة ثابتةالفريق التقني مع الاستقبالنهاية الأسبوع الأولنضيف مهمة تنظيف بيانات يدوية
A-03مزود الرسائل يدعم العربية واسم العيادة كمرسلالفريق التقنيقبل بدء US-06نختار مزوداً آخر
A-04مدة كل نوع موعد ثابتة لكل الأطباءالطبيب المسؤولقبل بدء US-04نجعل المدة إعداداً لكل طبيب

القيود Constraints: ما لا نناقشه. في مثالنا:

  • الإطلاق قبل موسم الإجازات، والميزانية المعتمدة.
  • حفظ البيانات على خوادم داخل المملكة بقرار من المالك. ونقل البيانات الشخصية خارج المملكة تنظمه لائحة نقل البيانات الشخصية خارج المملكة.
  • يعمل النظام على متصفحات الجوال الحديثة دون تثبيت.

اعرض نموذجاً أولياً Low-fidelity Prototype قبل الوثيقة النهائية

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

شاشتا جوال رماديتان: الأولى احجز موعداً فيها اختيار الطبيب ثم اليوم من أربعة أيام ثم الوقت من شبكة أوقات بعضها مشطوب لأنه محجوز وزر تأكيد الحجز، والثانية تأكيد فيها علامة صح ورقم الحجز وتنبيه أن الإلغاء مسموح حتى 4 ساعات قبل الموعد وزر إضافة إلى التقويم ورابط إلغاء الموعد، وبجانبهما ملاحظات تربط كل جزء بقاعدة أو قصة
النموذج الرمادي Wireframe يجعل النقاش على الخطوات والمعلومات وليس على الألوان

وعند العرض لا تسأل «هل يعجبك؟»، لأن الإجابة دائماً نعم. أعط الشخص مهمة: «احجزي موعداً للدكتورة هدى يوم الأربعاء صباحاً». ثم اصمت وراقب أين يتردد. وبعدها اسأل:

  • هل هناك معلومة تحتاجها ولا تراها في الشاشة؟
  • ماذا تتوقع أن يحدث بعد الضغط على «تأكيد الحجز»؟
  • إذا أردت إلغاء الموعد بعد يومين، من أين ستبدأ؟
  • للاستقبال: كيف ستحجزين لمريض على الهاتف من نفس الشاشة؟

وكل ملاحظة من هذه الجلسة تعدل قصة أو معيار قبول، أو تضيف سؤالاً مفتوحاً إلى الوثيقة.

الخطوة 8: اجمع كل شيء في وثيقة SRS من صفحة واحدة

ما هي: وثيقة مواصفة المتطلبات Software Requirements Specification. والقالب التالي مبني على الأقسام التي يطلبها المعيار ISO/IEC/IEEE 29148، لكنه مختصر لمشروع صغير.

القاعدة: الوثيقة تشير إلى الجداول بالأرقام ولا تكررها. والجداول تعيش في نظام إدارة المهام. والعمود الأخير هو مثال العيادة بعد ملئه:

القسمماذا تكتب فيهمثال العيادة
رأس الوثيقةاسم النظام، والإصدار، والتاريخ، والحالة (مسودة أو معتمدة)، والمالكنظام حجز المواعيد للعيادة، الإصدار 1.0، 2026-10-12، معتمدة، المالك: مالك العيادة
1. الهدفبيان المشكلة في 3 إلى 5 أسطر، ومقياس النجاحيرى المريض الأوقات ويحجز ويلغي بنفسه، والجميع على جدول واحد. النجاح: المكالمات إلى النصف خلال 3 أشهر
2. النطاقالقصص داخل النطاق، وقائمة خارج النطاقداخل: US-01 إلى US-06، وCould: US-07. خارج: الدفع، والتأمين، والملف الطبي، والفروع، وتطبيق المتجر
3. أصحاب المصلحةإشارة إلى جدولهمجدول أصحاب المصلحة (5 أطراف)
4. القاموسالمصطلحات وتعريفاتهافترة، موعد، حجز مبدئي، عدم حضور، جدول اليوم
5. المتطلبات الوظيفيةجدول القصص بأرقامها وأولوياتهاUS-01 إلى US-08
6. قواعد العملجدول القواعد ومصادرهاBR-01 إلى BR-05
7. المتطلبات غير الوظيفيةالجدول بالأرقام وطرق التحققNFR-01 إلى NFR-09
8. القيودما لا يناقشالإطلاق قبل الإجازات، والميزانية، والاستضافة داخل المملكة، ومتصفح الجوال
9. الافتراضاتجدول الافتراضات ومن يتأكد منهاA-01 إلى A-04
10. أسئلة مفتوحةكل سؤال، ومن يجيب، ومتىهل يحق للطبيب حجز وقت لمريض خارج ساعات عمله؟ (الطبيب المسؤول، قبل بدء US-04)
11. سجل التغييراتالإصدار، والتاريخ، والتغيير، ورقم الطلب، ومن اعتمده1.0: الإصدار الأول
12. الاعتمادالدور، والاسم، والتاريخ، والقرارالمالك، والطبيب المسؤول ممثلاً للمستخدمين، وقائد الفريق التقني

المراجعة Review والتوقيع Sign-off

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

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

المصدر: تقرير GAO-15-238.

وقبل التوقيع نمر على هذه القائمة مع صاحب العمل وممثل المستخدمين وقائد الفريق التقني:

المحورنتأكد أن
الوضوحلا توجد كلمات غامضة مثل «سريع، سهل، آمن، مرن، تقريباً، حسب الحاجة». كل متطلب جملة بقرار واحد ورقم فريد. كل مصطلح في القاموس، ونفس الكلمة تعني نفس الشيء في كل مكان
الاكتماللكل صاحب مصلحة متطلبات، أو مكتوب لماذا لا. لكل قصة Must معايير قبول بأمثلة تشمل الحالة العادية والحدود والأخطاء. المتطلبات غير الوظيفية بالأرقام. الخصوصية والأمن راجعها المسؤول. خارج النطاق مكتوب صراحة
الصحةكل متطلب حاجة، وليس حلاً لم نسأل عنه «لماذا؟». لا يوجد متطلبان متعارضان. كل متطلب ممكن ضمن الموعد والميزانية
المخاطركل افتراض وكل سؤال مفتوح له مسؤول وموعد. النموذج الأولي راجعه مستخدمون حقيقيون
الإدارةالوثيقة لها إصدار ومالك ومكان واحد يعرفه الجميع. طريقة طلب التغيير مكتوبة ومعروفة

بعد التوقيع: كيف تستقبل طلب تغيير Change Request

بعد أسبوعين من التوقيع يرسل المالك: «نبغى الإلغاء يكون قبل 24 ساعة بدل 4 ساعات، لأن المرضى يلغون متأخر وما نلحق نعطي الموعد لغيرهم».

الطلب معقول. والسؤال ليس هل نقبله، وإنما كيف ندخله دون أن يعطل شيئاً ودون أن يضيع سببه. والصورة التالية تبين الخطوات الست، وقائمة الأثر لهذا الطلب:

ست خطوات مرقمة من اليمين إلى اليسار: تسجيل الطلب، تحليل الأثر، القرار، تحديث الوثيقة والاختبارات، تعديل النظام حتى تنجح الاختبارات، الإطلاق وإبلاغ المستخدمين، وتحتها قائمة أثر الطلب CR-01: القاعدة BR-04 والقصة US-02 وإعداد مهلة الإلغاء في النظام ونص الشاشة ورسالة التذكير وسياسة المواعيد المحجوزة قبل التغيير
التتبع Traceability يجعل قائمة الأثر بحثاً عن الرقم BR-04 وليس تخميناً

سجل الطلب وحلل أثره Impact Analysis

نسجل الطلب برقم في نفس المكان الذي تعيش فيه المتطلبات، بهذا القالب:

الحقلCR-01: الإلغاء قبل 24 ساعة بدل 4 ساعات
طلبه ومتىمالك العيادة، 2026-10-26، والمصدر رسالة واتساب (مع رابطها)
الطلبتغيير مهلة إلغاء المريض من 4 ساعات إلى 24 ساعة قبل الموعد
السببالمرضى يلغون متأخراً فلا يتسع الوقت لإعطاء الموعد لغيرهم
الأثر على المتطلباتالقاعدة BR-04 تعدل، ومعايير قبول القصة US-02 تعدل، والوثيقة من 1.0 إلى 1.1
الأثر على النظامإعداد مهلة الإلغاء، واختباران مرتبطان بالقاعدة BR-04، ولا تغيير في البيانات
الأثر على المستخدميننص شاشة التأكيد، ونص رسالة التذكير
الجهدنصف يوم مع الاختبار
سؤال للقرارالمواعيد المحجوزة قبل التغيير، بأي قاعدة تلغى؟
القرارمقبول. المواعيد المحجوزة قبل الإطلاق تبقى على قاعدة 4 ساعات. اعتمده المالك في 2026-10-27

تحليل الأثر أخذ دقائق، لأن الرقم BR-04 موجود في كل مكان: في الوثيقة، وفي بطاقة القصة، وفي أسماء الاختبارات. البحث عن الرقم يعطيك القائمة كاملة.

ولاحظ سؤال «المواعيد المحجوزة قبل التغيير». هو قرار عمل لم يكن ليظهر لو عدل الفريق الرقم مباشرة عندما وصلته الرسالة. ولو لم يسأل أحد، لاكتشف المرضى القاعدة الجديدة عندما يحاولون الإلغاء.

عدل معايير القبول قبل أن يعدل الفريق النظام

بعد القرار نعدل الوثيقة إلى الإصدار 1.1. ثم نعدل أمثلة معايير القبول قبل أي تعديل في النظام. وأهم مثال هو الذي يقع بين الحد القديم والجديد:

المريض يلغي قبل الموعد بـالقاعدة القديمة (4 ساعات)القاعدة الجديدة (24 ساعة)
25 ساعةيقبليقبل
23 ساعةيقبليرفض

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

نفذ، ثم أبلغ

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

  • تحديث نص شاشة التأكيد ورسالة التذكير.
  • إضافة سطر في سجل تغييرات الوثيقة: «1.1، CR-01، الإلغاء قبل 24 ساعة، اعتمده المالك».
  • إبلاغ الاستقبال قبل الإطلاق حتى لا يتفاجأ المرضى.

وبهذا يكون لكل تغيير سبب مكتوب، ومن قرره، ومتى. وإذا سأل موظف جديد بعد سنة «لماذا 24 ساعة؟»، فالبحث عن CR-01 يعطيه القصة كاملة.

أخطاء شائعة

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

ابدأ من مشروعك

  1. خذ مشروعاً حقيقياً تعمل عليه، واملأ جدول وثيقة SRS له في ساعة واحدة. ثم عد الأسئلة المفتوحة والافتراضات التي ظهرت، وأرسلها لمن يستطيع الإجابة.
  2. اختر قاعدة عمل واحدة في مشروعك، واكتب لها جدول أمثلة على الحدود مثل جدول «ساعتين» أعلاه، ثم اعرضه على صاحب القرار.

الخلاصة

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

سجل التحديثات

  • 2026-11-13: إعادة كتابة المقال بلغة أوضح وخطوات وجداول، دون كود.
  • أكتوبر 2026: كتابة المقال، واختبار ملفات Gherkin بأداة behave 1.3.3 على Python 3.12.15 داخل python:3.12-slim.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.