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

الخطوة 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 | الأداء Performance | 95% من طلبات عرض الأوقات المتاحة تظهر في أقل من ثانية، عند 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 | سهولة الاستخدام Usability | 4 من 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 قبل الوثيقة النهائية
قبل أن نكتب الوثيقة نرسم الشاشتين الأهم، ونعرضهما على موظفة الاستقبال وعلى مريضين. والنموذج رمادي عمداً، بلا ألوان ولا شعار. الشاشة الجميلة تجعل الناس يعلقون على اللون، والرمادية تجعلهم يعلقون على الخطوات والمعلومات:

وعند العرض لا تسأل «هل يعجبك؟»، لأن الإجابة دائماً نعم. أعط الشخص مهمة: «احجزي موعداً للدكتورة هدى يوم الأربعاء صباحاً». ثم اصمت وراقب أين يتردد. وبعدها اسأل:
- هل هناك معلومة تحتاجها ولا تراها في الشاشة؟
- ماذا تتوقع أن يحدث بعد الضغط على «تأكيد الحجز»؟
- إذا أردت إلغاء الموعد بعد يومين، من أين ستبدأ؟
- للاستقبال: كيف ستحجزين لمريض على الهاتف من نفس الشاشة؟
وكل ملاحظة من هذه الجلسة تعدل قصة أو معيار قبول، أو تضيف سؤالاً مفتوحاً إلى الوثيقة.
الخطوة 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 ساعات، لأن المرضى يلغون متأخر وما نلحق نعطي الموعد لغيرهم».
الطلب معقول. والسؤال ليس هل نقبله، وإنما كيف ندخله دون أن يعطل شيئاً ودون أن يضيع سببه. والصورة التالية تبين الخطوات الست، وقائمة الأثر لهذا الطلب:

سجل الطلب وحلل أثره 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 يعطيه القصة كاملة.
أخطاء شائعة
- كتابة الوثيقة قبل المقابلات «لتوفير الوقت»: فيوافق الناس على ما يقرؤونه، بدل أن يحكوا ما يحدث فعلاً.
- ملء القوالب كلها لمشروع صغير: القالب تذكير بالأسئلة وليس استمارة. إذا كان قسم لا ينطبق، فاكتب «لا ينطبق» وسببه في سطر.
- اختبار تفاصيل الشاشة بمعايير القبول: فتفشل الاختبارات مع كل تعديل في التصميم، ويتوقف الفريق عن تشغيلها.
- قبول التغيير مباشرة لأنه «سطر واحد»: فتصبح الوثيقة والنظام والاختبار ثلاث روايات مختلفة لنفس القاعدة.
- توقيع المالك وحده: دون ممثل للمستخدمين، فيوقع على ما يريده هو، وليس على ما يحتاجه من سيستخدم النظام.
ابدأ من مشروعك
- خذ مشروعاً حقيقياً تعمل عليه، واملأ جدول وثيقة SRS له في ساعة واحدة. ثم عد الأسئلة المفتوحة والافتراضات التي ظهرت، وأرسلها لمن يستطيع الإجابة.
- اختر قاعدة عمل واحدة في مشروعك، واكتب لها جدول أمثلة على الحدود مثل جدول «ساعتين» أعلاه، ثم اعرضه على صاحب القرار.
الخلاصة
- الطلب الأول يتحول إلى أسئلة أولاً، ثم إلى خطة مقابلات تشمل من يستخدم النظام، وليس المالك وحده.
- بيان المشكلة يقول من يتأثر وكيف نعرف النجاح قبل أي حل، والقيم الحالية تقاس ولا تخترع.
- القصص تحمل السبب، وقواعد العمل تكتب مستقلة برقم، ومعايير القبول بأمثلة على الحدود.
- المتطلبات غير الوظيفية بالأرقام مع طريقة التحقق، والخصوصية يراجعها المسؤول عنها.
- خارج النطاق والافتراضات والقيود مكتوبة صراحة، ولكل افتراض مسؤول وموعد.
- التوقيع يصنع خط الأساس، وكل تغيير بعده يمر بالتسجيل وتحليل الأثر والقرار، ثم تعديل معايير القبول قبل النظام.
سجل التحديثات
- 2026-11-13: إعادة كتابة المقال بلغة أوضح وخطوات وجداول، دون كود.
- أكتوبر 2026: كتابة المقال، واختبار ملفات Gherkin بأداة behave 1.3.3 على Python 3.12.15 داخل python:3.12-slim.