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.
Id учётной записи Dropbox. Отсутствует в схеме: модуль dropbox записывает его напрямую. Уникален, поэтому одна учётная запись Dropbox привязана к одному пользователю. Ядро использует его, чтобы найти пользователей для синхронизации.
Зашифрованный токен обновления Dropbox. Отсутствует в схеме, записывается модулем dropbox. Весь объект dropbox удаляется при отвязке.
DropboxHandler.mjs:111, :181
dropbox.cursor
String
Курсор Dropbox list_folder папки приложения пользователя, чтобы следующая загрузка читала только более новые изменения. Отсутствует в схеме: записывается third-party-datastore, только пока пользователь всё ещё привязан к той же учётной записи Dropbox.
Групповой SSO (массив sso из groupId, linkedAt, primary) и поля управляемых пользователей (managedBy, enrolledAt). Групповые подписки не входят в CE.
User.mjs:56-72
writefull
Object
Состояние Writefull: initialized, autoCreatedAccount, isPremium, premiumSource. Ядро записывает его только при включённой функции saas, то есть не в CE.
autoIndex в Mongoose отключён (services/web/app/src/infrastructure/Mongoose.mjs:7), поэтому индексы создают только перечисленные выше миграции.
При удалении пользователя весь документ перемещается в deletedUsers (см. Deleted Users Collection).
Вот реальный пример пользователя Overleaf.
Эта учётная запись была создана в более старой версии. В ней всё ещё есть поля, которых больше нет в схеме и которые ничто не читает: staffAccess, ace.enableNewEditor, features.aiErrorAssistant, aiErrorAssistant и writefull.enabled (теперь writefull.initialized). ace.breadcrumbs теперь по умолчанию false.