Chuyển đến nội dung chính
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ặc deleted (bị thay thế, hoặc dự án đã bị xóa). Các thao tác đọc chỉ xét active và 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/chunks trong môi trường phát triển (develop/docker-compose.yml:90), hoặc overleaf-chunks với S3_ENABLED=true (develop/s3/docker-compose.yml:51).
  • Các bản ghi ở trạng thái deleted hoặc pending, cùng các đối tượng bucket của chúng, chỉ bị gỡ bỏ bởi delete_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 ghi overleaf.history.currentEndVersion, currentEndTimestamp, updatedAt và overleaf.backup.pendingChangeAt vào dự án (mongo.js:232-262). CE không cấu hình backupStore, nên mongo.js:238-240 trả về sớm.
Lần sửa đổi cuối 21 tháng 11, 2026