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

# Collezione Contacts

`contacts` ricorda con quali utenti un utente ha lavorato, così che la finestra di condivisione possa suggerirli. Un documento per utente. Ne è proprietario `web`, senza schema Mongoose; il codice è `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id del documento, creato dall'upsert. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | L'utente a cui appartengono questi contatti. Un documento per utente. | `ContactManager.mjs:6` |
| `contacts` | Object | Mappa con chiave l'id utente del contatto (come stringa). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Quante volte i due utenti sono stati messi in contatto. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Quando è successo l'ultima volta. | `ContactManager.mjs:9` |

#### Chi la scrive

| Codice | Cosa fa |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Esegue l'upsert dei documenti di entrambi gli utenti: `$inc` su `n`, `$set` di `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` chiama `addContact` quando riceve l'utente che aggiunge: un invito accettato (chi invita e chi è invitato, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) e un trasferimento di proprietà (nuovo e precedente proprietario, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). L'accesso tramite link di condivisione non passa alcun utente che aggiunge (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), quindi non aggiunge contatti. |

#### Chi la legge

| Codice | Cosa fa |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: ordina per `n`, poi per `ts`, entrambi dal più alto. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): restituisce i primi 50 come utenti, senza gli account provvisori, più ciò che i moduli aggiungono tramite l'hook `getContacts`. |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Note

* I contatti valgono in entrambe le direzioni: aggiungere B al progetto di A rende B un contatto di A e A un contatto di B.
* Nulla rimuove un contatto o il documento, nemmeno l'eliminazione di un utente.


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