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

# Kolekcja Rooms

`rooms` przechowuje jeden dokument na pokój czatu projektu: czat projektu albo jeden wątek komentarzy recenzji. Zapisuje do niej tylko usługa chat, w `services/chat/app/js/Features/Threads/ThreadManager.js`. Nie ma schematu Mongoose. Wiadomości pokoju znajdują się w kolekcji [messages](https://ayakaleaf-pro.mintlify.site/pl/dev/data-model/messages-collection.md).

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Identyfikator pokoju. Wskazuje tu `messages.room_id`. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Projekt, do którego należy pokój. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Tylko w wątkach komentarzy: identyfikator komentarza, taki sam jak `id` i `op.t` komentarza w `docs.ranges.comments` (zobacz [docs](https://ayakaleaf-pro.mintlify.site/pl/dev/data-model/docs-collection.md)). Brak w pokoju czatu projektu. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Ustawiane, gdy wątek zostaje rozwiązany, usuwane, gdy zostaje ponownie otwarty. Wątek bez tego pola jest otwarty. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Identyfikator użytkownika, który rozwiązał wątek. Zapisany jako string, a nie ObjectId: treść żądania jest tylko sprawdzana pod kątem poprawnego identyfikatora, nie konwertowana. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Kiedy wątek został rozwiązany. | `ThreadManager.js:104` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Wykonuje upsert pokoju. Działa przy każdym wysłaniu, odczycie, edycji i usunięciu wiadomości (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), więc pierwsza wiadomość komentarza tworzy pokój jego wątku, a odczyt czatu projektu tworzy pokój czatu projektu. |
| `ThreadManager.js:94-109` `resolveThread` | Ustawia `resolved`. Wywoływane z web przez moduł track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), przywracanie historii (`services/web/app/src/Features/History/RestoreManager.mjs:276`) i moduł mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Usuwa `resolved`. Te same wywołania: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Wstawia nowy pokój z nowym `thread_id`, kopiując `resolved`. Używane, gdy dokument jest przywracany z historii (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Kopiuje każdy pokój wątku projektu do innego projektu, z nowym `_id` i tym samym `thread_id`. Używane, gdy projekt jest kopiowany razem z zakresami (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Usuwa jeden pokój wątku; następnie kontroler usuwa jego wiadomości (`MessageHttpController.js:167-175`). Wywoływane przez moduł track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Usuwa wszystkie pokoje projektu (`MessageHttpController.js:261-273`). Wywoływane, gdy wygasa usunięty projekt (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Wyświetla pokoje wątków projektu z ich wiadomościami (`MessageHttpController.js:71-81`), dla panelu recenzji modułu track-changes (`TrackChangesController.mjs:82`) i modułu mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Zwraca identyfikatory rozwiązanych wątków. Web dodaje te dotyczące dokumentu do dokumentu wysyłanego do document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Jeden wątek z wiadomościami (`MessageHttpController.js:97-120`). Web używa go, aby recenzent mógł zmieniać tylko wątki, które sam rozpoczął (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Dane wątków dla podanych identyfikatorów, używane przez przywracanie historii (`RestoreManager.mjs:259`). |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Starszy indeks `project_id` (`20190912145026_create_rooms_indexes.mjs`) został usunięty przez `20250205145327_drop_rooms_projectId_index.mjs`.

#### Uwagi

* Projekt ma najwyżej jeden pokój bez `thread_id`: czat projektu. Usługa chat znajduje go za pomocą `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Stan rozwiązania komentarza istnieje tylko tutaj. Docstore usuwa `op.resolved` przed zapisaniem zakresów (`services/docstore/app/js/RangeManager.js:59-61`).
* Po skopiowaniu projektu ten sam `thread_id` istnieje w dwóch projektach. Zawsze odpytuj `project_id` i `thread_id` razem, tak jak robi to usługa chat.
* Pokoje usuniętego projektu pozostają, dopóki usunięty projekt nie wygaśnie.


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