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

# Project Invites Koleksiyonu

`projectInvites`, bir proje sahibinin paylaşım penceresinden gönderdiği davetleri tutar. Bir belge, bir e-posta adresine gönderilen bir davettir. Davet kabul edildiğinde veya geri alındığında silinir; süresi dolduğunda ise Mongo siler. Şema `services/web/app/src/models/ProjectInvite.mjs` dosyasındadır ve `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` yazar.

Davet kimseyi üye yapmaz. Üyeler projenin `*_refs` dizilerindedir, bkz. [Projects Koleksiyonu](https://ayakaleaf-pro.mintlify.site/tr/dev/data-model/projects-collection.md).

#### Alanlar

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Davet id'si. Mevcut bir kullanıcının davet bildirimi `project-invite-<_id>` anahtarını kullanır (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Davetin gönderildiği adres. Bir kullanıcı için davet geri alınırken kullanıcının doğrulanmış e-postalarıyla karşılaştırılır (`CollaboratorsInviteHandler.mjs:103-116`). Paylaşım bağlantısı davetinde ayarlanmaz. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | Davet bağlantısındaki tokenin HMAC-SHA256 değeri (anahtar `overleaf-token-invite`). Düz token yalnızca e-postada ve bildirimde bulunur; aramalar URL'deki tokeni hash'leyip bu alanla karşılaştırır. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Yalnızca paylaşım bağlantısı davetlerinde: sahibin bağlantıyı yeniden görebilmesi için `Settings.projectInviteEncryptorOptions` ile şifrelenmiş token (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Daveti gönderen kullanıcı. Kabul edildiğinde yeni üyeyi ekleyen kullanıcı olarak aktarılır (`CollaboratorsInviteHandler.mjs:199-205`). Paylaşım bağlantısı davetinde ayarlanmaz. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Davetin ait olduğu proje. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Davet edilenin alacağı erişim: `readOnly`, `readAndWrite` veya `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Paylaşım bağlantısı daveti `false` da içerebilir; bu erişim olmadığı anlamına gelir. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Davet kaydedilirken şemanın varsayılan değeri tarafından ayarlanır. | `ProjectInvite.mjs:26` |
| `expires` | Date | Şemanın varsayılan değeri: oluşturulduktan 30 gün sonra. TTL indeksi daveti bu zamandan yaklaşık 10 saniye sonra kaldırır. Hiç süresi dolmayan paylaşım bağlantısı davetinde `null`. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | Kabul edildiğinde silinen e-posta davetinde `false` (`CollaboratorsInviteHandler.mjs:207-220`). Kalıcı olan paylaşım bağlantısı davetinde `true`. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Yalnızca paylaşım bağlantısı davetlerinde: üyeleri bağlantıyı kabul edebilen grup aboneliği (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Bir e-posta daveti oluşturur, ardından e-postayı ve mevcut bir kullanıcı için bildirimi gönderir. `POST /project/:Project_id/invite` tarafından çağrılır (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Bir daveti siler ve bildirimini okundu olarak işaretler. `DELETE /project/:Project_id/invite/:invite_id` tarafından çağrılır (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Yeniden gönder: daveti siler ve yeni bir tokenle yeni bir davet oluşturur (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Kullanıcı bir bağlantı paylaşım tokeniyle katıldığında (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) veya bir erişim isteğinden sonra erişim aldığında (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`), kullanıcının doğrulanmış e-postalarından birine gönderilen daveti siler. |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Kullanıcıyı projeye ekler, ardından `reusable` değilse daveti siler. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Bir projenin tek yeniden kullanılabilir paylaşım bağlantısı davetini oluşturur veya günceller. Bu route'lar `sharing-updates-new-link` split testini gerektirir (`CollaboratorsRouter.mjs:134-152`); bu test `splitTestOverrides` içinde yoktur (`services/web/config/settings.defaults.js:1371-1383`). Bu yüzden o split test kurulmadıkça 403 döndürürler. |

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Paylaşım penceresi için bekleyen e-posta davetlerini listeler (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Yeniden kullanılabilir davetleri atlar. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | `readOnly` olmayan bekleyen e-posta davetlerini sayar. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70`, ortak çalışan sınırını denetlerken bunları düzenleyicilere ekler. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Davet sayfası ve kabul için URL'deki tokenin hash'iyle daveti bulur (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Bir projenin paylaşım bağlantısı davetini bulur. |

#### İndeksler

| Ad | Anahtarlar | Seçenekler | Migration |
| - | - | - | - |
| `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` |

Migration'lar `tools/migrations/` içindedir. Şema `expires` üzerindeki TTL indeksini de tanımlar, ancak Mongoose `autoIndex` kapalıdır (`services/web/app/src/infrastructure/Mongoose.mjs:7`), bu yüzden indeksi migration oluşturur.

#### Notlar

* Bir `readAndWrite` veya `review` daveti kabul edildiğinde projede boş düzenleyici yeri kalmamışsa, kullanıcı salt okunur olarak katılır ve projenin `pendingEditor_refs` veya `pendingReviewer_refs` alanında listelenir (`CollaboratorsInviteHandler.mjs:162-205`).
* Eski davetler düz tokeni bir `token` alanında saklıyordu. `20240524135408_add_token_hmac_project_invite_tokens.mjs` migration'ı `tokenHmac` alanını ekledi ve `20240531082910_remove_project_invite_tokens.mjs` `token` alanını kaldırdı.
* Silinmiş bir projenin davetlerini hiçbir şey silmez; TTL indeksi kaldırana kadar kalırlar.


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