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

`tags` зберігає теги (папки), за якими користувач розкладає проєкти на панелі проєктів. Кожен документ описує один тег одного користувача. Власником є `web`; схема: `services/web/app/src/models/Tag.mjs`, а всі записи проходять через `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Id тегу, використовується в маршрутах `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Власник тегу. Звичайний рядок, а не ObjectId, з історичних причин. | `Tag.mjs:7-12` |
| `name` | String | Назва тегу, не більше 50 символів (`MAX_TAG_LENGTH`). Унікальна в межах користувача. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Необов'язковий колір: шістнадцятковий код на кшталт `#a1b2c3` або значення `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Id проєктів у цьому тегу, у вигляді рядків. | `Tag.mjs:23` |
| `__v` | Number | Ключ версії Mongoose, додається, коли `Tag.create` створює документ. | `TagsHandler.mjs:27` |

#### Хто записує

| Код | Що робить |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Якщо назва повторюється, повертає наявний тег. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` і `/tag/:tagId/edit` (`router.mjs:879-886`): задають `name` або `name` і `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Додає або видаляє один чи кілька проєктів (`$addToSet` / `$pull` / `$pullAll` для `project_ids`), маршрути `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Викликається для кожного учасника, коли проєкт видаляють (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`), а також коли користувача вилучають із проєкту або він його залишає (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Додає скопійований проєкт до тих самих тегів, що й оригінал (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Адміністративний скрипт, що перейменовує тег одного користувача безпосередньо в Mongo. |

#### Хто читає

| Код | Що робить |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Панель проєктів (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` і приватний API `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Теги відкритого проєкту в редакторі (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Підрахунок для аналітики під час копіювання проєкту (`ProjectDuplicator.mjs:98`). |

#### Індекси

| Назва | Ключі | Параметри | Міграція |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Та сама міграція створила й `user_id_1`; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` знову видаляє його, бо складений індекс його покриває.

#### Примітки

* Теги належать окремому користувачу: два співавтори одного проєкту зберігають для нього кожен свої теги.
* `user_id` і `project_ids` є рядками, тому запитуйте їх за рядковими id, а не за ObjectId.
* Видалення користувача (`services/web/app/src/Features/User/UserDeleter.mjs`) не зачіпає `tags`.


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