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

`tags` bir kullanıcının proje panosunda projeleri ayırdığı etiketleri (klasörleri) tutar. Her belge, bir kullanıcının bir etiketidir. Sahibi `web`'dir; şema `services/web/app/src/models/Tag.mjs` dosyasıdır ve tüm yazmalar `services/web/app/src/Features/Tags/TagsHandler.mjs` üzerinden yapılır.

#### Alanlar

| Alan | Tür | Anlamı | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Etiket kimliği; `/tag/:tagId` rotalarında kullanılır. | `Tag.mjs:10` |
| `user_id` | String | Etiketin sahibi. Eski nedenlerle ObjectId değil, düz bir dizedir. | `Tag.mjs:7-12` |
| `name` | String | Etiket adı, en fazla 50 karakter (`MAX_TAG_LENGTH`). Kullanıcı başına benzersizdir. | `Tag.mjs:13`, `TagsHandler.mjs:4` |
| `color` | String | İsteğe bağlı renk: `#a1b2c3` gibi bir onaltılık kod veya bir `hsl(<n>, 70%, 45%)` değeri (`TAG_COLOR_REGEX`). | `Tag.mjs:5`, `Tag.mjs:14-22` |
| `project_ids` | Array of String | Bu etiketteki projelerin kimlikleri, dize olarak. | `Tag.mjs:23` |
| `__v` | Number | Mongoose sürüm anahtarı; `Tag.create` belgeyi oluştururken eklenir. | `TagsHandler.mjs:27` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `TagsHandler.mjs:18-35` (`createTag`) | `POST /tag` (`services/web/app/src/router.mjs:873-874`). Ad yineleniyorsa mevcut etiketi döndürür. |
| `TagsHandler.mjs:37-70` (`renameTag`, `editTag`) | `POST /tag/:tagId/rename` ve `/tag/:tagId/edit` (`router.mjs:879-886`): `name` ya da `name` ve `color` değerini ayarlar. |
| `TagsHandler.mjs:72-77` (`deleteTag`) | `DELETE /tag/:tagId` (`router.mjs:891-892`). |
| `TagsHandler.mjs:79-113` | Bir veya birden çok projeyi ekler ya da kaldırır (`project_ids` üzerinde `$addToSet` / `$pull` / `$pullAll`), rotalar `router.mjs:897-916`. |
| `TagsHandler.mjs:124-128` (`removeProjectFromAllTags`) | Bir proje silindiğinde (`services/web/app/src/Features/Project/ProjectDeleter.mjs:236-238`) ve bir kullanıcı projeden çıkarıldığında veya ayrıldığında (`services/web/app/src/Features/Collaborators/CollaboratorsController.mjs:621`) her üye için çağrılır. |
| `TagsHandler.mjs:130-134` (`addProjectToTags`) | Kopyalanan bir projeyi orijinaliyle aynı etiketlere koyar (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:190-194`). |
| `services/web/modules/server-ce-scripts/scripts/rename-tag.mjs:20-23` | Bir kullanıcının etiketini doğrudan Mongo'da yeniden adlandıran yönetici betiği. |

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `TagsHandler.mjs:6-8` (`getAllTags`) | Proje panosu (`services/web/app/src/Features/Project/ProjectListController.mjs:313`, `:747`), `GET /tag` ve özel API `GET /user/:userId/tag` (`router.mjs:863-869`). |
| `TagsHandler.mjs:14-16` (`getTagsForProject`) | Düzenleyicide açık projenin etiketleri (`services/web/app/src/Features/Project/ProjectController.mjs:672`). |
| `TagsHandler.mjs:10-12` (`countTagsForProject`) | Bir proje kopyalandığında analiz sayımı (`ProjectDuplicator.mjs:98`). |

#### Dizinler

| Ad | Anahtarlar | Seçenekler | Geçiş |
| - | - | - | - |
| `user_id_1_name_1` | `{ user_id: 1, name: 1 }` | unique | `tools/migrations/20190912145029_create_tags_indexes.mjs` |

Aynı geçiş `user_id_1` dizinini de oluşturdu; bileşik dizin onu kapsadığı için `tools/migrations/20231031164732_drop_redundant_indexes.mjs` onu yeniden kaldırır.

#### Notlar

* Etiketler kullanıcıya özeldir: aynı projenin iki ortak çalışanı, proje için her biri kendi etiketlerini tutar.
* `user_id` ve `project_ids` dizedir; bu yüzden onları ObjectId ile değil, dize kimliklerle sorgulayın.
* Bir kullanıcıyı silmek (`services/web/app/src/Features/User/UserDeleter.mjs`) `tags` koleksiyonuna dokunmaz.


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