> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# مجموعة المشاريع (Projects)

يمثل `Project` مشروع LaTeX واحدًا في Overleaf. ويخزّن البيانات الوصفية للمشروع، والملكية والتحكم في الوصول، وبنية الملفات، وإعدادات الترجمة، وحالة التعاون.

#### التعريف الأساسي والبيانات الوصفية

* `_id`: معرّف ObjectId فريد في MongoDB يحدد المشروع.
* `name`: اسم المشروع المعروض.
* `description`: وصف نصي اختياري للمشروع.
* `active`: يشير إلى ما إذا كان المشروع نشطًا حاليًا.
* `version`: إصدار المخطط الداخلي أو تنسيق المشروع.
* `trashed`: قائمة العناصر المنقولة إلى سلة المهملات (محذوفة حذفًا ناعمًا).
* `deletedDocs`: سجلات المستندات المحذوفة نهائيًا.

#### الملكية والتحكم في الوصول

* `owner_ref`: مرجع إلى المستخدم المالك للمشروع.
* `collaberator_refs`: المستخدمون الذين لديهم صلاحيات التحرير.
* `reviewer_refs`: المستخدمون الذين لديهم وصول بمستوى المراجع.
* `readOnly_refs`: المستخدمون الذين لديهم وصول للقراءة فقط.
* `pendingEditor_refs` / `pendingReviewer_refs`: الدعوات المعلّقة.

#### الوصول القائم على الرموز (Tokens)

* `tokens`: سجل الرموز الخاصة بالروابط المشتركة.
* `tokenAccessReadOnly_refs`: الرموز التي تمنح وصولًا للقراءة فقط.
* `tokenAccessReadAndWrite_refs`: الرموز التي تمنح وصولًا للقراءة والكتابة.

#### تتبع النشاط

* `lastUpdated`: الطابع الزمني لآخر تعديل.
* `lastUpdatedBy`: المستخدم الذي أجرى آخر تحديث.
* `lastOpened`: الطابع الزمني لآخر مرة فُتح فيها المشروع.
* `deletedByExternalDataSource`: ما إذا كان الحذف قد تم بواسطة تكامل خارجي.

#### بنية المشروع

المستند الجذر والمجلد الجذر

* `rootDoc_id`: معرّف ObjectId لمستند LaTeX الرئيسي (عادةً `main.tex`).
* `rootFolder`: تمثيل مضمَّن لشجرة ملفات المشروع.

يحتوي كل إدخال مجلد على:

* `name` / `_id`: اسم المجلد ومعرّفه.
* `docs`: قائمة بمستندات مصدر LaTeX مع الاسم و`_id`.
* `fileRefs`: مراجع الملفات الثنائية (الصور، ملفات البيانات)، وتتضمن:
  * `name`: اسم الملف
  * `created`: الطابع الزمني للرفع
  * `rev`: عدّاد المراجعات
  * `hash`: تجزئة المحتوى لإزالة التكرار
  * `linkedFileData`: الربط بتخزين خارجي (إن وُجد)
* `folders`: المجلدات الفرعية المتداخلة.

#### إعدادات الترجمة والمحرر

* `compiler`: محرك LaTeX المحدد (`pdflatex`، `xelatex`، `lualatex`، إلخ).
* `spellCheckLanguage`: لغة المدقق الإملائي لهذا المشروع.

#### إعدادات الإتاحة العامة والمشاركة

* `publicAccesLevel`: مستوى ظهور المشروع (`private`، `readOnly`، `public`، إلخ).
* `collabratecUsers`: المستخدمون المرتبطون من منصات تعاون خارجية.

#### امتدادات خاصة بـ Overleaf

* `overleaf.history`:
  * `id`: المعرّف المستخدم من قِبل خدمة السجل.
  * `display`: ما إذا كان السجل مفعّلًا ومرئيًا.

#### الإصدارات الداخلية

* `__v`: مفتاح الإصدار الداخلي في Mongoose للتحكم في التزامن.

فيما يلي مثال حقيقي لمشروع في Overleaf.

<Accordion title="مثال على مشروع">
  ```json5 theme={null}
  {
      _id: ObjectId('69686c09bcb72ccea226ff33'),
      name: 'overleaf-example',
      lastUpdated: ISODate('2026-01-15T04:25:34.637Z'),
      lastUpdatedBy: ObjectId('696868f6bcb72ccea226fe5f'),
      lastOpened: ISODate('2026-01-15T04:25:22.286Z'),
      active: true,
      owner_ref: ObjectId('696868f6bcb72ccea226fe5f'),
      collaberator_refs: [],
      reviewer_refs: [],
      readOnly_refs: [],
      pendingEditor_refs: [],
      pendingReviewer_refs: [],
      rootDoc_id: ObjectId('69686c09bcb72ccea226ff38'),
      rootFolder: [
          {
              name: 'rootFolder',
              _id: ObjectId('69686c09bcb72ccea226ff32'),
              docs: [
                  {
                      name: 'main.tex',
                      _id: ObjectId('69686c09bcb72ccea226ff38')
                  },
                  {
                      name: 'sample.bib',
                      _id: ObjectId('69686c09bcb72ccea226ff3f')
                  }
              ],
              fileRefs: [
                  {
                      name: 'frog.jpg',
                      created: ISODate('2026-01-15T04:24:41.963Z'),
                      rev: 0,
                      linkedFileData: null,
                      hash: '5b889ef3cf71c83a4c027c4e4dc3d1a106b27809',
                      _id: ObjectId('69686c09bcb72ccea226ff45')
                  }
              ],
              folders: []
          }
      ],
      version: 3,
      publicAccesLevel: 'private',
      compiler: 'pdflatex',
      spellCheckLanguage: 'en',
      deletedByExternalDataSource: false,
      description: '',
      trashed: [],
      deletedDocs: [],
      tokens: {},
      tokenAccessReadOnly_refs: [],
      tokenAccessReadAndWrite_refs: [],
      overleaf: {
          history: {
              id: '69686c09bcb72ccea226ff33',
              display: true
          }
      },
      collabratecUsers: [],
      __v: 0
  }
  ```
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.