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

`messages` lưu một tài liệu cho mỗi tin nhắn: một dòng trong chat của dự án, hoặc một bình luận hay trả lời trong một luồng bình luận review. Chỉ dịch vụ chat ghi vào nó, trong `services/chat/app/js/Features/Messages/MessageManager.js`. Không có schema Mongoose. Mỗi tin nhắn thuộc về một phòng trong collection [rooms](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/rooms-collection.md).

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id của tin nhắn. | `MessageManager.js:13-14` |
| `room_id` | ObjectId | Phòng (`rooms._id`), không phải id dự án hay id luồng. | `MessageManager.js:8,106-108` |
| `user_id` | ObjectId | Tác giả. | `MessageManager.js:9,103-105` |
| `content` | String | Nội dung tin nhắn, từ 1 đến 10240 ký tự (`MAX_MESSAGE_LENGTH`). | `MessageManager.js:7`, `services/chat/app/js/Features/Messages/MessageHttpSchemas.js:3,12-15` |
| `timestamp` | Number | Thời điểm gửi, tính bằng mili giây kể từ 1970 (`Date.now()`), không phải Date. | `MessageManager.js:10`, `services/chat/app/js/Features/Messages/MessageHttpController.js:288` |
| `edited_at` | Number | Thời điểm chỉnh sửa gần nhất, tính bằng mili giây (`Date.now()`). Không có nếu chưa từng chỉnh sửa. | `MessageManager.js:65-69`, `MessageHttpController.js:189,213` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `MessageManager.js:5-16` `createMessage` | Chèn một tin nhắn (`MessageHttpController.js:275-294`). Web gửi tin nhắn chat của dự án từ `services/web/app/src/Features/Chat/ChatController.mjs:32`, và bình luận từ module track-changes (`services/web/modules/track-changes/app/src/TrackChangesController.mjs:95`) và module mcp-server (`services/web/modules/mcp-server/app/src/CommentTools.mjs:133`). |
| `MessageManager.js:51-72` `updateMessage` | Đặt `content` và `edited_at`. Khi có id người dùng, chỉ tin nhắn của người dùng đó khớp (`MessageManager.js:62-64`). Được gọi từ `ChatController.mjs:135` và `TrackChangesController.mjs:110`. |
| `MessageManager.js:74-80` `deleteMessage` | Xóa một tin nhắn. Được gọi từ `ChatController.mjs:105` và `TrackChangesController.mjs:129`. |
| `MessageManager.js:39-49` `deleteAllMessagesInRoom(s)` | Xóa các tin nhắn của một luồng đã bị xóa (`MessageHttpController.js:172-173`) hoặc của cả một dự án khi dự án đã xóa hết hạn (`MessageHttpController.js:261-271`, được gọi từ `services/web/app/src/Features/Project/ProjectDeleter.mjs:391`). |
| `MessageManager.js:115-127` `duplicateRoomToOtherRoom` | Sao chép `content`, `timestamp` và `user_id` của mọi tin nhắn sang phòng khác, không kèm `edited_at`. Dùng khi khôi phục lịch sử nhân bản một luồng (`MessageHttpController.js:316-342`) và khi sao chép dự án cùng các vùng của nó (`MessageHttpController.js:344-357`). |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `MessageManager.js:18-29` `getMessages` | Mới nhất trước, tối đa `limit` (mặc định 50) cũ hơn `before` (một giá trị `timestamp`). Dùng cho chat của dự án (`ChatController.mjs:80`). |
| `MessageManager.js:31-37` `findAllMessagesInRooms` | Mọi tin nhắn của một số phòng, cho danh sách luồng trong bảng review (`TrackChangesController.mjs:82`), module mcp-server (`CommentTools.mjs:83`) và khôi phục lịch sử (`services/web/app/src/Features/History/RestoreManager.mjs:259`). Web cũng kiểm tra tin nhắn đầu tiên của luồng để người review chỉ sửa được những luồng do họ bắt đầu (`services/web/app/src/Features/Authorization/AuthorizationManager.mjs:409-411`). |
| `MessageManager.js:90-100` `getMessage` | Một tin nhắn. Web kiểm tra `user_id` của nó trước khi người dùng sửa hoặc xóa tin nhắn của chính mình (`services/web/app/src/Features/Authorization/AuthorizationMiddleware.mjs:253-257`, `TrackChangesController.mjs:124-125`). |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `room_id_1_timestamp_-1` | `{ room_id: 1, timestamp: -1 }` | | `tools/migrations/20190912145013_create_messages_indexes.mjs` |

#### Ghi chú

* Để tìm các tin nhắn của một bình luận, trước tiên tìm phòng theo `project_id` và `thread_id`, rồi truy vấn `room_id`. Id bình luận trong doc là `thread_id`, không phải `room_id`.
* Văn bản mà bình luận trỏ tới là `op.c` trong `docs.ranges.comments`; phần thảo luận nằm ở đây.


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