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

# Collection Tags

`tags` lưu các thẻ (thư mục) mà người dùng dùng để sắp xếp dự án trên bảng điều khiển dự án. Mỗi tài liệu là một thẻ của một người dùng. `web` sở hữu collection này; schema là `services/web/app/src/models/Tag.mjs`, và mọi thao tác ghi đều đi qua `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id của thẻ, dùng trong các route `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Chủ sở hữu thẻ. Là chuỗi thông thường, không phải ObjectId, vì lý do lịch sử. | `Tag.mjs:7-12` |
| `name` | String | Tên thẻ, tối đa 50 ký tự (`MAX_TAG_LENGTH`). Duy nhất theo từng người dùng. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Màu tùy chọn: mã hex như `#a1b2c3` hoặc giá trị `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Id của các dự án trong thẻ này, dưới dạng chuỗi. | `Tag.mjs:23` |
| `__v` | Number | Khóa phiên bản của Mongoose, được thêm khi `Tag.create` tạo tài liệu. | `TagsHandler.mjs:27` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Nếu tên bị trùng, trả về thẻ đã có. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` và `/tag/:tagId/edit` (`router.mjs:879-886`): đặt `name`, hoặc `name` và `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Thêm hoặc xóa một hay nhiều dự án (`$addToSet` / `$pull` / `$pullAll` trên `project_ids`), các route `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Được gọi cho từng thành viên khi một dự án bị xóa (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) và khi người dùng bị gỡ khỏi hoặc rời một dự án (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Đưa dự án được sao chép vào cùng các thẻ với bản gốc (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Script quản trị đổi tên một thẻ của một người dùng trực tiếp trong Mongo. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Bảng điều khiển dự án (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` và API riêng `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Các thẻ của dự án đang mở trong trình soạn thảo (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Đếm cho mục đích phân tích khi một dự án được sao chép (`ProjectDuplicator.mjs:98`). |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Cùng migration đó cũng tạo `user_id_1`; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` xóa nó đi vì chỉ mục kết hợp đã bao phủ nó.

#### Ghi chú

* Thẻ là riêng cho từng người dùng: hai cộng tác viên của cùng một dự án mỗi người giữ thẻ riêng của mình cho dự án đó.
* `user_id` và `project_ids` là chuỗi, vì vậy hãy truy vấn chúng bằng id dạng chuỗi, không phải ObjectId.
* Xóa người dùng (`services/web/app/src/Features/User/UserDeleter.mjs`) không động đến `tags`.


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