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

`contacts` ghi nhớ người dùng đã làm việc với những ai, để hộp thoại chia sẻ có thể gợi ý họ. Mỗi người dùng một tài liệu. `web` sở hữu collection này, không có schema Mongoose; mã là `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id tài liệu, được tạo bởi upsert. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | Người dùng sở hữu các liên hệ này. Mỗi người dùng một tài liệu. | `ContactManager.mjs:6` |
| `contacts` | Object | Bản đồ có khóa là id người dùng của liên hệ (dạng chuỗi). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Số lần hai người dùng được kết nối với nhau. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Thời điểm gần nhất việc đó xảy ra. | `ContactManager.mjs:9` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Upsert tài liệu của cả hai người dùng: `$inc` trên `n`, `$set` cho `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` gọi `addContact` khi được truyền người dùng thực hiện thêm: một lời mời được chấp nhận (người mời và người được mời, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) và một lần chuyển quyền sở hữu (chủ sở hữu mới và cũ, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). Tham gia qua liên kết chia sẻ không truyền người dùng thực hiện thêm (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), nên không thêm liên hệ. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: sắp xếp theo `n`, rồi theo `ts`, đều từ cao xuống thấp. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): trả về 50 người đầu tiên dưới dạng người dùng, không gồm tài khoản tạm, cộng thêm những gì các module bổ sung qua hook `getContacts`. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Ghi chú

* Liên hệ có tính hai chiều: thêm B vào dự án của A khiến B thành liên hệ của A và A thành liên hệ của B.
* Không có gì xóa một liên hệ hay tài liệu, kể cả khi người dùng bị xóa.


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