> ## 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 بأفضل صورة عندما يستخدم الفريق الكلمات نفسها للمعاني نفسها. طلب الخدمة ليس مهمة، والمهمة ليست حدث تقويم، والملف ليس صلاحية، والإشعار ليس دليلاً على قرار. يعرّف هذا الدليل اللبنات الأساسية كي يتمكن الفريق من نمذجة خدمة بوضوح قبل إنشاء الشاشات أو النماذج أو التقارير.

تستخدم الأمثلة طلب مديرية خدمات المواطنين `CSR-2026-00042`: يستقبل الطلب، ويتحقق من اكتماله، ويعيّن، ويعاين عند الحاجة، ويتخذ قرار بشأنه، ثم يُبلّغ ويغلق. يصلح النموذج نفسه للتراخيص والشكاوى والصيانة والمشاريع والموارد البشرية.

## الهدف

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

## المفردات المشتركة

| المصطلح        | معناه في KayanOS                                                                | ما ليس هو                                                       |
| -------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| المؤسسة        | سياق جهة العمل الذي يملك الأعضاء والبيانات والإعدادات وقواعد الوصول             | تسمية عامة تمنح العضو وصولاً إلى كل السجلات                     |
| العضو          | هوية موظف داخل المؤسسة لها تعيينات وأدوار وأفعال متاحة                          | مواطن أو مقدم طلب، إلا إذا نمذجه الفريق كسجل مقصود              |
| الدور          | مجموعة قابلة لإعادة الاستخدام من أفعال مسموحة لموارد وفي نطاق معتمد             | مسمى وظيفي يمنح كل القدرات تلقائياً                             |
| النطاق         | الجزء المحدد من المؤسسة أو الهيكل أو النموذج أو المورد الذي يطبق فيه الفعل      | مرشح بصري يمكن تجاوزه عند الحفظ                                 |
| التطبيق والقسم | هيكل التنقل للكيانات والنماذج ولوحات المعلومات المرتبطة                         | البيانات نفسها أو بديل فحص الصلاحية                             |
| الكيان         | تعريف قابل لإعادة الاستخدام لنوع سجل تشغيلي مثل طلبات الخدمة أو المعاينات       | طلب مواطن واحد                                                  |
| السجل          | عنصر محفوظ من كيان، مثل `CSR-2026-00042`                                        | نافذة مؤقتة أو تنبيه أو بطاقة لوحة                              |
| الحقل          | قيمة مسماة في سجل، مثل الحالة أو المالك أو الموقع أو المعرّف التسلسلي أو المبلغ | عنوان مترجم؛ تستخدم التعبيرات مفاتيح الحقول الثابتة لا العناوين |
| العلاقة        | اتصال مضبوط بين سجلات، مثل طلب ومعايناته                                        | فقرة ملصقة تصف سجلاً آخر                                        |
| النموذج        | طريقة مصممة لجمع البيانات أو تحديثها                                            | المصدر الدائم الوحيد لقرار ينتمي إلى سجل كيان                   |
| جلسة النموذج   | تفاعل شخص واحد قيد التنفيذ أو مكتمل مع نموذج                                    | بديلاً عن دورة حياة الخدمة                                      |
| الحالة         | المرحلة المعتمدة الحالية للسجل أو المهمة                                        | ملاحظة نص حر بلا معنى مسؤول                                     |
| المهمة         | عمل مسؤول له دور واستحقاق وحالة ونشاط                                           | القضية نفسها أو موافقة قانونية افتراضياً                        |
| الحدث          | وقت مخطط لاجتماع أو معاينة أو مراجعة                                            | دليلاً أن الحدث حدث أو أن دعوة خارجية سُلّمت                    |
| عنصر المكتبة   | ملف أو مجلد أو مساحة مضبوطة للأدلة والمواد المعتمدة                             | تجاوزاً للوصول أو بديلاً عن حقول السجل                          |
| الإشعار        | تنبيه يشير إلى عمل ذي صلة                                                       | العمل أو الدليل أو القرار الذي يعلنه                            |

## ابدأ بالسجل الدائم

السجل الأساسي هو جواب سؤال: «ما الذي نديره؟». في سيناريو مديرية خدمات المواطنين، هو **طلب خدمة مواطن**. يحتفظ بالحقائق الدائمة التي يجب أن يبحث عنها الموظفون ويراجعوها ويرشحوها ويبلغوا عنها ويحتفظوا بها:

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

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

## اختر الكائن المناسب لكل عمل

عند تصميم الخدمة، اسأل أين يجب أن تبقى الحقيقة بعد انتهاء التفاعل.

