> ## 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` は削除されたユーザーアカウントを保持します。削除されたアカウントごとに 1 つのドキュメントがあり、ユーザードキュメント全体のコピーと削除した人が記録されます。Web が `services/web/app/src/Features/User/UserDeleter.mjs` で書き込み、スキーマは `services/web/app/src/models/DeletedUser.mjs` です。完全削除までの猶予期間が過ぎると、期限切れ処理がユーザーのコピーを削除しますが、`deleterData` を持つレコードは残ります。

ユーザーを削除すると、そのユーザーが所有するプロジェクトも削除されます。それらは理由 `account-deletion` で [Deleted Projects コレクション](https://ayakaleaf-pro.mintlify.site/ja/dev/data-model/deleted-projects-collection.md) に入ります。

#### フィールド

| フィールド | 型 | 意味 | 出典 |
| - | - | - | - |
| `_id` | ObjectId | レコード id。ユーザー id ではありません。 | `DeletedUser.mjs:21` |
| `user` | Object | 削除時点の `users` ドキュメントのコピーで、ユーザースキーマを使います。[Users コレクション](https://ayakaleaf-pro.mintlify.site/ja/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`）。1 人のユーザーの場合：`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` | 期限切れになっていない削除済みユーザーを 1 人、削除者とともに表示します。 |
| `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/ja/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.