projectHistoryChunks에는 기록 청크마다 문서 하나가 있습니다. 청크는 한 프로젝트 기록에서 연속된 버전의 구간입니다. Mongo에는 청크의 메타데이터만 있으며, 청크 자체(스냅샷과 그 이후의 변경)는 chunks 버킷에 있는 gzip으로 압축된 JSON 객체입니다. Mongoose 스키마는 없습니다. history-v1이 services/history-v1/storage/lib/chunk_store/mongo.js에서 컬렉션에 쓰며, CE에서처럼 16진수 24자의 모든 기록 id에 이를 사용합니다(services/history-v1/storage/lib/chunk_store/index.js:644-652).
필드
쓰는 코드
새 청크는 project-history에서 옵니다. project-history는 대기 중인 편집을 history-v1
POST /projects/:project_id/legacy_changes로 보내고(services/history-v1/api/routes/project_import.js:29-31), history-v1은 chunkStore.update 또는 chunkStore.create를 호출합니다(services/history-v1/storage/lib/persist_changes.js:215, 229). 새 프로젝트는 첫 청크를 chunkStore.initializeProject에서 받습니다(chunk_store/index.js:54-80).
읽는 코드
인덱스
참고
- 상태 흐름:
pending(레코드 작성됨, 업로드 중) →active(가장 최근 청크, 아직 확장 가능) →closed(더 새로운 청크가 뒤따름) 또는deleted(대체되었거나 프로젝트가 삭제됨). 읽기는active와closed만 봅니다. - 청크 객체는 gzip으로 압축된 JSON(
services/history-v1/storage/lib/history_store.js:151-170)이며 키<project key>/<chunk id>(history_store.js:65-67)에 있습니다. 프로젝트 키는 0으로 채운 기록 id를 뒤집어 3/3/나머지 문자로 나눈 것입니다(libraries/object-persistor/src/ProjectKey.js:8-15). 버킷은OVERLEAF_EDITOR_CHUNKS_BUCKET(services/history-v1/config/custom-environment-variables.json:53-56)으로, 개발 환경에서는/buckets/chunks(develop/docker-compose.yml:90),S3_ENABLED=true에서는overleaf-chunks(develop/s3/docker-compose.yml:51)입니다. deleted또는pending상태의 레코드와 그 버킷 객체는delete_old_chunks.js만 제거합니다(yarn delete_old_chunks,services/history-v1/package.json:79). CE 이미지에는 이를 위한 cron 작업이 없으므로(server-ce/config/crontab-history,server-ce/config/crontab-deletion) CE에서는 계속 남아 있습니다.- web이 삭제된 프로젝트를 만료시킬 때 history-v1
DELETE /projects/:history_id를 호출하며(services/web/app/src/Features/Project/ProjectDeleter.mjs:385-391,HistoryManager.mjs:127-135,152-162), 이로써 프로젝트의 모든 청크가deleted로 표시됩니다. backupStore가 설정되어 있으면 청크를 확정할 때overleaf.history.currentEndVersion,currentEndTimestamp,updatedAt,overleaf.backup.pendingChangeAt도 프로젝트에 씁니다(mongo.js:232-262). CE는backupStore를 설정하지 않으므로mongo.js:238-240에서 일찍 반환합니다.

