projects хранит по одному документу на проект: имя, владельца и участников, совместный доступ, дерево файлов и настройки проекта. Текста документов здесь нет (см. Коллекция Docs), а двоичные файлы лежат в хранилище blob-объектов history-v1 под своим hash. Схема: 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 при каждом изменении дерева файлов (добавление, переименование, перемещение, удаление, замена).
false после деактивации проекта: его документы были архивированы из Mongo (docs.inS3). Открытие проекта разархивирует их и снова устанавливает значение true. В CE cron-задача, которая деактивирует старые проекты, запускается только при ENABLE_CRON_RESOURCE_DELETION=true.
Пользователи, которые архивировали проект. Архивирование действует для каждого пользователя отдельно. Старые булевы значения были преобразованы миграцией 20221111111111_ce_sp_convert_archived_state.
Устаревшее поле, { _id, name, deletedAt }. Удалённые документы теперь остаются в docs с deleted: true. Этот массив читается только при восстановлении старого удалённого проекта: записи копируются в docstore, а массив очищается. Ничто в него не пишет.
Только в схеме: ядро 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 и перечисляются здесь, пока их нельзя повысить.
Читатели, запросившие больше прав: userId, privilegeLevel, requestedAt. Одна запись на пользователя. Удаляется, когда запрос одобрен или отклонён либо пользователь покинул проект.
Состояние отслеживания изменений. true означает включено для всех (старый формат); иначе это объект с id пользователей в качестве ключей и true для каждого пользователя, у которого оно включено. Его записывает модуль track-changes, а ядро включает его для пользователя, назначенного рецензентом.
Связи с 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: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
true, когда папку проекта удалили на стороне Dropbox. Сам проект не удаляется; редактор показывает уведомление, а флаг сбрасывается при следующем открытии проекта.
Образ TeX Live, используемый для этого проекта при компиляции в песочнице. Новый проект получает Settings.currentImageName; галерея шаблонов и MCP-сервер могут его изменить.
Данные импорта overleaf.com v1. В CE не задаются. У overleaf.id есть уникальный индекс.
Project.mjs:88-91
__v
Number
Ключ версии Mongoose.
Mongoose
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 его не настраивает, поэтому эти поля не появляются.
Индексы
Все они создаются миграциями с тегом server-ce в tools/migrations/.
Имя
Ключи
Параметры
Миграция
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
Примечания
autoIndex в Mongoose отключён (services/web/app/src/infrastructure/Mongoose.mjs:7): параметры index в схеме существуют только потому, что их создают перечисленные выше миграции.
Миграция 20250620152657_ensure_collaborator_arrays устанавливает отсутствующие collaberator_refs, pendingEditor_refs, pendingReviewer_refs, readOnly_refs и reviewer_refs в [].