메인 콘텐츠로 건너뛰기
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에서 일찍 반환합니다.
마지막 수정일 2026년 11월 21일