> ## 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`에서 쓰며, 스키마는 `services/web/app/src/models/DeletedProject.mjs`입니다. 영구 삭제 지연 시간이 지나면 만료 처리가 프로젝트 데이터를 파기하고 `project`를 비우지만, `deleterData`가 있는 레코드는 남습니다.

휴지통에 있는 프로젝트는 여기에 없습니다. 휴지통으로 옮기면 프로젝트의 `trashed`에 사용자가 추가될 뿐입니다. [Projects 컬렉션](https://ayakaleaf-pro.mintlify.site/ko/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`입니다. 레코드 하나를 조회할 때 사용합니다. | `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`로 실패합니다. 관리자 패널에서 호출됩니다. 프로젝트 하나 복원(`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`). 프로젝트 하나: `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.