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

# مجموعة Rooms

تحتفظ `rooms` بمستند واحد لكل غرفة دردشة في المشروع: دردشة المشروع، أو سلسلة تعليقات مراجعة واحدة. لا تكتب فيها إلا خدمة chat، في `services/chat/app/js/Features/Threads/ThreadManager.js`. لا يوجد مخطط Mongoose. رسائل الغرفة موجودة في مجموعة [messages](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/messages-collection.md).

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف الغرفة. يشير `messages.room_id` إلى هنا. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | المشروع الذي تنتمي إليه الغرفة. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | في سلاسل التعليقات فقط: معرّف التعليق، وهو نفسه `id` و`op.t` للتعليق في `docs.ranges.comments` (راجع [docs](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/docs-collection.md)). غير موجود في غرفة دردشة المشروع. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | يُضبط عند حل السلسلة، ويُزال عند إعادة فتحها. السلسلة التي لا تحتوي عليه مفتوحة. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | معرّف المستخدم الذي حلّ السلسلة. يُخزَّن كسلسلة نصية لا كـ ObjectId: يُتحقق فقط من أن جسم الطلب معرّف صالح، ولا يُحوَّل. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | وقت حل السلسلة. | `ThreadManager.js:104` |

#### من يكتبها

| الكود | ماذا يفعل |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | يُجري upsert للغرفة. يعمل عند كل إرسال وقراءة وتعديل وحذف للرسائل (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`)، لذا فإن أول رسالة في تعليق تنشئ غرفة سلسلته، وقراءة دردشة المشروع تنشئ غرفة دردشة المشروع. |
| `ThreadManager.js:94-109` `resolveThread` | يضبط `resolved`. يُستدعى من web بواسطة وحدة track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`)، واستعادة السجل (`services/web/app/src/Features/History/RestoreManager.mjs:276`)، ووحدة mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | يزيل `resolved`. المستدعون أنفسهم: `TrackChangesController.mjs:160`، `RestoreManager.mjs:285`، `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | يُدرج غرفة جديدة بـ `thread_id` جديد، مع نسخ `resolved`. يُستخدم عند استعادة مستند من السجل (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | ينسخ كل غرف السلاسل في مشروع إلى مشروع آخر، بـ `_id` جديد و`thread_id` نفسه. يُستخدم عند نسخ مشروع مع نطاقاته (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | يحذف غرفة سلسلة واحدة؛ ثم يحذف المتحكم رسائلها (`MessageHttpController.js:167-175`). تستدعيه وحدة track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | يحذف كل غرف المشروع (`MessageHttpController.js:261-273`). يُستدعى عند انتهاء صلاحية مشروع محذوف (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### من يقرؤها

| الكود | ماذا يفعل |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | يسرد غرف سلاسل المشروع مع رسائلها (`MessageHttpController.js:71-81`)، للوحة المراجعة في وحدة track-changes (`TrackChangesController.mjs:82`) ووحدة mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | يعيد معرّفات السلاسل المحلولة. يضيف web ما يخص مستندًا ما إلى المستند الذي يرسله إلى document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | سلسلة واحدة مع رسائلها (`MessageHttpController.js:97-120`). يستخدمها web كي لا يغيّر المراجع إلا السلاسل التي بدأها (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | بيانات السلاسل لمعرّفات محددة، تستخدمها استعادة السجل (`RestoreManager.mjs:259`). |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

حُذف الفهرس الأقدم `project_id` (`20190912145026_create_rooms_indexes.mjs`) بواسطة `20250205145327_drop_rooms_projectId_index.mjs`.

#### ملاحظات

* للمشروع غرفة واحدة على الأكثر بلا `thread_id`: دردشة المشروع. تجدها خدمة chat باستخدام `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* حالة الحل للتعليق موجودة هنا فقط. يزيل Docstore `op.resolved` قبل حفظ النطاقات (`services/docstore/app/js/RangeManager.js:59-61`).
* بعد نسخ مشروع، يوجد `thread_id` نفسه في مشروعين. استعلم دائمًا باستخدام `project_id` و`thread_id` معًا، كما تفعل خدمة chat.
* تبقى غرف المشروع المحذوف حتى تنتهي صلاحية المشروع المحذوف.


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