> ## 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`؛ المخطط هو `services/web/app/src/models/Tag.mjs`، وكل عمليات الكتابة تمر عبر `services/web/app/src/Features/Tags/TagsHandler.mjs`.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف الوسم، ويُستخدم في المسارات `/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 | معرّفات المشاريع في هذا الوسم، كسلاسل نصية. | `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` | تضيف مشروعًا أو أكثر أو تزيله (`$addToSet` / `$pull` / `$pullAll` على `project_ids`)، والمسارات في `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` سلاسل نصية، لذا استعلم عنها بمعرّفات نصية لا بـ 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.