تحتفظ projects بمستند واحد لكل مشروع: الاسم، والمالك والأعضاء، والمشاركة، وشجرة الملفات، وإعدادات المشروع. نص المستندات ليس هنا (راجع مجموعة Docs)، أما الملفات الثنائية فتوجد في مخزن الكائنات الثنائية (blob) الخاص بـ history-v1 تحت قيمة hash الخاصة بها. المخطط هو services/web/app/src/models/Project.mjs، وشجرة الملفات في Folder.mjs وFile.mjs وDoc.mjs بجانبه.في عمود المصدر، يشير Project.mjs:N إلى سطر في ذلك المخطط، وتقع أسماء الملفات الأخرى غير المسبوقة بمسار ضمن services/web/app/src/Features/، ويقع modules/... ضمن services/web/. أرقام الأسطر مأخوذة من server-pro وقت الكتابة.
التعريف الأساسي والبيانات الوصفية
الحقل
النوع
المعنى
المصدر
_id
ObjectId
معرّف المشروع.
MongoDB
name
String
اسم المشروع.
Project.mjs:18
description
String
وصف المشروع. فارغ افتراضيًا.
Project.mjs:50
version
Number
يزداد بمقدار 1 مع كل تغيير في شجرة الملفات (إضافة، إعادة تسمية، نقل، حذف، استبدال).
تصبح false بعد إلغاء تنشيط المشروع: إذ تُؤرشف مستنداته خارج Mongo (docs.inS3). يؤدي فتح المشروع إلى إلغاء أرشفتها وإعادة القيمة إلى true. في CE لا تعمل مهمة cron التي تلغي تنشيط المشاريع القديمة إلا مع ENABLE_CRON_RESOURCE_DELETION=true.
حقل قديم، { _id, name, deletedAt }. تبقى المستندات المحذوفة الآن في docs مع deleted: true. لا تُقرأ هذه المصفوفة إلا عند استعادة مشروع محذوف قديم: تُنسخ الإدخالات إلى docstore وتُفرَّغ المصفوفة. لا شيء يكتب فيها.
موجود في المخطط فقط: لا تستخدمه نواة CE ولا وحداتنا.
Project.mjs:28
الملكية والتحكم في الوصول
الحقل
النوع
المعنى
المصدر
owner_ref
ObjectId
المالك.
Project.mjs:29
collaberator_refs
Array of ObjectId
المستخدمون الذين يمكنهم التحرير (هذا الإملاء هو اسم الحقل الفعلي).
Project.mjs:30
reviewer_refs
Array of ObjectId
المستخدمون الذين يمكنهم المراجعة: التعليق والاقتراح مع تتبّع التغييرات.
Project.mjs:31
readOnly_refs
Array of ObjectId
المستخدمون الذين يمكنهم العرض فقط.
Project.mjs:32
pendingEditor_refs / pendingReviewer_refs
Array of ObjectId
ليست دعوات (الدعوات موجودة في projectInvites). مستخدمون أُضيفوا كمحررين أو مراجعين في وقت لم يكن لدى المالك فيه مقعد متعاون شاغر. يُضافون إلى readOnly_refs ويُدرجون هنا إلى أن تمكن ترقيتهم.
المشاهدون الذين طلبوا وصولًا أكبر: userId وprivilegeLevel وrequestedAt. إدخال واحد لكل مستخدم. يُزال عند قبول الطلب أو رفضه، أو عند مغادرة المستخدم للمشروع.
حالة تتبّع التغييرات. تعني true أنه مفعّل للجميع (التنسيق القديم)؛ وإلا فهو كائن مفاتيحه معرّفات المستخدمين مع true لكل مستخدم فعّله. تكتبه الوحدة track-changes، وتفعّله النواة للمستخدم الذي يُعيَّن مراجعًا.
روابط IEEE Collabratec: user_id وcollabratec_document_id وcollabratec_privategroup_id وadded_at. غير مستخدم في CE.
Project.mjs:104-116
المشاركة عبر الرابط
الحقل
النوع
المعنى
المصدر
publicAccesLevel
String
private أو tokenBased (المشاركة عبر الرابط مفعّلة). قد تحتوي المشاريع القديمة على القيم القديمة readOnly أو readAndWrite. لا توجد قيمة public. هذا الإملاء هو اسم الحقل الفعلي.
صورة TeX Live المستخدمة لهذا المشروع مع الترجمة في بيئة معزولة. يحصل المشروع الجديد على Settings.currentImageName؛ ويمكن لمعرض القوالب وخادم MCP تغييرها.
بيانات استيراد overleaf.com v1. لا تُعيَّن في CE. لـ overleaf.id فهرس فريد.
Project.mjs:88-91
__v
Number
مفتاح إصدار Mongoose.
Mongoose
يمكن لـ history-v1 أيضًا كتابة overleaf.history.currentEndVersion وoverleaf.history.currentEndTimestamp وoverleaf.history.updatedAt وoverleaf.backup.*، ولكن فقط عند تهيئة backupStore الخاص به (services/history-v1/storage/lib/chunk_store/mongo.js:238-258). لا يهيئه CE، لذا لا تظهر هذه الحقول.
الفهارس
تأتي جميعها من عمليات الترحيل الموسومة بـ server-ce في tools/migrations/.
الاسم
المفاتيح
الخيارات
الترحيل
owner_ref_1
owner_ref: 1
20190912145024_create_projects_indexes
collaberator_refs_1
collaberator_refs: 1
20190912145024_create_projects_indexes
readOnly_refs_1
readOnly_refs: 1
20190912145024_create_projects_indexes
tokenAccessReadOnly_refs_1
tokenAccessReadOnly_refs: 1
20190912145024_create_projects_indexes
tokenAccessReadAndWrite_refs_1
tokenAccessReadAndWrite_refs: 1
20190912145024_create_projects_indexes
tokens.readOnly_1
tokens.readOnly: 1
unique, partial (field exists)
20190912145024_create_projects_indexes
tokens.readAndWrite_1
tokens.readAndWrite: 1
unique, partial
20190912145024_create_projects_indexes
tokens.readAndWritePrefix_1
tokens.readAndWritePrefix: 1
unique, partial
20190912145024_create_projects_indexes
overleaf.history.id_1
overleaf.history.id: 1
unique, partial
20190912145024_create_projects_indexes
overleaf.id_1
overleaf.id: 1
unique, partial
20190912145024_create_projects_indexes
collabratecUsers.user_id_1
collabratecUsers.user_id: 1
sparse
20190912145024_create_projects_indexes
imageName_1
imageName: 1
20240730155209_create_project_imageName_index
reviewer_refs_1
reviewer_refs: 1
20241204103349_create_reviewer_refs_index
active_true_lastOpened_1
lastOpened: 1
partial (active: true)
20250320161029_update_inactive_project_index
ملاحظات
خيار autoIndex في Mongoose معطّل (services/web/app/src/infrastructure/Mongoose.mjs:7): لا توجد خيارات index في المخطط إلا لأن عمليات الترحيل أعلاه تنشئها.