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
Ai ghi
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
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 bucketOVERLEAF_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;
getBlobtrả 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.

