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

`rooms` enthält ein Dokument pro Chatraum eines Projekts: den Projekt-Chat oder einen Review-Kommentar-Thread. Nur der Chat-Dienst schreibt sie, in `services/chat/app/js/Features/Threads/ThreadManager.js`. Es gibt kein Mongoose-Schema. Die Nachrichten eines Raums liegen in der Collection [messages](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/messages-collection.md).

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Raum-ID. `messages.room_id` verweist hierher. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Projekt, zu dem der Raum gehört. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Nur bei Kommentar-Threads: die ID des Kommentars, identisch mit `id` und `op.t` des Kommentars in `docs.ranges.comments` (siehe [docs](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/docs-collection.md)). Fehlt beim Projekt-Chat-Raum. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Wird gesetzt, wenn der Thread gelöst wird, und entfernt, wenn er wieder geöffnet wird. Ein Thread ohne dieses Feld ist offen. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | ID des Benutzers, der den Thread gelöst hat. Als String gespeichert, nicht als ObjectId: Der Request-Body wird nur auf eine gültige ID geprüft, nicht umgewandelt. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Zeitpunkt, zu dem der Thread gelöst wurde. | `ThreadManager.js:104` |

#### Wer schreibt sie

| Code | Was er tut |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Führt ein Upsert des Raums aus. Läuft bei jedem Senden, Lesen, Bearbeiten und Löschen von Nachrichten (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`). Daher legt die erste Nachricht eines Kommentars seinen Thread-Raum an, und das Lesen des Projekt-Chats legt den Projekt-Chat-Raum an. |
| `ThreadManager.js:94-109` `resolveThread` | Setzt `resolved`. Aufgerufen aus Web vom track-changes-Modul (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), von der Verlaufswiederherstellung (`services/web/app/src/Features/History/RestoreManager.mjs:276`) und vom mcp-server-Modul (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Entfernt `resolved`. Dieselben Aufrufer: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Fügt einen neuen Raum mit einer neuen `thread_id` ein und kopiert `resolved`. Wird verwendet, wenn ein Doc aus dem Verlauf wiederhergestellt wird (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Kopiert jeden Thread-Raum eines Projekts in ein anderes Projekt, mit neuer `_id` und derselben `thread_id`. Wird verwendet, wenn ein Projekt mit seinen Bereichen kopiert wird (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Löscht einen Thread-Raum; der Controller löscht danach dessen Nachrichten (`MessageHttpController.js:167-175`). Aufgerufen vom track-changes-Modul (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Löscht alle Räume eines Projekts (`MessageHttpController.js:261-273`). Aufgerufen, wenn ein gelöschtes Projekt abläuft (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Wer liest sie

| Code | Was er tut |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Listet die Thread-Räume eines Projekts mit ihren Nachrichten auf (`MessageHttpController.js:71-81`), für das Review-Panel des track-changes-Moduls (`TrackChangesController.mjs:82`) und das mcp-server-Modul (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Gibt die IDs der gelösten Threads zurück. Web fügt die eines Docs dem Doc hinzu, das es an document-updater sendet (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Ein Thread mit seinen Nachrichten (`MessageHttpController.js:97-120`). Web nutzt ihn, damit ein Reviewer nur Threads ändern kann, die er selbst begonnen hat (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Thread-Daten zu gegebenen IDs, verwendet von der Verlaufswiederherstellung (`RestoreManager.mjs:259`). |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Der ältere Index `project_id` (`20190912145026_create_rooms_indexes.mjs`) wurde durch `20250205145327_drop_rooms_projectId_index.mjs` entfernt.

#### Hinweise

* Ein Projekt hat höchstens einen Raum ohne `thread_id`: den Projekt-Chat. Der Chat-Dienst findet ihn mit `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Der Gelöst-Status eines Kommentars liegt nur hier. Docstore entfernt `op.resolved`, bevor er Bereiche speichert (`services/docstore/app/js/RangeManager.js:59-61`).
* Nach einer Projektkopie existiert dieselbe `thread_id` in zwei Projekten. Fragen Sie immer `project_id` und `thread_id` zusammen ab, wie es der Chat-Dienst tut.
* Räume eines gelöschten Projekts bleiben erhalten, bis das gelöschte Projekt abläuft.


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