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

# Colección Rooms

`rooms` guarda un documento por sala de chat de un proyecto: el chat del proyecto o un hilo de comentarios de revisión. Solo el servicio chat la escribe, en `services/chat/app/js/Features/Threads/ThreadManager.js`. No hay esquema de Mongoose. Los mensajes de una sala están en la colección [messages](https://ayakaleaf-pro.mintlify.site/es/dev/data-model/messages-collection.md).

#### Campos

| Campo | Tipo | Significado | Origen |
| - | - | - | - |
| `_id` | ObjectId | Id de la sala. `messages.room_id` apunta aquí. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Proyecto al que pertenece la sala. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Solo en hilos de comentarios: el id del comentario, igual que `id` y `op.t` del comentario en `docs.ranges.comments` (consulta [docs](https://ayakaleaf-pro.mintlify.site/es/dev/data-model/docs-collection.md)). No existe en la sala del chat del proyecto. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Se establece cuando el hilo se resuelve y se elimina cuando se reabre. Un hilo sin este campo está abierto. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Id del usuario que resolvió el hilo. Se guarda como cadena, no como ObjectId: el cuerpo de la solicitud solo se comprueba como id válido, no se convierte. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Cuándo se resolvió el hilo. | `ThreadManager.js:104` |

#### Quién la escribe

| Código | Qué hace |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Hace un upsert de la sala. Se ejecuta en cada envío, lectura, edición y eliminación de mensajes (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`), así que el primer mensaje de un comentario crea la sala de su hilo, y leer el chat del proyecto crea la sala del chat del proyecto. |
| `ThreadManager.js:94-109` `resolveThread` | Establece `resolved`. Lo llaman desde web el módulo track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), la restauración del historial (`services/web/app/src/Features/History/RestoreManager.mjs:276`) y el módulo mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Elimina `resolved`. Mismos llamadores: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Inserta una sala nueva con un `thread_id` nuevo, copiando `resolved`. Se usa cuando un doc se restaura desde el historial (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Copia cada sala de hilo de un proyecto a otro proyecto, con un `_id` nuevo y el mismo `thread_id`. Se usa cuando un proyecto se copia con sus rangos (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Elimina una sala de hilo; luego el controlador elimina sus mensajes (`MessageHttpController.js:167-175`). Lo llama el módulo track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Elimina todas las salas de un proyecto (`MessageHttpController.js:261-273`). Se llama cuando caduca un proyecto eliminado (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Quién la lee

| Código | Qué hace |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Lista las salas de hilos de un proyecto con sus mensajes (`MessageHttpController.js:71-81`), para el panel de revisión del módulo track-changes (`TrackChangesController.mjs:82`) y el módulo mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Devuelve los ids de los hilos resueltos. Web añade los de un doc al doc que envía a document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Un hilo con sus mensajes (`MessageHttpController.js:97-120`). Web lo usa para que un revisor solo pueda cambiar los hilos que inició (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Datos de hilos para ids dados, usados por la restauración del historial (`RestoreManager.mjs:259`). |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

El índice antiguo `project_id` (`20190912145026_create_rooms_indexes.mjs`) se eliminó con `20250205145327_drop_rooms_projectId_index.mjs`.

#### Notas

* Un proyecto tiene como máximo una sala sin `thread_id`: el chat del proyecto. El servicio chat la encuentra con `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* El estado resuelto de un comentario solo existe aquí. Docstore quita `op.resolved` antes de guardar los rangos (`services/docstore/app/js/RangeManager.js:59-61`).
* Después de copiar un proyecto, el mismo `thread_id` existe en dos proyectos. Consulta siempre por `project_id` y `thread_id` juntos, como hace el servicio chat.
* Las salas de un proyecto eliminado se mantienen hasta que caduca el proyecto eliminado.


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