> ## 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.

# Collection Deleted Users

`deletedUsers` giữ lại một tài khoản người dùng sau khi nó bị xóa: mỗi tài khoản bị xóa có một tài liệu, gồm bản sao toàn bộ tài liệu người dùng và người đã xóa nó. Web ghi collection này trong `services/web/app/src/Features/User/UserDeleter.mjs`; schema là `services/web/app/src/models/DeletedUser.mjs`. Khi thời hạn xóa vĩnh viễn trôi qua, quá trình hết hạn gỡ bỏ bản sao người dùng, nhưng bản ghi có `deleterData` vẫn còn.

Xóa người dùng cũng xóa các dự án mà người dùng sở hữu; chúng đi vào [Collection Deleted Projects](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/deleted-projects-collection.md) với lý do `account-deletion`.

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id của bản ghi, không phải id người dùng. | `DeletedUser.mjs:21` |
| `user` | Object | Bản sao tài liệu `users` tại thời điểm xóa, theo schema người dùng, xem [Collection Users](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/users-collection.md). Bị gỡ bỏ khi hết hạn. | `DeletedUser.mjs:24`, `UserDeleter.mjs:192-196,104,106` |
| `deleterData` | Object | Ai đã xóa tài khoản, và một bản tóm tắt vẫn còn sau khi hết hạn. | `DeletedUser.mjs:7-19,23` |
| `deleterData.deletedAt` | Date | Thời điểm xóa. Việc hết hạn chạy sau đó `userHardDeletionDelay`: 90 ngày, hoặc `OVERLEAF_USER_HARD_DELETION_DELAY` mili giây (`services/web/config/settings.defaults.js:739-741`). | `DeletedUser.mjs:10`, `UserDeleter.mjs:198` |
| `deleterData.deleterId` | ObjectId | Người dùng đã xóa tài khoản: chính người dùng trên trang cài đặt tài khoản, hoặc quản trị viên trong bảng quản trị. Không có khi script `delete-user` xóa nó. | `DeletedUser.mjs:8`, `UserDeleter.mjs:199` |
| `deleterData.deleterIpAddress` | String | Địa chỉ IP của yêu cầu đó; là `0.0.0.0` khi đến từ script `delete-user` (`services/web/modules/server-ce-scripts/scripts/delete-user.mjs:40-44`). Bị gỡ bỏ khi hết hạn. | `DeletedUser.mjs:9`, `UserDeleter.mjs:200,105` |
| `deleterData.deletedUserId` | ObjectId | `_id` của người dùng bị xóa. Phần lõi tra cứu bản ghi theo giá trị này. | `DeletedUser.mjs:11`, `UserDeleter.mjs:201` |
| `deleterData.deletedUserLastLoggedIn` | Date | `lastLoggedIn` của người dùng. | `DeletedUser.mjs:12`, `UserDeleter.mjs:202` |
| `deleterData.deletedUserSignUpDate` | Date | `signUpDate` của người dùng. | `DeletedUser.mjs:13`, `UserDeleter.mjs:203` |
| `deleterData.deletedUserLoginCount` | Number | `loginCount` của người dùng. | `DeletedUser.mjs:14`, `UserDeleter.mjs:204` |
| `deleterData.deletedUserReferralId` | String | `referal_id` của người dùng. | `DeletedUser.mjs:15`, `UserDeleter.mjs:205` |
| `deleterData.deletedUserReferredUsers` | Array of ObjectId | `refered_users` của người dùng. | `DeletedUser.mjs:16`, `UserDeleter.mjs:206` |
| `deleterData.deletedUserReferredUserCount` | Number | `refered_user_count` của người dùng. | `DeletedUser.mjs:17`, `UserDeleter.mjs:207` |
| `deleterData.deletedUserOverleafId` | Number | `overleaf.id` của người dùng, nếu được đặt. | `DeletedUser.mjs:18`, `UserDeleter.mjs:208` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `UserDeleter.mjs:37-80` (`deleteUser`) | Thêm một mục nhật ký kiểm tra `delete-account`, dọn dẹp người dùng và kích hoạt hook `deleteUser`, upsert bản ghi (`_createDeletedUser`, `UserDeleter.mjs:192-213`), xóa các dự án của người dùng, gửi email cảnh báo bảo mật trừ khi bị bỏ qua, và xóa tài liệu `users`. Nơi gọi: trang cài đặt tài khoản (`services/web/app/src/Features/User/UserController.mjs:280-284`), bảng quản trị (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:604-612`) và script `delete-user` (`delete-user.mjs:40-45`). |
| `UserDeleter.mjs:93-115` (`expireDeletedUser`) | Kích hoạt hook `expireDeletedUser`, xóa dữ liệu onboarding của người dùng, sau đó gỡ bỏ `user` và `deleterData.deleterIpAddress`. |
| `UserDeleter.mjs:117-161` (`expireDeletedUsersAfterDuration`) | Làm hết hạn mọi bản ghi cũ hơn thời hạn và xóa `userAuditLogEntries` của người dùng. Route `POST /internal/expire-deleted-users-after-duration` (`services/web/app/src/router.mjs:847-851`), được cron của Community Edition gọi mỗi giờ vào phút thứ 15 khi `ENABLE_CRON_RESOURCE_DELETION` là `true` (`server-ce/cron/delete-users.sh:10-23`, `server-ce/config/crontab-deletion:2`). Một người dùng: `POST /internal/users/:userId/expire` (`router.mjs:857-861`). |
| `AdminUserManager.mjs:630-649` (`purgeDeletedUser`, module `admin-tools`) | Purge trong bảng quản trị: chạy `expireDeletedUser` và xóa các mục nhật ký kiểm tra của người dùng. |
| `AdminUserManager.mjs:651-696` (`restoreDeletedUser`, module `admin-tools`) | Khôi phục trong bảng quản trị: tạo lại tài liệu `users` từ `user` (bị từ chối nếu email đã được dùng), xóa bản ghi và khôi phục các dự án bị xóa cùng tài khoản. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:195-213,263-275` | Liệt kê và đếm người dùng đã xóa cho bảng quản trị, lọc theo `user.*`. |
| `AdminUserListManager.mjs:428-452` | Hiển thị một người dùng đã xóa chưa hết hạn, cùng người đã xóa. |
| `AdminUserListManager.mjs:456-480` | Nêu tên chủ sở hữu của một hàng trong các danh sách quản trị khác, kể cả khi chủ sở hữu đã bị xóa. |
| `AdminUserListManager.mjs:175-183` | Thu thập id của nhà cung cấp đăng nhập, kể cả từ người dùng đã xóa. |
| `AdminUserManager.mjs:623-627,631-634,652` | Đọc bản ghi khi quản trị viên xóa, dọn sạch hoặc khôi phục người dùng; các đoạn này tra cứu theo `user._id`. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `deleterData.deleteUserId_1` | `{ "deleterData.deletedUserId": 1 }` | unique | `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterData_deletedAt_user_1` | `{ "deleterData.deletedAt": 1 }` | một phần: `user` là một đối tượng | `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 }` | một phần: `user.emails.email` tồn tại | `20250321112055_create_deletedUsers_email_indexes.mjs` |

Các migration nằm trong `tools/migrations/`. Tên chỉ mục ghi `deleteUserId`, nhưng khóa là `deletedUserId`.

#### Ghi chú

* Các module lắng nghe `expireDeletedUser` xóa dữ liệu riêng của chúng về người dùng: `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`) và `gitea-sync` (`services/web/modules/gitea-sync/index.mjs:56`).
* Bản ghi đã hết hạn không bao giờ bị xóa: `deleterData` được giữ mãi mãi, chỉ `user` và địa chỉ IP bị gỡ bỏ.
* Token truy cập cá nhân của người dùng không bị xóa cùng tài khoản, xem [Collection OAuth Access Tokens](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/oauth-access-tokens-collection.md).
* Mongoose cũng gán cho `deleterData` một `_id` riêng, không có gì đọc nó.


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