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

# Samlingen Tags

`tags` innehåller de taggar (mappar) som en användare sorterar projekt i på projektpanelen. Ett dokument är en tagg för en användare. `web` äger den; schemat är `services/web/app/src/models/Tag.mjs`, och alla skrivningar går via `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Taggens id, används i routerna `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Taggens ägare. En vanlig sträng, inte ett ObjectId, av historiska skäl. | `Tag.mjs:7-12` |
| `name` | String | Taggens namn, högst 50 tecken (`MAX_TAG_LENGTH`). Unikt per användare. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Valfri färg: en hexkod som `#a1b2c3` eller ett värde `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Id för projekten i taggen, som strängar. | `Tag.mjs:23` |
| `__v` | Number | Mongoose-versionsnyckel, läggs till när `Tag.create` skapar dokumentet. | `TagsHandler.mjs:27` |

#### Vem skriver

| Kod | Vad den gör |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Vid ett dubblettnamn returneras den befintliga taggen. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` och `/tag/:tagId/edit` (`router.mjs:879-886`): sätter `name`, eller `name` och `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Lägger till eller tar bort ett eller flera projekt (`$addToSet` / `$pull` / `$pullAll` på `project_ids`), router `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Anropas för varje medlem när ett projekt raderas (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) och när en användare tas bort från eller lämnar ett projekt (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Lägger ett kopierat projekt i samma taggar som originalet (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Administratörsskript som byter namn på en användares tagg direkt i Mongo. |

#### Vem läser

| Kod | Vad den gör |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Projektpanelen (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` och det privata API:et `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Taggar för det öppna projektet i redigeraren (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Analysräkning när ett projekt kopieras (`ProjectDuplicator.mjs:98`). |

#### Index

| Namn | Nycklar | Alternativ | Migrering |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Samma migrering skapade även `user_id_1`; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` tar bort det igen, eftersom det sammansatta indexet täcker det.

#### Anmärkningar

* Taggar gäller per användare: två medarbetare i samma projekt har var sina egna taggar för det.
* `user_id` och `project_ids` är strängar, så fråga efter dem med sträng-id, inte med ObjectId.
* Att radera en användare (`services/web/app/src/Features/User/UserDeleter.mjs`) påverkar inte `tags`.


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