users enthält ein Dokument pro Konto. Es speichert Anmeldedaten, das Profil, Editor-Einstellungen, Features und Aktivität. Das Schema ist services/web/app/src/models/User.mjs; die meisten Schreibzugriffe laufen über services/web/app/src/Features/User/UserUpdater.mjs. In der Spalte Quelle ist User.mjs:N eine Zeile dieses Schemas, andere Dateinamen ohne Pfad liegen unter services/web/app/src/Features/ und modules/... liegt unter services/web/. Die Zeilennummern stammen aus server-pro zum Zeitpunkt der Erstellung.
Kernidentität & Authentifizierung
Feld
Typ
Bedeutung
Quelle
_id
ObjectId
ID des Benutzers. Andere Collections verweisen mit user_id, owner_ref und ähnlichen Feldern hierher.
MongoDB
email
String
Primäre E-Mail-Adresse. Eindeutig, auch ohne Beachtung der Groß-/Kleinschreibung (siehe Indizes).
User.mjs:26
emails
Array von Object
Alle Adressen des Kontos. Die primäre ist der Eintrag, der gleich email ist.
User.mjs:27
emails.email
String
Die Adresse.
User.mjs:29
emails.reversedHostname
String
Domain der Adresse, umgekehrt (moc.elpmaxe). Wird beim Hinzufügen der Adresse gesetzt.
Wann die Adresse zum ersten Mal bestätigt wurde (eine spätere Bestätigung behält das frühere Datum). Die Module LDAP, SAML und OIDC setzen emails.0.confirmedAt, wenn sie ein Konto anlegen.
bcrypt-Hash des lokalen Passworts. Fehlt bei Konten ohne Passwort: LDAP- und SAML-Anmeldungen entfernen ihn, und die Migration 20260511150000_reset_hardcoded_admin_password entfernt ein bekanntes Standardpasswort.
createdAt, enrolledAt, secretEncrypted. Nur im Schema: Der CE-Core und unsere Module verwenden es nicht.
User.mjs:239-243
Kontostatus & Lebenszyklus
Feld
Typ
Bedeutung
Quelle
signUpDate
Date
Wann das Konto erstellt wurde.
User.mjs:75
suspended
Boolean
true, wenn ein Administrator das Konto deaktiviert hat. UserUpdater.suspendUser setzt es und beendet die Sitzungen; das Modul admin-tools ruft es auf und kann es zurücksetzen. Jeder Einstiegspunkt, der nicht hinter einer Sitzung liegt (Tokens, signierte Links, Websockets, Webhooks), muss es prüfen.
true für ein Platzhalterkonto, dessen Registrierung nicht abgeschlossen ist. Die Registrierung setzt es auf false; Kontakte überspringen Platzhalterkonten.
Bei true leitet die Anmeldung den Benutzer statt zum Editor auf die Seite zur erneuten Bestätigung. Ein Zurücksetzen des Passworts setzt es wieder auf false. Nichts in CE setzt es auf true.
Letzter Zeitpunkt, an dem der Benutzer bestätigt hat, dass die primäre E-Mail-Adresse noch ihm gehört, oder sie geändert hat. Nur overleaf.com (saas) prüft es: Ist es zu alt, leitet die Projektliste auf die Seite zur Prüfung der primären E-Mail-Adresse weiter.
Pflichtfeld. ID für Analyseereignisse. UserCreator legt ohne sie keinen Benutzer an; die Registrierungswege und die Module LDAP, SAML und OIDC übergeben eine zufällige UUID (UserRegistrationHandler.mjs:103, modules/login-register/app/src/RegisterController.mjs:127). Die Migrationen 20260424120000 und 20260616070000_back_fill_users_analyticsId haben sie für alte Konten aus _id befüllt.
User.mjs:246, UserCreator.mjs:57-58
onboardingEmailSentAt
Date
Wann die Onboarding-E-Mail gesendet wurde. Die E-Mail wird nur geplant, wenn das Feature saas aktiv ist, daher setzt CE es nicht.
Nur im Schema: Der CE-Core und unsere Module verwenden sie nicht.
User.mjs:87, :234, :231
overleaf
Object
id, accessToken, refreshToken eines verknüpften overleaf.com-v1-Kontos. overleaf.id hat einen eindeutigen Index; nichts in CE schreibt diese Felder.
User.mjs:230-234
Anmelde- & Aktivitätsverfolgung
Feld
Typ
Bedeutung
Quelle
lastLoginIp
String
IP der letzten Anmeldung.
User.mjs:85, AuthenticationController.mjs:381
loginCount
Number
Anzahl erfolgreicher Anmeldungen.
User.mjs:88, AuthenticationController.mjs:623
lastLoggedIn
Date
Zeitpunkt der letzten erfolgreichen Anmeldung.
User.mjs:84, AuthenticationController.mjs:622
loginEpoch
Number
Sperre für Anmeldungen: Jeder Anmeldeversuch erhöht den Wert und aktualisiert das Dokument nur, wenn es noch den gelesenen Wert hat, sodass nicht zwei parallele Anmeldungen gleichzeitig durchkommen. Die Module LDAP, SAML und OIDC machen es genauso.
Anzeigeoptionen des Editors. Standardwerte false, true, false, false, true.
User.mjs:104, :109-110, :112-113
ace.referencesSearchMode
String
advanced oder simple.
User.mjs:111, UserController.mjs:513-515
ace.zotero / ace.mendeley / ace.papers
Object
Einstellungen des Literaturverwaltungsprogramms: enabled (Standard true), groups (Array von { id }), disablePersonalLibrary.
User.mjs:10-22, :114-116
Feature-Flags & Limits (features)
features ist das Ergebnis einer Berechnung und nicht zum manuellen Bearbeiten gedacht. FeaturesUpdater beginnt mit Settings.defaultFeatures, führt jeden nicht abgelaufenen Eintrag in featuresOverrides zusammen und schreibt das Ergebnis mit featuresUpdatedAt (FeaturesUpdater.mjs:220-300, UserFeaturesUpdater.mjs:10-24). Das Produktions-Image setzt collaborators, dropbox, versioning, compileTimeout, compileGroup, trackChanges und references als Standardwerte (server-ce/config/settings.js:301-309); die übrigen Schlüssel bleiben ungesetzt.In Ayakaleaf Pro schaltet das Admin-Panel Features pro Benutzer ab. Das Modul admin-tools speichert sie als Eintrag in featuresOverrides mit note: 'admin-panel' (modules/admin-tools/app/src/AdminFeatures.mjs:13-30), und das Modul instance-features behandelt einen ungesetzten Schlüssel als aktiviert (modules/instance-features/app/src/UserFeatures.mjs:12-14).
Feld
Typ
Bedeutung
Quelle
features.collaborators
Number
Maximale Anzahl Mitarbeiter pro Projekt, -1 = unbegrenzt.
Dropbox-Synchronisierung, GitHub-, GitLab- und Gitea-Synchronisierung sowie Git-Zugriff. Von diesen Modulen geprüft, siehe requireUserFeature. gitlab und gitea (ab v6.3.4) haben keinen Standardwert: Sie bleiben ungesetzt, was als aktiviert gilt, bis ein Administrator sie auf dem Tab Features abschaltet. Die Migration 20230817081910_back_fill_gitBridge_feature_server_pro hat gitBridge: true für alle Benutzer gesetzt.
User.mjs:127-131
features.compileTimeout
Number
Kompilierungs-Timeout in Sekunden. COMPILE_TIMEOUT legt den Standardwert fest.
User.mjs:132
features.compileGroup
String
Kompilierungsgruppe, zum Beispiel standard.
User.mjs:136
features.references
Boolean
Veraltet. Bei älteren Konten aktiviert es weiterhin referencesSearch und mendeley.
User.mjs:140, ProjectEditorHandler.mjs:72-77
features.trackChanges
Boolean
Änderungsverfolgung. Das Modul track-changes prüft es beim Projekteigentümer.
Schalter für die Literatursuche, die Symbolpalette und den Offlinemodus.
User.mjs:151-163
features.aiUsageQuota
String
KI-Nutzungsstufe. Standard basic.
User.mjs:159
featuresOverrides
Array von Object
Benutzerspezifische Änderungen an den Standardwerten. Jeder Eintrag hat createdAt, expiresAt (nach diesem Datum ignoriert), note und features (dieselben Schlüssel wie oben, plus templates).
User.mjs:165-196, UserFeaturesUpdater.mjs:45-48
featuresUpdatedAt
Date
Wann features zuletzt berechnet wurde.
User.mjs:197
featuresEpoch
String
Kopie von Settings.featuresEpoch bei der letzten Berechnung, um alte Konten zu aktualisieren.
User.mjs:198, FeaturesUpdater.mjs:34-36
Der KI-Assistent und der Fehlerassistent sind kein Schlüssel in features. Sie richten sich nach den KI-Einstellungen der Instanz und aiFeatures.enabled, siehe unten.
Integrationen
Feld
Typ
Bedeutung
Quelle
aiFeatures.enabled
Boolean
false schaltet den KI-Assistenten und den Fehlerassistenten für diesen Benutzer ab. Standard true.
Verschlüsselte Zugangsdaten des verknüpften Literaturverwaltungsprogramms, vom Modul tpr-webmodule geschrieben ({ encrypted } für Mendeley, { apiKeyEncrypted } für Zotero). Wird beim Trennen entfernt.
Dropbox-Konto-ID. Nicht im Schema: Das Modul dropbox schreibt sie direkt. Eindeutig, sodass ein Dropbox-Konto mit genau einem Benutzer verknüpft ist. Der Core verwendet sie, um die zu synchronisierenden Benutzer zu finden.
Verschlüsseltes Dropbox-Refresh-Token. Nicht im Schema, vom Modul dropbox geschrieben. Das gesamte Objekt dropbox wird beim Trennen entfernt.
DropboxHandler.mjs:111, :181
dropbox.cursor
String
Dropbox-Cursor list_folder des App-Ordners des Benutzers, damit der nächste Abruf nur neuere Änderungen liest. Nicht im Schema: von third-party-datastore geschrieben, nur solange der Benutzer noch mit demselben Dropbox-Konto verknüpft ist.
Gruppen-SSO (Array sso aus groupId, linkedAt, primary) und Felder für verwaltete Benutzer (managedBy, enrolledAt). Gruppenabonnements sind nicht Teil von CE.
User.mjs:56-72
writefull
Object
Writefull-Status: initialized, autoCreatedAccount, isPremium, premiumSource. Der Core schreibt ihn nur, wenn das Feature saas aktiv ist, also nicht in CE.
Mongoose autoIndex ist deaktiviert (services/web/app/src/infrastructure/Mongoose.mjs:7), daher erstellen nur die oben genannten Migrationen Indizes.
Beim Löschen eines Benutzers wird das gesamte Dokument nach deletedUsers verschoben (siehe Deleted Users Collection).
Hier ist ein reales Beispiel für einen Overleaf-Benutzer.
Dieses Konto wurde mit einer älteren Version erstellt. Es hat noch Felder, die nicht mehr im Schema stehen und die nichts liest: staffAccess, ace.enableNewEditor, features.aiErrorAssistant, aiErrorAssistant und writefull.enabled (jetzt writefull.initialized). ace.breadcrumbs hat jetzt den Standardwert false.