> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kayanos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# وصفات أتمتة KayanOS

> بناء مسارات عمل KayanOS كاملة وقابلة للمراجعة للإدخال والمعاينة والتصعيد ومستندات القرار والاستجابات المضبوطة.

## كيفية استخدام هذه الوصفات

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

تتبع كل وصفة الشكل الآمن نفسه:

```mermaid theme={null}
flowchart LR
    A["حدث محدد"] --> B["التحقق من البيانات والحالة"]
    B --> C["البحث عن العمل المرتبط"]
    C --> D{"هل عولجت سابقاً؟"}
    D -->|نعم| E["تحديث أو توقف"]
    D -->|لا| F["إنشاء متابعة مضبوطة"]
    F --> G["إشعار الفريق المسؤول"]
    G --> H["تسجيل النتيجة ومراجعتها"]
```

## الوصفة 1: توجيه طلب خدمة إلى طابور الحالات المناسب

**استخدمها عندما:** يجب أن يتحول طلب خدمة عامة إلى حالة داخلية لها مالك مسؤول من دون إنشاء تكرارات.

| قرار التصميم       | التنفيذ الموصى به                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| حدث المصدر         | **New Record Created** على جدول الإدخال، أو **On Form Action** عندما يكون إجراء الإرسال المضبوط هو نقطة الإدخال الفعلية. |
| قيم المصدر اللازمة | فئة الخدمة، والمنطقة، ومعرّف الطلب، ومرجع العلاقة أو الاتصال عند السماح به، والحالة الأولية.                             |
| شرط الحماية        | الطلب مكتمل، وفئة خدمته مدعومة، ولم يجر توجيهه مسبقاً.                                                                   |
| فحص التكرار        | **Find Records** لحالة مفتوحة لها علاقة الطلب المصدر نفسها أو معرّف المصدر نفسه.                                         |
| المتابعة           | **Create Record** في جدول حالات الخدمة؛ واربط الطلب المصدر والفئة والمنطقة والوحدة المالكة والحالة `New`.                |
| التسليم البشري     | **Create Task** لمالك الطابور و**Send Notification** لمنسق داخلي ذي نطاق ضيق.                                            |
| دليل النجاح        | يشير الطلب إلى حالة واحدة، وتشير الحالة إلى الطلب، ويستطيع مالك الطابور رؤية المهمة أو الإشعار.                          |

### خطوات البناء

1. اختبر حدث الإدخال بطلب غير إنتاجي مثل `REQUEST-TEST-001`.
2. افحص مخرجات المشغّل وحدد حقل معرّف المصدر والفئة بالضبط.
3. ابحث عن حالات مفتوحة لها معرّف المصدر نفسه.
4. إن وجدت حالة، فتوقف أو حدّثها حسب سياسة الخدمة.
5. إن لم توجد، فأنشئ حالة واحدة بعلاقة مصدر واضحة وحالة يملكها الطابور.
6. أنشئ المهمة فقط بعد نجاح إنشاء الحالة، حتى يكون للمهمة هدف قابل للمراجعة دائماً.
7. أبلغ مالك الطابور أو محدد أعضاء مقيداً؛ لا تبلغ جمهوراً واسعاً في المؤسسة.

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

## الوصفة 2: إعداد معاينة ميدانية وتتبعها

**استخدمها عندما:** تحتاج الحالة إلى جدولة أو إعداد لفريق ميداني بعد قرار أهلية.

| قرار التصميم      | التنفيذ الموصى به                                                                        |
| ----------------- | ---------------------------------------------------------------------------------------- |
| حدث المصدر        | **Record Changes** على جدول الطلب أو الحالة مع مراقبة التحديثات.                         |
| شرط الحماية       | تغيرت الحالة إلى `Ready for inspection`؛ واكتمل العنوان والمنطقة؛ ولا توجد معاينة فعالة. |
| خطوة القراءة      | **Get Record** للبيانات الحالية و**Find Records** لمعاينة فعالة مرتبطة بالحالة المصدر.   |
| المتابعة          | **Create Record** في `Inspection Cases` ثم **Create Task** للوحدة الميدانية المسؤولة.    |
| الإيقاف الاختياري | **Wait for Record Change** على حقل `Outcome` أو `Status` لحالة المعاينة.                 |
| نتيجة الاستئناف   | تحديث الحالة المصدر أو إنشاء مهمة قرار أو إعداد مستند المعاينة المعتمد.                  |

### لماذا يهم انتقال الحالة؟

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

### حالات اختبار يجب تشغيلها

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

## الوصفة 3: تصعيد حالة خدمة متقادمة

**استخدمها عندما:** تحتاج الحالة إلى انتباه بعد حد زمني متفق عليه مع تجنب التنبيهات المتكررة.

