> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# مجموعة Project History Blobs

تحتوي `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`).

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف السجل التاريخي للمشروع، وهو القيمة في `projects.overleaf.history.id`. | `mongo.js:37-40` |
| `blobs` | Object | سجلات blob مجمّعة في دلاء. مفتاح الدلو هو أول 3 أرقام سداسية عشرية من التجزئة. | `mongo.js:39`, `429-431` |
| `blobs.<abc>` | Array of Object | حتى 8 سجلات تبدأ تجزئتها بـ `abc`. عندما يحتوي الدلو على 8 بالفعل، يذهب السجل التالي إلى [مجموعة Project History Sharded Blobs](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/project-history-sharded-blobs-collection.md). | `mongo.js:23`, `375-389` |
| `blobs.<abc>[].h` | Binary | التجزئة، 20 بايتًا: SHA-1 لـ git blob، ‏`sha1("blob " + byteLength + "\0" + content)` ‏(`libraries/overleaf-editor-core/lib/blob_utils.js:36-43`). صيغتها السداسية العشرية هي التجزئة المستخدمة في أماكن أخرى، مثل `fileRefs.hash` في المشاريع. | `mongo.js:472` |
| `blobs.<abc>[].b` | Number | طول المحتوى بالبايت. | `mongo.js:473` |
| `blobs.<abc>[].s` | Number | طول المحتوى كنص؛ ‏`null` عندما لا يكون المحتوى نصًا قابلًا للتحرير (ثنائي، أو أكبر من أن يُحرَّر) (`blob_utils.js:116-130`). | `mongo.js:474` |

#### من يكتب فيها

| الشيفرة | ما تفعله |
| - | - |
| `services/history-v1/storage/lib/blob_store/mongo.js:34-47` | ‏`initialize`: تُدرج `{ _id, blobs: {} }` عندما ينشئ history-v1 السجل التاريخي للمشروع (`services/history-v1/storage/lib/chunk_store/index.js:67-68`). |
| `mongo.js:370-390` | ‏`insertBlob`: تُجري `$addToSet` للسجل في دلوه ما دام الدلو يحتوي على أقل من 8 سجلات، وإلا ففي المجموعة المجزّأة. تعمل بعد رفع البايتات، من `putString` و`putBlob` و`copyBlob` ‏(`blob_store/index.js:223-237`, `271-278`, `456-467`). |
| `mongo.js:54-105` | ‏`clone`: تنسخ الدلاء إلى معرّف سجل آخر، لـ `POST /projects/:project_id/clone` في history-v1. لا شيء في web يستدعي ذلك المسار (راجع [مجموعة Project History Chunks](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/project-history-chunks-collection.md)). |
| `mongo.js:413-422` | ‏`deleteBlobs`: تحذف المستند والمستندات المجزّأة للمشروع، عند `DELETE /projects/:project_id` في history-v1 ‏(`services/history-v1/api/controllers/projects.js:361-373`). |

من أين تأتي 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`).

#### من يقرأ منها

| الشيفرة | ما تفعله |
| - | - |
| `mongo.js:113-157` | ‏`findBlob`: ‏blob واحد بالتجزئة؛ تبحث في المجموعة المجزّأة عندما يكون الدلو ممتلئًا. يستخدمها `BlobStore.getBlob` ‏(`blob_store/index.js:376-387`) لمسارات blob ‏(`projects.js:416-480`)، وقبل الإدراج لتخطي blobs الموجودة مسبقًا (`blob_store/index.js:441-448`). |
| `mongo.js:165-260` | ‏`findBlobs`: عدة blobs دفعة واحدة، لتحميل ملفات جزء. |
| `mongo.js:265-309` | ‏`getProjectBlobs`: جميع blobs المشروع. |
| `mongo.js:316-363` | ‏`getProjectBlobsBatch`: جميع blobs لعدة مشاريع، لـ `POST /projects/blob-stats` في history-v1 ‏(`projects.js:620`). تعرض الوحدة admin-tools النتيجة على أنها حجم المشروع (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:395-405`). |

#### الفهارس

الفهرس الافتراضي على `_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 مشروع.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.