projectHistoryChunks lưu một tài liệu cho mỗi chunk lịch sử, tức một dãy phiên bản trong lịch sử của một dự án. Mongo chỉ lưu siêu dữ liệu của chunk; bản thân chunk (một snapshot cộng với các thay đổi sau nó) là một đối tượng JSON được nén gzip trong bucket chunks. Không có schema Mongoose: history-v1 ghi collection trong services/history-v1/storage/lib/chunk_store/mongo.js, được dùng cho mọi id lịch sử gồm 24 ký tự thập lục phân, như trong CE (services/history-v1/storage/lib/chunk_store/index.js:644-652).
Các trường
Ai ghi
Chunk mới đến từ project-history, dịch vụ gửi các chỉnh sửa đang xếp hàng đến history-v1
POST /projects/:project_id/legacy_changes (services/history-v1/api/routes/project_import.js:29-31); sau đó history-v1 gọi chunkStore.update hoặc chunkStore.create (services/history-v1/storage/lib/persist_changes.js:215, 229). Một dự án mới nhận chunk đầu tiên từ chunkStore.initializeProject (chunk_store/index.js:54-80).
Ai đọc
Chỉ mục
Ghi chú
- Luồng trạng thái:
pending(bản ghi đã ghi, đang tải lên) →active(chunk mới nhất, vẫn có thể mở rộng) →closed(có chunk mới hơn theo sau) hoặcdeleted(bị thay thế, hoặc dự án đã bị xóa). Các thao tác đọc chỉ xétactivevàclosed. - Đối tượng chunk là JSON được nén gzip (
services/history-v1/storage/lib/history_store.js:151-170) ở khóa<project key>/<chunk id>(history_store.js:65-67). 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). Bucket làOVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56):/buckets/chunkstrong môi trường phát triển (develop/docker-compose.yml:90), hoặcoverleaf-chunksvớiS3_ENABLED=true(develop/s3/docker-compose.yml:51). - Các bản ghi ở trạng thái
deletedhoặcpending, cùng các đối tượng bucket của chúng, chỉ bị gỡ bỏ bởidelete_old_chunks.js(yarn delete_old_chunks,services/history-v1/package.json:79). Image CE không có cron job cho việc này (server-ce/config/crontab-history,server-ce/config/crontab-deletion), nên trong CE chúng vẫn còn đó. - Khi web làm hết hạn một dự án đã xóa, nó gọi history-v1
DELETE /projects/:history_id(services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391,HistoryManager.mjs:127-135,152-162), việc này đánh dấu mọi chunk của dự án làdeleted. - Khi có cấu hình
backupStore, việc xác nhận một chunk cũng ghioverleaf.history.currentEndVersion,currentEndTimestamp,updatedAtvàoverleaf.backup.pendingChangeAtvào dự án (mongo.js:232-262). CE không cấu hìnhbackupStore, nênmongo.js:238-240trả về sớm.

