projects에는 프로젝트마다 하나의 문서가 있으며 이름, 소유자와 구성원, 공유, 파일 트리, 프로젝트 설정을 담습니다. 문서 본문은 여기에 없고(Docs 컬렉션 참고), 바이너리 파일은 hash를 키로 history-v1 blob 저장소에 보관됩니다. 스키마는 services/web/app/src/models/Project.mjs이며, 파일 트리는 같은 위치의 Folder.mjs, File.mjs, Doc.mjs에 있습니다.
출처 열에서 Project.mjs:N은 해당 스키마의 줄이고, 경로가 없는 다른 파일 이름은 services/web/app/src/Features/ 아래에, modules/...는 services/web/ 아래에 있습니다. 줄 번호는 작성 시점의 server-pro 기준입니다.
핵심 식별 정보 및 메타데이터
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
_id | ObjectId | 프로젝트의 id. | MongoDB |
name | String | 프로젝트 이름. | Project.mjs:18 |
description | String | 프로젝트 설명. 기본값은 비어 있음. | Project.mjs:50 |
version | Number | 파일 트리가 변경될 때마다(추가, 이름 변경, 이동, 삭제, 교체) 1씩 증가합니다. | Project.mjs:45, ProjectEntityMongoUpdateHandler.mjs:451-460 |
active | Boolean | 프로젝트가 비활성화된 후 false가 됩니다. 해당 문서는 Mongo 밖으로 보관되었습니다(docs.inS3). 프로젝트를 열면 보관이 해제되고 값이 다시 true가 됩니다. CE에서 오래된 프로젝트를 비활성화하는 cron은 ENABLE_CRON_RESOURCE_DELETION=true일 때만 실행됩니다. | Project.mjs:27, InactiveProjectManager.mjs:39-59, :94-123, server-ce/cron/deactivate-projects.sh |
archived | Array of ObjectId | 프로젝트를 보관한 사용자. 보관은 사용자별입니다. 예전의 불리언 값은 마이그레이션 20221111111111_ce_sp_convert_archived_state로 변환되었습니다. | Project.mjs:51, ProjectDeleter.mjs:159, ProjectHelper.mjs:40 |
trashed | Array of ObjectId | 프로젝트를 자신의 휴지통으로 옮긴 사용자. 이것도 사용자별입니다. | Project.mjs:52, ProjectDeleter.mjs:176, ProjectHelper.mjs:51 |
deletedDocs | Array of Object | 레거시, { _id, name, deletedAt }. 삭제된 문서는 이제 deleted: true와 함께 docs에 남습니다. 이 배열은 오래된 삭제 프로젝트를 복원할 때만 읽힙니다. 항목이 docstore로 복사되고 배열은 비워집니다. 여기에 쓰는 코드는 없습니다. | Project.mjs:11-14, :53, ProjectDeleter.mjs:322-333 |
readOnly | Boolean | 스키마에만 있습니다. CE 코어와 저희 모듈은 사용하지 않습니다. | Project.mjs:28 |
소유권 및 접근 제어
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
owner_ref | ObjectId | 소유자. | Project.mjs:29 |
collaberator_refs | Array of ObjectId | 편집할 수 있는 사용자(이 철자가 실제 필드 이름입니다). | Project.mjs:30 |
reviewer_refs | Array of ObjectId | 검토할 수 있는 사용자: 댓글을 달고 변경 내용 추적으로 제안할 수 있습니다. | Project.mjs:31 |
readOnly_refs | Array of ObjectId | 보기만 할 수 있는 사용자. | Project.mjs:32 |
pendingEditor_refs / pendingReviewer_refs | Array of ObjectId | 초대가 아닙니다(초대는 projectInvites에 있음). 소유자에게 빈 공동 작업자 자리가 없을 때 편집자나 검토자로 추가된 사용자입니다. 이들은 readOnly_refs에 추가되고, 업그레이드할 수 있을 때까지 여기에 기록됩니다. | Project.mjs:33-34, CollaboratorsHandler.mjs:132-136, TokenAccessController.mjs:362-373 |
editAccessRequests | Array of Object | 더 많은 접근 권한을 요청한 보기 사용자: userId, privilegeLevel, requestedAt. 사용자당 항목 하나. 요청이 승인되거나 거절되거나 사용자가 프로젝트를 떠나면 제거됩니다. | Project.mjs:35-41, CollaboratorsHandler.mjs:423-476 (request), :477 (decline), :322 (grant) |
track_changes | Boolean or Object | 변경 내용 추적 상태. true는 모두에게 켜짐(예전 형식)을 뜻합니다. 그 외에는 사용자 id를 키로 하는 객체이며, 켜 둔 각 사용자에 대해 true가 들어갑니다. track-changes 모듈이 이를 쓰고, 코어는 검토자로 지정된 사용자에 대해 이를 켭니다. | Project.mjs:57, ProjectHelper.mjs:66-80, modules/track-changes/app/src/TrackChangesController.mjs:25, CollaboratorsHandler.mjs:344-357 |
collabratecUsers | Array of Object | IEEE Collabratec 연결: user_id, collabratec_document_id, collabratec_privategroup_id, added_at. CE에서는 사용되지 않습니다. | Project.mjs:104-116 |
링크 공유
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
publicAccesLevel | String | private 또는 tokenBased(링크 공유 켜짐). 오래된 프로젝트에는 레거시 값 readOnly 또는 readAndWrite가 남아 있을 수 있습니다. public은 없습니다. 이 철자가 실제 필드 이름입니다. | Project.mjs:46, Authorization/PublicAccessLevels.mjs:3-20 |
tokens.readOnly | String | 보기 전용 링크의 토큰. 고유. | Project.mjs:59-65, ProjectDetailsHandler.mjs:250-252 |
tokens.readAndWrite | String | 편집 링크의 토큰. 고유. | Project.mjs:66-72, ProjectDetailsHandler.mjs:245-248 |
tokens.readAndWritePrefix | String | 편집 토큰의 숫자 접두사로, 토큰을 조회하는 데 사용됩니다. 고유. | Project.mjs:73-81, TokenAccessHandler.mjs:120 |
tokenAccessReadOnly_refs | Array of ObjectId | 보기 전용 링크로 참여한 사용자(토큰이 아니라 사용자 id). | Project.mjs:83 |
tokenAccessReadAndWrite_refs | Array of ObjectId | 편집 링크로 참여한 사용자. | Project.mjs:84 |
tokens가 제거되고 publicAccesLevel이 private로 돌아갑니다(ProjectDetailsHandler.mjs:233-238).
활동 추적
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
lastUpdated | Date | 콘텐츠나 파일 트리가 마지막으로 변경된 시각. 앞으로만 이동합니다. | Project.mjs:19, ProjectUpdateHandler.mjs:5-17 |
lastUpdatedBy | ObjectId | 그 마지막 변경을 한 사용자. | Project.mjs:25, ProjectUpdateHandler.mjs:17 |
lastOpened | Date | 누군가 마지막으로 프로젝트를 연 시각. | Project.mjs:26, ProjectUpdateHandler.mjs:24 |
deletedByExternalDataSource | Boolean | Dropbox 쪽에서 프로젝트 폴더가 삭제되면 true가 됩니다. 프로젝트 자체는 삭제되지 않습니다. 편집기가 알림을 표시하고, 다음에 프로젝트를 열 때 플래그가 지워집니다. | Project.mjs:49, TpdsUpdateHandler.mjs:83, Editor/EditorHttpController.mjs:76-77 |
deferredTpdsFlushCounter | Number | overleaf.com v1 가져오기에서 남은 레거시. 0보다 크면 로드할 때 프로젝트가 Dropbox로 한 번 푸시되고 카운터가 초기화됩니다. | Project.mjs:117, TpdsProjectFlusher.mjs:40-44, :90-99 |
프로젝트 구조
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
rootDoc_id | ObjectId | 컴파일되는 메인 문서. | Project.mjs:42 |
mainBibliographyDoc_id | ObjectId | 프로젝트 설정에서 선택한 메인 .bib 파일. | Project.mjs:44, ProjectEntityUpdateHandler.mjs:1188 |
rootFolder | Array of Folder | 파일 트리. 항상 요소 하나, 즉 루트 폴더입니다. | Project.mjs:43 |
Folder.mjs):
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
_id | ObjectId | 폴더 id. | MongoDB |
name | String | 폴더 이름(루트 폴더의 이름은 rootFolder). | Folder.mjs:9 |
docs | Array of Object | 편집 가능한 텍스트 파일: _id와 name만 있습니다. _id는 본문을 담고 있는 docs 컬렉션의 _id입니다. | Folder.mjs:15, Doc.mjs:7 |
fileRefs | Array of Object | 바이너리 파일, 아래 참고. | Folder.mjs:16 |
folders | Array of Folder | 하위 폴더. | Folder.mjs:17 |
fileRefs의 각 파일(File.mjs):
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
_id | ObjectId | 파일 id. 파일이 교체되면 바뀝니다. | ProjectEntityMongoUpdateHandler.mjs:167 |
name | String | 파일 이름. | File.mjs:7 |
created | Date | 파일이 업로드되었거나 마지막으로 교체된 시각. | File.mjs:11, ProjectEntityMongoUpdateHandler.mjs:168 |
rev | Number | 파일이 교체될 때마다 1씩 증가합니다. | File.mjs:17, ProjectEntityMongoUpdateHandler.mjs:176 |
hash | String | 내용의 SHA-1. 파일은 이 해시로 history-v1 blob 저장소에 저장되며, 다운로드도 그곳에서 읽습니다. | File.mjs:19, FileStore/FileStoreController.mjs:87-92, History/HistoryManager.mjs:43-48 |
linkedFileData | Mixed | 연결된 파일(URL, 다른 프로젝트, 출력 파일, Zotero 또는 Mendeley에서 가져온 파일)에 설정됩니다: provider, 그 원본 데이터, importedAt. | File.mjs:18, LinkedFiles/LinkedFilesController.mjs:52-58 |
컴파일 및 편집기 설정
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
compiler | String | LaTeX 엔진: Settings.safeCompilers 중 하나(xelatex, pdflatex, latex, lualatex). | Project.mjs:47, ProjectOptionsHandler.mjs:16-31, services/web/config/settings.defaults.js:78 |
imageName | String | 샌드박스 컴파일에서 이 프로젝트에 사용되는 TeX Live 이미지. 새 프로젝트는 Settings.currentImageName을 받습니다. 템플릿 갤러리와 MCP 서버가 이를 변경할 수 있습니다. | Project.mjs:54, ProjectCreationHandler.mjs:265-269, modules/template-gallery/app/src/TemplatesManager.mjs:101-103, modules/mcp-server/app/src/ProjectTools.mjs:121 |
spellCheckLanguage | String | 맞춤법 검사 언어. 새 프로젝트는 소유자의 ace.spellCheckLanguage를 복사합니다. | Project.mjs:48, ProjectCreationHandler.mjs:277 |
png2pdf | Boolean | 설정 요청(body.png2pdf)에서 저장되는 프로젝트 설정. | Project.mjs:55, ProjectController.mjs:216-217, ProjectOptionsHandler.mjs:62 |
referenceFormat | String | 참고문헌 형식 설정. | Project.mjs:118, ProjectOptionsHandler.mjs:123-130 |
brandVariationId | String | 출판사 브랜딩. 템플릿 갤러리가 설정할 수 있습니다. | Project.mjs:56, modules/template-gallery/app/src/TemplatesManager.mjs:128 |
fromV1TemplateId / fromV1TemplateVersionId | Number | 프로젝트의 출처인 overleaf.com v1 템플릿. CE에서는 설정되지 않습니다. | Project.mjs:85-86 |
기록(overleaf)
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
overleaf.history.id | Mixed | project-history와 history-v1에서의 프로젝트 id. 새 프로젝트는 프로젝트 id를 문자열로 사용합니다. 고유. | Project.mjs:93, ProjectCreationHandler.mjs:251-257 |
overleaf.history.display | Boolean | 새 프로젝트에서는 항상 true이며, 호환성을 위해서만 유지됩니다. | Project.mjs:94, ProjectCreationHandler.mjs:260-263 |
overleaf.history.rangesSupportEnabled | Boolean | 기록에는 댓글과 추적된 변경 내용도 저장됩니다. 이 값이 true일 때만 버전을 복원할 때 이들도 복원됩니다. | Project.mjs:98, ProjectOptionsHandler.mjs:98-101, History/RestoreManager.mjs:119 |
overleaf.history.otMigrationStage | Number | 기록의 OT 업데이트 형식으로 옮겨 가는 단계. 증가만 합니다. | Project.mjs:99, ProjectOptionsHandler.mjs:108-120 |
overleaf.history.lastResyncedAt | Date | 기록 재동기화가 마지막으로 끝난 시각. web이 아니라 project-history가 씁니다. | Project.mjs:100, services/project-history/app/js/SyncManager.js:239-246 |
overleaf.history.upgradedAt, allowDowngrade, zipFileArchivedInProject | Date / Boolean / Boolean | 전체 프로젝트 기록으로 옮겨 갈 때 남은 필드. | Project.mjs:95-97 |
overleaf.isDebugCopyOf | ObjectId | 다른 프로젝트의 디버그 사본에 설정됩니다. | Project.mjs:102, ProjectCreationHandler.mjs:287-288 |
overleaf.id, imported_at_ver_id, token, read_token | Number / Number / String / String | overleaf.com v1 가져오기 데이터. CE에서는 설정되지 않습니다. overleaf.id에는 고유 인덱스가 있습니다. | Project.mjs:88-91 |
__v | Number | Mongoose 버전 키. | Mongoose |
overleaf.history.currentEndVersion, overleaf.history.currentEndTimestamp, overleaf.history.updatedAt, overleaf.backup.*도 쓸 수 있지만, backupStore가 구성된 경우에만 그렇습니다(services/history-v1/storage/lib/chunk_store/mongo.js:238-258). CE는 이를 구성하지 않으므로 이 필드들은 나타나지 않습니다.
인덱스
모두tools/migrations/에서 server-ce 태그가 붙은 마이그레이션에서 생성됩니다.
| 이름 | 키 | 옵션 | 마이그레이션 |
|---|---|---|---|
owner_ref_1 | owner_ref: 1 | 20190912145024_create_projects_indexes | |
collaberator_refs_1 | collaberator_refs: 1 | 20190912145024_create_projects_indexes | |
readOnly_refs_1 | readOnly_refs: 1 | 20190912145024_create_projects_indexes | |
tokenAccessReadOnly_refs_1 | tokenAccessReadOnly_refs: 1 | 20190912145024_create_projects_indexes | |
tokenAccessReadAndWrite_refs_1 | tokenAccessReadAndWrite_refs: 1 | 20190912145024_create_projects_indexes | |
tokens.readOnly_1 | tokens.readOnly: 1 | unique, partial (field exists) | 20190912145024_create_projects_indexes |
tokens.readAndWrite_1 | tokens.readAndWrite: 1 | unique, partial | 20190912145024_create_projects_indexes |
tokens.readAndWritePrefix_1 | tokens.readAndWritePrefix: 1 | unique, partial | 20190912145024_create_projects_indexes |
overleaf.history.id_1 | overleaf.history.id: 1 | unique, partial | 20190912145024_create_projects_indexes |
overleaf.id_1 | overleaf.id: 1 | unique, partial | 20190912145024_create_projects_indexes |
collabratecUsers.user_id_1 | collabratecUsers.user_id: 1 | sparse | 20190912145024_create_projects_indexes |
imageName_1 | imageName: 1 | 20240730155209_create_project_imageName_index | |
reviewer_refs_1 | reviewer_refs: 1 | 20241204103349_create_reviewer_refs_index | |
active_true_lastOpened_1 | lastOpened: 1 | partial (active: true) | 20250320161029_update_inactive_project_index |
참고 사항
- Mongoose
autoIndex는 꺼져 있습니다(services/web/app/src/infrastructure/Mongoose.mjs:7). 스키마의index옵션은 위의 마이그레이션이 이를 생성하기 때문에 존재할 뿐입니다. - 마이그레이션
20250620152657_ensure_collaborator_arrays는 누락된collaberator_refs,pendingEditor_refs,pendingReviewer_refs,readOnly_refs,reviewer_refs를[]로 설정합니다. - 프로젝트를 삭제하면 문서가
deletedProjects로 이동합니다(Deleted Projects Collection 참고).
프로젝트 예시
프로젝트 예시
{
_id: ObjectId('69686c09bcb72ccea226ff33'),
name: 'overleaf-example',
lastUpdated: ISODate('2026-01-15T04:25:34.637Z'),
lastUpdatedBy: ObjectId('696868f6bcb72ccea226fe5f'),
lastOpened: ISODate('2026-01-15T04:25:22.286Z'),
active: true,
owner_ref: ObjectId('696868f6bcb72ccea226fe5f'),
collaberator_refs: [],
reviewer_refs: [],
readOnly_refs: [],
pendingEditor_refs: [],
pendingReviewer_refs: [],
rootDoc_id: ObjectId('69686c09bcb72ccea226ff38'),
rootFolder: [
{
name: 'rootFolder',
_id: ObjectId('69686c09bcb72ccea226ff32'),
docs: [
{
name: 'main.tex',
_id: ObjectId('69686c09bcb72ccea226ff38')
},
{
name: 'sample.bib',
_id: ObjectId('69686c09bcb72ccea226ff3f')
}
],
fileRefs: [
{
name: 'frog.jpg',
created: ISODate('2026-01-15T04:24:41.963Z'),
rev: 0,
linkedFileData: null,
hash: '5b889ef3cf71c83a4c027c4e4dc3d1a106b27809',
_id: ObjectId('69686c09bcb72ccea226ff45')
}
],
folders: []
}
],
version: 3,
publicAccesLevel: 'private',
compiler: 'pdflatex',
spellCheckLanguage: 'en',
deletedByExternalDataSource: false,
description: '',
trashed: [],
deletedDocs: [],
tokens: {},
tokenAccessReadOnly_refs: [],
tokenAccessReadAndWrite_refs: [],
overleaf: {
history: {
id: '69686c09bcb72ccea226ff33',
display: true
}
},
collabratecUsers: [],
__v: 0
}

