跳转到主要内容
projects 中每个项目对应一个文档:名称、所有者和成员、共享、文件树以及项目设置。文档的正文不在这里(参见 Docs 集合),二进制文件则以其 hash 存放在 history-v1 的 blob 存储中。Schema 为 services/web/app/src/models/Project.mjs,文件树定义在同目录的 Folder.mjs、File.mjs 和 Doc.mjs 中。 在“来源”列中,Project.mjs:N 表示该 schema 的某一行,其他不带路径的文件名位于 services/web/app/src/Features/ 下,modules/... 位于 services/web/ 下。行号取自撰写时的 server-pro。

核心标识与元数据

所有权与访问控制

关闭链接共享会删除 tokens,并将 publicAccesLevel 设回 private(ProjectDetailsHandler.mjs:233-238)。

活动跟踪

项目结构

每个文件夹(Folder.mjs): fileRefs 中的每个文件(File.mjs):

编译与编辑器设置

历史(overleaf)

history-v1 还可以写入 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 标签的迁移。

说明

  • Mongoose 的 autoIndex 已关闭(services/web/app/src/infrastructure/Mongoose.mjs:7):schema 中的 index 选项之所以存在,只是因为上面的迁移会创建它们。
  • 迁移 20250620152657_ensure_collaborator_arrays 会将缺失的 collaberator_refs、pendingEditor_refs、pendingReviewer_refs、readOnly_refs 和 reviewer_refs 设为 []。
  • 删除项目会把文档移到 deletedProjects(参见 Deleted Projects Collection)。
下面是一个真实的 Overleaf 项目示例。
最后修改于 2026年11月20日