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

# Coleção Rooms

`rooms` guarda um documento por sala de chat de um projeto: o chat do projeto ou um tópico de comentários de revisão. Só o serviço chat a escreve, em `services/chat/app/js/Features/Threads/ThreadManager.js`. Não há schema Mongoose. As mensagens de uma sala ficam na coleção [messages](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/messages-collection.md).

#### Campos

| Campo | Tipo | Significado | Origem |
| - | - | - | - |
| `_id` | ObjectId | Id da sala. `messages.room_id` aponta para cá. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Projeto ao qual a sala pertence. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Só em tópicos de comentários: o id do comentário, igual a `id` e `op.t` do comentário em `docs.ranges.comments` (veja [docs](https://ayakaleaf-pro.mintlify.site/pt/dev/data-model/docs-collection.md)). Ausente na sala do chat do projeto. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Definido quando o tópico é resolvido e removido quando é reaberto. Um tópico sem este campo está aberto. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Id do usuário que resolveu o tópico. Guardado como string, não como ObjectId: o corpo da requisição só é verificado como id válido, não convertido. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Quando o tópico foi resolvido. | `ThreadManager.js:104` |

#### Quem a escreve

| Código | O que faz |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Faz upsert da sala. Executa a cada envio, leitura, edição e exclusão de mensagens (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), então a primeira mensagem de um comentário cria a sala do seu tópico, e ler o chat do projeto cria a sala do chat do projeto. |
| `ThreadManager.js:94-109` `resolveThread` | Define `resolved`. Chamado a partir do web pelo módulo track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), pela restauração do histórico (`services/web/app/src/Features/History/RestoreManager.mjs:276`) e pelo módulo mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Remove `resolved`. Mesmos chamadores: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Insere uma nova sala com um novo `thread_id`, copiando `resolved`. Usado quando um doc é restaurado do histórico (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Copia cada sala de tópico de um projeto para outro projeto, com um novo `_id` e o mesmo `thread_id`. Usado quando um projeto é copiado com seus intervalos (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Exclui uma sala de tópico; o controller depois exclui as mensagens dela (`MessageHttpController.js:167-175`). Chamado pelo módulo track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Exclui todas as salas de um projeto (`MessageHttpController.js:261-273`). Chamado quando um projeto excluído expira (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Quem a lê

| Código | O que faz |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Lista as salas de tópicos de um projeto com suas mensagens (`MessageHttpController.js:71-81`), para o painel de revisão do módulo track-changes (`TrackChangesController.mjs:82`) e o módulo mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Retorna os ids dos tópicos resolvidos. O web adiciona os de um doc ao doc que envia ao document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Um tópico com suas mensagens (`MessageHttpController.js:97-120`). O web o usa para que um revisor só altere tópicos que ele iniciou (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Dados de tópicos para ids informados, usados pela restauração do histórico (`RestoreManager.mjs:259`). |

#### Índices

| Nome | Chaves | Opções | Migração |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

O índice antigo `project_id` (`20190912145026_create_rooms_indexes.mjs`) foi removido por `20250205145327_drop_rooms_projectId_index.mjs`.

#### Notas

* Um projeto tem no máximo uma sala sem `thread_id`: o chat do projeto. O serviço chat a encontra com `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* O estado resolvido de um comentário existe só aqui. O docstore remove `op.resolved` antes de salvar os intervalos (`services/docstore/app/js/RangeManager.js:59-61`).
* Depois de copiar um projeto, o mesmo `thread_id` existe em dois projetos. Sempre consulte `project_id` e `thread_id` juntos, como faz o serviço chat.
* As salas de um projeto excluído permanecem até o projeto excluído expirar.


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