users зберігає по одному документу на обліковий запис: дані для входу, профіль, налаштування редактора, функції та активність. Схема розташована в services/web/app/src/models/User.mjs; більшість записів проходить через services/web/app/src/Features/User/UserUpdater.mjs. У стовпці «Джерело» User.mjs:N означає рядок цієї схеми, інші назви файлів без шляху розташовані в services/web/app/src/Features/, а modules/... розташовано в services/web/. Номери рядків взято з server-pro на момент написання.
Основна ідентичність і автентифікація
Поле
Тип
Значення
Джерело
_id
ObjectId
Id користувача. Інші колекції посилаються сюди через user_id, owner_ref та подібні поля.
MongoDB
email
String
Основна адреса електронної пошти. Унікальна, зокрема без урахування регістру (див. «Індекси»).
User.mjs:26
emails
Масив Object
Усі адреси облікового запису. Основною вважається запис, що дорівнює email.
User.mjs:27
emails.email
String
Адреса.
User.mjs:29
emails.reversedHostname
String
Домен адреси у зворотному порядку (moc.elpmaxe). Задається під час додавання адреси.
Коли адресу вперше підтверджено (пізніше підтвердження зберігає ранішу дату). Модулі LDAP, SAML і OIDC задають emails.0.confirmedAt під час створення облікового запису.
bcrypt-хеш локального пароля. Відсутній в облікових записах без пароля: входи через LDAP і SAML видаляють його, а міграція 20260511150000_reset_hardcoded_admin_password видаляє відомий пароль за замовчуванням.
createdAt, enrolledAt, secretEncrypted. Лише в схемі: ядро CE і наші модулі його не використовують.
User.mjs:239-243
Стан і життєвий цикл облікового запису
Поле
Тип
Значення
Джерело
signUpDate
Date
Коли обліковий запис було створено.
User.mjs:75
suspended
Boolean
true, якщо адміністратор вимкнув обліковий запис. UserUpdater.suspendUser задає його та завершує сеанси; модуль admin-tools викликає його і може повернути значення назад. Кожна точка входу, не захищена сеансом (токени, підписані посилання, websocket, webhook), має його перевіряти.
Якщо значення true, вхід перенаправляє користувача на сторінку повторного підтвердження замість редактора. Скидання пароля повертає значення false. Ніщо в CE не встановлює true.
Коли користувач востаннє підтвердив, що основна адреса досі належить йому, або змінив основну адресу. Перевіряє це лише overleaf.com (saas): якщо значення надто старе, список проєктів перенаправляє на сторінку перевірки основної адреси.
Обов’язкове. Id для подій аналітики. UserCreator відмовляється створювати користувача без нього; шляхи реєстрації та модулі LDAP, SAML і OIDC передають випадковий UUID (UserRegistrationHandler.mjs:103, modules/login-register/app/src/RegisterController.mjs:127). Міграції 20260424120000 і 20260616070000_back_fill_users_analyticsId заповнили його з _id для старих облікових записів.
User.mjs:246, UserCreator.mjs:57-58
onboardingEmailSentAt
Date
Коли було надіслано вітальний лист. Лист планується лише за увімкненої функції saas, тому CE його не задає.
Лише в схемі: ядро CE і наші модулі їх не використовують.
User.mjs:87, :234, :231
overleaf
Object
id, accessToken, refreshToken пов’язаного облікового запису overleaf.com v1. overleaf.id має унікальний індекс; ніщо в CE не записує ці поля.
User.mjs:230-234
Відстеження входів і активності
Поле
Тип
Значення
Джерело
lastLoginIp
String
IP останнього входу.
User.mjs:85, AuthenticationController.mjs:381
loginCount
Number
Кількість успішних входів.
User.mjs:88, AuthenticationController.mjs:623
lastLoggedIn
Date
Час останнього успішного входу.
User.mjs:84, AuthenticationController.mjs:622
loginEpoch
Number
Блокування для входів: кожна спроба входу збільшує значення й оновлює документ лише тоді, коли в ньому досі прочитане значення, тож два паралельні входи не можуть пройти обидва. Модулі LDAP, SAML і OIDC роблять те саме.
Параметри відображення редактора. За замовчуванням false, true, false, false, true.
User.mjs:104, :109-110, :112-113
ace.referencesSearchMode
String
advanced або simple.
User.mjs:111, UserController.mjs:513-515
ace.zotero / ace.mendeley / ace.papers
Object
Налаштування менеджера бібліографії: enabled (за замовчуванням true), groups (масив { id }), disablePersonalLibrary.
User.mjs:10-22, :114-116
Прапорці функцій і обмеження (features)
features є результатом обчислення, і редагувати його вручну не потрібно. FeaturesUpdater починає з Settings.defaultFeatures, об’єднує кожен непрострочений запис featuresOverrides і записує результат разом із featuresUpdatedAt (FeaturesUpdater.mjs:220-300, UserFeaturesUpdater.mjs:10-24). Робочий образ задає за замовчуванням collaborators, dropbox, versioning, compileTimeout, compileGroup, trackChanges і references (server-ce/config/settings.js:301-309); решта ключів лишається незаданою.В Ayakaleaf Pro панель адміністратора вимикає функції для окремих користувачів. Модуль admin-tools зберігає їх як запис featuresOverrides з note: 'admin-panel' (modules/admin-tools/app/src/AdminFeatures.mjs:13-30), а модуль instance-features вважає незаданий ключ увімкненим (modules/instance-features/app/src/UserFeatures.mjs:12-14).
Поле
Тип
Значення
Джерело
features.collaborators
Number
Максимум співавторів у проєкті, -1 = без обмежень.
Синхронізація з Dropbox, синхронізація з GitHub, GitLab і Gitea та доступ через Git. Перевіряються відповідними модулями, див. requireUserFeature. gitlab і gitea (починаючи з v6.3.4) не мають значення за замовчуванням: вони лишаються незаданими, що вважається увімкненим, доки адміністратор не вимкне їх на вкладці Features. Міграція 20230817081910_back_fill_gitBridge_feature_server_pro встановила gitBridge: true для всіх користувачів.
User.mjs:127-131
features.compileTimeout
Number
Тайм-аут компіляції в секундах. COMPILE_TIMEOUT задає значення за замовчуванням.
User.mjs:132
features.compileGroup
String
Група компіляції, наприклад standard.
User.mjs:136
features.references
Boolean
Застаріло. Для старих облікових записів досі вмикає referencesSearch і mendeley.
User.mjs:140, ProjectEditorHandler.mjs:72-77
features.trackChanges
Boolean
Відстеження змін. Модуль track-changes перевіряє його у власника проєкту.
Перемикачі пошуку бібліографії, палітри символів і офлайн-режиму.
User.mjs:151-163
features.aiUsageQuota
String
Рівень використання ШІ. За замовчуванням basic.
User.mjs:159
featuresOverrides
Масив Object
Зміни значень за замовчуванням для окремого користувача. Кожен запис має createdAt, expiresAt (після цієї дати ігнорується), note і features (ті самі ключі, що вище, плюс templates).
User.mjs:165-196, UserFeaturesUpdater.mjs:45-48
featuresUpdatedAt
Date
Коли features обчислювалося востаннє.
User.mjs:197
featuresEpoch
String
Копія Settings.featuresEpoch на момент останнього обчислення, використовується для оновлення старих облікових записів.
User.mjs:198, FeaturesUpdater.mjs:34-36
ШІ-асистент і помічник з помилками не є ключем features. Вони залежать від налаштувань ШІ екземпляра та aiFeatures.enabled, див. нижче.
Інтеграції
Поле
Тип
Значення
Джерело
aiFeatures.enabled
Boolean
false вимикає ШІ-асистента та помічника з помилками для цього користувача. За замовчуванням true.
Зашифровані облікові дані прив’язаного менеджера бібліографії, які записує модуль tpr-webmodule ({ encrypted } для Mendeley, { apiKeyEncrypted } для Zotero). Видаляються під час від’єднання.
Id облікового запису Dropbox. Відсутній у схемі: модуль dropbox записує його напряму. Унікальний, тож один обліковий запис Dropbox прив’язаний до одного користувача. Ядро використовує його, щоб знайти користувачів для синхронізації.
Зашифрований токен оновлення Dropbox. Відсутній у схемі, його записує модуль dropbox. Увесь об’єкт dropbox видаляється під час від’єднання.
DropboxHandler.mjs:111, :181
dropbox.cursor
String
Курсор Dropbox list_folder папки застосунку користувача, щоб наступне отримання читало лише новіші зміни. Відсутній у схемі: його записує third-party-datastore, лише поки користувач досі прив’язаний до того самого облікового запису Dropbox.
Цей обліковий запис створено в старішій версії. У ньому досі є поля, яких більше немає в схемі і які ніщо не читає: staffAccess, ace.enableNewEditor, features.aiErrorAssistant, aiErrorAssistant і writefull.enabled (тепер writefull.initialized). ace.breadcrumbs тепер за замовчуванням false.