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

`rooms` sisältää yhden dokumentin projektin jokaista chat-huonetta kohden: projektin chatin tai yhden arvioinnin kommenttiketjun. Vain chat-palvelu kirjoittaa siihen, tiedostossa `services/chat/app/js/Features/Threads/ThreadManager.js`. Mongoose-skeemaa ei ole. Huoneen viestit ovat kokoelmassa [messages](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/messages-collection.md).

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Huoneen tunniste. `messages.room_id` osoittaa tähän. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Projekti, johon huone kuuluu. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Vain kommenttiketjuissa: kommentin tunniste, sama kuin kommentin `id` ja `op.t` kentässä `docs.ranges.comments` (katso [docs](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/docs-collection.md)). Puuttuu projektin chat-huoneesta. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Asetetaan, kun ketju ratkaistaan, ja poistetaan, kun se avataan uudelleen. Ketju ilman tätä kenttää on avoin. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Ketjun ratkaisseen käyttäjän tunniste. Tallennetaan merkkijonona, ei ObjectId-arvona: pyynnön runko tarkistetaan vain kelvolliseksi tunnisteeksi, sitä ei muunneta. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Milloin ketju ratkaistiin. | `ThreadManager.js:104` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Tekee huoneelle upsertin. Suoritetaan jokaisella viestin lähetyksellä, lukemisella, muokkauksella ja poistolla (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), joten kommentin ensimmäinen viesti luo sen ketjuhuoneen ja projektin chatin lukeminen luo projektin chat-huoneen. |
| `ThreadManager.js:94-109` `resolveThread` | Asettaa kentän `resolved`. Kutsutaan webistä track-changes-moduulista (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), historian palautuksesta (`services/web/app/src/Features/History/RestoreManager.mjs:276`) ja mcp-server-moduulista (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Poistaa kentän `resolved`. Samat kutsujat: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Lisää uuden huoneen uudella kentällä `thread_id` ja kopioi kentän `resolved`. Käytetään, kun dokumentti palautetaan historiasta (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Kopioi projektin jokaisen ketjuhuoneen toiseen projektiin uudella kentällä `_id` ja samalla kentällä `thread_id`. Käytetään, kun projekti kopioidaan alueineen (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Poistaa yhden ketjuhuoneen; ohjain poistaa sen jälkeen sen viestit (`MessageHttpController.js:167-175`). Kutsutaan track-changes-moduulista (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Poistaa projektin kaikki huoneet (`MessageHttpController.js:261-273`). Kutsutaan, kun poistettu projekti vanhenee (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Listaa projektin ketjuhuoneet viesteineen (`MessageHttpController.js:71-81`) track-changes-moduulin arviointipaneelia (`TrackChangesController.mjs:82`) ja mcp-server-moduulia (`CommentTools.mjs:83`) varten. |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Palauttaa ratkaistujen ketjujen tunnisteet. Web lisää dokumenttia koskevat tunnisteet dokumenttiin, jonka se lähettää document-updaterille (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Yksi ketju viesteineen (`MessageHttpController.js:97-120`). Web käyttää sitä, jotta arvioija voi muuttaa vain itse aloittamiaan ketjuja (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Annettujen tunnisteiden ketjutiedot, joita historian palautus käyttää (`RestoreManager.mjs:259`). |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Vanhempi indeksi `project_id` (`20190912145026_create_rooms_indexes.mjs`) poistettiin migraatiolla `20250205145327_drop_rooms_projectId_index.mjs`.

#### Huomautuksia

* Projektilla on enintään yksi huone ilman kenttää `thread_id`: projektin chat. Chat-palvelu löytää sen ehdolla `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Kommentin ratkaisutila on vain täällä. Docstore poistaa kentän `op.resolved` ennen alueiden tallentamista (`services/docstore/app/js/RangeManager.js:59-61`).
* Projektin kopioinnin jälkeen sama `thread_id` on kahdessa projektissa. Tee kysely aina kentillä `project_id` ja `thread_id` yhdessä, kuten chat-palvelu tekee.
* Poistetun projektin huoneet säilyvät, kunnes poistettu projekti vanhenee.


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