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

`tags` enthält die Tags (Ordner), in die ein Benutzer Projekte auf dem Projekt-Dashboard einsortiert. Ein Dokument ist ein Tag eines Benutzers. `web` ist Eigentümer; das Schema ist `services/web/app/src/models/Tag.mjs`, und alle Schreibvorgänge laufen über `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Tag-ID, verwendet in den Routen `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Eigentümer des Tags. Aus historischen Gründen ein einfacher String, keine ObjectId. | `Tag.mjs:7-12` |
| `name` | String | Tag-Name, höchstens 50 Zeichen (`MAX_TAG_LENGTH`). Pro Benutzer eindeutig. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Optionale Farbe: ein Hex-Code wie `#a1b2c3` oder ein Wert `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | IDs der Projekte in diesem Tag, als Strings. | `Tag.mjs:23` |
| `__v` | Number | Mongoose-Versionsschlüssel, hinzugefügt, wenn `Tag.create` das Dokument anlegt. | `TagsHandler.mjs:27` |

#### Wer schreibt

| Code | Was er tut |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Bei einem doppelten Namen gibt er den vorhandenen Tag zurück. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` und `/tag/:tagId/edit` (`router.mjs:879-886`): setzen `name` bzw. `name` und `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Fügt ein oder mehrere Projekte hinzu oder entfernt sie (`$addToSet` / `$pull` / `$pullAll` auf `project_ids`), Routen `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Wird für jedes Mitglied aufgerufen, wenn ein Projekt gelöscht wird (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) und wenn ein Benutzer aus einem Projekt entfernt wird oder es verlässt (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Legt ein kopiertes Projekt in dieselben Tags wie das Original (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Admin-Skript, das einen Tag eines Benutzers direkt in Mongo umbenennt. |

#### Wer liest

| Code | Was er tut |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Projekt-Dashboard (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` und die private API `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Tags des geöffneten Projekts im Editor (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Analytics-Zählung, wenn ein Projekt kopiert wird (`ProjectDuplicator.mjs:98`). |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Dieselbe Migration hat auch `user_id_1` angelegt; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` entfernt ihn wieder, da der zusammengesetzte Index ihn abdeckt.

#### Hinweise

* Tags gelten pro Benutzer: Zwei Mitarbeiter am selben Projekt behalten jeweils ihre eigenen Tags dafür.
* `user_id` und `project_ids` sind Strings, fragen Sie sie also mit String-IDs ab, nicht mit ObjectIds.
* Das Löschen eines Benutzers (`services/web/app/src/Features/User/UserDeleter.mjs`) verändert `tags` nicht.


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