> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ar/idarh-almstkhdmyn-walmsharya/project-management.md).

# إدارة المشاريع

### عرض سجل تدقيق مشروع

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

* ابحث عن المستخدم
* انقر على زر **المشاريع** علامة التبويب
* حدد مشروعًا
* انقر على أيقونة (i)
* انقر على زر **سجل التدقيق** علامة التبويب

إذا تمت مشاركة مشروع مع متعاون مُسمّى (باستخدام عنوان بريده الإلكتروني)، فبمجرد أن ينضم المستلم، سيُدرج في نافذة المشاركة مع صلاحياته ويكون مرئيًا لمالك المشروع. ستظهر هذه المعلومات أيضًا للمسؤولين عند عرض علامة تبويب معلومات المشروع للمشروع عبر لوحة الإدارة.

### استعادة المستندات المحذوفة

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

سيأخذ الملف المستعاد التنسيق التالي: `اسم_الملف-الطابع_الزمني.الامتداد`. على سبيل المثال، ستُستعاد نسخة من `main.tex` إلى جذر المشروع باسم الملف `main-2024-02-23-130441542.tex`.

### نقل ملكية مشروع

تحتوي لوحة الإدارة في Server Pro على صفحة مخصصة لكل مشروع. يمكنك الوصول إليها إما بالبحث عن المستخدم على "/admin/user"، ثم الانتقال إلى **المشاريع** علامة التبويب الخاصة به، والعثور على المشروع في القائمة والنقر على أيقونة المعلومات؛ أو بالانتقال مباشرةً إلى الصفحة باستخدام معرّف مشروع معروف [**https://your-instance-url/admin/project/**](https://your-instance-url/admin/project/). في صفحة معلومات المشروع، يمكنك العثور على **نقل الملكية** زر، يفتح نافذة يمكنك فيها تحديد أي مستخدم كمالك جديد. لا يلزم أن يكون المالك الجديد متعاونًا حاليًا في المشروع.

{% hint style="info" %}
لاحظ أن المالك السابق سيُضاف كمتعاون لديه صلاحية القراءة والكتابة للمشروع كجزء من عملية نقل الملكية.
{% endhint %}

### تحديث مهلة تجميع المشروع 

تم حاليًا ضبط مهلة التجميع الافتراضية للمشاريع على 180 ثانية. يمكن تغيير هذه القيمة ويتطلب ذلك عملية من خطوتين.

أولًا، عدّل **config/variables.env** الملف وأضف `COMPILE_TIMEOUT`متغير البيئة واضبط قيمته على المهلة المطلوبة بالثواني. على سبيل المثال، `COMPILE_TIMEOUT=300` لمدة 5 دقائق.

{% hint style="danger" %}
لا يستحق الأمر رفع المهلة إلى ما بعد 10 دقائق. إذا فعلت ذلك، فمن المرجح أن تواجه مهلة في مكون آخر من التطبيق.
{% endhint %}

بعد إجراء هذا التغيير، ستحتاج إلى إعادة إنشاء **sharelatex** الحاوية عن طريق تشغيل `bin/up -d`الأمر.

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

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

يمكنك العثور على معلومات حول إجراء النسخ الاحتياطية [هنا](/on-premises/ar/alsyanh/data-and-backups.md).

لتحديث قيمة مهلة التجميع لجميع المستخدمين الحاليين، ستحتاج إلى تشغيل أمر الصدفة التالي على مضيف Docker:

{% code overflow="wrap" %}

```bash
echo 'db.users.updateMany({}, {$set: {"features.compileTimeout": <value>}})' | docker exec -i mongo mongosh --quiet localhost/sharelatex
```

{% endcode %}

ستحتاج إلى استبدال `<value>` في الاستعلام أعلاه بالقيمة المطلوبة للمهلة بالثواني.

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

### تتبع وصول المشروع

يمكن معرفة من ومتى تم تحميل مشروع باستخدام الأمر التالي:

{% code overflow="wrap" %}

```bash
docker exec sharelatex bash -c 'grep "join project request" /var/log/overleaf/web.log'
```

{% endcode %}

سيعطيك كلا من `الطابع الزمني`, `معرّف_المستخدم` و `معرّف_المشروع`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ar/idarh-almstkhdmyn-walmsharya/project-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.