> ## 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 schema。聊天室的訊息保存在 [messages](https://ayakaleaf-pro.mintlify.site/zh-TW/dev/data-model/messages-collection.md) 集合中。

#### 欄位

| 欄位 | 型別 | 含義 | 來源 |
| - | - | - | - |
| `_id` | ObjectId | 聊天室 ID。`messages.room_id` 指向這裡。 | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | 聊天室所屬的專案。 | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | 僅存在於註解討論串上：註解的 ID，與 `docs.ranges.comments` 中該註解的 `id` 和 `op.t` 相同（參見 [docs](https://ayakaleaf-pro.mintlify.site/zh-TW/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 | 解決該討論串的使用者 ID。以字串而非 ObjectId 儲存：請求本文只檢查其為有效 ID，不做轉換。 | `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` | 回傳已解決的討論串 ID。Web 會把某個文件的這些 ID 加到它傳送給 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` | 指定 ID 的討論串資料，供歷史還原使用（`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.