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

`deletedProjects` 會在專案被刪除後保留該專案：每個被刪除的專案一個文件，包含整份專案文件的副本以及刪除者。Web 在 `services/web/app/src/Features/Project/ProjectDeleter.mjs` 中寫入它；schema 是 `services/web/app/src/models/DeletedProject.mjs`。硬刪除延遲過後，過期處理會銷毀專案資料並清空 `project`，但帶有 `deleterData` 的記錄會保留下來。

資源回收筒中的專案不在這裡：移到資源回收筒只會把使用者加入專案的 `trashed`，請參閱 [Projects 集合](https://ayakaleaf-pro.mintlify.site/zh-TW/dev/data-model/projects-collection.md)。

#### 欄位

| 欄位 | 型別 | 含義 | 來源 |
| - | - | - | - |
| `_id` | ObjectId | 記錄 id，不是專案 id。 | `DeletedProject.mjs:26` |
| `project` | Object | 刪除時 `projects` 文件的副本，使用專案 schema。記錄過期後為 `null`。 | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | 誰刪除了專案，以及過期後仍保留的摘要。值為 `undefined` 的鍵會被省略。 | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | 刪除時間。過期處理在其後 `projectHardDeletionDelay` 執行：90 天，或 `OVERLEAF_PROJECT_HARD_DELETION_DELAY` 毫秒（`services/web/config/settings.defaults.js:742-744`）。 | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | 刪除專案的使用者。不是由使用者直接刪除時缺少此欄位，請參閱 `deletedReason`。 | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | 該請求的 IP 位址。過期時設為 `null`。 | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | 專案被刪除的原因，見下表。較舊的記錄沒有此欄位。 | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | 被刪除專案的 `_id`。查找單筆記錄時使用它。 | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | 專案的 `owner_ref`。 | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | 專案的 `collaberator_refs`。 | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | 專案的 `readOnly_refs`。 | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | 專案的 `reviewer_refs`。 | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | 專案的 `tokenAccessReadAndWrite_refs`。 | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | 專案的 `tokenAccessReadOnly_refs`。 | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | 專案的 `tokens.readAndWrite`（若有）。 | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | 專案的 `tokens.readOnly`（若有）。 | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | 專案的 `lastUpdated`。 | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | 專案的 `overleaf.id`（若已設定）。 | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | 專案的 `overleaf.history.id`（若已設定）。 | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

`deletedReason` 的值（`services/web/app/src/Features/Project/DeletedProjectReasons.mjs:1-8`）：

| 值 | 何時設定 | `deleterId` |
| - | - | - |
| `user` | 使用者在專案清單中刪除專案（`services/web/app/src/Features/Project/ProjectController.mjs:281-291`），或管理員在管理面板中刪除它（`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`） | 有 |
| `account-deletion` | 擁有者的帳戶被刪除（`ProjectDeleter.mjs:82-95`，由 `services/web/app/src/Features/User/UserDeleter.mjs:66` 呼叫） | 缺少 |
| `zip-import-failure` | 從上傳的 zip 建立專案失敗（`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`） | 缺少 |
| `clone-failure` | 複製專案失敗；損壞的副本會被刪除（`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`） | 缺少 |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | 缺少 |
| `github-import-failure` | 已定義，但此儲存庫中沒有任何程式碼使用 | |

#### 寫入方

| 程式碼 | 作用 |
| - | - |
| `ProjectDeleter.mjs:189-293`（`deleteProject`） | 排清專案，把其 docs 從 Mongo 封存出去，將其從標籤中移除，upsert 記錄並刪除 `projects` 文件。 |
| `ProjectDeleter.mjs:295-342`（`undeleteProject`） | 以 `<name> (Restored)` 的名稱（對擁有者唯一）重新插入專案並取消封存，然後刪除記錄。一旦 `project` 為 `null`，就以 `project_too_old_to_restore` 失敗。由管理面板呼叫：還原一個專案（`AdminProjectManager.mjs:497-515`），或還原已刪除的使用者以及隨帳戶一起刪除的專案（`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`）。 |
| `ProjectDeleter.mjs:344-416`（`expireDeletedProject`） | 銷毀專案的 docs、歷史、聊天與專案稽核記錄並觸發 `projectExpired` 掛鉤，然後將 `project` 與 `deleterData.deleterIpAddress` 設為 `null`。如果專案又存在了，則只刪除過時的記錄。 |
| `ProjectDeleter.mjs:97-146`（`expireDeletedProjectsAfterDuration`） | 讓一批早於延遲時間的記錄過期。路由 `POST /internal/expire-deleted-projects-after-duration`（`services/web/app/src/router.mjs:842-846`），當 `ENABLE_CRON_RESOURCE_DELETION` 為 `true` 時，Community Edition 的 cron 每小時第 20 分鐘呼叫它（`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`）。單一專案：`POST /internal/project/:projectId/expire-deleted-project`（`router.mjs:852-856`），或管理面板中的 Purge（`AdminProjectManager.mjs:517-529`）。 |

#### 讀取方

| 程式碼 | 作用 |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272`（模組 `admin-tools`） | 列出尚未過期的已刪除專案。 |
| `AdminProjectManager.mjs:418-454` | 顯示一個已刪除專案及其擁有者與刪除者。 |
| `AdminProjectManager.mjs:178-191` | 透過連結分享權杖尋找專案，包括已刪除的專案（`project.tokens.*`）。 |
| `AdminUserManager.mjs:678-684` | 尋找隨還原的使用者一起找回的專案：屬於該使用者，且刪除原因為 `account-deletion` 或沒有原因。 |

#### 索引

| 名稱 | 鍵 | 選項 | 遷移 |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`，由 `20200210121103_uniqueify-deletedthings-indexes.mjs` 改為唯一 |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | 部分索引：`project` 是物件 | `20250126195914_update_deleterData.deletedAt_index.mjs`（取代 `20190912145002_create_deletedProjects_indexes.mjs` 中的一般索引） |

遷移位於 `tools/migrations/`。

#### 備註

* 監聽 `projectExpired` 的模組會刪除它們自己保存的該專案資料：`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`）與 `dropbox`（`services/web/modules/dropbox/index.mjs:54`）。
* 過期的記錄永遠不會被刪除：`deleterData` 會永久保留，只有 `project` 與 IP 位址會被清空。
* Mongoose 也會給 `deleterData` 一個自己的 `_id`，沒有任何程式碼讀取它。


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