> ## 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 Sharded Blobs

تحتفظ `projectHistoryShardedBlobs` بسجلات blob التي لم تتسع لها [projectHistoryBlobs](https://ayakaleaf-pro.mintlify.site/dev/data-model/project-history-blobs-collection.md): عندما تحتوي الحاوية الخاصة ببادئة تجزئة هناك على 8 سجلات بالفعل، تذهب السجلات التالية إلى هنا. للمشروع فيها 16 مستندًا على الأكثر، واحد لكل رقم ست عشري أول من التجزئة. لا يوجد مخطط Mongoose؛ يكتبها history-v1 في `services/history-v1/storage/lib/blob_store/mongo.js` (البنية موصوفة في `mongo.js:1-16`).

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | Binary | 13 بايت: معرّف سجل المشروع، وهو `0`، ورقم الجزء (shard) مقروءًا بالست عشري (`<history id>0<digit>`). رقم الجزء هو أول رقم ست عشري من التجزئة. | `mongo.js:439-453` |
| `blobs` | Object | سجلات blob مجمّعة في حاويات. مفتاح الحاوية هو الأرقام الست عشرية من 2 إلى 4 في التجزئة. | `mongo.js:439-443` |
| `blobs.<bcd>` | Array of Object | سجلات الحاوية. لا يحدّ الكود من حجمها. | `mongo.js:399-407` |
| `blobs.<bcd>[].h` | Binary | التجزئة، 20 بايت، كما في projectHistoryBlobs. | `mongo.js:472` |
| `blobs.<bcd>[].b` | Number | طول المحتوى بالبايت. | `mongo.js:473` |
| `blobs.<bcd>[].s` | Number | طول المحتوى كنص؛ `null` عندما لا يكون المحتوى نصًا قابلًا للتحرير. | `mongo.js:474` |

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

| الكود | ماذا يفعل |
| - | - |
| `services/history-v1/storage/lib/blob_store/mongo.js:399-407` | `insertRecordSharded`: upsert باستخدام `$addToSet` في الحاوية. يستدعيه `insertBlob` عندما تمتلئ الحاوية في projectHistoryBlobs (`mongo.js:387-389`). |
| `mongo.js:75-103` | `clone`: ينسخ أجزاء المشروع إلى معرّف سجل آخر، لمسار history-v1 `POST /projects/:project_id/clone`، الذي لا يستدعيه شيء في web. |
| `mongo.js:413-422` | `deleteBlobs`: يحذف كل أجزاء المشروع مع مستنده في projectHistoryBlobs، عند history-v1 `DELETE /projects/:project_id`. |

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

| الكود | ماذا يفعل |
| - | - |
| `mongo.js:144-157` | `findBlobSharded`: blob واحد، لا يُبحث عنه إلا عندما تحتوي حاويته في projectHistoryBlobs على 8 سجلات ولا تضمه (`mongo.js:127-131`). |
| `mongo.js:217-260` | `findBlobsSharded`: كائنات blob التي لم يجدها `findBlobs` في projectHistoryBlobs (`mongo.js:202-206`). |
| `mongo.js:285-306` | `getProjectBlobs`: كل أجزاء المشروع. |
| `mongo.js:337-361` | `getProjectBlobsBatch`: كل أجزاء عدة مشاريع، لمسار إحصاءات blob. |

#### الفهارس

الفهرس الافتراضي `_id` فقط. لا يضيف أي ترحيل في `tools/migrations/` فهرسًا.

#### ملاحظات

* تقع أجزاء المشروع الواحد متجاورة بترتيب `_id`، لذا يجدها الكود بنطاق `_id` من `<history id>00` إلى `<history id>0f` (`mongo.js:75-80`، `287-295`).
* لا تظهر المجموعة إلا عندما يكون لمشروع ما أكثر من 8 كائنات blob بالبادئة الثلاثية نفسها للتجزئة، لذا قد لا توجد على الإطلاق في نسخة صغيرة.


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