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

# Colección Contacts

`contacts` recuerda con qué usuarios ha trabajado un usuario, para que el diálogo de compartir pueda sugerirlos. Un documento por usuario. `web` es su propietario, sin esquema de Mongoose; el código es `services/web/app/src/Features/Contacts/ContactManager.mjs`.

#### Campos

| Campo | Tipo | Significado | Fuente |
| - | - | - | - |
| `_id` | ObjectId | Id del documento, creado por el upsert. | `ContactManager.mjs:5-12` |
| `user_id` | ObjectId | El usuario al que pertenecen estos contactos. Un documento por usuario. | `ContactManager.mjs:6` |
| `contacts` | Object | Mapa cuya clave es el id de usuario del contacto (como cadena). | `ContactManager.mjs:8-9` |
| `contacts.<userId>.n` | Number | Cuántas veces se ha puesto en contacto a los dos usuarios. | `ContactManager.mjs:8` |
| `contacts.<userId>.ts` | Date | Cuándo ocurrió por última vez. | `ContactManager.mjs:9` |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `ContactManager.mjs:4-13` (`touchContact`), `:23-28` (`addContact`) | Hace upsert de los documentos de ambos usuarios: `$inc` sobre `n`, `$set` de `ts`. |
| `services/web/app/src/Features/Collaborators/CollaboratorsHandler.mjs:155-157` | `addUserIdToProject` llama a `addContact` cuando recibe el usuario que añade: una invitación aceptada (quien invita y quien es invitado, `services/web/app/src/Features/Collaborators/CollaboratorsInviteHandler.mjs:199-205`) y una transferencia de propiedad (propietario nuevo y anterior, `services/web/app/src/Features/Collaborators/OwnershipTransferHandler.mjs:138-144`). Unirse mediante un enlace para compartir no pasa ningún usuario que añade (`services/web/app/src/Features/TokenAccess/TokenAccessController.mjs:386-388`, `:632-634`), por lo que no añade ningún contacto. |

#### Quién lee

| Código | Qué hace |
| - | - |
| `ContactManager.mjs:15-21`, `:30-42` | `getContactIds`: ordena por `n` y luego por `ts`, ambos de mayor a menor. |
| `services/web/app/src/Features/Contacts/ContactController.mjs:19-59` | `GET /user/contacts` (`services/web/app/src/Features/Contacts/ContactRouter.mjs:22-26`): devuelve los 50 primeros como usuarios, sin las cuentas provisionales, más lo que añaden los módulos a través del hook `getContacts`. |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `user_id_1` | `{ user_id: 1 }` | unique | `tools/migrations/20190912145001_create_contacts_indexes.mjs` |

#### Notas

* Los contactos son recíprocos: añadir a B al proyecto de A convierte a B en contacto de A y a A en contacto de B.
* Nada elimina un contacto ni el documento, ni siquiera cuando se elimina un usuario.


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