> ## 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: جميع أنواع الحقول المدعومة، ومتى تستخدمها، وكيف ترتّبها للعمل الحقيقي.

## ابدأ بالقرار لا بقائمة الحقول

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

قبل إضافة أي حقل، حدّد ما يلي:

1. ما القرار أو الإجراء الذي ستدعمه هذه القيمة؟
2. من سيدخلها وفي أي مرحلة من المسار؟
3. هل هي وصف حر أم اختيار مضبوط أم علاقة أم وقت أم نتيجة محسوبة؟
4. هل يجب البحث فيها أو تصفيتها أو تضمينها في تقرير أو توقيع أو تصدير أو تقييد رؤيتها؟

إن لم يغيّر الحقل قراراً أو تسليماً أو تقريراً فلا تضفه بعد. السجل الصغير الواضح أسهل إدخالاً وأوثق للاعتماد عليه.

## نموذج عملي: التراخيص والمعاينات

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

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

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

## المرجع الكامل لأنواع الحقول

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

### أدلة مستقلة للحقول ذات الضوابط الخاصة

تحتاج ميزتان إلى قرار أوسع من اختيار نوع الحقل. اقرأ [المعرّفات التسلسلية](/ar/build/serial-ids) قبل إصدار مرجع عام: يشرح الدليل النطاقات وأنماط الإصدار وحدود التعيين اليدوي وسجل التدقيق والاختبار الآمن من التكرار. واقرأ [الحقول المحسوبة](/ar/build/calculated-fields) قبل اشتقاق قيمة: يشرح سياق التعبير والعلاقات المباشرة والعكسية والحفظ والتحديث الخلفي وحدود جودة البيانات.

### `text`

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

