> ## 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` は削除されたプロジェクトを保持します。削除されたプロジェクトごとに 1 つのドキュメントがあり、プロジェクトドキュメント全体のコピーと削除した人が記録されます。Web が `services/web/app/src/Features/Project/ProjectDeleter.mjs` で書き込み、スキーマは `services/web/app/src/models/DeletedProject.mjs` です。完全削除までの猶予期間が過ぎると、期限切れ処理がプロジェクトのデータを破棄して `project` を空にしますが、`deleterData` を持つレコードは残ります。

ゴミ箱内のプロジェクトはここにはありません。ゴミ箱への移動は、プロジェクトの `trashed` にユーザーを追加するだけです。[Projects コレクション](https://ayakaleaf-pro.mintlify.site/ja/dev/data-model/projects-collection.md) を参照してください。

#### フィールド

| フィールド | 型 | 意味 | 出典 |
| - | - | - | - |
| `_id` | ObjectId | レコード id。プロジェクト id ではありません。 | `DeletedProject.mjs:26` |
| `project` | Object | 削除時点の `projects` ドキュメントのコピーで、プロジェクトスキーマを使います。レコードが期限切れになると `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`。1 件のレコードの検索にはこれを使います。 | `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`） | プロジェクトをフラッシュし、その doc を Mongo の外へアーカイブし、タグから外し、レコードを upsert して `projects` ドキュメントを削除します。 |
| `ProjectDeleter.mjs:295-342`（`undeleteProject`） | プロジェクトを `<name> (Restored)` という名前（オーナー内で一意にしたもの）で、アーカイブされていない状態で再挿入し、レコードを削除します。`project` が `null` になると `project_too_old_to_restore` で失敗します。管理パネルから呼び出されます：1 つのプロジェクトの復元（`AdminProjectManager.mjs:497-515`）、または削除されたユーザーとアカウントと一緒に削除されたプロジェクトの復元（`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`）。 |
| `ProjectDeleter.mjs:344-416`（`expireDeletedProject`） | プロジェクトの doc、履歴、チャット、プロジェクト監査ログを破棄して `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`）。1 つのプロジェクトの場合：`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` | 削除済みプロジェクトを 1 つ、オーナーと削除者とともに表示します。 |
| `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.