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

# Kolekce Contacts

`contacts` si pamatuje, se kterými uživateli uživatel spolupracoval, aby je mohl navrhnout dialog sdílení. Jeden dokument na uživatele. Vlastníkem je `web`, bez schématu Mongoose; kód je `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | Id dokumentu, vytvořené upsertem. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | Uživatel, kterému tyto kontakty patří. Jeden dokument na uživatele. | `ContactManager.mjs:6` |
| `contacts` | Object | Mapa s id uživatele kontaktu (jako řetězcem) jako klíčem. | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Kolikrát byli oba uživatelé spojeni. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Kdy se to stalo naposledy. | `ContactManager.mjs:9` |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Provede upsert dokumentů obou uživatelů: `$inc` na `n`, `$set` pro `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` volá `addContact`, když dostane přidávajícího uživatele: při přijaté pozvánce (zvoucí a pozvaný, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) a při převodu vlastnictví (nový a předchozí vlastník, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). Připojení přes odkaz pro sdílení přidávajícího uživatele nepředává (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), takže kontakt nepřidá. |

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: řadí podle `n`, pak podle `ts`, obojí sestupně. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): vrací prvních 50 jako uživatele, bez dočasných účtů, plus to, co moduly přidají přes hook `getContacts`. |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Poznámky

* Kontakty platí oběma směry: přidání B do projektu A udělá z B kontakt A a z A kontakt B.
* Nic kontakt ani dokument neodstraní, ani smazání uživatele.


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