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

# Collection Rooms

`rooms` lưu một tài liệu cho mỗi phòng chat của một dự án: chat của dự án, hoặc một luồng bình luận review. Chỉ dịch vụ chat ghi vào nó, trong `services/chat/app/js/Features/Threads/ThreadManager.js`. Không có schema Mongoose. Tin nhắn của một phòng nằm trong collection [messages](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/messages-collection.md).

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id của phòng. `messages.room_id` trỏ tới đây. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Dự án mà phòng thuộc về. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Chỉ có trên luồng bình luận: id của bình luận, giống `id` và `op.t` của bình luận trong `docs.ranges.comments` (xem [docs](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/docs-collection.md)). Không có trên phòng chat của dự án. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Được đặt khi luồng được giải quyết, bị xóa khi luồng được mở lại. Luồng không có trường này là đang mở. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Id của người dùng đã giải quyết luồng. Lưu dưới dạng chuỗi, không phải ObjectId: body của request chỉ được kiểm tra là id hợp lệ, không được chuyển đổi. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Thời điểm luồng được giải quyết. | `ThreadManager.js:104` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Upsert phòng. Chạy mỗi lần gửi, đọc, sửa và xóa tin nhắn (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), nên tin nhắn đầu tiên của một bình luận tạo phòng cho luồng đó, và việc đọc chat của dự án tạo phòng chat của dự án. |
| `ThreadManager.js:94-109` `resolveThread` | Đặt `resolved`. Được gọi từ web bởi module track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), bởi khôi phục lịch sử (`services/web/app/src/Features/History/RestoreManager.mjs:276`) và bởi module mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Xóa `resolved`. Cùng các nơi gọi: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Chèn một phòng mới với `thread_id` mới, sao chép `resolved`. Dùng khi một doc được khôi phục từ lịch sử (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Sao chép mọi phòng luồng của một dự án sang dự án khác, với `_id` mới và cùng `thread_id`. Dùng khi sao chép dự án cùng các vùng của nó (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Xóa một phòng luồng; sau đó controller xóa các tin nhắn của nó (`MessageHttpController.js:167-175`). Được gọi bởi module track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Xóa mọi phòng của một dự án (`MessageHttpController.js:261-273`). Được gọi khi dự án đã xóa hết hạn (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Liệt kê các phòng luồng của dự án cùng tin nhắn (`MessageHttpController.js:71-81`), cho bảng review của module track-changes (`TrackChangesController.mjs:82`) và module mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Trả về id của các luồng đã giải quyết. Web thêm những id thuộc một doc vào doc mà nó gửi tới document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Một luồng cùng tin nhắn (`MessageHttpController.js:97-120`). Web dùng nó để người review chỉ sửa được những luồng do họ bắt đầu (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Dữ liệu luồng cho các id cho trước, dùng bởi khôi phục lịch sử (`RestoreManager.mjs:259`). |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Chỉ mục cũ `project_id` (`20190912145026_create_rooms_indexes.mjs`) đã bị xóa bởi `20250205145327_drop_rooms_projectId_index.mjs`.

#### Ghi chú

* Một dự án có tối đa một phòng không có `thread_id`: chat của dự án. Dịch vụ chat tìm nó bằng `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Trạng thái đã giải quyết của bình luận chỉ nằm ở đây. Docstore loại bỏ `op.resolved` trước khi lưu các vùng (`services/docstore/app/js/RangeManager.js:59-61`).
* Sau khi sao chép dự án, cùng một `thread_id` tồn tại trong hai dự án. Luôn truy vấn bằng cả `project_id` và `thread_id`, như dịch vụ chat.
* Các phòng của dự án đã xóa vẫn còn cho đến khi dự án đã xóa hết hạn.


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