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

# Kolekce Rooms

`rooms` uchovává jeden dokument na chatovací místnost projektu: chat projektu, nebo jedno vlákno komentářů revize. Zapisuje do ní pouze služba chat, v `services/chat/app/js/Features/Threads/ThreadManager.js`. Schéma Mongoose neexistuje. Zprávy místnosti jsou v kolekci [messages](https://ayakaleaf-pro.mintlify.site/cs/dev/data-model/messages-collection.md).

#### Pole

| Pole | Typ | Význam | Zdroj |
| - | - | - | - |
| `_id` | ObjectId | ID místnosti. Ukazuje sem `messages.room_id`. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Projekt, do kterého místnost patří. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Pouze u vláken komentářů: ID komentáře, shodné s `id` a `op.t` komentáře v `docs.ranges.comments` (viz [docs](https://ayakaleaf-pro.mintlify.site/cs/dev/data-model/docs-collection.md)). U místnosti chatu projektu chybí. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Nastaví se, když je vlákno vyřešeno, a odstraní se, když je znovu otevřeno. Vlákno bez tohoto pole je otevřené. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | ID uživatele, který vlákno vyřešil. Ukládá se jako řetězec, ne jako ObjectId: tělo požadavku se pouze kontroluje, zda jde o platné ID, a nepřevádí se. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Kdy bylo vlákno vyřešeno. | `ThreadManager.js:104` |

#### Kdo zapisuje

| Kód | Co dělá |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Provede upsert místnosti. Spouští se při každém odeslání, čtení, úpravě a smazání zpráv (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), takže první zpráva komentáře vytvoří místnost jeho vlákna a čtení chatu projektu vytvoří místnost chatu projektu. |
| `ThreadManager.js:94-109` `resolveThread` | Nastaví `resolved`. Volá se z web modulem track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), obnovením historie (`services/web/app/src/Features/History/RestoreManager.mjs:276`) a modulem mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Odstraní `resolved`. Stejní volající: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Vloží novou místnost s novým `thread_id` a zkopíruje `resolved`. Používá se při obnovení dokumentu z historie (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Zkopíruje každou místnost vlákna projektu do jiného projektu, s novým `_id` a stejným `thread_id`. Používá se, když se projekt kopíruje i s rozsahy (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Smaže jednu místnost vlákna; kontrolér pak smaže její zprávy (`MessageHttpController.js:167-175`). Volá ho modul track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Smaže všechny místnosti projektu (`MessageHttpController.js:261-273`). Volá se, když vyprší smazaný projekt (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Kdo čte

| Kód | Co dělá |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Vypíše místnosti vláken projektu s jejich zprávami (`MessageHttpController.js:71-81`) pro panel revizí modulu track-changes (`TrackChangesController.mjs:82`) a modul mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Vrátí ID vyřešených vláken. Web přidá ta, která patří k dokumentu, do dokumentu, který posílá do document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Jedno vlákno se zprávami (`MessageHttpController.js:97-120`). Web ho používá, aby recenzent mohl měnit jen vlákna, která sám založil (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Data vláken pro zadaná ID, používaná obnovením historie (`RestoreManager.mjs:259`). |

#### Indexy

| Název | Klíče | Volby | Migrace |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Starší index `project_id` (`20190912145026_create_rooms_indexes.mjs`) byl odstraněn migrací `20250205145327_drop_rooms_projectId_index.mjs`.

#### Poznámky

* Projekt má nejvýše jednu místnost bez `thread_id`: chat projektu. Služba chat ji najde pomocí `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Stav vyřešení komentáře je uložen pouze zde. Docstore před uložením rozsahů odstraní `op.resolved` (`services/docstore/app/js/RangeManager.js:59-61`).
* Po zkopírování projektu existuje stejné `thread_id` ve dvou projektech. Vždy se dotazujte na `project_id` a `thread_id` společně, stejně jako služba chat.
* Místnosti smazaného projektu zůstávají, dokud smazaný projekt nevyprší.


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