> ## 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` は、ユーザーがプロジェクトダッシュボードでプロジェクトを分類するためのタグ（フォルダー）を保持します。1 つのドキュメントは 1 人のユーザーの 1 つのタグです。`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` のような 16 進コード、または `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` | 1 つまたは複数のプロジェクトを追加・削除します（`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` | 1 人のユーザーのタグを 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` がそれを再び削除します。

#### 補足

* タグはユーザーごとです。同じプロジェクトの 2 人の共同編集者は、それぞれ自分のタグを持ちます。
* `user_id` と `project_ids` は文字列なので、ObjectId ではなく文字列の id でクエリしてください。
* ユーザーの削除（`services/web/app/src/Features/User/UserDeleter.mjs`）は `tags` に影響しません。


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