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

# المكتبة

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

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

في سيناريو مديرية خدمات المواطنين، يحفظ تقرير المعاينة وقالب الرد المعتمد للطلب `CSR-2026-00042` في مساحة الخدمة المحددة. يحتفظ سجل الطلب بحقائق الخدمة وروابط الدليل المطلوب؛ وتحفظ المكتبة الملفات في موضع يستطيع الفريق الصحيح حوكمته.

## الهدف

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

## اختر المساحة قبل الرفع

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

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

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

## ابنِ مسار دليل مضبوطاً

في سيناريو مديرية خدمات المواطنين، استخدم بنية متوقعة تطابق نموذج الخدمة:

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

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

## إجراءات الملفات والمجلدات

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

استخدم الحدود التالية:

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

## سلة المحذوفات مقابل الحذف النهائي

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

قبل الحذف النهائي، اسأل:

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

## الإتاحة والوصول

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

عند غياب إجراء ملف، تحقق من:

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

## اختبار آمن

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

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

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

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

* تواصل بنتيجة مراجعة عبر [البريد الإلكتروني](/ar/work/email).
* حافظ على المتابعة المسؤولة في [المهام والموافقات](/ar/work/tasks-and-approvals).
* صمم حقول الملفات وتخطيطات السجل في [حقول الكيانات وتخطيطاتها](/ar/build/entity-fields-and-layouts).
* راجع حدود النطاق في [الأدوار والوصول](/ar/start/roles-and-access) و[الصلاحيات والإتاحة](/ar/reference/permissions-and-availability).

![مكتبة KayanOS بمواد مضبوطة لفريق خدمة عامة](https://kayanos.app/docs-images/ar/work/library.png)
