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مبكرًا.

