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

# Collection Tags

`tags` contient les tags (dossiers) dans lesquels un utilisateur range ses projets sur le tableau de bord des projets. Un document correspond à un tag d'un utilisateur. `web` en est propriétaire ; le schéma est `services/web/app/src/models/Tag.mjs`, et toutes les écritures passent par `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Id du tag, utilisé dans les routes `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Propriétaire du tag. Une simple chaîne, pas un ObjectId, pour des raisons historiques. | `Tag.mjs:7-12` |
| `name` | String | Nom du tag, 50 caractères au maximum (`MAX_TAG_LENGTH`). Unique par utilisateur. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Couleur facultative : un code hexadécimal comme `#a1b2c3` ou une valeur `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Ids des projets de ce tag, sous forme de chaînes. | `Tag.mjs:23` |
| `__v` | Number | Clé de version Mongoose, ajoutée lorsque `Tag.create` crée le document. | `TagsHandler.mjs:27` |

#### Qui l'écrit

| Code | Ce qu'il fait |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). En cas de nom en double, renvoie le tag existant. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` et `/tag/:tagId/edit` (`router.mjs:879-886`) : définissent `name`, ou `name` et `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Ajoute ou retire un ou plusieurs projets (`$addToSet` / `$pull` / `$pullAll` sur `project_ids`), routes `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Appelé pour chaque membre lorsqu'un projet est supprimé (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) et lorsqu'un utilisateur est retiré d'un projet ou le quitte (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Place un projet copié dans les mêmes tags que l'original (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Script d'administration qui renomme un tag d'un utilisateur directement dans Mongo. |

#### Qui la lit

| Code | Ce qu'il fait |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Tableau de bord des projets (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` et l'API privée `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Tags du projet ouvert dans l'éditeur (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Comptage analytique lors de la copie d'un projet (`ProjectDuplicator.mjs:98`). |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

La même migration a aussi créé `user_id_1` ; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` le supprime ensuite, car l'index composé le couvre.

#### Remarques

* Les tags sont propres à chaque utilisateur : deux collaborateurs d'un même projet gardent chacun leurs propres tags pour celui-ci.
* `user_id` et `project_ids` sont des chaînes : interrogez-les avec des ids sous forme de chaînes, pas avec des ObjectId.
* La suppression d'un utilisateur (`services/web/app/src/Features/User/UserDeleter.mjs`) ne touche pas `tags`.


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