تحتفظ 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
معرّف المستخدم. تشير المجموعات الأخرى إلى هنا عبر 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). يُعيَّن عند إضافة العنوان.
تجزئة 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 ويمكنها إعادته. يجب على كل نقطة دخول لا تقع خلف جلسة (الرموز المميزة، والروابط الموقّعة، وwebsockets، وwebhooks) أن تتحقق منه.
عندما تكون قيمته true، يرسل تسجيل الدخول المستخدم إلى صفحة إعادة التأكيد بدلًا من المحرر. تعيده إعادة تعيين كلمة المرور إلى false. لا شيء في CE يعيّنه إلى true.
آخر مرة أكّد فيها المستخدم أن البريد الأساسي لا يزال له، أو غيّر البريد الأساسي. لا يتحقق منه إلا overleaf.com (saas): عندما يكون قديمًا جدًا، تعيد قائمة المشاريع التوجيه إلى صفحة التحقق من البريد الأساسي.
موجودة في المخطط فقط: لا تستخدمها نواة 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.
معرّف حساب Dropbox. غير موجود في المخطط: تكتبه وحدة dropbox مباشرة. فريد، لذا يرتبط حساب Dropbox واحد بمستخدم واحد. تستخدمه النواة للعثور على المستخدمين المطلوب مزامنتهم.
رمز تحديث Dropbox مشفّر. غير موجود في المخطط، تكتبه وحدة dropbox. يُزال كائن dropbox بالكامل عند فك الربط.
DropboxHandler.mjs:111, :181
dropbox.cursor
String
مؤشر Dropbox list_folder لمجلد تطبيق المستخدم، حتى لا يقرأ السحب التالي إلا التغييرات الأحدث. غير موجود في المخطط: يكتبه third-party-datastore، فقط ما دام المستخدم مرتبطًا بحساب Dropbox نفسه.
تسجيل الدخول الموحد للمجموعات (مصفوفة sso من groupId وlinkedAt وprimary) وحقول المستخدمين المُدارين (managedBy وenrolledAt). اشتراكات المجموعات ليست جزءًا من CE.
User.mjs:56-72
writefull
Object
حالة Writefull: initialized وautoCreatedAccount وisPremium وpremiumSource. لا تكتبها النواة إلا عند تفعيل ميزة saas، لذا ليست في CE.
أُنشئ هذا الحساب في إصدار أقدم. لا تزال فيه حقول لم تعد موجودة في المخطط ولا يقرؤها أي شيء: staffAccess وace.enableNewEditor وfeatures.aiErrorAssistant وaiErrorAssistant وwritefull.enabled (أصبح الآن writefull.initialized). القيمة الافتراضية لـ ace.breadcrumbs أصبحت الآن false.