> ## 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 컬렉션

`rooms`에는 프로젝트의 채팅방마다 문서 하나가 저장됩니다. 프로젝트 채팅이거나 리뷰 댓글 스레드 하나입니다. chat 서비스만 이 컬렉션에 쓰며, `services/chat/app/js/Features/Threads/ThreadManager.js`에서 씁니다. Mongoose 스키마는 없습니다. 방의 메시지는 [messages](https://ayakaleaf-pro.mintlify.site/ko/dev/data-model/messages-collection.md) 컬렉션에 있습니다.

#### 필드

| 필드 | 타입 | 의미 | 출처 |
| - | - | - | - |
| `_id` | ObjectId | 방 ID. `messages.room_id`가 여기를 가리킵니다. | `ThreadManager.js:57-61` |
| `project_id` | ObjectId | 방이 속한 프로젝트. | `ThreadManager.js:43-54` |
| `thread_id` | ObjectId | 댓글 스레드에만 있습니다. 댓글의 ID로, `docs.ranges.comments`에 있는 해당 댓글의 `id` 및 `op.t`와 같습니다([docs](https://ayakaleaf-pro.mintlify.site/ko/dev/data-model/docs-collection.md) 참고). 프로젝트 채팅방에는 없습니다. | `ThreadManager.js:38-55`, `services/docstore/app/js/RangeManager.js:54-57` |
| `resolved` | Object | 스레드가 해결되면 설정되고 다시 열리면 제거됩니다. 이 필드가 없는 스레드는 열린 상태입니다. | `ThreadManager.js:94-123` |
| `resolved.user_id` | String | 스레드를 해결한 사용자의 ID. ObjectId가 아니라 문자열로 저장됩니다. 요청 본문은 유효한 ID인지만 확인하고 변환하지 않습니다. | `ThreadManager.js:103`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:70` |
| `resolved.ts` | Date | 스레드가 해결된 시각. | `ThreadManager.js:104` |

#### 쓰는 곳

| 코드 | 하는 일 |
| - | - |
| `ThreadManager.js:31-63` `findOrCreateThread` | 방을 upsert합니다. 메시지를 보내고, 읽고, 편집하고, 삭제할 때마다 실행되므로(`services/chat/app/js/Features/Messages/MessageHttpController.js:183,204,227,236,245,280,301`) 댓글의 첫 메시지가 해당 스레드 방을 만들고, 프로젝트 채팅을 읽으면 프로젝트 채팅방이 만들어집니다. |
| `ThreadManager.js:94-109` `resolveThread` | `resolved`를 설정합니다. Web의 track-changes 모듈(`services/web/modules/track-changes/app/src/TrackChangesController.mjs:142`), 기록 복원(`services/web/app/src/Features/History/RestoreManager.mjs:276`), mcp-server 모듈(`services/web/modules/mcp-server/app/src/CommentTools.mjs:159`)에서 호출합니다. |
| `ThreadManager.js:111-123` `reopenThread` | `resolved`를 제거합니다. 호출하는 곳은 같습니다: `TrackChangesController.mjs:160`, `RestoreManager.mjs:285`, `CommentTools.mjs:183`. |
| `ThreadManager.js:154-172` `duplicateThread` | 새 `thread_id`를 가진 새 방을 삽입하고 `resolved`를 복사합니다. 기록에서 문서를 복원할 때 사용합니다(`RestoreManager.mjs:233`). |
| `ThreadManager.js:12-29` `cloneThreads` | 프로젝트의 모든 스레드 방을 다른 프로젝트로 복사하며, `_id`는 새로 만들고 `thread_id`는 그대로 둡니다. 프로젝트를 범위와 함께 복사할 때 사용합니다(`services/web/app/src/Features/Project/ProjectDuplicator.mjs:197`). |
| `ThreadManager.js:125-131` `deleteThread` | 스레드 방 하나를 삭제합니다. 그런 다음 컨트롤러가 그 메시지를 삭제합니다(`MessageHttpController.js:167-175`). track-changes 모듈에서 호출합니다(`TrackChangesController.mjs:173`). |
| `ThreadManager.js:133-137` `deleteAllThreadsInProject` | 프로젝트의 모든 방을 삭제합니다(`MessageHttpController.js:261-273`). 삭제된 프로젝트가 만료될 때 호출합니다(`services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |

#### 읽는 곳

| 코드 | 하는 일 |
| - | - |
| `ThreadManager.js:65-78` `findAllThreadRooms` | 프로젝트의 스레드 방을 메시지와 함께 나열합니다(`MessageHttpController.js:71-81`). track-changes 모듈의 리뷰 패널(`TrackChangesController.mjs:82`)과 mcp-server 모듈(`CommentTools.mjs:83`)에서 사용합니다. |
| `ThreadManager.js:139-152` `getResolvedThreadIds` | 해결된 스레드 ID를 반환합니다. Web은 문서에 해당하는 ID를 document-updater로 보내는 문서에 추가합니다(`services/web/app/src/Features/Documents/DocumentController.mjs:69-77`). |
| `ThreadManager.js:174-188` `findThread` | 메시지가 포함된 스레드 하나(`MessageHttpController.js:97-120`). Web은 리뷰어가 자신이 시작한 스레드만 변경할 수 있도록 이를 사용합니다(`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409`). |
| `ThreadManager.js:190-197` `findThreadsById` | 주어진 ID의 스레드 데이터로, 기록 복원에서 사용합니다(`RestoreManager.mjs:259`). |

#### 인덱스

| 이름 | 키 | 옵션 | 마이그레이션 |
| - | - | - | - |
| `project_id_1_thread_id_1` | `{ project_id: 1, thread_id: 1 }` | | `tools/migrations/20250206103037_create_rooms_projectId_threadId_index.mjs` |

이전 `project_id` 인덱스(`20190912145026_create_rooms_indexes.mjs`)는 `20250205145327_drop_rooms_projectId_index.mjs`에서 삭제되었습니다.

#### 참고

* 프로젝트에는 `thread_id`가 없는 방이 최대 하나 있으며, 이것이 프로젝트 채팅입니다. chat 서비스는 `thread_id: { $exists: false }`로 이를 찾습니다(`ThreadManager.js:38-45`).
* 댓글의 해결 상태는 여기에만 있습니다. Docstore는 범위를 저장하기 전에 `op.resolved`를 제거합니다(`services/docstore/app/js/RangeManager.js:59-61`).
* 프로젝트를 복사하면 같은 `thread_id`가 두 프로젝트에 존재합니다. chat 서비스처럼 항상 `project_id`와 `thread_id`를 함께 사용해 조회하세요.
* 삭제된 프로젝트의 방은 그 프로젝트가 만료될 때까지 남아 있습니다.


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