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

`contacts` mengingat pengguna mana saja yang pernah bekerja sama dengan seorang pengguna, agar dialog berbagi dapat menyarankan mereka. Satu dokumen per pengguna. Pemiliknya adalah `web`, tanpa skema Mongoose; kodenya `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id dokumen, dibuat oleh upsert. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | Pengguna pemilik kontak-kontak ini. Satu dokumen per pengguna. | `ContactManager.mjs:6` |
| `contacts` | Object | Peta dengan kunci id pengguna kontak (sebagai string). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Berapa kali kedua pengguna dipertemukan. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Kapan hal itu terakhir terjadi. | `ContactManager.mjs:9` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Melakukan upsert dokumen kedua pengguna: `$inc` pada `n`, `$set` untuk `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` memanggil `addContact` saat diberi pengguna yang menambahkan: undangan yang diterima (pengundang dan yang diundang, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) dan pengalihan kepemilikan (pemilik baru dan sebelumnya, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). Bergabung melalui tautan berbagi tidak meneruskan pengguna yang menambahkan (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), sehingga tidak menambahkan kontak. |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: mengurutkan berdasarkan `n`, lalu `ts`, keduanya dari yang tertinggi. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): mengembalikan 50 teratas sebagai pengguna, tanpa akun sementara, ditambah apa yang ditambahkan modul melalui hook `getContacts`. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Catatan

* Kontak berlaku dua arah: menambahkan B ke proyek A menjadikan B kontak A dan A kontak B.
* Tidak ada yang menghapus kontak atau dokumennya, bahkan saat pengguna dihapus.


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