> ## 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` 负责；schema 为 `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` | 添加或移除一个或多个项目（对 `project_ids` 执行 `$addToSet` / `$pull` / `$pullAll`），路由见 `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.