> ## 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` 中寫入它；schema 是 `services/web/app/src/models/DeletedUser.mjs`。硬刪除延遲過後，過期處理會移除使用者副本，但帶有 `deleterData` 的記錄會保留下來。

刪除使用者也會刪除該使用者擁有的專案；這些專案會以原因 `account-deletion` 進入 [Deleted Projects 集合](https://ayakaleaf-pro.mintlify.site/zh-TW/dev/data-model/deleted-projects-collection.md)。

#### 欄位

| 欄位 | 型別 | 含義 | 來源 |
| - | - | - | - |
| `_id` | ObjectId | 記錄 id，不是使用者 id。 | `DeletedUser.mjs:21` |
| `user` | Object | 刪除時 `users` 文件的副本，使用使用者 schema，請參閱 [Users 集合](https://ayakaleaf-pro.mintlify.site/zh-TW/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/zh-TW/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.