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

# Collection Rooms

`rooms` contient un document par salon de discussion d’un projet : le chat du projet, ou un fil de commentaires de relecture. Seul le service chat l’écrit, dans `services/chat/app/js/Features/Threads/ThreadManager.js`. Il n’y a pas de schéma Mongoose. Les messages d’un salon se trouvent dans la collection [messages](https://ayakaleaf-pro.mintlify.site/fr/dev/data-model/messages-collection.md).

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Identifiant du salon. `messages.room_id` pointe ici. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | Projet auquel appartient le salon. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | Uniquement sur les fils de commentaires : l’identifiant du commentaire, identique à `id` et `op.t` du commentaire dans `docs.ranges.comments` (voir [docs](https://ayakaleaf-pro.mintlify.site/fr/dev/data-model/docs-collection.md)). Absent sur le salon du chat du projet. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | Défini lorsque le fil est résolu, supprimé lorsqu’il est rouvert. Un fil sans ce champ est ouvert. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | Identifiant de l’utilisateur qui a résolu le fil. Stocké sous forme de chaîne, pas d’ObjectId : le corps de la requête est seulement vérifié comme identifiant valide, pas converti. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | Date à laquelle le fil a été résolu. | `ThreadManager.js:104` |

#### Qui l’écrit

| Code | Ce qu’il fait |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | Effectue un upsert du salon. S’exécute à chaque envoi, lecture, modification et suppression de messages (`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`) : le premier message d’un commentaire crée donc le salon de son fil, et la lecture du chat du projet crée le salon du chat du projet. |
| `ThreadManager.js:94-109` `resolveThread` | Définit `resolved`. Appelé depuis web par le module track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), par la restauration de l’historique (`services/web/app/src/Features/History/RestoreManager.mjs:276`) et par le module mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`). |
| `ThreadManager.js:111-123` `reopenThread` | Supprime `resolved`. Mêmes appelants : `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | Insère un nouveau salon avec un nouveau `thread_id`, en copiant `resolved`. Utilisé lorsqu’un doc est restauré depuis l’historique (`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | Copie chaque salon de fil d’un projet vers un autre projet, avec un nouveau `_id` et le même `thread_id`. Utilisé lorsqu’un projet est copié avec ses plages (`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | Supprime un salon de fil ; le contrôleur supprime ensuite ses messages (`MessageHttpController.js:167-175`). Appelé par le module track-changes (`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | Supprime tous les salons d’un projet (`MessageHttpController.js:261-273`). Appelé lorsqu’un projet supprimé expire (`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### Qui la lit

| Code | Ce qu’il fait |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | Liste les salons de fils d’un projet avec leurs messages (`MessageHttpController.js:71-81`), pour le panneau de relecture du module track-changes (`TrackChangesController.mjs:82`) et le module mcp-server (`CommentTools.mjs:83`). |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | Renvoie les identifiants des fils résolus. Web ajoute ceux d’un doc au doc qu’il envoie à document-updater (`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | Un fil avec ses messages (`MessageHttpController.js:97-120`). Web l’utilise pour qu’un relecteur ne puisse modifier que les fils qu’il a lancés (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | Données des fils pour des identifiants donnés, utilisées par la restauration de l’historique (`RestoreManager.mjs:259`). |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

L’ancien index `project_id` (`20190912145026_create_rooms_indexes.mjs`) a été supprimé par `20250205145327_drop_rooms_projectId_index.mjs`.

#### Remarques

* Un projet a au plus un salon sans `thread_id` : le chat du projet. Le service chat le trouve avec `thread_id: { $exists: false }` (`ThreadManager.js:38-45`).
* L’état résolu d’un commentaire n’existe qu’ici. Docstore retire `op.resolved` avant d’enregistrer les plages (`services/docstore/app/js/RangeManager.js:59-61`).
* Après la copie d’un projet, le même `thread_id` existe dans deux projets. Interrogez toujours `project_id` et `thread_id` ensemble, comme le fait le service chat.
* Les salons d’un projet supprimé restent jusqu’à l’expiration du projet supprimé.


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