메인 콘텐츠로 건너뛰기
docs는 프로젝트의 편집 가능한 텍스트 파일(Overleaf에서는 doc이라고 부릅니다)의 내용을 담습니다. 예를 들어 main.tex나 sample.bib입니다. doc마다 문서 하나가 있으며, 줄, 댓글과 변경 내용 추적, 카운터 두 개, 삭제 상태가 들어 있습니다. 파일 이름과 트리에서의 위치는 여기가 아니라 projects.rootFolder에 있습니다(Projects 컬렉션 참고). 바이너리 파일도 여기에 없습니다. 마이그레이션과 유지 관리 스크립트를 제외하면 이 컬렉션에 쓰는 것은 docstore뿐이며, 위치는 services/docstore/app/js/MongoManager.js입니다. Mongoose 모델은 없고, web과 document-updater는 docstore HTTP API를 통해 접근합니다(services/docstore/app.js:31-70). 출처 열에서 경로 없는 파일 이름은 services/docstore/app/js/ 아래에 있습니다.

필드

Ranges

ranges에는 배열 두 개가 있습니다. document-updater가 libraries/ranges-tracker/index.cjs로 만들고, docstore는 저장하기 전에 id를 ObjectId로, ts를 Date로 바꿉니다(RangeManager.js:41-63). 댓글도 변경 내용 추적도 없는 doc은 ranges: {}를 갖거나 ranges가 없습니다. 댓글과 답글의 텍스트는 docs에 없습니다. messages 컬렉션에서 thread_id가 댓글 id인 room에 있습니다. 댓글의 해결 여부는 여기가 아니라 그 room에 저장되며, docstore는 resolved 플래그가 전송되면 버립니다(RangeManager.js:59-61). Rooms 컬렉션과 Messages 컬렉션을 참고하세요.

쓰는 코드

읽는 코드

인덱스

모두 tools/migrations/에서 server-ce 태그가 붙은 마이그레이션에서 옵니다.

참고

  • doc이 열려 있는 동안 최신 텍스트는 여기가 아니라 document-updater(Redis)에 있습니다. Mongo는 document-updater가 플러시할 때만 갱신됩니다(services/document-updater/app/js/PersistenceManager.js:128-160). 프로젝트 전체의 doc을 읽는 코드는 ProjectDuplicator처럼 먼저 flushProjectToMongo를 호출해야 합니다.
  • 삭제된 doc은 프로젝트가 파기될 때까지 deleted: true 상태로 이 컬렉션에 남습니다. docstore는 최신순으로 최대 MAX_DELETED_DOCS(기본값 2000)개를 반환합니다(MongoManager.js:29-44, services/docstore/config/settings.defaults.cjs:40). 기록 패널은 이를 사용하지 않고 history-v1을 읽습니다.
  • rev와 version 카운터는 history-v1의 프로젝트 기록 버전과 관련이 없습니다.
다음은 Overleaf docs의 실제 예시입니다.
마지막 수정일 2026년 11월 21일