الانتقال إلى المحتوى الرئيسي
تحتوي projectHistoryChunks على مستند واحد لكل جزء (chunk) من السجل التاريخي، وهو سلسلة من الإصدارات في السجل التاريخي لمشروع واحد. لا يحتفظ Mongo إلا بالبيانات الوصفية للجزء؛ أما الجزء نفسه (لقطة إضافةً إلى التغييرات بعدها) فهو كائن JSON مضغوط بـ gzip في حاوية الأجزاء. لا يوجد مخطط Mongoose: يكتب history-v1 المجموعة في services/history-v1/storage/lib/chunk_store/mongo.js، الذي يستخدمه لكل معرّف سجل مكوّن من 24 حرفًا سداسيًا عشريًا، كما في CE ‏(services/history-v1/storage/lib/chunk_store/index.js:644-652).

الحقول

من يكتب فيها

تأتي الأجزاء الجديدة من project-history، الذي يرسل التعديلات المنتظرة في الطابور إلى POST /projects/:project_id/legacy_changes في history-v1 ‏(services/history-v1/api/routes/project_import.js:29-31)؛ ثم يستدعي history-v1 ‏chunkStore.update أو chunkStore.create ‏(services/history-v1/storage/lib/persist_changes.js:215, 229). يحصل المشروع الجديد على أول جزء له من chunkStore.initializeProject ‏(chunk_store/index.js:54-80).

من يقرأ منها

الفهارس

ملاحظات

  • تسلسل الحالات: ‏pending (السجل مكتوب، والرفع جارٍ) → active (أحدث جزء، ويمكن توسيعه بعد) → closed (يليه جزء أحدث) أو deleted (استُبدل، أو حُذف المشروع). لا تنظر القراءات إلا إلى active وclosed.
  • كائن الجزء هو JSON مضغوط بـ gzip ‏(services/history-v1/storage/lib/history_store.js:151-170) عند المفتاح <project key>/<chunk id> ‏(history_store.js:65-67). مفتاح المشروع هو معرّف السجل مُكمَّلًا بالأصفار، معكوسًا ومقسّمًا إلى 3/3/بقية الأحرف (libraries/object-persistor/src/ProjectKey.js:8-15). الحاوية هي OVERLEAF_EDITOR_CHUNKS_BUCKET ‏(services/history-v1/config/custom-environment-variables.json:53-56): ‏/buckets/chunks في بيئة التطوير (develop/docker-compose.yml:90)، أو overleaf-chunks مع S3_ENABLED=true ‏(develop/s3/docker-compose.yml:51).
  • لا يزيل السجلات بالحالة deleted أو pending، ولا كائناتها في الحاوية، إلا delete_old_chunks.js ‏(yarn delete_old_chunks، ‏services/history-v1/package.json:79). لا تحتوي صورة CE على مهمة cron لذلك (server-ce/config/crontab-history, server-ce/config/crontab-deletion)، لذا تبقى في CE.
  • عندما يُنهي web مشروعًا محذوفًا، يستدعي DELETE /projects/:history_id في history-v1 ‏(services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391, HistoryManager.mjs:127-135, 152-162)، فتُوضع على جميع أجزاء المشروع علامة deleted.
  • عند ضبط backupStore، يكتب تأكيد الجزء أيضًا overleaf.history.currentEndVersion وcurrentEndTimestamp وupdatedAt وoverleaf.backup.pendingChangeAt في المشروع (mongo.js:232-262). لا يضبط CE ‏backupStore، لذا تعود mongo.js:238-240 مبكرًا.
آخر تعديل في ٢١ نوفمبر ٢٠٢٦