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

يستخدم هذا الدليل سيناريو تدريبياً لـ **مديرية خدمات المواطنين**. يُسجل طلب المواطن بالمرجع `CSR-2026-00042`، ويراجعه فريق الخدمة، ويُحدد له موعد معاينة عند الحاجة، وتُحفظ أدلته في موقع مضبوط، ثم يُغلق بنتيجة مسجلة. استخدم السيناريو لفهم نمط التصميم، ثم استبدل حقوله وأدواره وقواعده بما تعتمده مؤسستك.

## الهدف

بنهاية هذا الدليل تستطيع وصف خدمة واحدة منذ الاستقبال حتى الإغلاق، وتحديد:

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

## ما الذي يوضع في كل مكان؟

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

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

فمثلاً يحتفظ الطلب `CSR-2026-00042` ببيانات الخدمة وحالته ومالكه ومرجعه التسلسلي ونتيجته النهائية. أما المعاينة فهي سجل مرتبط لأنها تحتاج تاريخاً ومكاناً ومفتشاً ونتائج وملفات وحالة خاصة بها. وتُكلف مهمة موظف السجل بفحص اكتمال الطلب، ويحجز حدث التقويم وقت المعاينة، وتحفظ المكتبة التقرير، ويعيد الإشعار الشخص المسؤول إلى المهمة أو السجل الصحيح.

## اتبع طلباً من الاستقبال إلى الإغلاق

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

1. **سجّل الطلب.** يقدّم المواطن أو الموظف نموذج الاستقبال. ينشئ KayanOS سجل الخدمة أو يحدّثه ويمنحه مرجعاً مقروءاً متفقاً عليه مثل `CSR-2026-00042`.
2. **تحقق من الاكتمال.** يفتح موظف السجل الطلب ويتحقق من الفئة وطريقة التواصل والموقع والأدلة المطلوبة ورسائل التحقق. يسجل النتيجة على السجل ويكمل المهمة المرتبطة أو يعيدها.
3. **عيّن العمل المسؤول.** يصبح مدير الخدمة مالك السجل أو يعيّن مالكاً وفق سياسة الخدمة. ويمكن إسناد المهمة للشخص الذي ينفذ الإجراء التالي؛ ولا يضاف المساهمون أو المطلعون إلا إذا كان لهم دور فعلي.
4. **جدوِل نشاط الخدمة.** عند الحاجة إلى زيارة ميدانية، أنشئ حدثاً بالحضور الداخليين والمنطقة الزمنية الصحيحة والموقع أو القاعة وبنود الاجتماع والخطوات التالية. الحدث ينسق الوقت، ولا يحل محل سجل المعاينة.
5. **سجّل النتائج والأدلة.** ينشئ المفتش أو يحدّث سجل المعاينة المرتبط، ويرفع الدليل إلى موقع مضبوط، ويضيف ملاحظة تشغيلية مختصرة. تحفظ النتيجة الواقعية في السجل، لا في محادثة أو بريد فقط.
6. **راجع واتخذ القرار.** يفحص المراجع المخول السجل والأدلة والسياسة المنطبقة. إذا تطلب الأمر توقيعاً أو قرار نموذج مضبوطاً، استخدم مسار النموذج/التوقيع المهيأ؛ لا تعامل إكمال مهمة على أنه دليل موافقة رسمية.
7. **تواصل بحذر.** يجهز مستخدم البريد المخول الرسالة بعد التحقق من الحساب وهوية المرسل والمستلم والمرجع واللغة والمرفقات. المسودة المحفوظة ليست تسليماً، وقد تظهر نتيجة الإرسال فشلاً أو تسليماً جزئياً.
8. **أغلق وقِس.** حدّث الحالة المعتمدة وسجل النتيجة والالتزام التالي وأكمل المهام المتبقية ثم راجع الحمل في لوحة المعلومات. يظل السجل، لا رقم لوحة المعلومات، مصدر الحقيقة للطلب الفردي.

## الوصول جزء من تصميم الخدمة

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

1. **ما المورد المحمي؟** مثل طلبات الخدمة أو المعاينات أو الأحداث أو الملفات أو النماذج أو الأدوار.
2. **ما الإجراء المطلوب؟** سرد طابور أو فتح سجل أو إنشاء مهمة أو تحديث نتيجة أو حذف حدث أو مشاركة ملف؛ كلها إجراءات مختلفة.
3. **ما النطاق؟** قد يعمل العضو داخل مركز خدمة أو عقدة أو نموذج أو نطاق معتمد آخر فقط.
4. **كيف ستتحقق؟** اختبر بعضو مخول غير مالك للسجل، إضافة إلى المدير أو المسؤول، وتحقق من الفعل المسموح والفعل الذي يجب أن يبقى مرفوضاً.

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

## تسلسل موثوق للأسبوع الأول

استخدم التسلسل التالي لأول إصدار للخدمة. لكل خطوة مخرج محدد يراجعه مالك الخدمة.

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

## النتيجة المتوقعة

لديك مسار خدمة صغير وقابل للمراجعة يستطيع كل موظف معه الإجابة عن: «ما هو الطلب؟ من يملك الإجراء التالي؟ ما الدليل الذي يدعم الحالة الحالية؟ وماذا سيحدث لاحقاً؟». إذا احتاجت الإجابة إلى البحث في جدول منفصل ومحادثة وصندوق بريد، فحسّن نموذج السجل قبل توسيع الخدمة.

## اختبار آمن

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

## أخطاء شائعة

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

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

* تعلّم مفردات النموذج في [المفاهيم الأساسية](/ar/start/core-concepts).
* ابنِ وصولاً بأقل امتياز في [الأدوار والوصول](/ar/start/roles-and-access).
* اتبع السيناريو الكامل في [استكشاف مساحة عمل نموذجية](/ar/start/example-workspace).
* صمم السجل قبل التنفيذ في [تخطيط التطبيق قبل بنائه](/ar/build/plan-an-app).
* اضبط المرجع في [المعرّفات التسلسلية](/ar/build/serial-ids) والقيم المشتقة في [الحقول المحسوبة](/ar/build/calculated-fields).

![مساحة عمل KayanOS الرئيسية](https://kayanos.app/docs-images/ar/start/overview.png)