![ضبط حقل نص في KayanOS لعنوان طلب.](https://kayanos.app/docs-images/ar/build/entity-fields/text-settings.png)

* اختره عندما تقرأ القيمة كنص وغالباً تكون قصيرة.
* لا تستخدمه للوصف الطويل أو الحالة المضبوطة أو التاريخ أو العمليات الحسابية.
* استخدم مفتاحاً ثابتاً مثل `external_reference`؛ يمكن تغيير العنوان الظاهر لاحقاً دون كسر التكاملات.
* استخدم النص للمعرفات التي تهم فيها الأصفار البادئة، وليس الرقم.

### `long_text`

استخدم **النص الطويل** لوصف غير منسق: وصف المشكلة، ملاحظة المعاينة، المبرر، أو ملاحظة التسليم.

![ضبط حقل نص طويل في KayanOS لملخص خدمة.](https://kayanos.app/docs-images/ar/build/entity-fields/long-text-settings.png)

* يحتفظ بإجابة واضحة على شكل فقرات من دون تحويل الحقل إلى محرر مستندات.
* اطرح سؤالاً محدداً لكل حقل؛ افصل بين «الملاحظة» و«الإجراء المقترح» لكي يمكن مراجعتهما وتقريرهـما منفصلين.
* لا تجعله بديلاً عن حقول مضبوطة تحتاج إلى فرز أو تصفية أو عدّ.
* اجعله إلزامياً فقط عندما لا يمكن استمرار المسار من دون تفسير ذي معنى.

### `rich_text`

استخدم **النص المنسق** عندما يحتاج الكاتب إلى عناوين وقوائم وتأكيدات أو تعليمات منظمة.

![ضبط حقل نص منسق في KayanOS لسرد معاينة.](https://kayanos.app/docs-images/ar/build/entity-fields/rich-text-settings.png)

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

### `phone`

استخدم **الهاتف** لرقم اتصال يجب إدخاله وعرضه كرقم هاتف.

![ضبط حقل هاتف في KayanOS لرقم اتصال مقدم الطلب.](https://kayanos.app/docs-images/ar/build/entity-fields/phone-settings.png)

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

### `serial_id`

استخدم **المعرف التسلسلي** لرقم مقروء وقابل للتتبع ينشئه النظام.

![ضبط حقل معرف تسلسلي في KayanOS لمرجع طلب.](https://kayanos.app/docs-images/ar/build/entity-fields/serial-id-settings.png)

* أمثلته: `LIC-2026-0142` أو رقم معاينة أو رمز دورة رواتب أو تذكرة صيانة.
* اجعله المرجع المستخدم في المحادثات والمستندات ولوحات المعلومات، ولا تطلب من الموظفين اختراعه يدوياً.
* افصله عن معرف قاعدة البيانات وعن المرجع الخارجي القادم من نظام آخر.
* صمم البادئة وقاعدة الترقيم قبل النشر؛ تغييرها بعد استخدامها خارجياً يسبب التباساً غير ضروري.
* استخدم دليل [المعرّفات التسلسلية](/ar/build/serial-ids) لضبط نمط الإصدار والنطاق وتنسيق التاريخ والتعبئة المسبقة وسجل التصحيح وحالات الاختبار.

### `number`

استخدم **الرقم** للقيم التي ستُحسب أو تقارن أو تجمع أو تعرض في مخطط.

![ضبط حقل رقم في KayanOS لكمية ضمن خدمة عامة.](https://kayanos.app/docs-images/ar/build/entity-fields/number-settings.png)

* استخدمه للكمية أو المساحة أو عدد الحضور أو الدرجة أو المبلغ أو النسبة أو ساعات الحمل.
* لا تستخدمه للهاتف أو الرمز البريدي أو المعرف الوطني أو أي قيمة تهم فيها الأصفار البادئة.
* بيّن الوحدة في العنوان أو الوصف: `area_m2` و`estimated_hours` أو `requested_amount_syp` أوضح من `value`.
* اربطه بقاعدة تحقق أو بحقل محسوب عندما يكون المدى أو النتيجة المشتقة مهماً.
* للنتيجة المشتقة المخزنة، استخدم [الحقول المحسوبة](/ar/build/calculated-fields) لاختيار تعبير آمن وسياق العلاقة ومسار التحديث وخطة الاختبار.

### `duration`

استخدم **المدة** لكمية زمن لا للحظة زمنية.

![ضبط حقل مدة في KayanOS للوقت المتوقع للخدمة.](https://kayanos.app/docs-images/ar/build/entity-fields/duration-settings.png)

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

### `boolean`

استخدم **القيمة المنطقية** لحقيقة واضحة نعم/لا.

![ضبط حقل منطقي في KayanOS لقرار زيارة ميدانية.](https://kayanos.app/docs-images/ar/build/entity-fields/boolean-settings.png)

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

### `date`

استخدم **التاريخ** ليوم تقويمي لا يهم فيه وقت اليوم.

![ضبط حقل تاريخ في KayanOS لتاريخ زيارة مطلوب.](https://kayanos.app/docs-images/ar/build/entity-fields/date-settings.png)

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

### `datetime`

استخدم **التاريخ والوقت** لحدث يقع في لحظة محددة.

![ضبط حقل تاريخ ووقت في KayanOS لموعد.](https://kayanos.app/docs-images/ar/build/entity-fields/date-time-settings.png)

* يناسب وقت الإرسال أو بدء الموعد أو وقت الاعتماد أو وقوع حادث أو تسليم رسالة.
* وضّح توقع المنطقة الزمنية للفرق التي تعمل في مواقع متعددة.
* استخدم نطاق التاريخ والوقت عندما يملك الحدث بداية ونهاية.
* افصل طابع التدقيق النظامي عن تاريخ عمل مثل «اكتملت المعاينة في».

### `time`

استخدم **الوقت** لساعة متكررة من دون يوم محدد.

![ضبط حقل وقت في KayanOS لوقت اتصال مفضل.](https://kayanos.app/docs-images/ar/build/entity-fields/time-settings.png)

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

### `date_range`

استخدم **نطاق التاريخ** لفترة لها بداية ونهاية تقويميتان.

![ضبط حقل نطاق تاريخ في KayanOS لفترة خدمة.](https://kayanos.app/docs-images/ar/build/entity-fields/date-range-settings.png)

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

### `datetime_range`

استخدم **نطاق التاريخ والوقت** لنافذة دقيقة لها لحظة بداية ونهاية.

![ضبط حقل نطاق تاريخ ووقت في KayanOS لنافذة معاينة.](https://kayanos.app/docs-images/ar/build/entity-fields/date-time-range-settings.png)

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

### `time_range`

استخدم **نطاق الوقت** لفاصل يومي متكرر من دون تاريخ.

![ضبط حقل نطاق وقت في KayanOS لساعات استقبال.](https://kayanos.app/docs-images/ar/build/entity-fields/time-range-settings.png)

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

### `select`

استخدم **الاختيار** لقائمة قيم مضبوطة يجب أن يختار منها الموظفون بصورة متسقة.

![ضبط حقل اختيار في KayanOS لفئة خدمة مضبوطة.](https://kayanos.app/docs-images/ar/build/entity-fields/select-settings.png)

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

### `file`

استخدم **الملف** للمستندات أو الصور أو المسح الضوئي أو المرفقات الأخرى.

![ضبط حقل ملف في KayanOS لمستند داعم.](https://kayanos.app/docs-images/ar/build/entity-fields/file-settings.png)

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

### `relation`

استخدم **العلاقة** لربط هذا السجل بكيان آخر في KayanOS.

![ضبط حقل علاقة في KayanOS لمفتش معين.](https://kayanos.app/docs-images/ar/build/entity-fields/relation-settings.png)

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

### `form_session`

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

![ضبط حقل جلسة نموذج في KayanOS لطلب مرتبط.](https://kayanos.app/docs-images/ar/build/entity-fields/form-session-settings.png)

* تفيد في تتبع إرسال نموذج عام أو داخلي إلى الجلسة التي أنشأت السجل أو حدّثته.
* استخدم العلاقة لعلاقة عمل عادية بين كيانين؛ جلسة النموذج خاصة بدورة حياة النموذج.
* اجعل حقول العمل في الكيان مفهومة وحدها. يجب أن يفهم المراجع حالة السجل من دون فتح جلسة النموذج.
* لا تجعل الجلسة بديلاً عن مالك مسؤول أو حالة عمل.

### `json`

استخدم **JSON** للبيانات المنظمة المتقدمة التي يحدد شكلها تكامل أو تصميم تقني مضبوط بعناية.

![ضبط حقل JSON في KayanOS لبيانات مرجعية خارجية منظمة.](https://kayanos.app/docs-images/ar/build/entity-fields/json-settings.png)

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

### `member_selector`

استخدم **محدد العضو** لعضو KayanOS مسؤول أو لأعضاء مسؤولين.

![ضبط حقل محدد عضو في KayanOS لمالك حالة.](https://kayanos.app/docs-images/ar/build/entity-fields/member-selector-settings.png)

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

### `avatar`

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

![ضبط حقل صورة رمزية في KayanOS لصورة مقدم طلب.](https://kayanos.app/docs-images/ar/build/entity-fields/avatar-settings.png)

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

### `location`

استخدم **الموقع** لمكان جغرافي يمكن عرضه على خريطة أو استخدامه لتوجيه الخدمة.

![ضبط حقل موقع في KayanOS لموقع خدمة.](https://kayanos.app/docs-images/ar/build/entity-fields/location-settings.png)

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

### `action`

استخدم **الإجراء** لعملية مضبوطة على مستوى السجل يستدعيها المستخدم عمداً.

![ضبط حقل إجراء في KayanOS لجدولة معاينة.](https://kayanos.app/docs-images/ar/build/entity-fields/action-settings.png)

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

### `status`

استخدم **الحالة** لمرحلة دورة حياة السجل.

![ضبط حقل حالة في KayanOS لحالة مراجعة مضبوطة.](https://kayanos.app/docs-images/ar/build/entity-fields/status-settings.png)

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

## صمّم التخطيط بحسب العمل

يقرأ موظف الاستقبال والمراجع والمدير والمدقق السجل نفسه بطرق مختلفة. يجب أن يقلل التخطيط الضوضاء من دون إخفاء الحقائق اللازمة للقرار التالي.

### بنية مقترحة لسجل خدمة

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

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

## اضبط تجربة تفاصيل السجل

### اختر الصورة الأساسية للكيان

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

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

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

اضبط عرض التفاصيل عن قصد:

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

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

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

## مراجعة تصميم قبل النشر

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

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

* تعلّم إنشاء السجلات وربطها في [الكيانات](/ar/build/entities).
* اضبط المراجع الدائمة في [المعرّفات التسلسلية](/ar/build/serial-ids).
* ابنِ القيم المشتقة واختبرها في [الحقول المحسوبة](/ar/build/calculated-fields).
* استخدم [التعبيرات في المنشئ](/ar/build/expressions-in-builder) للحقول المحسوبة والقواعد الشرطية.
* ابنِ مسار إدخال واضحاً في [النماذج](/ar/build/forms).

![إعداد حقول الكيان وتخطيطه في KayanOS](https://kayanos.app/docs-images/ar/build/entity-fields-and-layouts.png)