| الحاجة                     | الكائن المقترح                           | مثال                                                    |
| -------------------------- | ---------------------------------------- | ------------------------------------------------------- |
| جمع معلومات المواطن الأولى | نموذج ينشئ أو يحدث سجل الطلب             | يسأل الاستقبال عن الفئة والموقع والملفات الداعمة        |
| منح الموظفين مرجعاً صادراً | حقل معرّف تسلسلي على كيان الطلب          | يظهر `CSR-2026-00042` في الرسالة وحديث الخدمة           |
| اشتقاق قيمة متكررة         | حقل محسوب على الكيان                     | يشتق `estimated_fee` من المبلغ المطلوب والنسبة المعتمدة |
| إسناد إجراء تالٍ محدد      | مهمة مرتبطة بالطلب                       | «تحقق من الأدلة المرفوعة قبل 14:00» لموظف السجل         |
| حجز وقت مع زملاء داخليين   | حدث تقويم                                | معاينة ميدانية مع المفتش والمدير                        |
| حفظ دليل في موقع معتمد     | ملف/مجلد مكتبة أو حقل ملف معتمد في السجل | تقرير المعاينة وحزمة الصور في مساحة الطلب المقيدة       |
| سؤال تنسيقي سريع           | محادثة داخلية                            | يسأل المفتش إن كان موقع الطلب صُحح                      |
| توثيق النتيجة الملزمة      | سجل الطلب أو المعاينة                    | يحفظ المفتش العنوان المتحقق ونتيجة المعاينة             |
| تنبيه شخص إلى عمل          | إشعار                                    | يتلقى المدير إشعاراً بمهمة مسندة مرتبطة بالمهمة         |

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

## الحقول والعناوين والمفاتيح

يرى الأشخاص عناوين مثل **معرّف الطلب** أو **الرسم المقدّر** أو **تاريخ المعاينة**. ويحافظ البناؤون على مفاتيح ثابتة مثل `request_id` و`estimated_fee` و`inspection_date`. العنوان المترجم يساعد المستخدم على فهم الشاشة؛ والمفتاح هو ما تستخدمه الحسابات والشروط والقوالب والتكاملات.

لا تغيّر عنوان الحقل لمجرد تشغيل تعبير. ولا تستخدم عنواناً مترجماً داخل تعبير. حافظ على المفتاح ثابتاً، وامنحه عنواناً واضحاً في كل لغة نشطة، ووثّق شكل البيانات المقبولة. راجع [حقول الكيانات وتخطيطاتها](/ar/build/entity-fields-and-layouts) و[المعرّفات التسلسلية](/ar/build/serial-ids) و[الحقول المحسوبة](/ar/build/calculated-fields) للتنفيذ التفصيلي.

## الحالة والمهمة والقرار ضوابط مختلفة

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

مثال عملي:

1. يصبح الطلب **مستَلماً** بعد الاستقبال.
2. تُسند مهمة اكتمال إلى موظف السجل.
3. يسجل الموظف الدليل الناقص وينقل الطلب وفق القاعدة المعتمدة.
4. يجدول مدير الخدمة معاينة وينشئ سجل المعاينة المرتبط.
5. يسجل المفتش النتائج؛ ولا يصبح الطلب **جاهزاً للقرار** إلا عند وجود الدليل المطلوب.
6. يسجل المراجع المخول القرار عبر سير العمل المهيأ. إغلاق مهمة وحده لا يثبت توقيعاً رسمياً أو قرار سياسة.

## الوصول يتبع العمل

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

صمم الوصول وفق مسار الخدمة:

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

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

## فحص تصميم عملي

قبل بناء الشاشة التالية، اكتب جملة واحدة لكل سؤال:

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

إذا لم يكن لسؤال جواب، فأجّل الأتمتة والمستندات ولوحات المعلومات والاتصال الخارجي حتى يتضح النموذج الأساسي.

## اختبار آمن

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

## استكشاف الأخطاء

| المشكلة                                      | افحص أولاً                                                                    |
| -------------------------------------------- | ----------------------------------------------------------------------------- |
| يستمر الموظفون في وضع القرارات داخل المحادثة | حدد حقل السجل أو إجراء الحالة أو نشاط المهمة الذي يجب أن يحمل النتيجة الدائمة |
| لا يجد الحساب حقلاً                          | أكد مفتاح الحقل الثابت وسياق الحساب؛ لا تستخدم عنواناً مترجماً                |
| لا يمكن ترشيح المعاينة أو تعيينها            | قد تحتاج إلى كيان مرتبط بدلاً من فقرة مكررة على الطلب                         |
| يرى العضو إشعاراً ولا يستطيع فتح الهدف       | راجع نطاق السجل الهدف وفعل الفتح للعضو؛ الإشعار ليس منحة وصول                 |
| يصعب إعداد تقرير عن إرسال نموذج              | أكد أن القيم المهمة المرسلة مرتبطة بحقول سجل الكيان الصحيحة                   |

## أدلة مرتبطة

* ابنِ أفعالاً ونطاقات دقيقة في [الأدوار والوصول](/ar/start/roles-and-access).
* افهم نقاط الدخول في [التنقل في KayanOS](/ar/start/navigate-kayanos).
* اتبع المسار الكامل في [استكشاف مساحة عمل نموذجية](/ar/start/example-workspace).
* صمم الكيانات في [تخطيط التطبيق قبل بنائه](/ar/build/plan-an-app) و[الكيانات](/ar/build/entities).
* اضبط إجراءات النماذج والتوقيعات في [إجراءات النموذج ومنطقه وتواقيعه](/ar/build/form-actions-logic-and-signatures).

![مساحة عمل KayanOS تعرض سجلات طلبات خدمة المواطنين](https://kayanos.app/docs-images/ar/start/core-concepts.png)