| قرار التصميم | التنفيذ الموصى به                                                                             |
| ------------ | --------------------------------------------------------------------------------------------- |
| حدث المصدر   | حدث تغير سجل مضبوط أو إجراء مهمة أو تسليم تشغيلي مجدول متاح في تصميم خدمتك.                   |
| شرط الحماية  | الحالة ما زالت مفتوحة، وتجاوزت الحد المتفق عليه، ولا توجد مهمة تصعيد غير محسومة.              |
| خطوة القراءة | **Find Records** لمهمة التصعيد أو علامة التصعيد الموجودة.                                     |
| المتابعة     | **Create Task** لدور التصعيد ثم **Send Notification** للمنسق المسؤول تحديداً.                 |
| منع التكرار  | احفظ حالة تصعيد مرئية أو طابعاً زمنياً أو معرّف مهمة تصعيد مرتبطة في الحالة.                  |
| المعالجة     | استخدم **Wait For Task Action** أو مشغّل إجراء المهمة للمتابعة فقط بعد استجابة الدور المسؤول. |

### اجعل التصعيد قابلاً للتنفيذ

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

## الوصفة 4: إعداد مستند قرار بعد الموافقة

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

| قرار التصميم   | التنفيذ الموصى به                                                                                      |
| -------------- | ------------------------------------------------------------------------------------------------------ |
| حدث المصدر     | **On Form Signature Signed** أو **On Form Action** عند نقطة القرار المعتمدة.                           |
| شرط الحماية    | نسخة النموذج ومسار التوقيع والقرار والحالة المصدر كلها هي المتوقعة.                                    |
| الحد البشري    | استخدم **Wait For Form Signature** أو **Wait For Form Action** عندما يتطلب الأمر قراراً بشرياً لاحقاً. |
| خطوة المستند   | **Word Template** أو **Excel Template** بقالب معتمد ومجموعة قيم مربوطة بوعي.                           |
| الناتج النهائي | **Word to PDF** أو **Excel to PDF** عندما تتطلب السياسة PDF.                                           |
| حفظ السجل      | **Update Record** بمرجع المستند المعتمد وحالة تعكس القرار بدقة.                                        |

### ضوابط المستند

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

## الوصفة 5: تقديم استجابة مضبوطة للوحة معلومات أو نموذج

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

| قرار التصميم   | التنفيذ الموصى به                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------- |
| حدث المصدر     | **On Dashboard Widget Call** أو **On Form Call**.                                                 |
| شرط الحماية    | الوضع وشكل المدخل ونطاق الخدمة المطلوب كلها صالحة.                                                |
| خطوة القراءة   | **Find Records** بأضيق معايير مسموحة.                                                             |
| خطوة الاستجابة | شكّل جسم JSON محدوداً ثم استخدم **Return Dashboard Widget Response** أو **Return Form Response**. |
| مسار الخطأ     | أعد استجابة فارغة أو استجابة تحقق أو خطأ موثقة دون تسريب بيانات خاصة.                             |
| دليل النجاح    | يعرض العنصر أو النموذج النتيجة المتوقعة لطلب مخوّل ولا يعرض نتيجة لنطاق غير مسموح.                |

### قائمة فحص تصميم الاستجابة

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

## الوصفة 6: إغلاق الحلقة بعد إجراء مهمة مراجع

**استخدمها عندما:** ينهي دور مسؤول إجراء مهمة وتحتاج الحالة المصدر إلى متابعة متسقة.

1. ابدأ بـ **On Task Action** لنوع المهمة الدقيق.
2. ضيّقه إلى انتقال الحالة القديم/الجديد المعتمد عندما يكون متاحاً.
3. اقرأ الحالة المصدر من العلاقة المحفوظة في المهمة أو من معرّف معروف.
4. تحقق من أن إجراء المهمة هو النتيجة المعتمدة المتوقعة.
5. حدّث الحالة المصدر بالقرار والحالة التالية.
6. إذا تطلبت السياسة تسليماً جديداً، فأنشئ المهمة أو الإشعار التالي فقط بعد نجاح تحديث الحالة.
7. أبقِ المهمة المكتملة والحالة وأي مستند مولد مرتبطة بحيث يمكن مراجعة مسار القرار.

## قائمة إطلاق لكل وصفة

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

<Warning>لا تنسخ وصفة مباشرة إلى خدمة حية. تتطلب كل وصفة نموذج البيانات وقواعد الوصول وحدود الموافقة والمالك المسؤول الخاص بمؤسستك.</Warning>

![وصفة أتمتة KayanOS لتصعيد خدمة مضبوط.](https://kayanos.app/docs-images/ar/build/automations-recipes.png)

## متابعة البناء

* افحص [مشغلات أتمتة KayanOS](/ar/build/automations-triggers) و[إجراءات أتمتة KayanOS](/ar/build/automations-actions) المتاحة.
* استخدم [اختبار الأتمتة وتشغيلها واستكشاف أعطالها](/ar/build/automations-test-run-and-troubleshoot) قبل تمكين أي وصفة.
* راجع [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability) قبل توسيع نطاق الخدمة.