> ## 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` には、プロジェクトのチャットルームごとに 1 つのドキュメントが保存されます。プロジェクトチャット、またはレビューコメントスレッド 1 つです。書き込むのは chat サービスだけで、`services/chat/app/js/Features/Threads/ThreadManager.js` で行われます。Mongoose スキーマはありません。ルームのメッセージは [messages](https://ayakaleaf-pro.mintlify.site/ja/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/ja/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` | スレッドルームを 1 つ削除します。その後コントローラーがそのメッセージを削除します（`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` | メッセージ付きのスレッド 1 つ（`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` のないルームが最大 1 つあり、それがプロジェクトチャットです。chat サービスは `thread_id: { $exists: false }` で検索します（`ThreadManager.js:38-45`）。
* コメントの解決状態はここにしかありません。Docstore は範囲を保存する前に `op.resolved` を取り除きます（`services/docstore/app/js/RangeManager.js:59-61`）。
* プロジェクトをコピーすると、同じ `thread_id` が 2 つのプロジェクトに存在します。chat サービスと同様に、必ず `project_id` と `thread_id` を組み合わせて検索してください。
* 削除済みプロジェクトのルームは、そのプロジェクトの期限が切れるまで残ります。


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