메인 콘텐츠로 건너뛰기
projectHistoryBlobs에는 프로젝트 기록마다 문서 하나가 있으며, history-v1이 해당 프로젝트를 위해 저장한 모든 blob의 메타데이터(해시와 크기)를 담습니다. blob은 파일이나 doc의 기록 중 어느 시점의 내용입니다. 바이트 자체는 프로젝트 blob 버킷의 객체입니다. Mongoose 스키마는 없습니다. history-v1이 services/history-v1/storage/lib/blob_store/mongo.js에서 컬렉션에 쓰며, CE에서처럼 16진수 24자의 기록 id에 이를 사용합니다(services/history-v1/storage/lib/blob_store/index.js:108-116).

필드

쓰는 코드

새 blob이 오는 곳:
  • 파일 업로드: web이 파일을 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).
  • 프로젝트 복사: web이 history-v1에 POST /projects/:project_id/blobs/:hash?copyFrom=로 각 파일의 blob 복사를 요청합니다(services/web/app/src/Features/Project/ProjectDuplicator.mjs:333-338, HistoryManager.mjs:177-187, projects.js:521-555).
  • doc 텍스트: history-v1이 청크를 쓸 때 각 doc의 텍스트와 그 댓글 및 변경 내용 추적(JSON)을 blob으로 저장합니다(chunk_store/index.js:402-405, libraries/overleaf-editor-core/lib/file_data/string_file_data.js:166-173).

읽는 코드

인덱스

기본 _id 인덱스만 있습니다. tools/migrations/의 어떤 마이그레이션도 인덱스를 추가하지 않습니다.

참고

  • blob의 바이트는 버킷 OVERLEAF_EDITOR_PROJECT_BLOBS_BUCKET(services/history-v1/config/custom-environment-variables.json:49-52)의 키 <project key>/<hash[0:2]>/<hash[2:]>(blob_store/index.js:51-53)에 있습니다. 프로젝트 키는 0으로 채운 기록 id를 뒤집어 3/3/나머지 문자로 나눈 것입니다(libraries/object-persistor/src/ProjectKey.js:8-15).
  • blob은 프로젝트마다 한 번만 저장됩니다. 프로젝트에 이미 있는 해시의 삽입은 건너뜁니다(blob_store/index.js:227-230, 249-252).
  • 빈 내용에는 레코드가 필요 없습니다. getBlob은 조회 없이 응답합니다(blob_store/index.js:378-380).
  • projectHistoryGlobalBlobs는 시작 시 읽히지만(blob_store/index.js:138-148) CE 코드는 여기에 쓰지 않으므로, CE에서는 모든 blob이 프로젝트 blob입니다.
마지막 수정일 2026년 11월 21일