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

# Koleksi Deleted Projects

`deletedProjects` menyimpan proyek setelah dihapus: satu dokumen per proyek yang dihapus, berisi salinan seluruh dokumen proyek dan siapa yang menghapusnya. Web menulis koleksi ini di `services/web/app/src/Features/Project/ProjectDeleter.mjs`; skemanya adalah `services/web/app/src/models/DeletedProject.mjs`. Setelah jeda penghapusan permanen berlalu, proses kedaluwarsa memusnahkan data proyek dan mengosongkan `project`, tetapi catatan dengan `deleterData` tetap ada.

Proyek di tempat sampah tidak ada di sini: memindahkan ke tempat sampah hanya menambahkan pengguna ke `trashed` milik proyek, lihat [Koleksi Projects](https://ayakaleaf-pro.mintlify.site/id/dev/data-model/projects-collection.md).

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id catatan, bukan id proyek. | `DeletedProject.mjs:26` |
| `project` | Object | Salinan dokumen `projects` saat penghapusan, dengan skema proyek. `null` setelah catatan kedaluwarsa. | `DeletedProject.mjs:29`, `ProjectDeleter.mjs:277-281,400-410` |
| `deleterData` | Object | Siapa yang menghapus proyek, dan ringkasan yang tetap ada setelah kedaluwarsa. Kunci yang nilainya `undefined` dihilangkan. | `DeletedProject.mjs:7-24,28`, `ProjectDeleter.mjs:247-275` |
| `deleterData.deletedAt` | Date | Waktu penghapusan. Kedaluwarsa dijalankan `projectHardDeletionDelay` setelahnya: 90 hari, atau `OVERLEAF_PROJECT_HARD_DELETION_DELAY` milidetik (`services/web/config/settings.defaults.js:742-744`). | `DeletedProject.mjs:10`, `ProjectDeleter.mjs:248` |
| `deleterData.deleterId` | ObjectId | Pengguna yang menghapus proyek. Tidak ada jika tidak ada pengguna yang menghapusnya secara langsung, lihat `deletedReason`. | `DeletedProject.mjs:8`, `ProjectDeleter.mjs:249-250` |
| `deleterData.deleterIpAddress` | String | Alamat IP permintaan tersebut. Diatur ke `null` saat kedaluwarsa. | `DeletedProject.mjs:9`, `ProjectDeleter.mjs:251,406` |
| `deleterData.deletedReason` | String | Mengapa proyek dihapus, lihat tabel di bawah. Catatan lama tidak memilikinya. | `DeletedProject.mjs:23`, `ProjectDeleter.mjs:252` |
| `deleterData.deletedProjectId` | ObjectId | `_id` proyek yang dihapus. Pencarian satu catatan menggunakannya. | `DeletedProject.mjs:11`, `ProjectDeleter.mjs:253` |
| `deleterData.deletedProjectOwnerId` | ObjectId | `owner_ref` proyek. | `DeletedProject.mjs:12`, `ProjectDeleter.mjs:254` |
| `deleterData.deletedProjectCollaboratorIds` | Array of ObjectId | `collaberator_refs` proyek. | `DeletedProject.mjs:13`, `ProjectDeleter.mjs:255` |
| `deleterData.deletedProjectReadOnlyIds` | Array of ObjectId | `readOnly_refs` proyek. | `DeletedProject.mjs:14`, `ProjectDeleter.mjs:256` |
| `deleterData.deletedProjectReviewerIds` | Array of ObjectId | `reviewer_refs` proyek. | `DeletedProject.mjs:15`, `ProjectDeleter.mjs:257` |
| `deleterData.deletedProjectReadWriteTokenAccessIds` | Array of ObjectId | `tokenAccessReadAndWrite_refs` proyek. | `DeletedProject.mjs:16`, `ProjectDeleter.mjs:258-259` |
| `deleterData.deletedProjectReadOnlyTokenAccessIds` | Array of ObjectId | `tokenAccessReadOnly_refs` proyek. | `DeletedProject.mjs:17`, `ProjectDeleter.mjs:267` |
| `deleterData.deletedProjectReadWriteToken` | String | `tokens.readAndWrite` proyek, jika ada. | `DeletedProject.mjs:18`, `ProjectDeleter.mjs:268` |
| `deleterData.deletedProjectReadOnlyToken` | String | `tokens.readOnly` proyek, jika ada. | `DeletedProject.mjs:19`, `ProjectDeleter.mjs:269` |
| `deleterData.deletedProjectLastUpdatedAt` | Date | `lastUpdated` proyek. | `DeletedProject.mjs:20`, `ProjectDeleter.mjs:270` |
| `deleterData.deletedProjectOverleafId` | Number | `overleaf.id` proyek, jika diatur. | `DeletedProject.mjs:21`, `ProjectDeleter.mjs:260-262` |
| `deleterData.deletedProjectOverleafHistoryId` | Mixed | `overleaf.history.id` proyek, jika diatur. | `DeletedProject.mjs:22`, `ProjectDeleter.mjs:263-266` |

Nilai `deletedReason` (`services/web/app/src/Features/Project/DeletedProjectReasons.mjs:1-8`):

| Nilai | Diatur ketika | `deleterId` |
| - | - | - |
| `user` | Pengguna menghapus proyek dari daftar proyek (`services/web/app/src/Features/Project/ProjectController.mjs:281-291`), atau admin menghapusnya di panel admin (`services/web/modules/admin-tools/app/src/AdminProjectManager.mjs:486-491`) | ada |
| `account-deletion` | Akun pemilik dihapus (`ProjectDeleter.mjs:82-95`, dipanggil dari `services/web/app/src/Features/User/UserDeleter.mjs:66`) | tidak ada |
| `zip-import-failure` | Pembuatan proyek dari zip yang diunggah gagal (`services/web/app/src/Features/Uploads/ProjectUploadManager.mjs:58-61,103-104`) | tidak ada |
| `clone-failure` | Penyalinan proyek gagal; salinan yang rusak dihapus (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:202-207`) | tidak ada |
| `script` | `services/web/scripts/soft_delete_project.mjs:15-17` | tidak ada |
| `github-import-failure` | Didefinisikan, tetapi tidak ada apa pun di repositori ini yang menggunakannya | |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `ProjectDeleter.mjs:189-293` (`deleteProject`) | Melakukan flush proyek, mengarsipkan docs-nya keluar dari Mongo, menghapusnya dari tag, melakukan upsert catatan, dan menghapus dokumen `projects`. |
| `ProjectDeleter.mjs:295-342` (`undeleteProject`) | Memasukkan proyek lagi dengan nama `<name> (Restored)` (dibuat unik untuk pemilik) dan tidak lagi diarsipkan, lalu menghapus catatan. Gagal dengan `project_too_old_to_restore` setelah `project` bernilai `null`. Dipanggil dari panel admin: memulihkan satu proyek (`AdminProjectManager.mjs:497-515`) atau memulihkan pengguna yang dihapus beserta proyek yang dihapus bersama akunnya (`services/web/modules/admin-tools/app/src/AdminUserManager.mjs:678-689`). |
| `ProjectDeleter.mjs:344-416` (`expireDeletedProject`) | Memusnahkan docs, riwayat, obrolan, dan log audit proyek serta memicu hook `projectExpired`, lalu mengatur `project` dan `deleterData.deleterIpAddress` ke `null`. Jika proyek ada lagi, hanya menghapus catatan yang usang. |
| `ProjectDeleter.mjs:97-146` (`expireDeletedProjectsAfterDuration`) | Mengedaluwarsakan sekumpulan catatan yang lebih lama dari jeda. Rute `POST /internal/expire-deleted-projects-after-duration` (`services/web/app/src/router.mjs:842-846`), yang dipanggil cron Community Edition setiap jam pada menit ke-20 ketika `ENABLE_CRON_RESOURCE_DELETION` bernilai `true` (`server-ce/cron/delete-projects.sh:10-23`, `server-ce/config/crontab-deletion:3`). Satu proyek: `POST /internal/project/:projectId/expire-deleted-project` (`router.mjs:852-856`), atau Purge di panel admin (`AdminProjectManager.mjs:517-529`). |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `AdminProjectManager.mjs:129-140,204-272` (modul `admin-tools`) | Mencantumkan proyek terhapus yang belum kedaluwarsa. |
| `AdminProjectManager.mjs:418-454` | Menampilkan satu proyek terhapus beserta pemilik dan penghapusnya. |
| `AdminProjectManager.mjs:178-191` | Menemukan proyek berdasarkan token berbagi tautan, termasuk yang terhapus (`project.tokens.*`). |
| `AdminUserManager.mjs:678-684` | Menemukan proyek yang dikembalikan bersama pengguna yang dipulihkan: dimiliki pengguna dan dihapus dengan alasan `account-deletion` atau tanpa alasan. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `deleterData.deletedProjectId_1` | `{ "deleterData.deletedProjectId": 1 }` | unique | `20190912145002_create_deletedProjects_indexes.mjs`, dijadikan unik oleh `20200210121103_uniqueify-deletedthings-indexes.mjs` |
| `deleterdata_deletedProjectOwnerId_1` | `{ "deleterData.deletedProjectOwnerId": 1 }` | | `20200120163346_atlas_recommended_indexes.mjs` |
| `deleterData.deletedAt_1` | `{ "deleterData.deletedAt": 1 }` | parsial: `project` adalah objek | `20250126195914_update_deleterData.deletedAt_index.mjs` (menggantikan indeks biasa dari `20190912145002_create_deletedProjects_indexes.mjs`) |

Migrasi ada di `tools/migrations/`.

#### Catatan

* Modul yang mendengarkan `projectExpired` menghapus data milik mereka untuk proyek tersebut: `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`), dan `dropbox` (`services/web/modules/dropbox/index.mjs:54`).
* Catatan yang kedaluwarsa tidak pernah dihapus: `deleterData` tetap ada selamanya, hanya `project` dan alamat IP yang dikosongkan.
* Mongoose juga memberi `deleterData` `_id` sendiri, yang tidak dibaca oleh apa pun.


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