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

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

![إعداد لوحة KayanOS لعبء عمل طلب خدمة مواطن.](https://kayanos.app/docs-images/ar/build/dashboards.png)

## نموذج اللوحة

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

لا تنشئ لوحة «كل الخدمات» واحدة ضخمة. ابنِ عروضاً صغيرة موجهة للغرض: عبء الاستقبال أو إكمال المعاينات أو تراكم القرارات أو أداء مركز الخدمة الأسبوعي.

## اختر العنصر حسب القرار

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

استخدم أصغر تصور يدعم القرار. يمكن لـKPI بلا مقام أو نطاق تاريخ أن يضلل؛ وقد تكون خريطة بمواقع حالات حساسة غير مناسبة حتى لو كانت سجلات المصدر مرئية لفريق ضيق.

## ابنِ لوحة عبء عمل خطوة بخطوة

### 1. حدد المقاييس بلغة عادية

للوحة عبء العمل، اكتب:

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

لا تسمِّ حقلاً «مغلقاً» لمجرد أنه غير فارغ. اتفق على حقل الحالة/القالب/التاريخ الدقيق مع مالك الخدمة قبل بناء العنصر.

### 2. اضبط مصدر البيانات عن قصد

للعناصر المدعومة بكيان، اختر الكيان والحقول اللازمة للتصور فقط: `status` و`service_centre` وتاريخ الإنشاء/الإغلاق والمرجع ومؤشر عبء غير حساس. للعناصر اليدوية، اذكر المالك ودورية التحديث ووثيقة مصدر الحقيقة وتاريخ آخر تحديث. لا تمزج بيانات يدوية وبيانات كيان في مقياس واحد بلا وسم الفرق.

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

### 3. طبق المرشحات الثابتة أولاً

تجيب المرشحات الثابتة السؤال المستقر، مثال:

```txt theme={null}
entity: service_requests
status: not closed
service_centre: central
```

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

### 4. أضف مرشحات المشاهد بحذر

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

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

تضيق المرشحات الاستعلام ولا توسع صلاحيات السجل. إذا لم يملك المشاهد وصول سجل المصدر، قد يعرض العنصر رفض صلاحية أو نتيجة فارغة حتى لو فتحت اللوحة.

### 5. رتب العرض ونسخه وانشره

اجمع عناصر عبء العمل حسب السؤال: KPIs عامة وجدول طابور واتجاه زمني ثم قسم استثناء/معاينة. امنح كل عنصر عنواناً يذكر الكيان والمقياس وأساس الوقت والنطاق، مثل «طلبات خدمة المواطن المفتوحة — مركز الخدمة المركزي — الأسبوع الحالي».

استخدم عملية تغيير ذات إصدار:

1. حرر إصدار مسودة/مراجعة ببيانات غير إنتاجية أو محدودة معتمدة.
2. قارن التصور بعد يدوي ومجموعة سجلات مصدر معروفة.
3. اطلب من مالك المقياس تأكيد التسميات والمرشحات وتعريفات الحالة والجمهور.
4. انشر/عيّن الإصدار المعتمد حسب سير اللوحة الصادر.
5. سجل ملاحظة تغيير عند تبدل حقل مصدر أو مرشح أو مقام أو نطاق وصول.

تغيير عنصر من يدوي إلى مدعوم بكيان، أو إضافة حقل، أو توسيع مرشح قد يكون تغيير وصول بيانات وكذلك تغيير تصميم.

## وصول البيانات والخصوصية

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

قبل نشر أي عنصر أجب:

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

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

## وضع المشاهد والطباعة والتصدير

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

قبل التصدير أو الطباعة:

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

## مصفوفة الاختبار

| الاختبار              | النتيجة المتوقعة                                                                   |
| --------------------- | ---------------------------------------------------------------------------------- |
| صحة المصدر            | يظهر سجل معروف مرة واحدة بالضبط في العنصر المقصود ولا يظهر في عنصر غير ذي صلة.     |
| صحة المرشح            | تشمل المرشحات الثابتة ومرشحات المشاهد السجلات المضبوطة المتوقعة/تستبعدها.          |
| صفر مقابل خطأ         | يمكن تمييز نتيجة فارغة حقيقية من فشل صلاحية/إعداد.                                 |
| النطاق                | لا يستطيع مشاهد مركز الخدمة المركزي الحصول على تفصيل مركز آخر بتغيير مرشح.         |
| التجميع               | تطابق مجاميع KPI/المخطط عدّاً يدوياً مراجعاً لنطاق تاريخ صغير.                     |
| دلالات الحالة/التاريخ | تستخدم مقاييس الوارد/المغلق أساس الحالة والتاريخ المعتمدين.                        |
| مصدر يدوي             | يظهر المالك وتاريخ التحديث والمصدر ويمكن تسوية القيمة.                             |
| تغيير الإصدار         | يراجع العنصر/المرشح المتغير قبل اعتماد المشاهدين عليه.                             |
| طباعة/PDF             | تكون العناصر المحملة والمرشحات والعناوين واللغة والبيانات الحساسة صحيحة في الناتج. |

## استكشاف الأخطاء وإصلاحها

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

## الأذونات وحدود جودة البيانات

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

## أدلة ذات صلة

* [الكيانات](/ar/build/entities)
* [الحقول المحسوبة](/ar/build/calculated-fields)
* [الصلاحيات والإتاحة](/ar/reference/permissions-and-availability)
* [مرجع الواجهة البرمجية العامة](/ar/reference/public-api)
* [استكشاف الأخطاء وإصلاحها](/ar/reference/troubleshooting)