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)입니다. 주소를 추가할 때 설정됩니다. | User.mjs:30, UserCreator.mjs:70, UserUpdater.mjs:123 |
emails.createdAt | Date | 주소를 추가한 시각입니다. | User.mjs:31 |
emails.confirmedAt | Date | 주소가 처음 확인된 시각입니다(이후 확인은 이전 날짜를 유지합니다). LDAP, SAML, OIDC 모듈은 계정을 만들 때 emails.0.confirmedAt을 설정합니다. | User.mjs:37, UserUpdater.mjs:402-404, modules/authentication/ldap/app/src/LDAPAuthenticationManager.mjs:56 |
emails.reconfirmedAt | Date | 주소를 가장 최근에 확인한 시각입니다. | User.mjs:40, UserUpdater.mjs:399-401 |
emails.samlProviderId | String | 주소의 기관 SSO 연결입니다. 기관 SSO는 CE에 포함되지 않습니다. | User.mjs:38 |
emails.affiliationUnchecked | Boolean | 기관 소속 상태입니다. CE에 포함되지 않습니다. | User.mjs:39 |
first_name / last_name | String | 프로필 이름이며 최대 255자입니다. LDAP, SAML, OIDC는 로그인할 때마다 이를 업데이트할 수 있습니다. | User.mjs:43, User.mjs:48 |
role / institution | String | 사용자가 계정 설정에서 직무와 기관으로 입력하는 자유 텍스트입니다. role은 권한이 아닙니다. | User.mjs:53-54, UserController.mjs:388, UserController.mjs:454 |
hashedPassword | String | 로컬 비밀번호의 bcrypt 해시입니다. 비밀번호가 없는 계정에는 없습니다. LDAP 및 SAML 로그인이 이를 제거하고, 마이그레이션 20260511150000_reset_hardcoded_admin_password가 알려진 기본 비밀번호를 제거합니다. | User.mjs:55, AuthenticationManager.mjs:108, LDAPAuthenticationManager.mjs:71 |
isAdmin | Boolean | 사이트 관리자입니다. LDAP, SAML, OIDC는 로그인할 때마다 IdP 속성에서 이를 설정할 수 있습니다. | User.mjs:73, LDAPAuthenticationManager.mjs:62-65 |
adminRoles | Array | 더 세분화된 관리자 역할입니다. Settings.adminRolesEnabled가 설정된 경우에만 읽습니다. | User.mjs:74, AuthorizationManager.mjs:156 |
samlIdentifiers | Object 배열 | SAML 로그인 연결입니다. saml 모듈은 samlIdentifiers.0.providerId(항상 '1'), externalUserId, userIdAttribute를 씁니다. | User.mjs:236, modules/authentication/saml/app/src/SAMLAuthenticationManager.mjs:36, :62-67 |
thirdPartyIdentifiers | Object 배열 | OIDC 로그인 연결로, 코어의 ThirdPartyIdentityManager가 oidc 모듈을 위해 씁니다. | User.mjs:237, modules/authentication/oidc/app/src/OIDCAuthenticationManager.mjs:80 |
twoFactorAuthentication | Object | createdAt, enrolledAt, secretEncrypted입니다. 스키마에만 있으며 CE 코어와 우리 모듈은 사용하지 않습니다. | User.mjs:239-243 |
계정 상태 및 수명 주기
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
signUpDate | Date | 계정을 만든 시각입니다. | User.mjs:75 |
suspended | Boolean | 관리자가 계정을 비활성화하면 true입니다. UserUpdater.suspendUser가 이를 설정하고 세션을 종료합니다. admin-tools 모듈이 이를 호출하며 되돌릴 수 있습니다. 세션 뒤에 있지 않은 모든 진입점(토큰, 서명된 링크, 웹소켓, 웹훅)은 이를 확인해야 합니다. | User.mjs:248, UserUpdater.mjs:613-616, modules/admin-tools/app/src/AdminUserManager.mjs:360 |
holdingAccount | Boolean | 등록을 마치지 않은 임시 계정이면 true입니다. 등록하면 false로 설정되며, 연락처는 임시 계정을 건너뜁니다. | User.mjs:89, UserRegistrationHandler.mjs:27-30, ContactController.mjs:45 |
must_reconfirm | Boolean | true이면 로그인 시 편집기 대신 재확인 페이지로 이동합니다. 비밀번호를 재설정하면 다시 false가 됩니다. CE에서는 아무것도 이를 true로 설정하지 않습니다. | User.mjs:201, AuthenticationController.mjs:215, UserUpdater.mjs:603-610 |
lastPrimaryEmailCheck | Date | 사용자가 기본 이메일이 여전히 본인 것임을 마지막으로 확인했거나 기본 이메일을 변경한 시각입니다. overleaf.com(saas)만 이를 확인하며, 너무 오래되면 프로젝트 목록이 기본 이메일 확인 페이지로 리디렉션합니다. | User.mjs:86, UserUpdater.mjs:259, UserEmailsController.mjs:488, Project/ProjectListController.mjs:234, :280-290 |
analyticsId | String | 필수입니다. 분석 이벤트에 사용하는 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에서는 설정되지 않습니다. | User.mjs:244, UserCreator.mjs:123-125, UserOnboardingEmailManager.mjs:24 |
lastTrial, migratedAt, awareOfV2 | Date / Date / Boolean | 스키마에만 있으며 CE 코어와 우리 모듈은 사용하지 않습니다. | User.mjs:87, :234, :231 |
overleaf | Object | 연결된 overleaf.com v1 계정의 id, accessToken, refreshToken입니다. 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 모듈도 같은 방식입니다. | User.mjs:81, AuthenticationManager.mjs:130-137, OIDCAuthenticationManager.mjs:100 |
lastFailedLogin | Date | 마지막으로 비밀번호가 틀린 시각입니다. | User.mjs:83, AuthenticationManager.mjs:131-132 |
lastActive | Date | 사용자가 마지막으로 프로젝트를 연 시각입니다. | User.mjs:82, ProjectController.mjs:919-921 |
편집기 환경설정 (ace)
계정 설정 페이지는 UserController.updateUserSettings(UserController.mjs:460-530)를 통해 이를 저장합니다.
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
ace.mode | String | 키 바인딩입니다. 설정 페이지는 default, vim, emacs 중 하나를 저장하며, 스키마 기본값은 none입니다. | User.mjs:91, services/web/frontend/js/features/ide-settings/components/editor-settings/keybinding-setting.tsx:6-16 |
ace.theme | String | 편집기 테마입니다. 기본값 textmate. | User.mjs:92 |
ace.overallTheme | String | UI 테마입니다. system은 lightTheme과 darkTheme 사이를 전환하고, light- 또는 빈 값은 theme을 사용합니다. | User.mjs:93-95 |
ace.lightTheme / ace.darkTheme | String | overallTheme: system과 함께 쓰는 편집기 테마입니다. 기본값 textmate와 overleaf_dark. | User.mjs:96-97 |
ace.fontSize | Number | 편집기 글꼴 크기입니다. 기본값 12. | User.mjs:98 |
ace.fontFamily / ace.lineHeight | String | 편집기 글꼴과 줄 높이입니다. | User.mjs:105-106 |
ace.autoComplete / ace.autoPairDelimiters | Boolean | 자동 완성과 닫는 괄호입니다. 기본값 true. | User.mjs:99-100 |
ace.spellCheckLanguage | String | 맞춤법 검사 언어입니다. 기본값 en. 새 프로젝트가 이를 복사합니다. | User.mjs:101, ProjectCreationHandler.mjs:277 |
ace.pdfViewer | String | PDF 뷰어입니다. 기본값 pdfjs. | User.mjs:102 |
ace.syntaxValidation | Boolean | 코드 검사입니다. | User.mjs:103 |
ace.mathPreview | Boolean | 수식 미리보기입니다. 기본값 true. | User.mjs:107 |
ace.breadcrumbs | Boolean | 편집기 위의 이동 경로입니다. 기본값 false. | User.mjs:108 |
ace.previewTabs, ace.editorTabs, ace.nonBlinkingCursor, ace.darkModePdf, ace.floatingMenu | Boolean | 편집기 표시 옵션입니다. 기본값 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 모듈은 이를 note: 'admin-panel'이 있는 featuresOverrides 항목으로 저장하고(modules/admin-tools/app/src/AdminFeatures.mjs:13-30), instance-features 모듈은 설정되지 않은 키를 켜진 것으로 처리합니다(modules/instance-features/app/src/UserFeatures.mjs:12-14).
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
features.collaborators | Number | 프로젝트당 최대 공동 작업자 수이며, -1 = 무제한입니다. | User.mjs:119 |
features.versioning | Boolean | 기록입니다. | User.mjs:123 |
features.dropbox / github / gitlab / gitea / gitBridge | Boolean | 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:144, modules/track-changes/app/src/TrackChangesRouter.mjs:17 |
features.mendeley / zotero / papers | Boolean | 참고문헌 관리자 연결입니다. | User.mjs:148-150 |
features.referencesSearch, symbolPalette, offlineMode | Boolean | 참고문헌 검색, 기호 팔레트, 오프라인 모드 스위치입니다. | User.mjs:151-163 |
features.aiUsageQuota | String | AI 사용 등급입니다. 기본값 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 키가 아닙니다. 인스턴스 AI 설정과 aiFeatures.enabled를 따르며, 아래를 참조하세요.
통합
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
aiFeatures.enabled | Boolean | false이면 이 사용자의 AI 어시스턴트와 오류 어시스턴트가 꺼집니다. 기본값 true. | User.mjs:223-225, modules/workbench/app/src/PermissionsMiddleware.mjs:12 |
refProviders.mendeley / refProviders.zotero | Mixed | 연결된 참고문헌 관리자의 암호화된 자격 증명으로, tpr-webmodule 모듈이 씁니다(Mendeley는 { encrypted }, Zotero는 { apiKeyEncrypted }). 연결을 해제하면 제거됩니다. | User.mjs:210-215, modules/tpr-webmodule/app/src/MendeleyApiClient.mjs:136, modules/tpr-webmodule/app/src/ZoteroApiClient.mjs:309 |
dropbox.access_token.uid | String | Dropbox 계정 Id입니다. 스키마에는 없으며 dropbox 모듈이 직접 씁니다. 고유하므로 Dropbox 계정 하나는 사용자 한 명에게만 연결됩니다. 코어는 이를 사용해 동기화할 사용자를 찾습니다. | modules/dropbox/app/src/DropboxHandler.mjs:103-112, TpdsUpdateSender.mjs:202 |
dropbox.access_token_oauth2.encrypted | String | 암호화된 Dropbox 새로 고침 토큰입니다. 스키마에는 없으며 dropbox 모듈이 씁니다. 연결을 해제하면 dropbox 객체 전체가 제거됩니다. | DropboxHandler.mjs:111, :181 |
dropbox.cursor | String | 사용자 앱 폴더의 Dropbox list_folder 커서로, 다음 가져오기에서 더 새로운 변경만 읽도록 합니다. 스키마에는 없으며, 사용자가 같은 Dropbox 계정에 연결되어 있는 동안에만 third-party-datastore가 씁니다. | services/third-party-datastore/app/js/StateManager.mjs:179-183 |
enrollment | Object | 그룹 SSO(groupId, linkedAt, primary로 이루어진 sso 배열)와 관리 사용자 필드(managedBy, enrolledAt)입니다. 그룹 구독은 CE에 포함되지 않습니다. | User.mjs:56-72 |
writefull | Object | Writefull 상태: initialized, autoCreatedAccount, isPremium, premiumSource. 코어는 saas 기능이 켜져 있을 때만 이를 쓰므로 CE에는 없습니다. | User.mjs:216-222, ProjectController.mjs:966-1002, :1445-1465 |
dsMobileApp.subscribed, stripeCustomerIds | Boolean / Object | 스키마에만 있으며 CE 코어와 우리 모듈은 사용하지 않습니다. | User.mjs:249-255 |
프로그램 및 실험
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
betaProgram | Boolean | 사용자가 베타 프로그램에 참여했습니다. | User.mjs:227, BetaProgramHandler.mjs:20 |
alphaProgram | Boolean | 알파 프로그램입니다. 마이그레이션 20220826104236_disable_alpha_beta_program이 모든 사용자에 대해 이 값과 betaProgram을 false로 설정했습니다. | User.mjs:226 |
labsProgram / labsExperiments | Boolean / Array | Labs 프로그램입니다. CE에서는 아무것도 이를 설정하지 않으며, 마이그레이션 20260615090000_back_fill_labsProgram이 값이 없는 곳에 labsProgram: false를 설정했습니다. | User.mjs:228-229 |
splitTests | Mixed | 테스트 이름별 A/B 테스트 배정입니다. | User.mjs:245 |
추천 및 튜토리얼
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
referal_id | String | 생성 시 만들어지는 임의의 추천 Id입니다. | User.mjs:202-207 |
refered_users / refered_user_count | ObjectId 배열 / Number | 이 추천 Id로 가입한 사용자입니다. | User.mjs:208-209, ReferalHandler.mjs:5-7 |
completedTutorials | Mixed | 튜토리얼 키별: { state, updatedAt, postponedUntil }. | User.mjs:247, TutorialHandler.mjs:20-30 |
인덱스
모두tools/migrations/에서 server-ce 태그가 붙은 마이그레이션에서 생성됩니다.
| 이름 | 키 | 옵션 | 마이그레이션 |
|---|---|---|---|
email_1 | email: 1 | unique | 20190912145032_create_users_indexes |
email_case_insensitive | email: 1 | unique, collation en strength 2 | 20190912145032_create_users_indexes |
emails_email_1 | emails.email: 1 | unique, partial (emails.email exists) | 20190912145032_create_users_indexes |
emails_email_case_insensitive | emails.email: 1 | unique, partial, collation en strength 2 | 20190912145032_create_users_indexes |
thirdPartyIdentifiers.externalUserId_1_thirdPartyIdentifiers.providerId_1 | thirdPartyIdentifiers.externalUserId: 1, thirdPartyIdentifiers.providerId: 1 | unique, sparse | 20190912145032_create_users_indexes |
dropbox.access_token.uid_unique | dropbox.access_token.uid: 1 | unique, sparse | 20190912145032_create_users_indexes |
overleaf.id_1 | overleaf.id: 1 | unique, partial | 20190912145032_create_users_indexes |
referal_id | referal_id: 1 | 20190912145032_create_users_indexes | |
signUpDate | signUpDate: 1 | 20190912145032_create_users_indexes | |
lastActive_1 | lastActive: 1 | 20240923131936_create_user_last_active_index | |
emails.reversedHostname_1_email_1 | emails.reversedHostname: 1, email: 1 | 20250321135735_add_email_to_emails_reversed_hostname_index | |
isAdmin_1 | isAdmin: 1 | partial (isAdmin: true) | 20251103164405_users_isAdmin_index |
참고
- Mongoose
autoIndex는 꺼져 있으므로(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입니다.사용자 예시
사용자 예시
{
_id: ObjectId('69661f10432ad80d8a7de39d'),
enrollment: {
sso: []
},
staffAccess: {
publisherMetrics: false,
publisherManagement: false,
institutionMetrics: false,
institutionManagement: false,
groupMetrics: false,
groupManagement: false,
adminMetrics: false,
splitTestMetrics: false,
splitTestManagement: false
},
ace: {
mode: 'none',
theme: 'textmate',
overallTheme: 'light-',
fontSize: 12,
autoComplete: true,
autoPairDelimiters: true,
spellCheckLanguage: 'en',
pdfViewer: 'pdfjs',
mathPreview: true,
breadcrumbs: true,
referencesSearchMode: 'advanced',
syntaxValidation: true,
enableNewEditor: false
},
features: {
collaborators: -1,
versioning: true,
dropbox: true,
github: true,
gitBridge: true,
compileTimeout: 180,
compileGroup: 'standard',
references: true,
trackChanges: true,
aiErrorAssistant: false
},
refProviders: {},
writefull: {
enabled: null,
autoCreatedAccount: false,
isPremium: false,
premiumSource: null
},
aiErrorAssistant: {
enabled: true
},
overleaf: {},
twoFactorAuthentication: {},
dsMobileApp: {},
email: 'admin@overleaf.com',
first_name: 'admin',
role: '',
institution: '',
isAdmin: true,
adminRoles: [],
lastLoginIp: '172.19.0.2',
loginCount: 14,
holdingAccount: false,
must_reconfirm: false,
refered_users: [],
refered_user_count: 0,
alphaProgram: false,
betaProgram: false,
labsProgram: false,
labsExperiments: [],
awareOfV2: false,
samlIdentifiers: [],
thirdPartyIdentifiers: [],
emails: [
{
email: 'admin@overleaf.com',
createdAt: ISODate('2026-01-15T07:53:24.276Z'),
reversedHostname: 'moc.faelrevo'
}
],
signUpDate: ISODate('2026-01-13T10:31:44.786Z'),
featuresOverrides: [],
referal_id: 'ncbyrxrr6rrfQzgp',
__v: 0,
hashedPassword: '$2b$12$2EgV4.qEDjDt6Qx8y5vFduMTBt/LvVfGqspDrAiy8L0OPffvNxLo.',
loginEpoch: 18,
lastLoggedIn: ISODate('2026-01-19T05:09:01.075Z'),
lastActive: ISODate('2026-01-19T05:06:43.145Z'),
last_name: 'user',
lastPrimaryEmailCheck: ISODate('2026-01-15T07:53:24.283Z'),
featuresUpdatedAt: ISODate('2026-01-15T07:53:24.305Z'),
completedTutorials: {
'ide-redesign-beta-intro': {
state: 'completed',
updatedAt: ISODate('2026-01-18T10:55:18.095Z')
}
},
lastFailedLogin: ISODate('2026-01-19T05:08:53.241Z')
}

