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

# Collection Project Invites

`projectInvites` lưu các lời mời mà chủ sở hữu dự án gửi từ hộp thoại chia sẻ. Mỗi document là một lời mời tới một địa chỉ email. Document bị xóa khi lời mời được chấp nhận hoặc thu hồi, hoặc bị Mongo xóa khi hết hạn. Schema là `services/web/app/src/models/ProjectInvite.mjs`, và `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs` ghi vào nó.

Lời mời không biến ai thành thành viên. Thành viên nằm trong các mảng `*_refs` của dự án, xem [Collection Projects](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/projects-collection.md).

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id lời mời. Thông báo lời mời của người dùng hiện có dùng khóa `project-invite-<_id>` (`services/web/app/src/Features/Notifications/NotificationsBuilder.mjs:102`). | `ProjectInvite.mjs:14` |
| `email` | String | Địa chỉ nhận lời mời. Khi thu hồi lời mời cho một người dùng, địa chỉ này được so với các email đã xác nhận của người dùng (`CollaboratorsInviteHandler.mjs:103-116`). Không được đặt cho lời mời qua liên kết chia sẻ. | `ProjectInvite.mjs:16`, `CollaboratorsInviteHandler.mjs:84` |
| `tokenHmac` | String | HMAC-SHA256 (khóa `overleaf-token-invite`) của token trong liên kết mời. Token gốc chỉ có trong email và thông báo; các truy vấn hash token từ URL rồi so với trường này. | `ProjectInvite.mjs:18`, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHelper.mjs:11-15`, `CollaboratorsInviteHandler.mjs:82,256` |
| `encryptedToken` | String | Chỉ với lời mời qua liên kết chia sẻ: token được mã hóa bằng `Settings.projectInviteEncryptorOptions`, để chủ sở hữu xem lại liên kết (`services/web/app/src/Features/Collaborators/CollaboratorsInviteController.mjs:606-611`). | `ProjectInvite.mjs:17`, `CollaboratorsInviteHelper.mjs:30-47`, `CollaboratorsInviteHandler.mjs:255-258` |
| `sendingUserId` | ObjectId | Người dùng đã gửi lời mời. Khi chấp nhận, giá trị này được chuyển tiếp như người dùng đã thêm thành viên mới (`CollaboratorsInviteHandler.mjs:199-205`). Không được đặt cho lời mời qua liên kết chia sẻ. | `ProjectInvite.mjs:19`, `CollaboratorsInviteHandler.mjs:86` |
| `projectId` | ObjectId | Dự án mà lời mời hướng tới. | `ProjectInvite.mjs:20`, `CollaboratorsInviteHandler.mjs:87` |
| `privileges` | String or Boolean | Quyền truy cập người được mời nhận: `readOnly`, `readAndWrite` hoặc `review` (`services/web/app/src/Features/Authorization/PrivilegeLevels.mjs:6-12`). Lời mời qua liên kết chia sẻ cũng có thể chứa `false`, nghĩa là không có quyền truy cập. | `ProjectInvite.mjs:21-25`, `CollaboratorsInviteHandler.mjs:88` |
| `createdAt` | Date | Được đặt bởi giá trị mặc định của schema khi lời mời được lưu. | `ProjectInvite.mjs:26` |
| `expires` | Date | Giá trị mặc định của schema: 30 ngày sau khi tạo. Chỉ mục TTL xóa lời mời khoảng 10 giây sau thời điểm này. `null` với lời mời qua liên kết chia sẻ, vốn không bao giờ hết hạn. | `ProjectInvite.mjs:6-12,27-31`, `CollaboratorsInviteHandler.mjs:264` |
| `reusable` | Boolean | `false` với lời mời qua email, bị xóa khi được chấp nhận (`CollaboratorsInviteHandler.mjs:207-220`). `true` với lời mời qua liên kết chia sẻ, vẫn được giữ lại. | `ProjectInvite.mjs:32`, `CollaboratorsInviteHandler.mjs:89,263` |
| `subscriptionId` | ObjectId | Chỉ với lời mời qua liên kết chia sẻ: gói đăng ký nhóm mà thành viên được phép chấp nhận liên kết (`CollaboratorsInviteController.mjs:490-501`). | `ProjectInvite.mjs:33`, `CollaboratorsInviteHandler.mjs:262` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `CollaboratorsInviteHandler.mjs:76-101` (`inviteToProject`) | Tạo lời mời qua email, rồi gửi email và, với người dùng hiện có, một thông báo. Được gọi bởi `POST /project/:Project_id/invite` (`services/web/app/src/Features/Collaborators/CollaboratorsRouter.mjs:114-125`). |
| `CollaboratorsInviteHandler.mjs:118-133` (`revokeInvite`) | Xóa một lời mời và đánh dấu thông báo của nó là đã đọc. Được gọi bởi `DELETE /project/:Project_id/invite/:invite_id` (`CollaboratorsRouter.mjs:154-159`). |
| `CollaboratorsInviteHandler.mjs:135-153` (`generateNewInvite`) | Gửi lại: xóa lời mời và tạo lời mời mới với token mới (`CollaboratorsRouter.mjs:161-169`). |
| `CollaboratorsInviteHandler.mjs:103-116` (`revokeInviteForUser`) | Xóa lời mời gửi tới một trong các email đã xác nhận của người dùng, khi người dùng tham gia qua token chia sẻ liên kết (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:396-401`) hoặc được cấp quyền sau một yêu cầu truy cập (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:503-513`). |
| `CollaboratorsInviteHandler.mjs:155-221` (`acceptInvite`) | Thêm người dùng vào dự án, rồi xóa lời mời trừ khi nó là `reusable`. |
| `CollaboratorsInviteHandler.mjs:249-269` (`createSharingLinkInvite`), `CollaboratorsInviteController.mjs:689-724` (`updateSharingLink`) | Tạo hoặc cập nhật lời mời qua liên kết chia sẻ duy nhất, dùng lại được, của một dự án. Các route này cần split test `sharing-updates-new-link` (`CollaboratorsRouter.mjs:134-152`), vốn không nằm trong `splitTestOverrides` (`services/web/config/settings.defaults.js:1371-1383`). Vì vậy chúng trả về 403 cho tới khi split test đó được thiết lập. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `services/web/app/src/Features/Collaborators/CollaboratorsInviteGetter.mjs:6-19` (`getAllInvites`) | Liệt kê các lời mời email đang chờ cho hộp thoại chia sẻ (`GET /project/:Project_id/invites`, `CollaboratorsRouter.mjs:127-132`). Bỏ qua lời mời dùng lại được. |
| `CollaboratorsInviteGetter.mjs:21-29` (`getEditInviteCount`) | Đếm các lời mời email đang chờ không phải `readOnly`. `services/web/app/src/Features/Subscription/LimitationsManager.mjs:61-70` cộng chúng vào số người chỉnh sửa khi kiểm tra giới hạn cộng tác viên. |
| `CollaboratorsInviteGetter.mjs:31-44` (`getInviteByToken`) | Tìm lời mời theo hash của token trong URL, cho trang lời mời và cho việc chấp nhận (`CollaboratorsInviteController.mjs:353,481`). |
| `CollaboratorsInviteGetter.mjs:46-70` | Tìm lời mời qua liên kết chia sẻ của một dự án. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | 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` |

Các migration nằm trong `tools/migrations/`. Schema cũng khai báo chỉ mục TTL trên `expires`, nhưng `autoIndex` của Mongoose đã tắt (`services/web/app/src/infrastructure/Mongoose.mjs:7`), nên migration tạo nó.

#### Ghi chú

* Nếu dự án không còn chỗ trống cho người chỉnh sửa khi một lời mời `readAndWrite` hoặc `review` được chấp nhận, người dùng tham gia với quyền chỉ đọc và được liệt kê trong `pendingEditor_refs` hoặc `pendingReviewer_refs` của dự án (`CollaboratorsInviteHandler.mjs:162-205`).
* Các lời mời cũ lưu token gốc trong trường `token`. Migration `20240524135408_add_token_hmac_project_invite_tokens.mjs` thêm `tokenHmac` và `20240531082910_remove_project_invite_tokens.mjs` xóa `token`.
* Không có gì xóa lời mời của một dự án đã bị xóa; chúng tồn tại cho tới khi chỉ mục TTL xóa chúng.


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