تخطَّ إلى المحتوى

الويب

كيف تكتب وثيقة متطلبات البرمجيات (مع نموذج بسيط)

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

بقلم فريق كود إلكترون الهندسيآخر تحديث قراءة 6 دقائق
رسم توضيحي لمسار مشروع من المتطلبات إلى الإطلاق ببطاقات مراحل مكتملة وأخرى قيد الانتظار

أهم النقاط

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

لماذا نكتب وثيقة المتطلبات

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

هيكل بسيط يعمل

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

كيف تصف الميزة جيدًا

استخدم جملًا بسيطة ومثالًا حقيقيًا. قارن بين الصياغتين.

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

ما لا تضمّنه

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

أخطاء شائعة

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

مثال تطبيقي: طلب توصيل

الهدف: يستطيع العملاء طلب توصيل ومعرفة موعد وصوله. المستخدمون: العميل والمنسق والسائق. المسار الرئيسي: يدخل العميل نقطتي الاستلام والتسليم ويرى السعر ويؤكد؛ ويسند المنسق سائقًا؛ ويحدّث السائق الحالة؛ ويُخطَر العميل عند كل خطوة.

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

ليست لديك وثيقة بعد؟

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

أسئلة شائعة

ما طول وثيقة المتطلبات؟

أقصر ما يمكن مع الإجابة عن ماذا ولمن وكيف يُحكم على النجاح. تحتاج مشروعات كثيرة من 5 إلى 15 صفحة مع رسومات. وتميل الوثائق الطويلة إلى إخفاء القرارات المهمة.

من يكتب المتطلبات؟

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

هل تتغير المتطلبات أثناء المشروع؟

نعم. اتفقوا على عملية تغيير بسيطة لتُقدَّر الأفكار الجديدة وتُرتَّب أولوياتها بدل أن تضاف بصمت.

عندك سؤال لم نتناوله؟

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