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

# Kolekcja Tags

`tags` przechowuje tagi (foldery), w których użytkownik porządkuje projekty na pulpicie projektów. Jeden dokument to jeden tag jednego użytkownika. Właścicielem jest `web`; schemat to `services/web/app/src/models/Tag.mjs`, a wszystkie zapisy przechodzą przez `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Id tagu, używane w trasach `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Właściciel tagu. Zwykły ciąg znaków, a nie ObjectId, ze względów historycznych. | `Tag.mjs:7-12` |
| `name` | String | Nazwa tagu, najwyżej 50 znaków (`MAX_TAG_LENGTH`). Unikalna dla każdego użytkownika. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Opcjonalny kolor: kod szesnastkowy, np. `#a1b2c3`, lub wartość `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Id projektów w tym tagu, jako ciągi znaków. | `Tag.mjs:23` |
| `__v` | Number | Klucz wersji Mongoose, dodawany, gdy `Tag.create` tworzy dokument. | `TagsHandler.mjs:27` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Przy zduplikowanej nazwie zwraca istniejący tag. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` i `/tag/:tagId/edit` (`router.mjs:879-886`): ustawiają `name` albo `name` i `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Dodaje lub usuwa jeden albo wiele projektów (`$addToSet` / `$pull` / `$pullAll` na `project_ids`), trasy `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Wywoływane dla każdego członka, gdy projekt zostaje usunięty (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`), oraz gdy użytkownik zostaje usunięty z projektu lub go opuszcza (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Umieszcza skopiowany projekt w tych samych tagach co oryginał (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Skrypt administracyjny, który zmienia nazwę tagu jednego użytkownika bezpośrednio w Mongo. |

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Pulpit projektów (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` i prywatne API `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Tagi otwartego projektu w edytorze (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Licznik analityczny przy kopiowaniu projektu (`ProjectDuplicator.mjs:98`). |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Ta sama migracja utworzyła też `user_id_1`; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` ponownie go usuwa, ponieważ obejmuje go indeks złożony.

#### Uwagi

* Tagi są przypisane do użytkownika: dwóch współpracowników tego samego projektu ma dla niego własne tagi.
* `user_id` i `project_ids` są ciągami znaków, więc odpytuj je za pomocą id w postaci ciągów, a nie ObjectId.
* Usunięcie użytkownika (`services/web/app/src/Features/User/UserDeleter.mjs`) nie zmienia `tags`.


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