المقالات / المتطلبات والمواصفات

المتطلبات والمواصفات: كيفية تنظيم القرارات والتغييرات

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

ما الذي تديره إلى جانب المستند؟

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

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

اربط الهدف والمتطلب والمواصفة ومعايير القبول

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

الهدف: تقليل النسخ اليدوي

تتضمن عملية إعداد التقارير الشهرية حاليًا نسخ السجلات يدويًا. والغرض من التصدير هو تسهيل هذا العمل.

المتطلب: تصدير السجلات اللازمة للتقرير

يحتاج أحد الموظفين إلى تصدير سجلات شهر محدد، ضمن نطاق البيانات المسموح له بالوصول إليها.

المواصفات: حدّد الملف وسلوكه

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

معايير القبول: اجعل النتيجة قابلة للتحقق

جهّز سجلات ذات تواريخ وأذونات معروفة، ونفّذ التصدير، وقارن المخرجات بالنتيجة المتفق عليها.

من الهدف إلى معايير القبول فتح ReqSpec AI

اكتب فكرة واحدة قابلة للتحقق لكل عنصر

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

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

قبل: “السماح بالتصدير إلى CSV.”

بعد التحسين: «صدّر الشهر المحدد باستخدام الأعمدة وترتيب الفرز المتفق عليهما. حدّد النتائج الفارغة وفحوصات الوصول في بنود منفصلة».

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

مجموعة صغيرة من الحقول للبدء

المعرّف والعنوان والوصف

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

السبب والمصدر

سجّل المشكلة التي يعالجها العنصر ومصدره، مثل محادثة أو طلب أو مستند داعم.

الأولوية والنطاق

ميّز بين ما يلزم لهذا الإصدار وما يمكن تأجيله. وضّح سبب تحديد الأولوية؛ ولا تجعل كل عنصر في أعلى مستوى من الأولوية.

المسؤول وحالة القرار

سجّل الشخص الذي سيوضح العنصر وما إذا كان مسودة أو قيد المراجعة أو تم الاتفاق عليه. وقد يختلف المسؤول عن التنفيذ عن الشخص المخوّل بالموافقة.

معايير القبول والمعلومات ذات الصلة

اربط العنصر بالمواصفات والتصاميم والمهام وسجلات التحقق ذات الصلة. احرص على تحديث هذه الروابط عند تغيّر المتطلبات.

مثال: ثلاثة متطلبات لتصدير CSV شهري

ما يلي مثال توضيحي. ينبغي الاتفاق على أسماء الحقول وسلوكها بما يناسب المنتج الذي تطوره؛ فهذا المثال ليس مواصفة كاملة لكل ميزة تصدير.

REQ-001: سجلات الشهر المحدد

مثال على المواصفات: استخدم الشهر المحدد وفق المنطقة الزمنية المتفق عليها للعمل، وصدّر المعرّف ID وتاريخ السجل والعنوان بتنسيق UTF-8، مرتبةً حسب التاريخ ثم المعرّف ID. مثال على القبول: تنتج ثلاثة سجلات مطابقة صفًا واحدًا للعناوين وثلاثة صفوف بيانات تمثل تلك السجلات بالضبط، دون أي سجلات من أشهر أخرى.

REQ-002: لا توجد سجلات مطابقة

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

REQ-003: يتم التحقق من صلاحية الوصول قبل التصدير

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

استخدم التسلسل الهرمي دون إغفال القرارات الفردية

جمّع العناصر حسب الغرض أو الميزة، ثم ضع الشروط التفصيلية تحت المجموعة المناسبة. على سبيل المثال: التقارير → تصدير CSV شهريًا → السجلات المستهدفة / تنسيق الملف / النتائج الفارغة / الوصول. ضع المعلومات الأساسية والأسئلة المفتوحة في الملاحظات بدلًا من دمجها في متطلب واحد طويل.

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

افصل بين الاتفاق والتنفيذ والتحقق

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

راجع الحالة المعتادة والمدخلات الفارغة أو المفقودة والأذونات وحالات الإخفاق الخارجية عند الاقتضاء. وحدد الأدلة التي يجب الاحتفاظ بها ومن سيتحقق منها ومن يملك صلاحية إغلاق مسألة لم تُحل.

سجّل التغيير وتأثيره قبل اعتباره متفقًا عليه

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

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

اختر مكانًا يمكنك تحديثه باستمرار

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

استخدم الذكاء الاصطناعي لمسودة ثم أكّد القرارات

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

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

ابدأ بميزة واحدة ومراجعة واحدة

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

قراءات إضافية

NASA: كيفية كتابة متطلب جيد

NASA: إدارة المتطلبات

نظّم المتطلبات والمواصفات باستخدام ReqSpec AI

يوفّر ReqSpec AI طريقة بسيطة لتنظيم المتطلبات والمواصفات على الهاتف والويب. استكشف ميزاته على صفحة التطبيق.