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

# Koleksi Tags

`tags` menyimpan tag (folder) yang digunakan pengguna untuk mengelompokkan proyek di dasbor proyek. Satu dokumen adalah satu tag milik satu pengguna. Pemiliknya adalah `web`; skemanya `services/web/app/src/models/Tag.mjs`, dan semua penulisan melalui `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id tag, digunakan di rute `/tag/:tagId`. | `Tag.mjs:10` |
| `user_id` | String | Pemilik tag. String biasa, bukan ObjectId, karena alasan historis. | `Tag.mjs:7-12` |
| `name` | String | Nama tag, paling banyak 50 karakter (`MAX_TAG_LENGTH`). Unik per pengguna. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | Warna opsional: kode heksadesimal seperti `#a1b2c3` atau nilai `hsl(<n>, 70%, 45%)` (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Id proyek dalam tag ini, sebagai string. | `Tag.mjs:23` |
| `__v` | Number | Kunci versi Mongoose, ditambahkan saat `Tag.create` membuat dokumen. | `TagsHandler.mjs:27` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Jika namanya duplikat, mengembalikan tag yang sudah ada. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` dan `/tag/:tagId/edit` (`router.mjs:879-886`): mengatur `name`, atau `name` dan `color`. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Menambahkan atau menghapus satu atau beberapa proyek (`$addToSet` / `$pull` / `$pullAll` pada `project_ids`), rute `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Dipanggil untuk setiap anggota saat proyek dihapus (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) dan saat pengguna dikeluarkan dari atau meninggalkan proyek (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`). |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Memasukkan proyek salinan ke tag yang sama dengan aslinya (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Skrip admin yang mengganti nama tag milik satu pengguna langsung di Mongo. |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Dasbor proyek (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag`, dan API privat `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Tag proyek yang sedang terbuka di editor (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Penghitungan analitik saat proyek disalin (`ProjectDuplicator.mjs:98`). |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Migrasi yang sama juga membuat `user_id_1`; `tools/migrations/20231031164732_drop_redundant_indexes.mjs` menghapusnya lagi karena indeks gabungan sudah mencakupnya.

#### Catatan

* Tag bersifat per pengguna: dua kolaborator pada proyek yang sama masing-masing menyimpan tag mereka sendiri untuk proyek itu.
* `user_id` dan `project_ids` adalah string, jadi kueri keduanya dengan id string, bukan ObjectId.
* Menghapus pengguna (`services/web/app/src/Features/User/UserDeleter.mjs`) tidak menyentuh `tags`.


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