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

# Koleksi Rooms

`rooms` menyimpan satu dokumen per room chat sebuah proyek: chat proyek, atau satu utas komentar tinjauan. Hanya layanan chat yang menulisnya, di `services/chat/app/js/Features/Threads/ThreadManager.js`. Tidak ada skema Mongoose. Pesan-pesan sebuah room ada di koleksi [messages](https://ayakaleaf-pro.mintlify.site/id/dev/data-model/messages-collection.md).

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id room. `messages.room_id` menunjuk ke sini. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Proyek tempat room berada. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Hanya pada utas komentar: id komentar, sama dengan `id` dan `op.t` dari komentar di `docs.ranges.comments` (lihat [docs](https://ayakaleaf-pro.mintlify.site/id/dev/data-model/docs-collection.md)). Tidak ada pada room chat proyek. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Diatur saat utas diselesaikan, dihapus saat dibuka kembali. Utas tanpa field ini berstatus terbuka. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Id pengguna yang menyelesaikan utas. Disimpan sebagai string, bukan ObjectId: body permintaan hanya diperiksa sebagai id yang valid, tidak dikonversi. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Kapan utas diselesaikan. | `ThreadManager.js:104` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Melakukan upsert room. Berjalan pada setiap pengiriman, pembacaan, penyuntingan, dan penghapusan pesan (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), sehingga pesan pertama sebuah komentar membuat room utasnya, dan membaca chat proyek membuat room chat proyek. |
| `ThreadManager.js:94-109` `resolveThread` | Mengatur `resolved`. Dipanggil dari web oleh modul track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), oleh pemulihan riwayat (`services/web/app/src/Features/History/RestoreManager.mjs:276`), dan oleh modul mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Menghapus `resolved`. Pemanggil yang sama: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Menyisipkan room baru dengan `thread_id` baru, menyalin `resolved`. Dipakai ketika doc dipulihkan dari riwayat (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Menyalin setiap room utas sebuah proyek ke proyek lain, dengan `_id` baru dan `thread_id` yang sama. Dipakai ketika proyek disalin bersama rentangnya (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Menghapus satu room utas; controller lalu menghapus pesannya (`MessageHttpController.js:167-175`). Dipanggil oleh modul track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Menghapus semua room sebuah proyek (`MessageHttpController.js:261-273`). Dipanggil ketika proyek yang dihapus kedaluwarsa (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Mencantumkan room utas sebuah proyek beserta pesannya (`MessageHttpController.js:71-81`), untuk panel tinjauan modul track-changes (`TrackChangesController.mjs:82`) dan modul mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Mengembalikan id utas yang sudah diselesaikan. Web menambahkan id milik sebuah doc ke doc yang dikirimnya ke document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Satu utas beserta pesannya (`MessageHttpController.js:97-120`). Web memakainya agar peninjau hanya dapat mengubah utas yang mereka mulai (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Data utas untuk id tertentu, dipakai oleh pemulihan riwayat (`RestoreManager.mjs:259`). |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Indeks lama `project_id` (`20190912145026_create_rooms_indexes.mjs`) dihapus oleh `20250205145327_drop_rooms_projectId_index.mjs`.

#### Catatan

* Sebuah proyek memiliki paling banyak satu room tanpa `thread_id`: chat proyek. Layanan chat menemukannya dengan `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Status selesai sebuah komentar hanya ada di sini. Docstore membuang `op.resolved` sebelum menyimpan rentang (`services/docstore/app/js/RangeManager.js:59-61`).
* Setelah proyek disalin, `thread_id` yang sama ada di dua proyek. Selalu kueri berdasarkan `project_id` dan `thread_id` bersama-sama, seperti yang dilakukan layanan chat.
* Room dari proyek yang dihapus tetap ada sampai proyek yang dihapus itu kedaluwarsa.


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