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

# Kolekcja Contacts

`contacts` zapamiętuje, z którymi użytkownikami pracował dany użytkownik, aby okno udostępniania mogło ich proponować. Jeden dokument na użytkownika. Właścicielem jest `web`, bez schematu Mongoose; kod to `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Id dokumentu, tworzone przez upsert. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | Użytkownik, do którego należą te kontakty. Jeden dokument na użytkownika. | `ContactManager.mjs:6` |
| `contacts` | Object | Mapa, której kluczem jest id użytkownika kontaktu (jako ciąg znaków). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Ile razy obaj użytkownicy zostali ze sobą połączeni. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Kiedy stało się to ostatnio. | `ContactManager.mjs:9` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Wykonuje upsert dokumentów obu użytkowników: `$inc` na `n`, `$set` dla `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` wywołuje `addContact`, gdy otrzyma dodającego użytkownika: przy przyjętym zaproszeniu (zapraszający i zaproszony, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) oraz przy przekazaniu własności (nowy i poprzedni właściciel, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). Dołączenie przez link udostępniania nie przekazuje dodającego użytkownika (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), więc nie dodaje kontaktu. |

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: sortuje według `n`, a potem według `ts`, w obu przypadkach malejąco. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): zwraca pierwszych 50 jako użytkowników, bez kont tymczasowych, oraz to, co moduły dodają przez hook `getContacts`. |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Uwagi

* Kontakty działają w obie strony: dodanie B do projektu A sprawia, że B staje się kontaktem A, a A kontaktem B.
* Nic nie usuwa kontaktu ani dokumentu, nawet usunięcie użytkownika.


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