users, hesap başına bir belge tutar. Oturum açma verilerini, profili, editör ayarlarını, özellikleri ve etkinliği saklar. Şema services/web/app/src/models/User.mjs dosyasıdır; yazma işlemlerinin çoğu services/web/app/src/Features/User/UserUpdater.mjs üzerinden geçer. Kaynak sütununda User.mjs:N bu şemanın bir satırıdır, yolu verilmeyen diğer dosya adları services/web/app/src/Features/ altında, modules/... ise services/web/ altındadır. Satır numaraları, yazıldığı tarihteki server-pro sürümünden alınmıştır.
Temel Kimlik ve Kimlik Doğrulama
Alan
Tür
Anlamı
Kaynak
_id
ObjectId
Kullanıcının kimliği. Diğer koleksiyonlar buraya user_id, owner_ref ve benzeri alanlarla işaret eder.
MongoDB
email
String
Birincil e-posta. Büyük/küçük harf duyarsız olarak da benzersizdir (bkz. Dizinler).
User.mjs:26
emails
Object dizisi
Hesabın tüm adresleri. Birincil adres, email ile eşit olan giriştir.
User.mjs:27
emails.email
String
Adres.
User.mjs:29
emails.reversedHostname
String
Adresin ters çevrilmiş alan adı (moc.elpmaxe). Adres eklendiğinde ayarlanır.
Adresin ilk onaylandığı zaman (sonraki bir onay önceki tarihi korur). LDAP, SAML ve OIDC modülleri bir hesap oluştururken emails.0.confirmedAt değerini ayarlar.
Yerel parolanın bcrypt özeti. Parolası olmayan hesaplarda yoktur: LDAP ve SAML oturum açmaları onu kaldırır ve 20260511150000_reset_hardcoded_admin_password geçişi bilinen bir varsayılan parolayı kaldırır.
createdAt, enrolledAt, secretEncrypted. Yalnızca şemada: CE çekirdeği ve modüllerimiz bunu kullanmaz.
User.mjs:239-243
Hesap Durumu ve Yaşam Döngüsü
Alan
Tür
Anlamı
Kaynak
signUpDate
Date
Hesabın oluşturulduğu zaman.
User.mjs:75
suspended
Boolean
Bir yönetici hesabı devre dışı bıraktığında true. UserUpdater.suspendUser bunu ayarlar ve oturumları sonlandırır; admin-tools modülü onu çağırır ve geri alabilir. Bir oturumun arkasında olmayan her giriş noktası (belirteçler, imzalı bağlantılar, websocket’ler, webhook’lar) bunu denetlemelidir.
true olduğunda oturum açma, kullanıcıyı editör yerine yeniden onay sayfasına gönderir. Parola sıfırlama bunu yeniden false yapar. CE’de hiçbir şey bunu true yapmaz.
Kullanıcının birincil e-postanın hâlâ kendisine ait olduğunu en son onayladığı ya da birincil e-postayı değiştirdiği zaman. Bunu yalnızca overleaf.com (saas) denetler: çok eskiyse proje listesi birincil e-posta denetimi sayfasına yönlendirir.
Zorunlu. Analiz olayları için kullanılan kimlik. UserCreator bu olmadan kullanıcı oluşturmayı reddeder; kayıt yolları ile LDAP, SAML ve OIDC modülleri rastgele bir UUID iletir (UserRegistrationHandler.mjs:103, modules/login-register/app/src/RegisterController.mjs:127). 20260424120000 ve 20260616070000_back_fill_users_analyticsId geçişleri eski hesaplar için bunu _id üzerinden doldurdu.
User.mjs:246, UserCreator.mjs:57-58
onboardingEmailSentAt
Date
Karşılama e-postasının gönderildiği zaman. E-posta yalnızca saas özelliği açıkken planlanır, bu yüzden CE bunu ayarlamaz.
Yalnızca şemada: CE çekirdeği ve modüllerimiz bunları kullanmaz.
User.mjs:87, :234, :231
overleaf
Object
Bağlı bir overleaf.com v1 hesabının id, accessToken, refreshToken değerleri. overleaf.id benzersiz bir dizine sahiptir; CE’de hiçbir şey bu alanları yazmaz.
User.mjs:230-234
Oturum Açma ve Etkinlik Takibi
Alan
Tür
Anlamı
Kaynak
lastLoginIp
String
Son oturum açmanın IP adresi.
User.mjs:85, AuthenticationController.mjs:381
loginCount
Number
Başarılı oturum açma sayısı.
User.mjs:88, AuthenticationController.mjs:623
lastLoggedIn
Date
Son başarılı oturum açmanın zamanı.
User.mjs:84, AuthenticationController.mjs:622
loginEpoch
Number
Oturum açmalar için kilit: her oturum açma denemesi değeri artırır ve belgeyi yalnızca okunan değer hâlâ geçerliyse günceller; böylece iki paralel oturum açma birlikte geçemez. LDAP, SAML ve OIDC modülleri de aynısını yapar.
Kaynakça yöneticisi ayarları: enabled (varsayılan true), groups ({ id } dizisi), disablePersonalLibrary.
User.mjs:10-22, :114-116
Özellik Bayrakları ve Sınırlar (features)
features bir hesaplamanın sonucudur, elle düzenlenecek bir şey değildir. FeaturesUpdater, Settings.defaultFeatures ile başlar, süresi dolmamış her featuresOverrides girdisini birleştirir ve sonucu featuresUpdatedAt ile yazar (FeaturesUpdater.mjs:220-300, UserFeaturesUpdater.mjs:10-24). Üretim imajı collaborators, dropbox, versioning, compileTimeout, compileGroup, trackChanges ve references değerlerini varsayılan olarak ayarlar (server-ce/config/settings.js:301-309); diğer anahtarlar ayarlanmamış kalır.Ayakaleaf Pro’da yönetici paneli özellikleri kullanıcı bazında kapatır. admin-tools modülü bunları note: 'admin-panel' içeren bir featuresOverrides girdisi olarak saklar (modules/admin-tools/app/src/AdminFeatures.mjs:13-30) ve instance-features modülü ayarlanmamış bir anahtarı açık kabul eder (modules/instance-features/app/src/UserFeatures.mjs:12-14).
Alan
Tür
Anlamı
Kaynak
features.collaborators
Number
Proje başına en fazla ortak çalışan sayısı, -1 = sınırsız.
Dropbox eşitlemesi, GitHub, GitLab ve Gitea eşitlemesi ile Git erişimi. Bu modüller tarafından denetlenir, bkz. requireUserFeature. gitlab ve gitea (v6.3.4’ten itibaren) varsayılana sahip değildir: bir yönetici bunları Features sekmesinde kapatana kadar ayarlanmamış kalırlar ve bu açık sayılır. 20230817081910_back_fill_gitBridge_feature_server_pro geçişi tüm kullanıcılar için gitBridge: true ayarladı.
User.mjs:127-131
features.compileTimeout
Number
Saniye cinsinden derleme zaman aşımı. COMPILE_TIMEOUT varsayılanı belirler.
User.mjs:132
features.compileGroup
String
Derleme grubu, örneğin standard.
User.mjs:136
features.references
Boolean
Kullanımdan kaldırıldı. Eski hesaplarda hâlâ referencesSearch ve mendeley özelliklerini açar.
User.mjs:140, ProjectEditorHandler.mjs:72-77
features.trackChanges
Boolean
Değişiklik takibi. track-changes modülü bunu proje sahibinde denetler.
Kaynakça arama, sembol paleti ve çevrimdışı mod için anahtarlar.
User.mjs:151-163
features.aiUsageQuota
String
Yapay zekâ kullanım düzeyi. Varsayılan basic.
User.mjs:159
featuresOverrides
Object dizisi
Varsayılanlarda kullanıcıya özel değişiklikler. Her girdinin createdAt, expiresAt (bu tarihten sonra yok sayılır), note ve features (yukarıdakiyle aynı anahtarlar, artı templates) alanları vardır.
User.mjs:165-196, UserFeaturesUpdater.mjs:45-48
featuresUpdatedAt
Date
features değerinin en son hesaplandığı zaman.
User.mjs:197
featuresEpoch
String
Son hesaplamadaki Settings.featuresEpoch değerinin kopyası; eski hesapları yenilemek için kullanılır.
User.mjs:198, FeaturesUpdater.mjs:34-36
Yapay zekâ asistanı ve hata asistanı bir features anahtarı değildir. Örnek düzeyindeki yapay zekâ ayarlarını ve aiFeatures.enabled değerini izlerler, aşağıya bakın.
Entegrasyonlar
Alan
Tür
Anlamı
Kaynak
aiFeatures.enabled
Boolean
false, bu kullanıcı için yapay zekâ asistanını ve hata asistanını kapatır. Varsayılan true.
Bağlı kaynakça yöneticisinin şifrelenmiş kimlik bilgileri; tpr-webmodule modülü tarafından yazılır (Mendeley için { encrypted }, Zotero için { apiKeyEncrypted }). Bağlantı kesildiğinde kaldırılır.
Dropbox hesap kimliği. Şemada yoktur: dropbox modülü bunu doğrudan yazar. Benzersizdir, böylece bir Dropbox hesabı tek bir kullanıcıya bağlanır. Çekirdek, eşitlenecek kullanıcıları bulmak için bunu kullanır.
Şifrelenmiş Dropbox yenileme belirteci. Şemada yoktur, dropbox modülü tarafından yazılır. Bağlantı kesildiğinde tüm dropbox nesnesi kaldırılır.
DropboxHandler.mjs:111, :181
dropbox.cursor
String
Kullanıcının uygulama klasörünün Dropbox list_folder imleci; böylece sonraki çekme yalnızca daha yeni değişiklikleri okur. Şemada yoktur: third-party-datastore tarafından, yalnızca kullanıcı hâlâ aynı Dropbox hesabına bağlıyken yazılır.
Grup SSO’su (groupId, linkedAt, primary içeren sso dizisi) ve yönetilen kullanıcı alanları (managedBy, enrolledAt). Grup abonelikleri CE’nin parçası değildir.
User.mjs:56-72
writefull
Object
Writefull durumu: initialized, autoCreatedAccount, isPremium, premiumSource. Çekirdek bunu yalnızca saas özelliği açıkken yazar, yani CE’de değil.
İşte bir Overleaf kullanıcısının gerçek bir örneği.
Bu hesap eski bir sürümde oluşturuldu. Artık şemada olmayan ve hiçbir şeyin okumadığı alanlara hâlâ sahiptir: staffAccess, ace.enableNewEditor, features.aiErrorAssistant, aiErrorAssistant ve writefull.enabled (artık writefull.initialized). ace.breadcrumbs artık varsayılan olarak false değerindedir.