AR

وثيقة متطلبات التطبيق: ما مواصفات التطبيق ولماذا توافق عليها

المواصفات من صفحة واحدة التي توافق عليها أولًا: غلاف مقالة مدونة Deployflix

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

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

ما مواصفات البرمجيات، بكلمات بسيطة؟

في البرمجيات، المواصفات (وتُسمى في المشاريع الكبيرة غالبًا وثيقة المتطلبات، أو SRS اختصارًا لمواصفات متطلبات البرمجيات) هي الاتفاق بين من يحتاج إلى التطبيق ومن يبنيه. وهي تقول ما يجب أن يفعله التطبيق، لا كيف يفعله الكود. وبالنسبة لمتجر أو نادٍ أو مدرسة، تكفي عادةً صفحة واحدة، ما دامت محددة وبكلمات بسيطة.

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

ما الذي تتضمنه وثيقة متطلبات التطبيق من صفحة واحدة؟

خذ مركز دروس خصوصية يريد تطبيقًا للحصص والحضور والرسوم. المواصفات المفيدة له من صفحة واحدة تتضمن هذه الأجزاء:

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

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

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

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

كيف تقرأ مواصفات التطبيق وتناقشها؟

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

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

ما الثغرات التي يجب أن تبحث عنها قبل الموافقة؟

معظم المواصفات التي تسوء ليست خاطئة؛ بل ناقصة. وهذه هي الثغرات الأكثر تكرارًا.

من يمكنه رؤية ماذا

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

التعديل والإلغاء والتراجع

كل سجل سيحتاج يومًا ما إلى تصحيح. تحقق من أن المواصفات تقول من يستطيع تعديل قيد أو إلغاءه، وهل تُحفظ القيمة القديمة.

المال

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

الرسائل والتذكيرات

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

بياناتك الحالية

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

الأجهزة واللغات

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

لماذا توافق على المواصفات قبل بناء أي شيء؟

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

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

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

كيف يُخطَّط للتعديلات بعد بناء التطبيق؟

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

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

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

قالب لمواصفات التطبيق يمكنك استخدامه

إن كنت تكتب مواصفاتك بنفسك، فانسخ هذه العناوين واملأ كلًّا منها بجمل بسيطة:

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

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

أسئلة

ما الفرق بين مواصفات التطبيق ووثيقة المتطلبات؟

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

من يجب أن يكتب مواصفات التطبيق؟

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

هل يمكنني تغيير المواصفات بعد الموافقة عليها؟

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

ما الطول المناسب لمواصفات التطبيق؟

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

صِف تطبيقك

اكتب ما تحتاجه بكلماتك. يكتب Deployflix خطة من صفحة واحدة مع تكلفتها، ولا يبني إلا بعد أن تعتمدها.