Choose “Save as PDF” as the destination to download this doc.

Back to the doc
حياة هوست

كيف تكتب وثيقة متطلبات مشروعك البرمجي؟ دليل عملي مع نموذج

البرمجة والتصميم  ·  https://www.hyyat.com/knowledgebase/كيف-تكتب-وثيقة-متطلبات-مشروعك-البرمجي/

آخر تحديث:

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

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

أقسام وثيقة المتطلبات التسعة

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

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

أقسام الوثيقة، خطوة بخطوة

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

نموذج جاهز تنسخه

انسخ هذا النموذج، واملأ كل بند بلغتك البسيطة:

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

أخطاء شائعة

كيف نتعامل مع المتطلبات في حياة هوست؟

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

والوثيقة المعتمدة هي المرجع عند التسليم: ما فيها ولا يعمل كما كُتب يُصلح مجاناً، وما ليس فيها طلب جديد. التفاصيل في شروط التصميم والبرمجة.

مثال: صاحب مشروع توصيل طلبات كتب في البداية: «تطبيق توصيل كامل». وبعد كتابة الوثيقة صار واضحاً أن المرحلة الأولى تحتاج: تسجيل العميل، وطلب التوصيل، وتتبع الطلب، ولوحة للمدير. أما محفظة العميل ونظام النقاط فأُجّلا لمرحلة ثانية، فصار السعر والمدة أوضح.

خلاصة

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

لديك فكرة مشروع؟ اطّلع على البرمجة الخاصة، واحمِ فكرتك أولاً مع اتفاقية عدم الإفصاح.

أسئلة شائعة

هل أحتاج خبرة تقنية لكتابة وثيقة المتطلبات؟

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

ما الفرق بين وثيقة المتطلبات وعرض السعر؟

الوثيقة تصف ما سيُبرمج بالتفصيل، وعرض السعر يُبنى عليها. بدون وثيقة يكون السعر تقديراً عاماً.

هل مرحلة التحليل مجانية؟

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

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

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

ماذا لو أردت إضافة وظيفة أثناء التنفيذ؟

تُعامل كطلب جديد، يُسعَّر ويُجدول قبل تنفيذه، حتى لا يتأخر باقي المشروع.