ابدأ موجز البرمجيات بمهمة: يُسند منسق زيارة غير مسندة إلى فني، ثم يتحقق ممن أصبح مسؤولًا عنها. سجّل الشروط والاستثناءات والأدلة التي يحتاجها الفريق لقبول هذه النتيجة.
يقدم الدليل ورقتي عمل ومتطلبًا مكتملًا يمكنك تكييفه. فريق الخدمة الميدانية وسجلاته افتراضيان. استخدم سير العمل والأمثلة الفعلية لفريقك عند استكمال الموجز.
تخيل منسقًا يستقبل طلبات الزيارة ويوزعها على الفنيين ويتابع الإكمال. عبارة «ابنِ لوحة تحكم» لا تفسر ما يتعطل. نقطة بداية أوضح: يحتاج المنسق إلى معرفة الزيارات غير المسندة وتعيين مسؤول لكل واحدة. ومع ذلك، يجب أن يتحقق الفريق من أن هذا الوصف يعكس العمل الفعلي قبل اعتماده.
أحضر النماذج الحالية وأمثلة مجهّلة وأسئلة الدعم واستعراضًا مع من يستخدمون العملية. افصل المشكلة المرصودة عن التفضيل والافتراض، كما يوصي دليل احتياجات المستخدمين من GOV.UK.
اكتب النتيجة بلغة يومية، ثم حدّد ما سيُلاحظ. في المثال، يستطيع المراجع العثور على طلب غير مسند وإسناده لفني مؤهل ورؤية الحالة الناتجة. لا تعد بنسبة توفير قبل جمع خط أساس والاتفاق على طريقة القياس.
استخدم الموجز التالي لتنظيم النقاش الأول. يحدد كل صف قرارًا ودليله وأي سؤال معلق. افصل متطلبات المنتج عن مسؤوليات المشروع: «المنسقون وحدهم يستطيعون إعادة إسناد الزيارات» سلوك، أما «مدير العمليات يعتمد القواعد» فتحديد لصاحب القرار.
| قسم الموجز | ما الذي تكتبه؟ | مثال من سير الزيارة |
|---|---|---|
| النتيجة والحدود | العمل المشمول والمؤجل عمدًا | طلب الزيارات وإسنادها وإكمالها؛ تأجيل الرواتب |
| المستخدمون والصلاحيات | من يعرض وينشئ ويعدل ويعتمد | المنسق يسند والفني يرى الزيارات المسموح بها |
| الحالات والاستثناءات | الانتقالات المسموحة وسلوك التعافي | مطلوب أو مسند أو مكتمل أو ملغى |
| ملكية البيانات | الحقول المرجعية والمعرّفات ودورة الحياة | نظام الزيارة يملك الإسناد ومصدر العميل محدد |
| الواجهات | الأنظمة والاتجاه والمحفز والتعامل مع الإخفاق | بحث عميل متفق عليه مع استجابة لحالة التعذر |
| قيود الجودة | اللغة والإتاحة والحمل واحتياجات التشغيل | مهام عربية وإنجليزية على أجهزة وظروف متفق عليها |
| القبول | سيناريوهات قابلة للملاحظة والأدلة المطلوبة | نجاح الإسناد ورفض إعادة الإسناد غير المسموحة |
| التسليم | الحسابات والوثائق والدعم والخروج | وصول تملكه الشركة وتصدير وتعليمات تشغيل |
قد يحتاج سير عمل خاضع لمتطلبات تنظيمية، أو تطبيق يعمل بلا اتصال، أو ترحيل معقد إلى تحليل إضافي. سجّل هذه الاعتماديات لكي يفصل العرض العمل المؤكد عن الاستكشاف والافتراضات والاستثناءات.
امنح كل متطلب مرجعًا ثابتًا ونتيجة واحدة واضحة. تدعم قائمة NASA لكتابة المتطلبات الجيدة هذا الأسلوب: يستطيع المراجع ربط المتطلب بغرضه ودليل التحقق منه.
ابدأ بالشخص والمهمة والسبب، ثم صف النتائج القابلة للملاحظة. يقدم دليل قصص المستخدم من GOV.UK هذا البناء. مثلًا: يحتاج المنسق إلى إسناد زيارة حتى يتولى فني مسؤوليتها. تبدأ الجملة النقاش، لكنها لا تحسم قواعد التوافر أو الصلاحيات أو التغييرات المتزامنة التي قد تؤثر في النتيجة النهائية.
استخدم السيناريوهات التالية للاتفاق على هذه القرارات الناقصة. اختبر ببيانات ممثلة، وسجّل ما حدث، وأرفق دليلًا يستطيع مراجع آخر فحصه.
| السيناريو | السلوك الذي يحتاج اتفاقًا | الدليل المطلوب فحصه |
|---|---|---|
| طلب صحيح وإسناده | حفظ التفاصيل المطلوبة وإسناد الزيارة لفني مؤهل | الطلب المحفوظ والمسؤول والحالة الناتجة |
| إرسال مكرر أو إعادة محاولة | ألا ينشئ الطلب المقصود نفسه زيارة ثانية غير مقصودة | معرّفات الطلب والسجلات الناتجة |
| إعادة إسناد غير مخولة | منع الفني غير المخوّل من تعديل إسناد آخر | العملية المرفوضة وبقاء السجل دون تغيير |
| تعديل متزامن من منسقين | ألا يطغى تعديل قديم بصمت على إسناد معتمد | استجابة التعارض والمسؤول النهائي |
| تعذر البحث عن العميل | توضيح ما حدث واتباع قاعدة إعادة المحاولة أو التعليق | رسالة المستخدم وحالة طلب قابلة للاستكمال |
| إلغاء الزيارة | آثار محددة للإلغاء في الوصول والإشعارات والسجل | الحالة النهائية والنتائج في الأنظمة المرتبطة |
| العربية والجوال ولوحة المفاتيح | فهم مهمة الإسناد كاملة وإتمامها | مراجعة المهمة وفق اللغة وظروف الوصول المتفق عليها |
اختبر النتائج خارج الشاشة أيضًا. تعطيل زر لا يثبت رفض الخادم لطلب غير مخوّل. وإشعار النجاح لا يثبت حفظ السجل الصحيح. وفي المقابل، قد تكون لقطة الشاشة دليلًا مناسبًا للتخطيط أو الصياغة عندما يكون هذا هو المتطلب الجاري مراجعته. اختر نوع الدليل بحسب القرار الذي تريد إثباته.
قرر ما يستطيع المستخدم فعله بعد انتهاء المهلة، وكيف يُعرف التكرار، وماذا يحدث عند مغادرة موظف. احتفظ بهذه القرارات في الموجز وفحوص القبول.
هذا سجل واحد لسير الزيارة الافتراضي. يحدد معنى أهلية الفني في المثال؛ وعلى فريقك اختيار قاعدته. تبقى تعارضات المواعيد متطلبًا منفصلًا.
| الحقل | مثال مكتمل |
|---|---|
| المرجع | REQ-VISIT-01 — إسناد زيارة غير مسندة |
| المتطلب | يجب أن يسمح النظام لمنسق مخوّل بإسناد زيارة غير مسندة إلى فني مؤهل. |
| قاعدة الأهلية | حساب الفني نشط، وهو عضو في فريق الخدمة المسؤول عن الزيارة. |
| إعداد الاختبار | الزيارة V-104 غير مسندة. يملك المنسق C-8 صلاحية إدارة فريق خدمتها. يحقق الفني T-17 قاعدة الأهلية. |
| الإجراء | يُسند C-8 الزيارة V-104 إلى T-17. |
| النتيجة المتوقعة | بعد تحميل الصفحة من جديد، يظهر T-17 مسؤولًا عن V-104 وحالتها «مسندة». ويطابق سجل الزيارة المحفوظ هذه النتيجة. |
| الأدلة | طلب الإسناد واستجابته، وسجل الزيارة الناتج، وعرض الصفحة بعد إعادة تحميلها، باستخدام حسابات اختبار. |
| سجل القبول | اترك القرار معلقًا حتى الفحص، ثم سجّل النجاح أو الإخفاق، والمراجع، ونسخة البرنامج المختبرة، ومكان الأدلة. |
أعد الزيارة الاختبارية إلى حالة «غير مسندة»، وكرر الطلب بحساب فني لا يملك صلاحية الإسناد. يتطلب القبول رفض العملية وبقاء الزيارة دون تغيير. يفحص ذلك حد الصلاحية خلف الشاشة. أبقِ التكرار والتعديل المتزامن وتعذر الأنظمة المرتبطة سيناريوهات منفصلة، حتى لا يحل نجاح إسناد واحد محل فحص سير العمل كاملًا.
استبدل «سريع» و«آمن» و«سهل الاستخدام» بنطاق وطريقة فحص متفق عليهما. للأداء، سمِّ المهمة والحمل وحجم البيانات والجهاز وظروف الشبكة وطريقة القياس قبل اختيار هدف. قد ينجح رقم زمن استجابة بلا هذه الظروف في عرض بسيط بينما يظل سير العمل الحقيقي بطيئًا أو صعب الإكمال.
للصلاحيات والبيانات، حدّد من يرى كل فئة، ومن أين تأتي المعلومات، ومن يستطيع تصديرها، وما قرارات الاحتفاظ والإتلاف المنطبقة. ضم النسخ الاحتياطية ووصول الدعم إلى النقاش. سمِّ المراجع التجاري أو النظامي المسؤول عندما تعتمد المتطلبات على عقد أو قاعدة منطبقة؛ اختيار موقع الاستضافة لا يحسم وحده كل التزامات البيانات.
يوفر معيار التحقق من أمن التطبيقات لدى OWASP متطلبات مرتبطة بإصدارات يمكن أن تدعم الشراء والتحقق. إذا استُخدم، فحدد الإصدار والمتطلبات المختارة والاستثناءات والأدلة المتوقعة. إضافة «ASVS» إلى العرض لا تثبت وحدها أن التطبيق اجتاز مراجعة أمنية أو أن كل جوانب الأمن دخلت في الفحص المتفق عليه.
تحتاج اللغة والإتاحة مهام كاملة أيضًا. افحص عناوين الحقول العربية والقيم المختلطة ورسائل التحقق وترتيب لوحة المفاتيح والنص المكبّر. بضعة أمثلة لا تثبت المطابقة الكاملة لمعيار إتاحة. استخدم قائمة تجربة العربية وRTL لجعل التجربة المقصودة أوضح قبل الاتفاق على نطاق المراجعة والأجهزة والمهام التي سيجربها الفريق.
احتفظ بقائمة قصيرة للمجهول مع مسؤول وموعد قرار. مثلًا: هل يعرض نظام العملاء الواجهة المطلوبة؟ هل يلزم العمل بلا اتصال؟ وهل يجب استيراد السجلات التاريخية؟ اطلب من العرض إظهار أثر هذه الافتراضات بدل إخفائها داخل اسم ميزة واحد يبدو بسيطًا بينما يتضمن أكثر من مسار تنفيذ محتمل.
اجعل الإصدار الأول متماسكًا. قد يكون سير كامل من الطلب إلى الإسناد أسهل مراجعة من أجزاء غير مكتملة لعشرة أقسام. اذكر القدرات المؤجلة وكيف تؤثر في قرارات اليوم. يساعد دليل معمارية المنتج الأولي في ربط هذا الحد بملكية البيانات والواجهات والتعافي دون افتراض حجم نمو لم يثبته الاستخدام الفعلي.
يجعل الموجز المتفق عليه تقييم البدائل أسهل أيضًا. اختبر منتجًا قائمًا على المهام المهمة نفسها قبل الالتزام بعمل مخصص. استخدم إطار SaaS أم البرمجيات المخصصة إذا بقي القرار مفتوحًا؛ ينبغي أن يجيب البناء المخصص عن فجوة فعلية في سير العمل أو متطلبات الملكية، لا مجرد تفضيل امتلاك تطبيق جديد.
راجع الموجز الحالي مع المسؤولين عن التشغيل والتنفيذ والقبول. أكد مسارات العمل المشمولة والاعتماديات المعلقة وسيناريوهات القبول وتسليم التشغيل. سجّل نسخة وصاحب قرار لكي تُقارن التغييرات اللاحقة بمرجع ملموس. يجب أن يعرف كل طرف ما اعتمده وما بقي قيد البحث، بدل افتراض أن الملاحظات المفتوحة التزامات نهائية.
عندما يتغير متطلب، حدّث مبرره والفحوص المتأثرة. قد تغير صلاحية جديدة الواجهات وانكشاف البيانات والتدريب، وقد تؤثر حالة جديدة في التقارير والإشعارات. اتفق على أثر ذلك في النطاق والتسليم قبل اعتبار العمل المعدّل مشمولًا. يساعد هذا السجل على نقاش واضح للتغيير دون منع الفريق من التعلم أثناء البناء.
يمكن أن تحدد خدمة البرمجيات المخصصة من تكنوستاك نطاق الاكتشاف أو التنفيذ أو تغيير مركز في نظام قائم. أحضر سير العمل وأمثلة ممثلة والأنظمة المعنية والقيود المعروفة. المخرج التالي المفيد نطاق تسليم قابل للمراجعة، بأدلة قبول ومسؤوليات، يستند إلى موجز تستطيع شرحه بالفعل ويستطيع فريقك اتخاذ قرار بشأنه.




