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

# Tags-collectie

`tags` bevat de tags (mappen) waarin een gebruiker projecten indeelt op het projectdashboard. Eén document is één tag van één gebruiker. `web` is de eigenaar; het schema is `services/web/app/src/models/Tag.mjs`, en alle schrijfacties lopen via `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Tag-id, gebruikt in de routes `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Eigenaar van de tag. Om historische redenen een gewone string, geen ObjectId. | `Tag.mjs:7-12` |
| `name` | String | Tagnaam, maximaal 50 tekens (`MAX_TAG_LENGTH`). Uniek per gebruiker. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Optionele kleur: een hexcode zoals `#a1b2c3` of een waarde `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Id's van de projecten in deze tag, als strings. | `Tag.mjs:23` |
| `__v` | Number | Mongoose-versiesleutel, toegevoegd wanneer `Tag.create` het document aanmaakt. | `TagsHandler.mjs:27` |

#### Wie schrijft

| Code | Wat het doet |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Bij een dubbele naam wordt de bestaande tag teruggegeven. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` en `/tag/:tagId/edit` (`router.mjs:879-886`): stellen `name` in, of `name` en `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Voegt een of meer projecten toe of verwijdert ze (`$addToSet` / `$pull` / `$pullAll` op `project_ids`), routes `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Wordt voor elk lid aangeroepen wanneer een project wordt verwijderd (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) en wanneer een gebruiker uit een project wordt gehaald of het verlaat (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Plaatst een gekopieerd project in dezelfde tags als het origineel (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Beheerscript dat een tag van één gebruiker rechtstreeks in Mongo hernoemt. |

#### Wie leest

| Code | Wat het doet |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Projectdashboard (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` en de privé-API `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Tags van het geopende project in de editor (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Telling voor analyse wanneer een project wordt gekopieerd (`ProjectDuplicator.mjs:98`). |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Dezelfde migratie maakte ook `user_id_1` aan; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` verwijdert die weer, omdat de samengestelde index hem dekt.

#### Opmerkingen

* Tags zijn per gebruiker: twee medewerkers aan hetzelfde project houden elk hun eigen tags ervoor.
* `user_id` en `project_ids` zijn strings, dus zoek erop met string-id's, niet met ObjectIds.
* Het verwijderen van een gebruiker (`services/web/app/src/Features/User/UserDeleter.mjs`) raakt `tags` niet aan.


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