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 у [].