الإجابة المختصرة

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

اكتب رحلة واحدة من البداية إلى النهاية

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

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

حوّل العبارات العامة إلى قواعد قابلة للفحص

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

حدّد البيانات والحالات

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

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

وصف جاهز للبناء

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

قبل اعتماد النتيجة

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

أسئلة شائعة

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

هل أطلب كل المزايا من البداية؟ اذكر تصورك العام، لكن ميّز ما تحتاجه لاختبار النسخة الأولى عما يمكن تأجيله.

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

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