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

مستند المواصفات SRS: الأهمية والمكونات

لماذا نجمع نتائج التحليل في مستند معتمد، وما الأقسام التي يحتويها مستند المتطلبات؟ ⏱ نحو 40 دقيقة.

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

تشرح أهمية مستندات المواصفات ومن يستفيد منها.
تميّز مستند المتطلبات SRS من المستند التقني SDD.
تعدّد أقسام SRS المعيارية وما يجيب عنه كل قسم.
تكتب مقدمة SRS: الغرض، والنطاق، والأهداف، والتعريفات، وفئات المستخدمين.

١لماذا نوثّق؟

جمعنا خلال المقرر متطلبات، ورسمنا مخططات، وصممنا صلاحيات. لكنها الآن متفرقة في محاضر ورسائل وملفات. مستند المواصفات يجمعها في مرجع واحد معتمد يعود إليه الجميع:

من يقرأ المستند	ماذا يستفيد
العميل	يتأكد أن ما فهمناه هو ما يريده، ويعتمده قبل دفع تكلفة التطوير
المطورون	يعرفون بالضبط ماذا يبنون، دون أسئلة متكررة
المختبِرون	يكتبون حالات الاختبار من معايير القبول
مدير المشروع	يقدّر الوقت والتكلفة، ويحكم في طلبات التغيير: هل هذا ضمن المتفق عليه؟
فريق المستقبل	يفهم النظام بعد سنوات حين يغادر من بناه

٢مستندان لجمهورين

	مستند المتطلبات SRS	المستند التقني SDD
يجيب عن	ماذا يفعل النظام؟	كيف سنبنيه؟
القارئ الأساسي	العميل والمستخدمون والفريق	المطورون والفريق التقني
اللغة	لغة العمل، بلا تفاصيل تقنية	تقنية: معمارية، وجداول، وواجهات API
يحوي	المتطلبات، وحالات الاستخدام، ومعايير القبول	المعمارية، ونموذج البيانات، و API، والصلاحيات، والتقنيات
نكتبه في	الدرس 23	الدرس 24

٣بنية SRS المعيارية

المعيار الدولي ISO/IEC/IEEE 29148 (وقبله IEEE 830 الشهير) يقترح بنية للمستند. لست ملزمًا بها حرفيًّا، لكنها تضمن ألا تنسى قسمًا مهمًّا، ويعرفها كل من عمل في المجال:

الأقسام الرئيسية لمستند المتطلبات SRS.

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

٤من مخرجات التحليل إلى أقسام المستند

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

ما صنعناه	الدرس	مكانه في المستند
خريطة أصحاب المصلحة والأدوار	1، 15	2. الوصف العام: فئات المستخدمين
قصص المستخدم ومعايير القبول	4	3. المتطلبات الوظيفية
المتطلبات غير الوظيفية المقيسة	5	3. المتطلبات غير الوظيفية
حالات الاستخدام ووصفها	6	3. الوظيفية (أو ملحق)
DFD والمخطط السياقي	7	2. منظور المنتج (النطاق والأنظمة الخارجية)
مخطط الأصناف و ERD والتسلسل	8–10	المستند التقني
مصفوفة الصلاحيات	16	الوظيفية (ما يحق لكل دور) + الملاحق

توقّع وتحقّق

أي مستند يجيب عن «كيف سنبني النظام؟»

لماذا نكتب «خارج النطاق» صراحة؟

أين توضع فئات المستخدمين في بنية SRS؟

أي هدف قابل للقياس؟

الخلاصة

المستند مرجع واحد معتمد للعميل والمطورين والمختبرين ومدير المشروع.
SRS يجيب «ماذا؟» بلغة العمل، و SDD يجيب «كيف؟» بلغة تقنية.
بنية SRS: المقدمة، والوصف العام، والمتطلبات التفصيلية، والملاحق.
النطاق يذكر ما يشمله النظام وما لا يشمله، والأهداف قابلة للقياس.
كل مخرجات التحليل السابقة لها مكان في المستند.

تحدٍّ تصميمي: مقدمة مستند المتطلبات

متوسط

اكتب القسم الأول من مستند SRS لنظام «دورات» والقسم الخاص بفئات المستخدمين، مستفيدًا مما صنعته في الدروس السابقة.

المطلوب:

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

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

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

💡 تلميح 1

النطاق يمنع النزاع لاحقًا: كل ميزة أجّلناها في MoSCoW (Won't) مكانها «خارج النطاق».

💡 تلميح 2

الأهداف من مشكلات العميل في الاجتماع الأول: المكالمات، وتأخر الاعتماد.

💡 تلميح 3

المصطلحات التي قد تُفهم بأكثر من معنى أولى بالتعريف: الطلب، والمقعد، والاعتماد.

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

1.1 الغرض: يصف هذا المستند متطلبات الإصدار 1.0 من نظام «دورات» لتسجيل الدورات القصيرة، ويخاطب إدارة مركز الأمل وفريق التطوير والاختبار.
1.2 النطاق: ضمن النطاق: نشر الدورات والبحث فيها.
ضمن النطاق: التسجيل والدفع الإلكتروني واعتماد الطلبات.
ضمن النطاق: تقارير الإيرادات ونسب الامتلاء.
خارج النطاق: الشهادات الإلكترونية (المرحلة الثانية).
خارج النطاق: تطبيق الجوال الأصلي.
الأهداف القابلة للقياس: تقليل المكالمات الهاتفية يوم فتح التسجيل بنسبة 70%.
اعتماد طلب التسجيل خلال يوم عمل واحد في 90% من الحالات.
1.3 التعريفات: طلب التسجيل: طلب متدرب الالتحاق بدورة قبل اعتماده.
المقعد المتاح: الفرق بين سعة الدورة وعدد الطلبات المعتمدة.
الاعتماد: موافقة موظفة التسجيل على الطلب.
الاسترداد: إعادة رسوم طلب ملغى إلى المتدرب.
2.3 فئات المستخدمين: المتدربون: يستخدمون الجوال غالبًا، وخبرتهم التقنية متفاوتة.
موظفة التسجيل: تستخدم الحاسب يوميًّا لاعتماد الطلبات.
المدربون: يطلعون على قوائم دوراتهم ويسجلون الحضور.
المدير: يتابع التقارير ويدير الحسابات.

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

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