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