مجموعة المشاريع (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.

مثال على مشروع

{
    _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
}