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

# Collezione Rooms

`rooms` contiene un documento per ogni stanza di chat di un progetto: la chat del progetto o un thread di commenti di revisione. Solo il servizio chat la scrive, in `services/chat/app/js/Features/Threads/ThreadManager.js`. Non esiste uno schema Mongoose. I messaggi di una stanza sono nella collezione [messages](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/messages-collection.md).

#### Campi

| Campo | Tipo | Significato | Fonte |
| - | - | - | - |
| `_id` | ObjectId | Id della stanza. `messages.room_id` punta qui. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Progetto a cui appartiene la stanza. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Solo nei thread di commenti: l’id del commento, uguale a `id` e `op.t` del commento in `docs.ranges.comments` (vedi [docs](https://ayakaleaf-pro.mintlify.site/it/dev/data-model/docs-collection.md)). Assente nella stanza della chat del progetto. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Impostato quando il thread viene risolto, rimosso quando viene riaperto. Un thread senza questo campo è aperto. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Id dell’utente che ha risolto il thread. Salvato come stringa, non come ObjectId: il corpo della richiesta viene solo verificato come id valido, non convertito. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Quando il thread è stato risolto. | `ThreadManager.js:104` |

#### Chi la scrive

| Codice | Cosa fa |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Esegue l’upsert della stanza. Viene eseguito a ogni invio, lettura, modifica ed eliminazione di messaggi (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), quindi il primo messaggio di un commento crea la stanza del suo thread e la lettura della chat del progetto crea la stanza della chat del progetto. |
| `ThreadManager.js:94-109` `resolveThread` | Imposta `resolved`. Chiamato da web dal modulo track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), dal ripristino della cronologia (`services/web/app/src/Features/History/RestoreManager.mjs:276`) e dal modulo mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Rimuove `resolved`. Stessi chiamanti: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Inserisce una nuova stanza con un nuovo `thread_id`, copiando `resolved`. Usato quando un doc viene ripristinato dalla cronologia (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Copia ogni stanza di thread di un progetto in un altro progetto, con un nuovo `_id` e lo stesso `thread_id`. Usato quando un progetto viene copiato con i suoi intervalli (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Elimina una stanza di thread; il controller elimina poi i suoi messaggi (`MessageHttpController.js:167-175`). Chiamato dal modulo track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Elimina tutte le stanze di un progetto (`MessageHttpController.js:261-273`). Chiamato quando un progetto eliminato scade (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Chi la legge

| Codice | Cosa fa |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Elenca le stanze dei thread di un progetto con i loro messaggi (`MessageHttpController.js:71-81`), per il pannello di revisione del modulo track-changes (`TrackChangesController.mjs:82`) e il modulo mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Restituisce gli id dei thread risolti. Web aggiunge quelli di un doc al doc che invia a document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Un thread con i suoi messaggi (`MessageHttpController.js:97-120`). Web lo usa per permettere a un revisore di modificare solo i thread che ha avviato (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Dati dei thread per gli id indicati, usati dal ripristino della cronologia (`RestoreManager.mjs:259`). |

#### Indici

| Nome | Chiavi | Opzioni | Migrazione |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

Il vecchio indice `project_id` (`20190912145026_create_rooms_indexes.mjs`) è stato eliminato da `20250205145327_drop_rooms_projectId_index.mjs`.

#### Note

* Un progetto ha al massimo una stanza senza `thread_id`: la chat del progetto. Il servizio chat la trova con `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* Lo stato risolto di un commento esiste solo qui. Docstore rimuove `op.resolved` prima di salvare gli intervalli (`services/docstore/app/js/RangeManager.js:59-61`).
* Dopo la copia di un progetto, lo stesso `thread_id` esiste in due progetti. Interroga sempre `project_id` e `thread_id` insieme, come fa il servizio chat.
* Le stanze di un progetto eliminato restano finché il progetto eliminato non scade.


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