الانتقال إلى المحتوى الرئيسي
تحتوي projectHistoryBlobs على مستند واحد لكل سجل تاريخي لمشروع: البيانات الوصفية (التجزئة والأحجام) لكل blob خزّنه history-v1 لذلك المشروع. الـ blob هو محتوى ملف أو doc عند نقطة ما من سجله التاريخي. البايتات نفسها كائنات في حاوية blobs المشروع. لا يوجد مخطط Mongoose: يكتب history-v1 المجموعة في services/history-v1/storage/lib/blob_store/mongo.js، الذي يستخدمه لمعرّفات السجل المكوّنة من 24 حرفًا سداسيًا عشريًا، كما في CE ‏(services/history-v1/storage/lib/blob_store/index.js:108-116).

الحقول

من يكتب فيها

من أين تأتي blobs الجديدة:
  • رفع الملفات: يرسل web الملف إلى PUT /projects/:project_id/blobs/:hash في history-v1 ‏(services/web/app/src/Features/History/HistoryManager.mjs:164-169, services/history-v1/api/controllers/projects.js:376-402).
  • نسخ المشاريع: يطلب web من history-v1 نسخ blob كل ملف باستخدام POST /projects/:project_id/blobs/:hash?copyFrom= ‏(services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555).
  • نص doc: عندما يكتب history-v1 جزءًا (chunk)، يخزّن نص كل doc، وتعليقاته وتغييراته المتتبَّعة بصيغة JSON، على هيئة blobs ‏(chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

من يقرأ منها

الفهارس

الفهرس الافتراضي على _id فقط. لا يضيف أي ترحيل في tools/migrations/ فهرسًا آخر.

ملاحظات

  • توجد بايتات الـ blob عند المفتاح <project key>/<hash[0:2]>/<hash[2:]> ‏(blob_store/index.js:51-53) في الحاوية OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET ‏(services/history-v1/config/custom-environment-variables.json:49-52). مفتاح المشروع هو معرّف السجل مُكمَّلًا بالأصفار، معكوسًا ومقسّمًا إلى 3/3/بقية الأحرف (libraries/object-persistor/src/ProjectKey.js:8-15).
  • يُخزَّن الـ blob مرة واحدة لكل مشروع: يُتخطّى إدراج تجزئة يملكها المشروع بالفعل (blob_store/index.js:227-230, 249-252).
  • المحتوى الفارغ لا يحتاج إلى سجل؛ يجيب getBlob عنه دون بحث (blob_store/index.js:378-380).
  • تُقرأ projectHistoryGlobalBlobs عند بدء التشغيل (blob_store/index.js:138-148)، لكن لا توجد شيفرة في CE تكتب فيها، لذا فكل blob في CE هو blob مشروع.
آخر تعديل في ٢١ نوفمبر ٢٠٢٦