كيف تكتب وثيقة متطلبات تطبيق قبل التحدث إلى المطورين

لماذا تتفوق الوثيقة القصيرة على المواصفات الطويلة

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

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

1. المشكلة، في فقرة واحدة

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

2. المستخدمون والأدوار

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

3. المهمة الواحدة للنسخة الأولى

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

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

إن كانت للنسخة الأولى ثلاث مهام رئيسية، فليست لها أي مهمة. اختر المهمة التي تجعل المنتج جديرًا بالاستخدام غدًا.

4. المسارات الأساسية، شاشةً بشاشة

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

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

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

5. ما يُستبعد من النسخة الأولى

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

6. البيانات والتكاملات

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

7. مقاييس النجاح ومن يقرر

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

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

لماذا يتفوق سبرنت الاستكشاف على عرض سعر ثابت لوثيقة غامضة

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

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

نسخة أولى عاملة خلال 2 إلى 3 أسابيع، لا عروض تقديمية.احجز مكالمة تحديد نطاق مدتها 30 دقيقة