الانتقال إلى المحتوى الرئيسي
تحتفظ docs بمحتوى الملفات النصية القابلة للتحرير في المشروع (يسميها Overleaf ‏docs)، مثل main.tex أو sample.bib. مستند واحد لكل doc: أسطره، وتعليقاته وتغييراته المتتبَّعة، وعدّادان، وحالة الحذف. اسم الملف وموقعه في الشجرة ليسا هنا بل في projects.rootFolder (راجع مجموعة المشاريع (Projects)). والملفات الثنائية ليست هنا كذلك. باستثناء عمليات الترحيل وسكربتات الصيانة، لا يكتب في هذه المجموعة إلا docstore، في services/docstore/app/js/MongoManager.js. لا يوجد نموذج Mongoose؛ يصل إليها web وdocument-updater عبر واجهة HTTP البرمجية لـ docstore ‏(services/docstore/app.js:31-70). في عمود المصدر، أسماء الملفات المجردة موجودة تحت services/docstore/app/js/.

الحقول

Ranges

يحتوي ranges على مصفوفتين. يبنيهما document-updater باستخدام libraries/ranges-tracker/index.cjs؛ ويحوّل docstore المعرّفات إلى ObjectId وts إلى Date قبل الحفظ (RangeManager.js:41-63). ‏doc بلا تعليقات أو تغييرات متتبَّعة يكون فيه ranges: {} أو لا يكون فيه ranges. نص التعليق وردوده ليس في docs: بل في المجموعة messages، في الـ room الذي يكون thread_id الخاص به هو معرّف التعليق. يُخزَّن ما إذا كان التعليق قد حُلّ على تلك الغرفة، وليس هنا؛ ويتجاهل docstore العلامة resolved إذا أُرسلت (RangeManager.js:59-61). راجع مجموعة Rooms ومجموعة Messages.

من يكتب فيها

من يقرأ منها

الفهارس

جميعها من عمليات ترحيل تحمل الوسم server-ce في tools/migrations/.

ملاحظات

  • أثناء فتح doc، يكون أحدث نص له في document-updater ‏(Redis)، وليس هنا. لا يُحدَّث Mongo إلا عندما يُجري document-updater عملية flush ‏(services/document-updater/app/js/PersistenceManager.js:128-160). على الشيفرة التي تقرأ docs مشروع كامل أن تستدعي flushProjectToMongo أولًا، كما يفعل ProjectDuplicator.
  • تبقى docs المحذوفة في هذه المجموعة، مع deleted: true، حتى يُتلف المشروع. يعيد docstore منها MAX_DELETED_DOCS على الأكثر (2000 افتراضيًا)، الأحدث أولًا (MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40). لا تستخدمها لوحة السجل التاريخي؛ بل تقرأ history-v1.
  • لا علاقة للعدّادين rev وversion بإصدارات السجل التاريخي للمشروع في history-v1.
فيما يلي أمثلة حقيقية لـ docs في Overleaf.
آخر تعديل في ٢١ نوفمبر ٢٠٢٦