كيفية استخدام هذه الوصفات
كل وصفة هي نمط تصميم وليست مساراً جاهزاً للتمكين كما هو. عدّل الجدول وأسماء الحالات والمالكين ونسخ النماذج وأسماء الإجراءات ونطاقات الصلاحية بما يلائم مؤسستك. ابنها أولاً في مساحة عمل غير إنتاجية معتمدة، وتحقق من كل مخرج، ثم انقلها عبر إطلاق مضبوط.
تتبع كل وصفة الشكل الآمن نفسه:
الوصفة 1: توجيه طلب خدمة إلى طابور الحالات المناسب
استخدمها عندما: يجب أن يتحول طلب خدمة عامة إلى حالة داخلية لها مالك مسؤول من دون إنشاء تكرارات.
خطوات البناء
- اختبر حدث الإدخال بطلب غير إنتاجي مثل
REQUEST-TEST-001.
- افحص مخرجات المشغّل وحدد حقل معرّف المصدر والفئة بالضبط.
- ابحث عن حالات مفتوحة لها معرّف المصدر نفسه.
- إن وجدت حالة، فتوقف أو حدّثها حسب سياسة الخدمة.
- إن لم توجد، فأنشئ حالة واحدة بعلاقة مصدر واضحة وحالة يملكها الطابور.
- أنشئ المهمة فقط بعد نجاح إنشاء الحالة، حتى يكون للمهمة هدف قابل للمراجعة دائماً.
- أبلغ مالك الطابور أو محدد أعضاء مقيداً؛ لا تبلغ جمهوراً واسعاً في المؤسسة.
امتداد شائع: أضف بحثاً عن الوحدة حسب الفئة بعد فحص التكرار. اجعل البديل صريحاً: إن لم توجد وحدة، فأنشئ مهمة مراجعة لفريق فرز مركزي بدلاً من تخمين المالك.
الوصفة 2: إعداد معاينة ميدانية وتتبعها
استخدمها عندما: تحتاج الحالة إلى جدولة أو إعداد لفريق ميداني بعد قرار أهلية.
لماذا يهم انتقال الحالة؟
لا تشغّل المسار عند كل تحديث للطلب. لا ينبغي أن يؤدي تصحيح عنوان أو رفع مرفق أو تعديل ملاحظة إلى جدولة معاينة أخرى. اطلب الحالة القديمة والجديدة المتوقعتين أو علامة أهلية صريحة مكافئة، وسجّل حالة المعاينة التي أنشئت.
حالات اختبار يجب تشغيلها
- طلب مؤهل بلا معاينة سابقة: ينشئ حالة معاينة واحدة ومهمة واحدة بالضبط.
- طلب مؤهل له معاينة مفتوحة: لا ينشئ تكراراً؛ بل يحدّث أو يعلّم الحالة الموجودة حسب السياسة.
- عنوان ناقص: لا ينشئ معاينة؛ وينشئ مهمة مراجعة فقط إذا كان ذلك مسار الاستثناء المعتمد.
- تحديث غير مرتبط: لا ينتج أي إجراء.
الوصفة 3: تصعيد حالة خدمة متقادمة
استخدمها عندما: تحتاج الحالة إلى انتباه بعد حد زمني متفق عليه مع تجنب التنبيهات المتكررة.
اجعل التصعيد قابلاً للتنفيذ
يجب أن يحمل التصعيد المعلومات اللازمة للتصرف: معرّف الحالة المصدر، والطابور الحالي، والعمر، والوحدة المسؤولة، والقرار التالي المتوقع، ورابطاً أو علاقة بالحالة. تجنب إرسال تنبيه عام يضطر المستلم إلى البحث عن السياق.
الوصفة 4: إعداد مستند قرار بعد الموافقة
استخدمها عندما: يجب أن ينتج نموذج أو قرار معتمد مستنداً مضبوطاً يمكن إرفاقه بالحالة.
ضوابط المستند
تعامل مع القالب بوصفه جزءاً من سياسة الخدمة. اختبره مع قيم اختيارية فارغة، ونص طويل، ومحتوى عربي، وكل نتيجة قرار مسموحة. تحقق من صحة العناوين وبيانات الموقّع والتاريخ والمرفقات في الناتج قبل استخدامه في عملية حية.
الوصفة 5: تقديم استجابة مضبوطة للوحة معلومات أو نموذج
استخدمها عندما: يجب أن يتلقى عنصر لوحة معلومات أو نموذج بيانات محسوبة دون كشف سجلات خارج نطاق المستخدم المسموح.
قائمة فحص تصميم الاستجابة
- عرّف حقول JSON وأنواعها وسلوك الحالة الفارغة قبل البناء.
- أعد المعرّفات والملخصات فقط عندما تحتاجها الواجهة.
- لا تعد ملاحظات خاصة أو حقولاً داخلية أو قوائم سجلات واسعة لمجرد أن الأتمتة تستطيع البحث عنها.
- اختبر مدخلاً مشوهاً، وصفر سجلات مطابقة، ونتائج متعددة، وطلباً خارج النطاق المقصود.
الوصفة 6: إغلاق الحلقة بعد إجراء مهمة مراجع
استخدمها عندما: ينهي دور مسؤول إجراء مهمة وتحتاج الحالة المصدر إلى متابعة متسقة.
- ابدأ بـ On Task Action لنوع المهمة الدقيق.
- ضيّقه إلى انتقال الحالة القديم/الجديد المعتمد عندما يكون متاحاً.
- اقرأ الحالة المصدر من العلاقة المحفوظة في المهمة أو من معرّف معروف.
- تحقق من أن إجراء المهمة هو النتيجة المعتمدة المتوقعة.
- حدّث الحالة المصدر بالقرار والحالة التالية.
- إذا تطلبت السياسة تسليماً جديداً، فأنشئ المهمة أو الإشعار التالي فقط بعد نجاح تحديث الحالة.
- أبقِ المهمة المكتملة والحالة وأي مستند مولد مرتبطة بحيث يمكن مراجعة مسار القرار.
قائمة إطلاق لكل وصفة
- ابنها باستخدام سجل غير إنتاجي معتمد ومستلمين غير إنتاجيين فقط.
- تحقق من حمولة المشغّل والشرط وكل قراءة وكل كتابة والنتيجة النهائية.
- شغّل كل حالة سلبية: بيانات ناقصة، وتحديث غير مرتبط، ومحاولة تكرار، وحالة خاطئة، ونطاق غير مخوّل.
- اجعل مالك الخدمة يراجع السجل أو المهمة أو المستند أو الاستجابة المنشأة، وليس مخرجات محرر الأتمتة فقط.
- فعّل أصغر نطاق خدمة أولاً.
- راقب النتائج الحية الأولى واحتفظ بمسار واضح لتعطيل التدفق إذا اختلفت النتائج عن التصميم المعتمد.
لا تنسخ وصفة مباشرة إلى خدمة حية. تتطلب كل وصفة نموذج البيانات وقواعد الوصول وحدود الموافقة والمالك المسؤول الخاص بمؤسستك.
متابعة البناء
