users przechowuje jeden dokument na konto. Zawiera dane logowania, profil, ustawienia edytora, funkcje i aktywność. Schemat to services/web/app/src/models/User.mjs; większość zapisów przechodzi przez services/web/app/src/Features/User/UserUpdater.mjs. W kolumnie Źródło User.mjs:N to wiersz tego schematu, inne nazwy plików bez ścieżki znajdują się w services/web/app/src/Features/, a modules/... w services/web/. Numery wierszy pochodzą z server-pro z chwili pisania.
Podstawowa tożsamość i uwierzytelnianie
Pole
Typ
Znaczenie
Źródło
_id
ObjectId
Id użytkownika. Inne kolekcje wskazują tutaj przez user_id, owner_ref i podobne pola.
MongoDB
email
String
Główny adres e-mail. Unikalny, także bez rozróżniania wielkości liter (zobacz Indeksy).
User.mjs:26
emails
Tablica Object
Wszystkie adresy konta. Główny to wpis równy email.
User.mjs:27
emails.email
String
Adres.
User.mjs:29
emails.reversedHostname
String
Domena adresu, odwrócona (moc.elpmaxe). Ustawiana przy dodawaniu adresu.
Kiedy adres został potwierdzony po raz pierwszy (późniejsze potwierdzenie zachowuje wcześniejszą datę). Moduły LDAP, SAML i OIDC ustawiają emails.0.confirmedAt przy tworzeniu konta.
Skrót bcrypt hasła lokalnego. Brak go w kontach bez hasła: logowania LDAP i SAML go usuwają, a migracja 20260511150000_reset_hardcoded_admin_password usuwa znane hasło domyślne.
createdAt, enrolledAt, secretEncrypted. Tylko w schemacie: rdzeń CE i nasze moduły go nie używają.
User.mjs:239-243
Stan konta i cykl życia
Pole
Typ
Znaczenie
Źródło
signUpDate
Date
Kiedy konto zostało utworzone.
User.mjs:75
suspended
Boolean
true, gdy administrator wyłączył konto. UserUpdater.suspendUser ustawia je i kończy sesje; moduł admin-tools je wywołuje i może przywrócić. Każdy punkt wejścia, który nie jest za sesją (tokeny, podpisane linki, websockety, webhooki), musi je sprawdzać.
Gdy ma wartość true, logowanie kieruje użytkownika na stronę ponownego potwierdzenia zamiast do edytora. Reset hasła ustawia je z powrotem na false. Nic w CE nie ustawia go na true.
Ostatni raz, gdy użytkownik potwierdził, że główny adres e-mail nadal należy do niego, lub zmienił główny adres. Sprawdza to tylko overleaf.com (saas): gdy wartość jest zbyt stara, lista projektów przekierowuje na stronę sprawdzania głównego adresu e-mail.
Wymagane. Id używany w zdarzeniach analitycznych. UserCreator odmawia utworzenia użytkownika bez niego; ścieżki rejestracji i moduły LDAP, SAML i OIDC przekazują losowy UUID (UserRegistrationHandler.mjs:103, modules/login-register/app/src/RegisterController.mjs:127). Migracje 20260424120000 i 20260616070000_back_fill_users_analyticsId uzupełniły go na podstawie _id dla starych kont.
User.mjs:246, UserCreator.mjs:57-58
onboardingEmailSentAt
Date
Kiedy wysłano wiadomość powitalną. Wiadomość jest planowana tylko przy włączonej funkcji saas, więc CE tego nie ustawia.
Tylko w schemacie: rdzeń CE i nasze moduły ich nie używają.
User.mjs:87, :234, :231
overleaf
Object
id, accessToken, refreshToken powiązanego konta overleaf.com v1. overleaf.id ma unikalny indeks; nic w CE nie zapisuje tych pól.
User.mjs:230-234
Śledzenie logowań i aktywności
Pole
Typ
Znaczenie
Źródło
lastLoginIp
String
IP ostatniego logowania.
User.mjs:85, AuthenticationController.mjs:381
loginCount
Number
Liczba udanych logowań.
User.mjs:88, AuthenticationController.mjs:623
lastLoggedIn
Date
Czas ostatniego udanego logowania.
User.mjs:84, AuthenticationController.mjs:622
loginEpoch
Number
Blokada logowań: każda próba logowania zwiększa wartość i aktualizuje dokument tylko wtedy, gdy nadal ma odczytaną wartość, więc dwa równoległe logowania nie mogą przejść jednocześnie. Moduły LDAP, SAML i OIDC działają tak samo.
Ustawienia menedżera bibliografii: enabled (domyślnie true), groups (tablica { id }), disablePersonalLibrary.
User.mjs:10-22, :114-116
Flagi funkcji i limity (features)
features to wynik obliczeń, a nie coś do ręcznej edycji. FeaturesUpdater zaczyna od Settings.defaultFeatures, scala każdy niewygasły wpis featuresOverrides i zapisuje wynik wraz z featuresUpdatedAt (FeaturesUpdater.mjs:220-300, UserFeaturesUpdater.mjs:10-24). Obraz produkcyjny ustawia jako domyślne collaborators, dropbox, versioning, compileTimeout, compileGroup, trackChanges i references (server-ce/config/settings.js:301-309); pozostałe klucze pozostają nieustawione.W Ayakaleaf Pro panel administracyjny wyłącza funkcje dla poszczególnych użytkowników. Moduł admin-tools zapisuje je jako wpis featuresOverrides z note: 'admin-panel' (modules/admin-tools/app/src/AdminFeatures.mjs:13-30), a moduł instance-features traktuje nieustawiony klucz jako włączony (modules/instance-features/app/src/UserFeatures.mjs:12-14).
Pole
Typ
Znaczenie
Źródło
features.collaborators
Number
Maksymalna liczba współpracowników na projekt, -1 = bez limitu.
Synchronizacja z Dropbox, synchronizacja z GitHub, GitLab i Gitea oraz dostęp przez Git. Sprawdzane przez te moduły, zobacz requireUserFeature. gitlab i gitea (od v6.3.4) nie mają wartości domyślnej: pozostają nieustawione, co oznacza włączenie, dopóki administrator nie wyłączy ich na karcie Features. Migracja 20230817081910_back_fill_gitBridge_feature_server_pro ustawiła gitBridge: true wszystkim użytkownikom.
User.mjs:127-131
features.compileTimeout
Number
Limit czasu kompilacji w sekundach. COMPILE_TIMEOUT ustawia wartość domyślną.
User.mjs:132
features.compileGroup
String
Grupa kompilacji, na przykład standard.
User.mjs:136
features.references
Boolean
Przestarzałe. W starszych kontach nadal włącza referencesSearch i mendeley.
User.mjs:140, ProjectEditorHandler.mjs:72-77
features.trackChanges
Boolean
Śledzenie zmian. Moduł track-changes sprawdza je u właściciela projektu.
Przełączniki wyszukiwania bibliografii, palety symboli i trybu offline.
User.mjs:151-163
features.aiUsageQuota
String
Poziom korzystania z AI. Domyślnie basic.
User.mjs:159
featuresOverrides
Tablica Object
Zmiany wartości domyślnych dla danego użytkownika. Każdy wpis ma createdAt, expiresAt (ignorowany po tej dacie), note i features (te same klucze co wyżej oraz templates).
User.mjs:165-196, UserFeaturesUpdater.mjs:45-48
featuresUpdatedAt
Date
Kiedy features obliczono ostatnio.
User.mjs:197
featuresEpoch
String
Kopia Settings.featuresEpoch z ostatniego obliczenia, używana do odświeżania starych kont.
User.mjs:198, FeaturesUpdater.mjs:34-36
Asystent AI i asystent błędów nie są kluczem features. Kierują się ustawieniami AI instancji i aiFeatures.enabled, zobacz niżej.
Integracje
Pole
Typ
Znaczenie
Źródło
aiFeatures.enabled
Boolean
false wyłącza asystenta AI i asystenta błędów dla tego użytkownika. Domyślnie true.
Zaszyfrowane dane uwierzytelniające powiązanego menedżera bibliografii, zapisywane przez moduł tpr-webmodule ({ encrypted } dla Mendeley, { apiKeyEncrypted } dla Zotero). Usuwane po odłączeniu.
Id konta Dropbox. Nie ma go w schemacie: moduł dropbox zapisuje go bezpośrednio. Unikalny, więc jedno konto Dropbox jest powiązane z jednym użytkownikiem. Rdzeń używa go do znajdowania użytkowników do synchronizacji.
Zaszyfrowany token odświeżania Dropbox. Nie ma go w schemacie, zapisuje go moduł dropbox. Cały obiekt dropbox jest usuwany po odłączeniu.
DropboxHandler.mjs:111, :181
dropbox.cursor
String
Kursor Dropbox list_folder folderu aplikacji użytkownika, aby kolejne pobranie czytało tylko nowsze zmiany. Nie ma go w schemacie: zapisuje go third-party-datastore, tylko dopóki użytkownik jest nadal powiązany z tym samym kontem Dropbox.
Grupowe SSO (tablica sso z groupId, linkedAt, primary) i pola użytkowników zarządzanych (managedBy, enrolledAt). Subskrypcje grupowe nie są częścią CE.
User.mjs:56-72
writefull
Object
Stan Writefull: initialized, autoCreatedAccount, isPremium, premiumSource. Rdzeń zapisuje go tylko przy włączonej funkcji saas, więc nie w CE.
To konto zostało utworzone w starszej wersji. Nadal ma pola, których nie ma już w schemacie i których nic nie odczytuje: staffAccess, ace.enableNewEditor, features.aiErrorAssistant, aiErrorAssistant i writefull.enabled (teraz writefull.initialized). ace.breadcrumbs ma teraz domyślnie wartość false.