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

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

Dự án trong thùng rác không nằm ở đây: chuyển vào thùng rác chỉ thêm người dùng vào `trashed` của dự án, xem [Collection Projects](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/projects-collection.md).

#### 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 dự án. | `DeletedProject.mjs:26` |
| `project` | Object | Bản sao tài liệu `projects` tại thời điểm xóa, theo schema dự án. Là `null` khi bản ghi đã hết hạn. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Ai đã xóa dự án, và một bản tóm tắt vẫn còn sau khi hết hạn. Các khóa có giá trị `undefined` bị bỏ qua. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Thời điểm xóa. Việc hết hạn chạy sau đó `projectHardDeletionDelay`: 90 ngày, hoặc `OVERLEAF_PROJECT_HARD_DELETION_DELAY` mili giây (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Người dùng đã xóa dự án. Không có khi không người dùng nào trực tiếp xóa, xem `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Địa chỉ IP của yêu cầu đó. Được đặt thành `null` khi hết hạn. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Lý do dự án bị xóa, xem bảng bên dưới. Bản ghi cũ không có trường này. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` của dự án bị xóa. Việc tra cứu một bản ghi dùng giá trị này. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` của dự án. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` của dự án. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` của dự án. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` của dự án. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` của dự án. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` của dự án. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` của dự án, nếu có. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` của dự án, nếu có. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` của dự án. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` của dự án, nếu được đặt. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` của dự án, nếu được đặt. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

Các giá trị của `deletedReason` (`services/web/app/src/Features/Project/DeletedProjectReasons.mjs:1-8`):

| Giá trị | Được đặt khi | `deleterId` |
| - | - | - |
| `user` | Người dùng xóa dự án khỏi danh sách dự án (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`), hoặc quản trị viên xóa nó trong bảng quản trị (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | có |
| `account-deletion` | Tài khoản của chủ sở hữu bị xóa (`ProjectDeleter.mjs:82-95`, được gọi từ `services/web/app/src/Features/User/UserDeleter.mjs:66`) | không có |
| `zip-import-failure` | Tạo dự án từ tệp zip tải lên thất bại (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | không có |
| `clone-failure` | Sao chép dự án thất bại; bản sao hỏng bị xóa (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | không có |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | không có |
| `github-import-failure` | Đã được định nghĩa, nhưng không có gì trong repository này sử dụng | |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Flush dự án, lưu trữ các doc của nó ra khỏi Mongo, gỡ nó khỏi các thẻ, upsert bản ghi và xóa tài liệu `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Chèn lại dự án với tên `<name> (Restored)` (được làm cho duy nhất với chủ sở hữu) và không còn ở trạng thái lưu trữ, sau đó xóa bản ghi. Thất bại với `project_too_old_to_restore` khi `project` là `null`. Được gọi từ bảng quản trị: khôi phục một dự án (`AdminProjectManager.mjs:497-515`) hoặc khôi phục người dùng đã bị xóa cùng các dự án bị xóa theo tài khoản (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Hủy các doc, lịch sử, trò chuyện và nhật ký kiểm tra của dự án và kích hoạt hook `projectExpired`, sau đó đặt `project` và `deleterData.deleterIpAddress` thành `null`. Nếu dự án tồn tại trở lại, chỉ xóa bản ghi cũ. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Làm hết hạn một loạt bản ghi cũ hơn thời hạn. Route `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), được cron của Community Edition gọi mỗi giờ vào phút thứ 20 khi `ENABLE_CRON_RESOURCE_DELETION` là `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Một dự án: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`), hoặc Purge trong bảng quản trị (`AdminProjectManager.mjs:517-529`). |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (module `admin-tools`) | Liệt kê các dự án đã xóa chưa hết hạn. |
| `AdminProjectManager.mjs:418-454` | Hiển thị một dự án đã xóa cùng chủ sở hữu và người xóa. |
| `AdminProjectManager.mjs:178-191` | Tìm dự án theo token chia sẻ bằng liên kết, kể cả dự án đã xóa (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Tìm các dự án được khôi phục cùng người dùng được khôi phục: thuộc sở hữu của người dùng và bị xóa với lý do `account-deletion` hoặc không có lý do. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, được làm duy nhất bởi `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | một phần: `project` là một đối tượng | `20250126195914_update_deleterData.deletedAt_index.mjs` (thay thế chỉ mục thường từ `20190912145002_create_deletedProjects_indexes.mjs`) |

Các migration nằm trong `tools/migrations/`.

#### Ghi chú

* Các module lắng nghe `projectExpired` xóa dữ liệu riêng của chúng về dự án: `git-bridge` (`services/web/modules/git-bridge/index.mjs:37`), `github-sync` (`services/web/modules/github-sync/index.mjs:56`), `gitlab-sync` (`services/web/modules/gitlab-sync/index.mjs:46`), `gitea-sync` (`services/web/modules/gitea-sync/index.mjs:46`) và `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Bản ghi đã hết hạn không bao giờ bị xóa: `deleterData` được giữ mãi mãi, chỉ `project` và địa chỉ IP bị làm rỗng.
* 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.