> ## 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.

# Collection Project History Blobs

`projectHistoryBlobs` lưu một tài liệu cho mỗi lịch sử dự án: siêu dữ liệu (hash và kích thước) của mọi blob mà history-v1 đã lưu cho dự án đó. Blob là nội dung của một tệp hoặc một doc tại một thời điểm trong lịch sử của nó. Bản thân các byte là đối tượng trong bucket blob của dự án. Không có schema Mongoose: history-v1 ghi collection trong `services/history-v1/storage/lib/blob_store/mongo.js`, được dùng cho id lịch sử gồm 24 ký tự thập lục phân, như trong CE (`services/history-v1/storage/lib/blob_store/index.js:108-116`).

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id lịch sử của dự án, giá trị trong `projects.overleaf.history.id`. | `mongo.js:37-40` |
| `blobs` | Object | Các bản ghi blob được nhóm theo nhóm. Khóa của một nhóm là 3 chữ số thập lục phân đầu tiên của hash. | `mongo.js:39`, `429-431` |
| `blobs.<abc>` | Array of Object | Tối đa 8 bản ghi có hash bắt đầu bằng `abc`. Khi một nhóm đã có 8 bản ghi, bản ghi tiếp theo vào [Collection Project History Sharded Blobs](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/project-history-sharded-blobs-collection.md). | `mongo.js:23`, `375-389` |
| `blobs.<abc>[].h` | Binary | Hash, 20 byte: SHA-1 của git blob, `sha1("blob " + byteLength + "\0" + content)` (`libraries/overleaf-editor-core/lib/blob_utils.js:36-43`). Dạng thập lục phân của nó là hash được dùng ở nơi khác, ví dụ `fileRefs.hash` trong dự án. | `mongo.js:472` |
| `blobs.<abc>[].b` | Number | Độ dài nội dung tính bằng byte. | `mongo.js:473` |
| `blobs.<abc>[].s` | Number | Độ dài nội dung dưới dạng văn bản; là `null` khi nội dung không phải văn bản có thể chỉnh sửa (nhị phân, hoặc quá lớn để chỉnh sửa) (`blob_utils.js:116-130`). | `mongo.js:474` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `services/history-v1/storage/lib/blob_store/mongo.js:34-47` | `initialize`: chèn `{ _id, blobs: {} }` khi history-v1 tạo lịch sử dự án (`services/history-v1/storage/lib/chunk_store/index.js:67-68`). |
| `mongo.js:370-390` | `insertBlob`: `$addToSet` bản ghi vào nhóm của nó khi nhóm còn ít hơn 8 bản ghi, nếu không thì vào collection được shard. Chạy sau khi các byte được tải lên, từ `putString`, `putBlob` và `copyBlob` (`blob_store/index.js:223-237`, `271-278`, `456-467`). |
| `mongo.js:54-105` | `clone`: sao chép các nhóm sang một id lịch sử khác, cho history-v1 `POST /projects/:project_id/clone`. Không có gì trong web gọi route đó (xem [Collection Project History Chunks](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/project-history-chunks-collection.md)). |
| `mongo.js:413-422` | `deleteBlobs`: xóa tài liệu và các tài liệu được shard của dự án, khi gọi history-v1 `DELETE /projects/:project_id` (`services/history-v1/api/controllers/projects.js:361-373`). |

Blob mới đến từ đâu:

* Tải tệp lên: web gửi tệp đến history-v1 `PUT /projects/:project_id/blobs/:hash` (`services/web/app/src/Features/History/HistoryManager.mjs:164-169`, `services/history-v1/api/controllers/projects.js:376-402`).
* Bản sao dự án: web yêu cầu history-v1 sao chép blob của từng tệp bằng `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`).
* Văn bản doc: khi history-v1 ghi một chunk, nó lưu văn bản của mỗi doc, cùng các bình luận và thay đổi được theo dõi dưới dạng JSON, thành các blob (`chunk_store/index.js:402-405`, `libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173`).

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `mongo.js:113-157` | `findBlob`: một blob theo hash; tìm trong collection được shard khi nhóm đã đầy. Được `BlobStore.getBlob` (`blob_store/index.js:376-387`) dùng cho các route blob (`projects.js:416-480`), và trước khi chèn để bỏ qua các blob đã tồn tại (`blob_store/index.js:441-448`). |
| `mongo.js:165-260` | `findBlobs`: nhiều blob cùng lúc, để tải các tệp của một chunk. |
| `mongo.js:265-309` | `getProjectBlobs`: tất cả blob của một dự án. |
| `mongo.js:316-363` | `getProjectBlobsBatch`: tất cả blob của nhiều dự án, cho history-v1 `POST /projects/blob-stats` (`projects.js:620`). Module admin-tools hiển thị kết quả như kích thước dự án (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:395-405`). |

#### Chỉ mục

Chỉ có chỉ mục mặc định `_id`. Không có migration nào trong `tools/migrations/` thêm chỉ mục khác.

#### Ghi chú

* Các byte của một blob nằm ở khóa `<project key>/<hash[0:2]>/<hash[2:]>` (`blob_store/index.js:51-53`) trong bucket `OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET` (`services/history-v1/config/custom-environment-variables.json:49-52`). Khóa dự án là id lịch sử được đệm số 0, đảo ngược và chia thành 3/3/phần còn lại của các ký tự (`libraries/object-persistor/src/ProjectKey.js:8-15`).
* Một blob chỉ được lưu một lần cho mỗi dự án: việc chèn một hash mà dự án đã có sẽ bị bỏ qua (`blob_store/index.js:227-230`, `249-252`).
* Nội dung rỗng không cần bản ghi; `getBlob` trả lời mà không cần tra cứu (`blob_store/index.js:378-380`).
* `projectHistoryGlobalBlobs` được đọc khi khởi động (`blob_store/index.js:138-148`), nhưng không có mã CE nào ghi vào nó, nên trong CE mọi blob đều là blob của dự án.


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