> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Deleted Users 컬렉션

`deletedUsers`는 삭제된 사용자 계정을 보관합니다. 삭제된 계정마다 문서 하나가 있으며, 전체 사용자 문서의 사본과 삭제한 사람이 담깁니다. Web이 `services/web/app/src/Features/User/UserDeleter.mjs`에서 쓰며, 스키마는 `services/web/app/src/models/DeletedUser.mjs`입니다. 영구 삭제 지연 시간이 지나면 만료 처리가 사용자 사본을 제거하지만, `deleterData`가 있는 레코드는 남습니다.

사용자를 삭제하면 그 사용자가 소유한 프로젝트도 삭제됩니다. 이 프로젝트들은 이유 `account-deletion`과 함께 [Deleted Projects 컬렉션](https://ayakaleaf-pro.mintlify.site/ko/dev/data-model/deleted-projects-collection.md)에 들어갑니다.

#### 필드

| 필드 | 타입 | 의미 | 출처 |
| - | - | - | - |
| `_id` | ObjectId | 레코드 id이며 사용자 id가 아닙니다. | `DeletedUser.mjs:21` |
| `user` | Object | 삭제 시점의 `users` 문서 사본으로, 사용자 스키마를 사용합니다. [Users 컬렉션](https://ayakaleaf-pro.mintlify.site/ko/dev/data-model/users-collection.md)을 참고하세요. 만료 시 제거됩니다. | `DeletedUser.mjs:24`, `UserDeleter.mjs:192-196,104,106` |
| `deleterData` | Object | 계정을 삭제한 사람과 만료 후에도 남는 요약입니다. | `DeletedUser.mjs:7-19,23` |
| `deleterData.deletedAt` | Date | 삭제 시각입니다. 만료는 그로부터 `userHardDeletionDelay` 후에 실행됩니다. 90일 또는 `OVERLEAF_USER_HARD_DELETION_DELAY` 밀리초입니다(`services/web/config/settings.defaults.js:739-741`). | `DeletedUser.mjs:10`, `UserDeleter.mjs:198` |
| `deleterData.deleterId` | ObjectId | 계정을 삭제한 사용자입니다. 계정 설정 페이지의 사용자 본인이거나 관리자 패널의 관리자입니다. `delete-user` 스크립트로 삭제한 경우에는 없습니다. | `DeletedUser.mjs:8`, `UserDeleter.mjs:199` |
| `deleterData.deleterIpAddress` | String | 해당 요청의 IP 주소입니다. `delete-user` 스크립트에서는 `0.0.0.0`입니다(`services/web/modules/server-ce-scripts/scripts/delete-user.mjs:40-44`). 만료 시 제거됩니다. | `DeletedUser.mjs:9`, `UserDeleter.mjs:200,105` |
| `deleterData.deletedUserId` | ObjectId | 삭제된 사용자의 `_id`입니다. 코어는 이것으로 레코드를 조회합니다. | `DeletedUser.mjs:11`, `UserDeleter.mjs:201` |
| `deleterData.deletedUserLastLoggedIn` | Date | 사용자의 `lastLoggedIn`입니다. | `DeletedUser.mjs:12`, `UserDeleter.mjs:202` |
| `deleterData.deletedUserSignUpDate` | Date | 사용자의 `signUpDate`입니다. | `DeletedUser.mjs:13`, `UserDeleter.mjs:203` |
| `deleterData.deletedUserLoginCount` | Number | 사용자의 `loginCount`입니다. | `DeletedUser.mjs:14`, `UserDeleter.mjs:204` |
| `deleterData.deletedUserReferralId` | String | 사용자의 `referal_id`입니다. | `DeletedUser.mjs:15`, `UserDeleter.mjs:205` |
| `deleterData.deletedUserReferredUsers` | Array of ObjectId | 사용자의 `refered_users`입니다. | `DeletedUser.mjs:16`, `UserDeleter.mjs:206` |
| `deleterData.deletedUserReferredUserCount` | Number | 사용자의 `refered_user_count`입니다. | `DeletedUser.mjs:17`, `UserDeleter.mjs:207` |
| `deleterData.deletedUserOverleafId` | Number | 사용자의 `overleaf.id`(설정된 경우)입니다. | `DeletedUser.mjs:18`, `UserDeleter.mjs:208` |

#### 쓰는 코드

| 코드 | 역할 |
| - | - |
| `UserDeleter.mjs:37-80`(`deleteUser`) | `delete-account` 감사 로그 항목을 추가하고, 사용자를 정리하고 `deleteUser` 훅을 실행하며, 레코드를 upsert하고(`_createDeletedUser`, `UserDeleter.mjs:192-213`), 사용자의 프로젝트를 삭제하고, 건너뛰지 않는 한 보안 알림 이메일을 보낸 뒤 `users` 문서를 삭제합니다. 호출하는 곳: 계정 설정 페이지(`services/web/app/src/Features/User/UserController.mjs:280-284`), 관리자 패널(`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:604-612`), `delete-user` 스크립트(`delete-user.mjs:40-45`). |
| `UserDeleter.mjs:93-115`(`expireDeletedUser`) | `expireDeletedUser` 훅을 실행하고 사용자의 온보딩 데이터를 삭제한 뒤, `user`와 `deleterData.deleterIpAddress`를 제거합니다. |
| `UserDeleter.mjs:117-161`(`expireDeletedUsersAfterDuration`) | 지연 시간보다 오래된 모든 레코드를 만료시키고 사용자의 `userAuditLogEntries`를 삭제합니다. 라우트 `POST /internal/expire-deleted-users-after-duration`(`services/web/app/src/router.mjs:847-851`)이며, `ENABLE_CRON_RESOURCE_DELETION`이 `true`이면 Community Edition cron이 매시 15분에 호출합니다(`server-ce/cron/delete-users.sh:10-23`, `server-ce/config/crontab-deletion:2`). 사용자 한 명: `POST /internal/users/:userId/expire`(`router.mjs:857-861`). |
| `AdminUserManager.mjs:630-649`(`purgeDeletedUser`, 모듈 `admin-tools`) | 관리자 패널의 Purge: `expireDeletedUser`를 실행하고 사용자의 감사 로그 항목을 삭제합니다. |
| `AdminUserManager.mjs:651-696`(`restoreDeletedUser`, 모듈 `admin-tools`) | 관리자 패널의 복원: `user`로 `users` 문서를 다시 만들고(이메일이 이미 사용 중이면 거부), 레코드를 삭제하고, 계정과 함께 삭제된 프로젝트를 복원합니다. |

#### 읽는 코드

| 코드 | 역할 |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:195-213,263-275` | 관리자 패널을 위해 삭제된 사용자를 나열하고 개수를 셉니다. `user.*`로 필터링합니다. |
| `AdminUserListManager.mjs:428-452` | 만료되지 않은 삭제된 사용자 한 명을 삭제한 사람과 함께 보여 줍니다. |
| `AdminUserListManager.mjs:456-480` | 다른 관리자 목록에서 행의 소유자 이름을 보여 줍니다. 소유자가 삭제된 경우에도 마찬가지입니다. |
| `AdminUserListManager.mjs:175-183` | 삭제된 사용자를 포함해 로그인 제공자 id를 수집합니다. |
| `AdminUserManager.mjs:623-627,631-634,652` | 관리자가 사용자를 삭제, 영구 삭제 또는 복원할 때 레코드를 읽습니다. 이 코드들은 `user._id`로 레코드를 조회합니다. |

#### 인덱스

| 이름 | 키 | 옵션 | 마이그레이션 |
| - | - | - | - |
| `deleterData.deleteUserId_1` | `{ "deleterData.deletedUserId": 1 }` | unique | `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterData_deletedAt_user_1` | `{ "deleterData.deletedAt": 1 }` | 부분: `user`가 객체 | `20250116090001_deletedUsers_non_expired_index.mjs` |
| `user.email_1` | `{ "user.email": 1 }` | | `20250321112055_create_deletedUsers_email_indexes.mjs` |
| `user.emails.email_1` | `{ "user.emails.email": 1 }` | 부분: `user.emails.email`이 존재 | `20250321112055_create_deletedUsers_email_indexes.mjs` |

마이그레이션은 `tools/migrations/`에 있습니다. 인덱스 이름은 `deleteUserId`이지만 키는 `deletedUserId`입니다.

#### 참고

* `expireDeletedUser`를 수신하는 모듈은 해당 사용자에 대한 자체 데이터를 삭제합니다: `dropbox`(`services/web/modules/dropbox/index.mjs:62`), `github-sync`(`services/web/modules/github-sync/index.mjs:66`), `gitlab-sync`(`services/web/modules/gitlab-sync/index.mjs:56`), `gitea-sync`(`services/web/modules/gitea-sync/index.mjs:56`).
* 만료된 레코드는 절대 삭제되지 않습니다. `deleterData`는 영구히 남고, `user`와 IP 주소만 제거됩니다.
* 사용자의 개인 액세스 토큰은 계정과 함께 삭제되지 않습니다. [OAuth Access Tokens 컬렉션](https://ayakaleaf-pro.mintlify.site/ko/dev/data-model/oauth-access-tokens-collection.md)을 참고하세요.
* Mongoose는 `deleterData`에도 자체 `_id`를 부여하지만, 이를 읽는 곳은 없습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.