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

# Contacts-kokoelma

`contacts` muistaa, kenen käyttäjien kanssa käyttäjä on työskennellyt, jotta jakamisikkuna voi ehdottaa heitä. Yksi dokumentti käyttäjää kohden. Omistaja on `web`, eikä Mongoose-skeemaa ole; koodi on `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Dokumentin id, jonka upsert luo. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | Käyttäjä, jolle nämä yhteystiedot kuuluvat. Yksi dokumentti käyttäjää kohden. | `ContactManager.mjs:6` |
| `contacts` | Object | Taulu, jonka avaimena on yhteyshenkilön käyttäjä-id (merkkijonona). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Kuinka monta kertaa käyttäjät on tuotu yhteen. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Milloin se tapahtui viimeksi. | `ContactManager.mjs:9` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Tekee upsertin molempien käyttäjien dokumenteille: `$inc` kenttään `n`, `$set` kentälle `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` kutsuu `addContact`-funktiota, kun se saa lisäävän käyttäjän: hyväksytty kutsu (kutsuja ja kutsuttu, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) ja omistajuuden siirto (uusi ja edellinen omistaja, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). Jakolinkin kautta liittyminen ei välitä lisäävää käyttäjää (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), joten yhteystietoa ei lisätä. |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: lajittelee ensin kentän `n` ja sitten kentän `ts` mukaan, molemmat suurimmasta alkaen. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): palauttaa 50 ensimmäistä käyttäjinä ilman väliaikaisia tilejä sekä sen, mitä moduulit lisäävät `getContacts`-koukun kautta. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Huomioita

* Yhteystiedot ovat molemminpuolisia: kun B lisätään A:n projektiin, B:stä tulee A:n yhteystieto ja A:sta B:n.
* Mikään ei poista yhteystietoa tai dokumenttia, ei edes käyttäjän poistaminen.


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