> ## 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.

# الكيانات

> نمذج السجلات التي يديرها فريقك فعلاً، وامنح كل سجل دورة حياة واضحة، واربطها من دون تكرار الحقائق.

## ما الذي يستحق كياناً مستقلاً؟

أنشئ كياناً عندما يملك الشيء هوية أو حقولاً أو مالكاً أو دورة حياة أو دليلاً أو حاجة تقريرية مستقلة. الحقل يجيب عن سؤال عن سجل واحد، أما الكيان فيمثل شيئاً يمكن العمل عليه بصورة مستقلة.

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

طلب التصريح مثلاً كيان. فئة التصريح حقل فيه. أما المعاينة فهي كيان آخر لأنها يمكن أن تُجدول وتُسند وتُنجز وتُراجع بصورة مستقلة.

## خريطة سجلات قابلة للتوسع

ابدأ بكيان أساسي وأضف كيانات داعمة فقط عندما يكون عملها مستقلاً فعلاً.

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

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

## ابنِ الكيان بترتيب موثوق

### 1. سمِّ اسم العمل

استخدم اسماً جمعاً واضحاً للمجموعة وعبارة مفردة لسجل واحد. «المعاينات» أوضح من «بيانات المعاينة». استخدم اللغة التي يعرفها الموظفون، وتجنب مصطلحات التنفيذ مثل «الجدول 3».

### 2. عرّف هوية السجل

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

### 3. اسند الكيان إلى قسم تطبيق

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

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

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

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

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

| عرض الكتالوج                      | ما الذي يجب فحصه أولاً                                                      | الاستجابة الآمنة                                                                                      |
| --------------------------------- | --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| كيان مفقود                        | نص البحث والتطبيق/القسم المحددان والمجموعات المطوية والملكية الحالية للكيان | امسح المرشح المناسب فقط وافتح المجموعة وابحث بالمفتاح الثابت؛ لا تعِد إنشاء الكيان.                   |
| محدد القسم غير متاح أو فارغ       | هل حُدد تطبيق؟ وهل يملك أقساماً؟                                            | اختر التطبيق المعتمد أولاً؛ ولا تنشئ قسماً إلا بعد موافقة مالك بنية المعلومات.                        |
| يفشل النقل أو الإنشاء داخل المحدد | المؤسسة الحالية وإذن المنشئ ونطاق الإنشاء/التحديث للمورد والوجهة            | اطلب من مالك الدور القدرة الضيقة المفقودة أو دع بانياً مخولاً ينفذ النقل؛ لا توسع الوصول إلى السجلات. |

### 4. أضف الحقول الأساسية فقط

ابدأ بالحقول التي تجيب عن:

* ما هذا السجل؟
* من يملك الإجراء التالي؟
* ما حالته الحالية؟
* متى يستحق أو يجدول أو يكتمل؟
* ما الدليل الذي يدعم القرار؟

استخدم [حقول الكيانات وتخطيطاتها](/ar/build/entity-fields-and-layouts) لقرار النوع التفصيلي.

#### أضف مساحة ملفات للسجل عندما يكون الدليل تابعاً له

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

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

### 5. أنشئ العلاقات عن قصد

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

* هل هي واحد لواحد أم واحد لعديد أم عديد لعديد؟
* أي سجل يمكن أن يوجد أولاً؟
* ماذا يحدث عند حذف السجل المرتبط؟
* أي الأدوار تستطيع رؤية أو تحرير كل جانب؟
* هل يجب أن تظهر العلاقة في نموذج أو جدول أو لوحة أو مستند أو أتمتة؟

### 6. امنح السجل دورة حياة

تحتاج معظم الكيانات التشغيلية إلى حالة. تجنب المراحل العامة مثل «قيد التنفيذ» إن لم تخبر الموظف بما يجب أن يفعله. للمعاينة، حالات **مجدولة** و**في الموقع** و**سجلت الملاحظات** و**بانتظار المراجعة** و**مكتملة** أنفع من حالة مبهمة واحدة.

### 7. صمّم الوصول قبل نشر البيانات

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

## صدّر بيانات الجدول بلغات المؤسسة

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

ينشئ المصنف لكل حقل مضبوط كمتعدد اللغات عموداً لكل لغة مهيأة في المؤسسة، ويعرّفه برمز اللغة، مثل `Description (en)` و`Description (ar)`. وينشئ حقل الاختيار عموداً ثابتاً للقيمة `(key)` وعمود تسمية لكل لغة مهيأة. احتفظ بالمفتاح عند المطابقة أو إعادة الاستخدام؛ إذ يمكن ترجمة التسميات أو إعادة تسميتها. تبقى الترجمة المفقودة فارغة بدلاً من استعارة نص من لغة أخرى، فيظهر نقص التوطين ولا يُخفى.

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

## راجع نتائج الذكاء الاصطناعي المحكومة

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

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

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

تفصل صلاحيات نتائج الذكاء الاصطناعي عن بعضها عمداً:

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

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

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

| العرض                                          | افحص أولاً                                                                               | الاستجابة الآمنة                                                                                           |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| تغيب **نتائج الذكاء الاصطناعي** أو يرفض الوصول | المؤسسة النشطة وأهلية حساب عضو المؤسسة للتجربة وإمكانات `ai_findings` في الدور           | اطلب من مالك الإطلاق تأكيد الأهلية، ثم اطلب أصغر إمكانية ناقصة فقط؛ ولا تستخدم رابطاً مباشراً كحل التفافي. |
| الدليل محجوب                                   | نطاق عرض سجل المصدر الحالي والوصول إلى الحقول المحمية وما إذا كان المصدر ما يزال موجوداً | راجعه مع عضو مخول أو أعد الوصول المشروع للمصدر؛ لا تنسخ الدليل عبر حد الصلاحية.                            |
| يبلغ إجراء المراجعة عن تعارض                   | هل غيّر مراجع آخر أو إعادة تقييم مراجعة النتيجة؟                                         | حدّث الصفحة وراجع المراجعة الجديدة قبل اتخاذ القرار مجدداً.                                                |
| التقييم فاشل أو دليله غير كافٍ                 | نتيجة العمليات المنقحة وإتاحة المصدر ومراجعة السياسة ونطاق الدليل المعتمد                | صحح مشكلة المصدر أو السياسة أو أعد المحاولة عبر الإجراء المخول؛ لا تعامل الإخفاق كحالة محلولة.             |

## تجنب أخطاء النمذجة الشائعة

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

## اختبر نموذج السجل قبل الأتمتة

أنشئ سجلاً طبيعياً وسجلاً استثنائياً في مساحة عمل غير إنتاجية. لكل منهما تحقق من:

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

إذا كان المسار اليدوي غير واضح فلن تزيده الأتمتة إلا سرعة في حدوث الالتباس.

## الخطوات التالية

* اختر الأنواع والتخطيطات بالتفصيل في [حقول الكيانات وتخطيطاتها](/ar/build/entity-fields-and-layouts).
* ابنِ تجربة إدخال للموظفين أو العامة في [النماذج](/ar/build/forms).
* استخدم [التعبيرات في المنشئ](/ar/build/expressions-in-builder) بعد استقرار حقول المصدر والعلاقات فقط.
* امنح أصغر إمكانات لازمة للنتائج في [الأدوار والنطاقات](/ar/admin/roles-and-scopes).

![قائمة كيانات KayanOS](https://kayanos.app/docs-images/ar/build/entities.png)