> ## 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 컬렉션

`projectInvites`에는 프로젝트 소유자가 공유 대화 상자에서 보내는 초대가 저장됩니다. 문서 하나는 이메일 주소 하나로 보낸 초대 하나입니다. 초대가 수락되거나 취소되면 삭제되며, 만료되면 Mongo가 삭제합니다. 스키마는 `services/web/app/src/models/ProjectInvite.mjs`이고, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs`가 기록합니다.

초대는 누구도 멤버로 만들지 않습니다. 멤버는 프로젝트의 `*_refs` 배열에 있습니다. [Projects 컬렉션](https://ayakaleaf-pro.mintlify.site/ko/dev/data-model/projects-collection.md)을 참조하세요.

#### 필드

| 필드 | 타입 | 의미 | 출처 |
| - | - | - | - |
| `_id` | ObjectId | 초대 id. 기존 사용자의 초대 알림은 키 `project-invite-<_id>`를 사용합니다(`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | 초대를 보낸 주소. 사용자의 초대를 취소할 때 사용자의 확인된 이메일과 비교합니다(`CollaboratorsInviteHandler.mjs:103-116`). 공유 링크 초대에는 설정되지 않습니다. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | 초대 링크 속 토큰의 HMAC-SHA256(키 `overleaf-token-invite`). 평문 토큰은 이메일과 알림에만 있으며, 조회 시 URL의 토큰을 해시해 이 필드와 비교합니다. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | 공유 링크 초대에만 있습니다: 소유자가 링크를 다시 볼 수 있도록 `Settings.projectInviteEncryptorOptions`로 암호화한 토큰(`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | 초대를 보낸 사용자. 수락 시 새 멤버를 추가한 사용자로 전달됩니다(`CollaboratorsInviteHandler.mjs:199-205`). 공유 링크 초대에는 설정되지 않습니다. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | 초대 대상 프로젝트. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | 초대받은 사람이 얻는 권한: `readOnly`, `readAndWrite`, `review`(`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). 공유 링크 초대는 권한 없음을 뜻하는 `false`일 수도 있습니다. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | 초대를 저장할 때 스키마 기본값으로 설정됩니다. | `ProjectInvite.mjs:26` |
| `expires` | Date | 스키마 기본값: 생성 후 30일. TTL 인덱스가 이 시각 약 10초 뒤 초대를 제거합니다. 만료되지 않는 공유 링크 초대는 `null`입니다. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | 이메일 초대는 `false`이며 수락하면 삭제됩니다(`CollaboratorsInviteHandler.mjs:207-220`). 공유 링크 초대는 `true`이며 계속 남습니다. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | 공유 링크 초대에만 있습니다: 멤버가 링크를 수락할 수 있는 그룹 구독(`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### 쓰는 코드

| 코드 | 역할 |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | 이메일 초대를 만든 뒤 이메일을 보내고, 기존 사용자에게는 알림도 보냅니다. `POST /project/:Project_id/invite`가 호출합니다(`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | 초대 하나를 삭제하고 그 알림을 읽음으로 표시합니다. `DELETE /project/:Project_id/invite/:invite_id`가 호출합니다(`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | 다시 보내기: 초대를 삭제하고 새 토큰으로 새 초대를 만듭니다(`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | 사용자가 링크 공유 토큰으로 참여하거나(`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) 액세스 요청 후 권한을 받으면(`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`), 그 사용자의 확인된 이메일 중 하나로 보낸 초대를 삭제합니다. |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | 사용자를 프로젝트에 추가한 뒤, `reusable`이 아니면 초대를 삭제합니다. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | 프로젝트의 유일한 재사용 가능 공유 링크 초대를 만들거나 업데이트합니다. 이 라우트는 split test `sharing-updates-new-link`가 필요한데(`CollaboratorsRouter.mjs:134-152`), 이는 `splitTestOverrides`에 없습니다(`services/web/config/settings.defaults.js:1371-1383`). 따라서 그 split test를 설정하기 전까지는 403으로 응답합니다. |

#### 읽는 코드

| 코드 | 역할 |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | 공유 대화 상자에 대기 중인 이메일 초대를 나열합니다(`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). 재사용 가능 초대는 건너뜁니다. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | `readOnly`가 아닌 대기 중인 이메일 초대를 셉니다. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70`는 공동 작업자 한도를 확인할 때 이를 편집자 수에 더합니다. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | 초대 페이지와 수락을 위해 URL 토큰의 해시로 초대를 찾습니다(`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | 프로젝트의 공유 링크 초대를 찾습니다. |

#### 인덱스

| 이름 | 키 | 옵션 | 마이그레이션 |
| - | - | - | - |
| `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` |

마이그레이션은 `tools/migrations/`에 있습니다. 스키마도 `expires`에 TTL 인덱스를 선언하지만 Mongoose `autoIndex`가 꺼져 있으므로(`services/web/app/src/infrastructure/Mongoose.mjs:7`) 마이그레이션이 인덱스를 만듭니다.

#### 참고

* `readAndWrite` 또는 `review` 초대를 수락할 때 프로젝트에 남은 편집자 자리가 없으면, 사용자는 읽기 전용으로 참여하며 프로젝트의 `pendingEditor_refs` 또는 `pendingReviewer_refs`에 기록됩니다(`CollaboratorsInviteHandler.mjs:162-205`).
* 예전 초대는 평문 토큰을 `token` 필드에 저장했습니다. 마이그레이션 `20240524135408_add_token_hmac_project_invite_tokens.mjs`가 `tokenHmac`을 추가했고 `20240531082910_remove_project_invite_tokens.mjs`가 `token`을 제거했습니다.
* 삭제된 프로젝트의 초대를 삭제하는 코드는 없습니다. TTL 인덱스가 제거할 때까지 남아 있습니다.


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