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

`rooms` bevat één document per chatruimte van een project: de projectchat of één thread met reviewopmerkingen. Alleen de chatservice schrijft erin, in `services/chat/app/js/Features/Threads/ThreadManager.js`. Er is geen Mongoose-schema. De berichten van een ruimte staan in de collectie [messages](https://ayakaleaf-pro.mintlify.site/nl/dev/data-model/messages-collection.md).

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Ruimte-id. `messages.room_id` verwijst hiernaar. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Project waartoe de ruimte behoort. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Alleen bij opmerkingenthreads: de id van de opmerking, gelijk aan `id` en `op.t` van de opmerking in `docs.ranges.comments` (zie [docs](https://ayakaleaf-pro.mintlify.site/nl/dev/data-model/docs-collection.md)). Ontbreekt bij de projectchatruimte. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Wordt gezet wanneer de thread is opgelost en verwijderd wanneer deze opnieuw wordt geopend. Een thread zonder dit veld is open. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Id van de gebruiker die de thread heeft opgelost. Opgeslagen als string, niet als ObjectId: de request-body wordt alleen gecontroleerd op een geldige id, niet omgezet. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Wanneer de thread is opgelost. | `ThreadManager.js:104` |

#### Wie schrijft het

| Code | Wat het doet |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Voert een upsert van de ruimte uit. Draait bij elk verzenden, lezen, bewerken en verwijderen van berichten (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), dus het eerste bericht van een opmerking maakt de threadruimte aan en het lezen van de projectchat maakt de projectchatruimte aan. |
| `ThreadManager.js:94-109` `resolveThread` | Zet `resolved`. Aangeroepen vanuit web door de track-changes-module (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), door geschiedenisherstel (`services/web/app/src/Features/History/RestoreManager.mjs:276`) en door de mcp-server-module (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Verwijdert `resolved`. Dezelfde aanroepers: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Voegt een nieuwe ruimte in met een nieuwe `thread_id` en kopieert `resolved`. Gebruikt wanneer een doc uit de geschiedenis wordt hersteld (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Kopieert elke threadruimte van een project naar een ander project, met een nieuwe `_id` en dezelfde `thread_id`. Gebruikt wanneer een project met zijn bereiken wordt gekopieerd (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Verwijdert één threadruimte; de controller verwijdert daarna de berichten ervan (`MessageHttpController.js:167-175`). Aangeroepen door de track-changes-module (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Verwijdert alle ruimtes van een project (`MessageHttpController.js:261-273`). Aangeroepen wanneer een verwijderd project verloopt (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Wie leest het

| Code | Wat het doet |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Toont de threadruimtes van een project met hun berichten (`MessageHttpController.js:71-81`), voor het reviewpaneel van de track-changes-module (`TrackChangesController.mjs:82`) en de mcp-server-module (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Geeft de id’s van opgeloste threads terug. Web voegt die van een doc toe aan het doc dat het naar document-updater stuurt (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Eén thread met zijn berichten (`MessageHttpController.js:97-120`). Web gebruikt dit zodat een reviewer alleen threads kan wijzigen die hij zelf is gestart (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Threadgegevens voor opgegeven id’s, gebruikt door geschiedenisherstel (`RestoreManager.mjs:259`). |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

De oudere index `project_id` (`20190912145026_create_rooms_indexes.mjs`) is verwijderd door `20250205145327_drop_rooms_projectId_index.mjs`.

#### Opmerkingen

* Een project heeft hoogstens één ruimte zonder `thread_id`: de projectchat. De chatservice vindt die met `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* De opgeloste status van een opmerking staat alleen hier. Docstore verwijdert `op.resolved` voordat het bereiken opslaat (`services/docstore/app/js/RangeManager.js:59-61`).
* Na een projectkopie bestaat dezelfde `thread_id` in twee projecten. Zoek altijd op `project_id` en `thread_id` samen, zoals de chatservice doet.
* Ruimtes van een verwijderd project blijven bestaan totdat het verwijderde project verloopt.


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