> ## 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 Project Invites

`projectInvites` menyimpan undangan yang dikirim pemilik proyek dari dialog berbagi. Satu dokumen adalah satu undangan ke satu alamat email. Dokumen dihapus saat undangan diterima atau dicabut, atau oleh Mongo saat kedaluwarsa. Skemanya adalah `services/web/app/src/models/ProjectInvite.mjs`, dan `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` yang menulisnya.

Undangan tidak menjadikan siapa pun anggota. Anggota ada di array `*_refs` 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 undangan. Notifikasi undangan untuk pengguna yang sudah ada memakai kunci `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Alamat tujuan undangan. Saat mencabut undangan untuk seorang pengguna, alamat ini dicocokkan dengan email terkonfirmasi milik pengguna (`CollaboratorsInviteHandler.mjs:103-116`). Tidak diisi pada undangan lewat tautan berbagi. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (kunci `overleaf-token-invite`) dari token di tautan undangan. Token aslinya hanya ada di email dan notifikasi; pencarian meng-hash token dari URL lalu mencocokkannya dengan field ini. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Hanya untuk undangan lewat tautan berbagi: token yang dienkripsi dengan `Settings.projectInviteEncryptorOptions`, agar pemilik dapat melihat tautannya lagi (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Pengguna yang mengirim undangan. Saat diterima, nilai ini diteruskan sebagai pengguna yang menambahkan anggota baru (`CollaboratorsInviteHandler.mjs:199-205`). Tidak diisi pada undangan lewat tautan berbagi. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Proyek yang dituju undangan. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Akses yang diterima orang yang diundang: `readOnly`, `readAndWrite`, atau `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Undangan lewat tautan berbagi juga dapat berisi `false`, artinya tanpa akses. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Diisi oleh nilai bawaan skema saat undangan disimpan. | `ProjectInvite.mjs:26` |
| `expires` | Date | Nilai bawaan skema: 30 hari setelah dibuat. Indeks TTL menghapus undangan sekitar 10 detik setelah waktu ini. `null` pada undangan lewat tautan berbagi, yang tidak pernah kedaluwarsa. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` pada undangan email, yang dihapus saat diterima (`CollaboratorsInviteHandler.mjs:207-220`). `true` pada undangan lewat tautan berbagi, yang tetap ada. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Hanya untuk undangan lewat tautan berbagi: langganan grup yang anggotanya boleh menerima tautan (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Membuat undangan email, lalu mengirim email dan, untuk pengguna yang sudah ada, notifikasi. Dipanggil oleh `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Menghapus satu undangan dan menandai notifikasinya sebagai sudah dibaca. Dipanggil oleh `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Kirim ulang: menghapus undangan dan membuat yang baru dengan token baru (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Menghapus undangan yang dikirim ke salah satu email terkonfirmasi milik pengguna, saat pengguna bergabung lewat token berbagi tautan (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) atau diberi akses setelah permintaan akses (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Menambahkan pengguna ke proyek, lalu menghapus undangan kecuali undangan itu `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Membuat atau memperbarui satu-satunya undangan tautan berbagi yang dapat dipakai ulang untuk sebuah proyek. Rute ini memerlukan split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), yang tidak ada di `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Karena itu rute ini menjawab 403 selama split test tersebut belum disiapkan. |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Menampilkan undangan email yang tertunda di dialog berbagi (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Melewati undangan yang dapat dipakai ulang. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Menghitung undangan email tertunda yang bukan `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` menambahkannya ke jumlah editor saat memeriksa batas kolaborator. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Menemukan undangan berdasarkan hash token di URL, untuk halaman undangan dan untuk menerima (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Menemukan undangan tautan berbagi milik proyek. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `expires_1` | `{ expires: 1 }` | TTL, `expireAfterSeconds: 10` | `20190912145023_create_projectInvites_indexes.mjs` |
| `projectId_1` | `{ projectId: 1 }` | | `20190912145023_create_projectInvites_indexes.mjs` |
| `tokenHmac_1` | `{ tokenHmac: 1 }` | | `20240524135408_add_token_hmac_project_invite_tokens.mjs` |

Migrasi ada di `tools/migrations/`. Skema juga mendeklarasikan indeks TTL pada `expires`, tetapi `autoIndex` Mongoose dimatikan (`services/web/app/src/infrastructure/Mongoose.mjs:7`), jadi migrasilah yang membuatnya.

#### Catatan

* Jika proyek tidak punya slot editor tersisa saat undangan `readAndWrite` atau `review` diterima, pengguna bergabung dengan akses hanya-baca dan tercantum di `pendingEditor_refs` atau `pendingReviewer_refs` milik proyek (`CollaboratorsInviteHandler.mjs:162-205`).
* Undangan lama menyimpan token asli di field `token`. Migrasi `20240524135408_add_token_hmac_project_invite_tokens.mjs` menambahkan `tokenHmac` dan `20240531082910_remove_project_invite_tokens.mjs` menghapus `token`.
* Tidak ada yang menghapus undangan milik proyek yang sudah dihapus; undangan tetap ada sampai indeks TTL menghapusnya.


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