# Đặc tả thao tác & hiển thị trong màn chi tiết tin nhắn

> Tài liệu để **hệ thống chat khác làm theo** cho đúng hành vi màn chat FlyChat (Zalo cá nhân + Zalo OA).
> Mọi mô tả dưới đây đọc ra từ code đang chạy, không phải bản thiết kế. Mỗi mục có ghi nguồn để tra lại khi cần.
>
> Nguồn chính:
> - Giao diện: [index.blade.php](../backend/resources/views/zalo/chat/index.blade.php) (khối `message-area` trở xuống)
> - Logic hiển thị: [normalizers.js](../backend/public/js/zalo-chat/normalizers.js) — *lưu ý: grep coi file này là nhị phân, phải dùng `grep -a`*
> - Thao tác trên tin: [messages.js](../backend/public/js/zalo-chat/messages.js), [composer-reactions.js](../backend/public/js/zalo-chat/composer-reactions.js), [groups-friends.js](../backend/public/js/zalo-chat/groups-friends.js), [templates-tags.js](../backend/public/js/zalo-chat/templates-tags.js)
> - Dữ liệu trả về: [ZaloMessage::toPublicArray](../backend/app/Models/ZaloMessage.php), map tin thô từ Zalo: [message-mapper.ts](../worker/src/zalo/message-mapper.ts)
> - Kích thước/màu: [zalo-chat.css](../backend/public/css/zalo-chat.css)

---

## Mục lục

1. [Dữ liệu một tin nhắn](#1-dữ-liệu-một-tin-nhắn)
2. [Bố cục một hàng tin](#2-bố-cục-một-hàng-tin)
3. [Nội dung chữ: link, @tag, gắn thẻ thành viên](#3-nội-dung-chữ-link-tag-gắn-thẻ-thành-viên)
4. [Phân loại đính kèm](#4-phân-loại-đính-kèm)
5. [Ảnh (kể cả JXL)](#5-ảnh-kể-cả-jxl)
6. [Sticker](#6-sticker)
7. [Video, tin nhắn thoại](#7-video-tin-nhắn-thoại)
8. [Thẻ liên kết (chia sẻ link)](#8-thẻ-liên-kết-chia-sẻ-link)
9. [Thẻ tệp theo định dạng](#9-thẻ-tệp-theo-định-dạng)
10. [Danh thiếp Zalo](#10-danh-thiếp-zalo)
11. [Trả lời / trích dẫn / nhảy tới tin gốc](#11-trả-lời--trích-dẫn--nhảy-tới-tin-gốc)
12. [Tin đã thu hồi](#12-tin-đã-thu-hồi)
13. [Thả cảm xúc](#13-thả-cảm-xúc)
14. [Menu chuột phải trên tin](#14-menu-chuột-phải-trên-tin)
15. [Bấm vào tên / ảnh đại diện / @tên: kết bạn hay nhắn riêng](#15-bấm-vào-tên--ảnh-đại-diện--tên-kết-bạn-hay-nhắn-riêng)
16. [Thanh kết bạn trong hội thoại 1-1](#16-thanh-kết-bạn-trong-hội-thoại-1-1)
17. [Khung soạn tin](#17-khung-soạn-tin)
18. [Trạng thái gửi: đang gửi, lỗi, thử lại](#18-trạng-thái-gửi-đang-gửi-lỗi-thử-lại)
19. [Đầu khung chat](#19-đầu-khung-chat)
20. [Cuộn, tải tin cũ, tự làm mới](#20-cuộn-tải-tin-cũ-tự-làm-mới)
21. [An toàn khi hiển thị](#21-an-toàn-khi-hiển-thị)
22. [Khác biệt Zalo cá nhân và Zalo OA](#22-khác-biệt-zalo-cá-nhân-và-zalo-oa)
23. [Danh sách kiểm tra cho hệ thống khác](#23-danh-sách-kiểm-tra-cho-hệ-thống-khác)

---

## 1. Dữ liệu một tin nhắn

API `GET /api/zalo-accounts/{id}/messages?conversation_key=...` trả mảng `data`, mỗi phần tử có dạng:

```json
{
  "msg_id": "7412345678901",
  "content": "Chào anh, đây là báo giá https://example.com/bao-gia.",
  "direction": "in",
  "attachments": [
    { "type": "image", "url": "https://...jxl/abc.jxl", "name": "", "thumb_url": "https://...jpg" }
  ],
  "mentions": [{ "uid": "123456", "pos": 0, "len": 8 }],
  "senderId": "123456",
  "senderName": "Nguyễn Văn A",
  "senderAvatarUrl": "https://...",
  "sentByUser": { "id": 3, "name": "Nhân viên B" },
  "sentByUserName": "Nhân viên B",
  "sentAt": "2026-11-09T08:15:00+07:00",
  "quote": { "msg_id": "741...", "senderName": "Bạn", "preview": "[Hình ảnh]", "direction": "out" },
  "canQuote": true,
  "canForward": true,
  "isRecalled": false,
  "reactions": [{ "actorId": "123", "actorName": "Nguyễn Văn A", "icon": "HEART", "rawIcon": "/-heart" }]
}
```

| Trường | Ý nghĩa | Ghi chú |
|---|---|---|
| `direction` | `in` = người khác gửi, `out` = tài khoản này gửi | Tin gửi từ app điện thoại của chính nick cũng là `out` |
| `content` | Phần chữ | Ảnh kèm chữ là **một** tin: chữ nằm ở `content`, ảnh ở `attachments` |
| `attachments[].type` | `image` / `video` / `audio` / `sticker` / `link` / `file` | Giao diện **phân loại lại** — xem mục 4 |
| `attachments[].sticker_id` | Id sticker | Chỉ có với sticker |
| `mentions` | Toạ độ `@tên` trong `content` (`pos`, `len`) + `uid` người bị gắn | Ưu tiên hơn việc dò `@` bằng regex |
| `sentByUserName` | Nhân viên nào trong hệ thống đã bấm gửi | Chỉ có với tin `out` gửi từ hệ thống |
| `quote` | Tin này đang trả lời tin nào | `direction: null` = tin gốc cũ hơn dữ liệu hệ thống lưu |
| `canQuote` | Có trả lời được tin này không | Do server quyết định (cần bản thô của tin) |
| `canForward` | Có chuyển tiếp được không | Do server quyết định theo loại tin |
| `isRecalled` | Tin đã bị thu hồi | |
| `reactions` | Cảm xúc thật của mọi người | |

Phân trang: `pagination.has_more`, `next_before_sent_at`, `next_before_id`. Tải tin cũ gửi thêm `load_older=1&before_sent_at=...&before_id=...`. Mỗi trang 50 tin.

---

## 2. Bố cục một hàng tin

```
[avatar]  Tên người gửi (chỉ nhóm)
          ┌───────────────────────────────┐
          │ ▌Khối trích dẫn (nếu trả lời) │
          │ [ảnh/sticker/video/link/tệp]  │
          │ Nội dung chữ ...       08:15  │   ← giờ nằm cuối dòng chữ
          └───────────────────────────────┘
          [👍 3] [❤️]                        ← chip cảm xúc
          Gửi bởi Nhân viên B · Đang gửi / Gửi thất bại [Thử lại]
```

- **Tin đến** (`in`) căn trái, có ảnh đại diện; **tin đi** (`out`) căn phải, không có ảnh đại diện.
- **Ảnh đại diện**:
  - Hội thoại 1-1: dùng `senderAvatarUrl`; thiếu thì lấy ảnh của tin đến gần nhất, cuối cùng lấy ảnh đại diện của hội thoại.
  - Nhóm: nhớ ảnh theo `senderId` trong các tin đã tải; người chưa có ảnh nào thì hiện chữ viết tắt.
  - Chữ viết tắt = chữ cái đầu của **2 từ cuối** trong tên, viết hoa ("Nguyễn Văn An" → "VA").
- **Tên người gửi (chỉ trong nhóm, chỉ tin đến)**: chỉ hiện ở tin **đầu tiên của một chuỗi tin liên tiếp cùng một người**. Không có tên thì hiện `ID {senderId}`, không có cả id thì "Người gửi". Tin đã thu hồi không hiện tên.
- **Đính kèm nằm TRONG bong bóng**, không tách thành khối riêng — ảnh kèm chữ là một tin, tách ra người đọc tưởng hai tin.
  - Tin chỉ có đính kèm, không chữ, không trích dẫn → bỏ nền/viền bong bóng (class `media-only`), trông như ảnh đứng một mình.
- **Giờ gửi**: định dạng `HH:mm` 24 giờ (`vi-VN`).
  - Tin có chữ → giờ nằm cuối dòng chữ.
  - Tin chỉ có đính kèm → giờ là một "viên" nhỏ dưới đính kèm.
  - Không bao giờ hiện hai lần trên một tin.
- **"Gửi bởi {tên nhân viên}"** dưới tin đi — để biết ai trong đội đã trả lời khách.

---

## 3. Nội dung chữ: link, @tag, gắn thẻ thành viên

Nguồn: `formatMessageContent()` trong [normalizers.js](../backend/public/js/zalo-chat/normalizers.js).

Thứ tự xử lý:

1. **Escape HTML toàn bộ** nội dung (`& < > " '`) — nội dung do người lạ gửi, không bao giờ chèn thẳng.
2. **Gắn thẻ thật** (`mentions` từ Zalo): cắt đúng đoạn `content[pos .. pos+len]`. Toạ độ hỏng (âm, vượt độ dài) thì bỏ qua.
3. **Đường dẫn**: regex `https?://[^\s<>"']+`.
   - Chỉ nhận link có `http://` hoặc `https://`. `www.abc.com` không có scheme thì **không** thành link.
   - Dấu câu dính ở cuối (`. , ; : ! ? ) } ]`) bị tách ra khỏi link, vẫn hiện như chữ thường. Ví dụ `https://a.com/x).` → link là `https://a.com/x`, phần `).` là chữ.
   - Mở **tab mới**, `rel="noopener noreferrer"`. Chữ hiển thị chính là URL đầy đủ.
4. **@tag thô** (regex `@[\p{L}\p{N}_][\p{L}\p{N}_.-]*`): chỉ khi trước `@` là đầu dòng, khoảng trắng hoặc `( [ { < " ' \``. Đoạn nào đã có gắn thẻ thật đè lên thì bỏ qua.
5. Ký tự xuống dòng `\n` → `<br>`.

| Loại | Hiển thị | Khi bấm |
|---|---|---|
| Đường dẫn | Màu nhấn đậm (`--app-accent-strong`) | Mở tab mới |
| Gắn thẻ thật (`@Tên` có uid) | Màu nhấn, nền hồng nhạt `rgba(194,29,99,.1)`, bo góc 4px, con trỏ tay | Mở **thẻ thành viên** (mục 15) — chỉ trong nhóm |
| @tag thô (không có uid) | Màu xanh ngọc `#0f766e` | **Không làm gì** (chặn điều hướng) |

> Vì sao ưu tiên `mentions`: tên người có khoảng trắng ("@Anh Vũ") — regex chỉ bắt được "@Anh".

Ký tự vô hình (`​-‍`, `﻿`) bị gỡ khi làm sạch tên/xem trước.

---

## 4. Phân loại đính kèm

Giao diện **không tin hoàn toàn** vào `type` server gửi — Zalo dùng nhiều `msgType` cho cùng một thứ. Thuật toán `attachmentDisplayType()`:

```
1. type == 'sticker'                        → sticker
2. type == 'link'                           → link
3. looksLikeLinkAttachment(att)             → link        (xem mục 8)
4. Lấy các URL [dataUrl, url, thumb_url], xét đuôi tệp:
   - có đuôi jpg|jpeg|png|gif|webp|jxl|heic|heif
     hoặc đường dẫn chứa "/jxl/"             → image
   - có đuôi mp4|mov|m4v|webm|m3u8          → video
   - có đuôi mp3|m4a|aac|ogg|wav            → audio
5. Còn lại: giữ type server gửi, không có thì → file
```

- Đuôi tệp lấy từ phần đường dẫn trước `?` / `#`, bỏ dấu câu dính cuối, dài 2–5 ký tự.
- Đường dẫn bị dính dấu câu ở cuối sau đuôi media (`.jpg).`) được cắt sạch trước khi dùng.

**Quy tắc dựng DOM quan trọng**: mỗi đính kèm chỉ dựng **đúng một** thẻ hợp loại của nó (lọc trước bằng `imageAttachments` / `videoAttachments` / `linkAttachments` / `fileAttachments`). Không dựng cả `<img>` + `<video>` rồi ẩn bớt bằng CSS — thẻ `<video>` bị ẩn vẫn tải ảnh về, giải mã hỏng, bắn lỗi và làm giao diện tưởng tấm ảnh lành bị hỏng.

| Nhóm hiển thị | Gồm |
|---|---|
| Ảnh-giống (`<img>`) | `image` và `sticker` còn xem được |
| Video (`<video>`) | `video` còn xem được |
| Thẻ liên kết | `link` |
| Thẻ tệp | Mọi thứ còn lại: `file`, `audio`, và **ảnh/video đã hỏng hẳn** |

---

## 5. Ảnh (kể cả JXL)

### Hiển thị

- Khung ảnh rộng `min(520px, 100%)` trên máy tính; `min(360px, 100%)` khi màn ≤ 920px; `min(100%, 100vw − 92px)` khi màn ≤ 480px.
- Giữ tỉ lệ (`object-fit: contain`), cao tối đa 520px, viền xám nhạt, bo góc 8px.
- Huy hiệu **"HD"** ở góc ảnh (không có ở sticker).
- `loading="lazy"`, `referrerpolicy="no-referrer"` (CDN Zalo chặn khi có referrer lạ).
- Con trỏ `zoom-in`. **Bấm vào ảnh → mở lớp xem phóng to** toàn màn hình: ảnh tối đa 92vw × 90vh, bo góc 10px, nút ✕ trắng góc trên. Bấm ra nền hoặc ✕ để đóng; bấm vào chính ảnh thì không đóng.
- Nút thả cảm xúc nổi trên ảnh (mục 13).

### Chọn đường dẫn để hiển thị (`attachmentUrl`)

Thứ tự ưu tiên:

1. `dataUrl` — ảnh vừa gửi từ máy này (blob cục bộ), hiện ngay không chờ server.
2. **Bản JPG của ảnh JXL** — nếu `url` là JXL và chưa thử hỏng.
3. `thumb_url` — nếu ảnh gốc đã lỗi một lần và thumb khác url.
4. `thumb_url` — nếu `url` là JXL còn thumb không phải JXL.
5. `url`, không có thì `thumb_url`.

### Ảnh JXL (JPEG XL)

Zalo hay trả ảnh dạng `.jxl` hoặc đường dẫn chứa `/jxl/`. **Chrome, Firefox, Edge không hiển thị được JXL**, nên:

- **Nhận diện JXL**: đuôi `.jxl` **hoặc** đường dẫn có đoạn `/jxl/`.
- **Đổi sang JPG**: thay `/jxl/` → `/jpg/` và đuôi `.jxl` → `.jpg` trên cùng URL. CDN Zalo để sẵn bản JPG song song ở đường dẫn đó.
  ```
  https://f20-zpc.zdn.vn/jxl/1234/abc.jxl
  → https://f20-zpc.zdn.vn/jpg/1234/abc.jpg
  ```
- Ảnh JXL vẫn được tính là **ảnh** khi phân loại (mục 4), không rơi về thẻ tệp.

### Chuỗi dự phòng khi ảnh lỗi (`onAttachmentError`)

Mỗi lần `<img>` bắn `error`, đổi sang nguồn kế tiếp:

```
Bản JPG suy ra từ JXL  ──lỗi──▶  đánh dấu _jxlJpgFailed
        │                         → thử thumb_url (nếu thumb không phải JXL), không thì url JXL gốc
        ▼
Ảnh gốc / thumb        ──lỗi──▶  đánh dấu _failed → thử thumb_url (nếu khác url)
        ▼
Vẫn lỗi                ──────▶  đánh dấu _broken → KHÔNG vẽ ảnh nữa,
                                  chuyển thành THẺ TỆP "Hình ảnh" + ⚠ "Không thể xem trước",
                                  bấm vào mở đường dẫn ở tab mới
```

- Link CDN Zalo **có hạn dùng** — ảnh cũ hết hạn là chuyện bình thường, phải có đường lui chứ không để ô ảnh vỡ.
- **Nhớ cờ hỏng qua các nhịp làm mới**: mỗi lần poll server trả object mới, cờ lỗi trên object cũ mất. Hệ thống mang cờ sang theo khoá `type|url|thumb_url|sticker_id`. Không làm thế thì cứ 8 giây ảnh lại nhấp nháy giữa ô vỡ và thẻ dự phòng. Nếu Zalo cấp URL mới cho cùng ảnh → khoá khác → thử lại từ đầu.
- Khoá DOM của ảnh gồm cả URL đang dùng, để `<img>` vẽ lại khi đổi sang nguồn dự phòng.

---

## 6. Sticker

### Hiển thị sticker trong khung chat

- Vẽ bằng `<img>` như ảnh nhưng:
  - Cố định **150 × 150px** (128 × 128px khi màn ≤ 920px), `object-fit: contain`, **nền trong suốt, không viền, không cắt vuông**.
  - **Không** có huy hiệu HD.
  - **Bấm vào không phóng to.**
  - Vẫn có nút thả cảm xúc.
- Nguồn ảnh: Zalo gửi sticker **chỉ có id**, không có ảnh. Worker tra ảnh qua `getStickersDetail` (ưu tiên `stickerWebpUrl`), cache theo id cho cả tiến trình. Tra lỗi thì dùng khuôn cố định:
  ```
  https://zalo-api.zadn.vn/api/emoticon/sticker/webpc?eid={sticker_id}&size=130
  ```
- Id sticker được moi từ các khoá `id`, `stickerId`, `sticker_id`, `eid`, `uri`, hoặc chuỗi dạng `[^cateId.stickerId^]` trong chữ. Không moi được id → hiện chữ `[Sticker]` thay vì bong bóng trắng.
- Xem trước / trích dẫn của tin sticker: `[Sticker]`.

### Bảng chọn sticker (gửi đi)

Nút sticker nằm cạnh nút emoji trong khung soạn. **Ẩn với hội thoại OA.**

- **Bấm nút** → mở bảng (đóng emoji và tin mẫu nếu đang mở), con trỏ vào ô tìm. Bấm lại nút → đóng. Bấm ra ngoài → đóng.
- **Nội dung mặc định khi mở**: có lịch sử "Gần đây" → hiện "Dùng gần đây"; chưa có → tìm theo từ khoá đầu tiên ("chào").
- **Ô tìm**: placeholder "Tìm sticker: cảm ơn, haha, ok...". Xoá trống ô tìm → quay về "Gần đây" (hoặc từ khoá đầu).
- **Chip từ khoá gợi ý**: `chào`, `cảm ơn`, `ok`, `haha`, `yêu`, `buồn`, `xin lỗi`, `chúc mừng`. Chip đang xem được tô sáng.
- **Tab bộ sticker**: tab "Gần đây" + tối đa **8 tab bộ** lấy từ các bộ đã dùng gần đây, icon tab là sticker dùng gần nhất của bộ đó. Bấm tab → tải trọn bộ (`GET stickers/categories/{cateId}`).
- **Nhãn phía trên lưới**: "Dùng gần đây" / "Cả bộ sticker" / `Kết quả cho "{từ khoá}"`.
- **Bấm một sticker → gửi luôn** (giống Zalo, không có bước xác nhận):
  - `POST /api/zalo-accounts/{id}/stickers` với `conversation_key`, `sticker_id`, `cate_id`, `type`.
  - Đang gửi: ô sticker đó mờ đi, mọi ô khác bị khoá (chỉ gửi một cái một lúc).
  - Thành công: lưu vào "Gần đây", đóng bảng, tải lại tin.
  - Lỗi: báo ở dải thông báo đỏ "Gửi sticker thất bại." / "Không thể kết nối để gửi sticker."
- **"Gần đây"** lưu ở `localStorage` khoá `zalo-chat.recent-stickers`, tối đa **32** sticker, mới nhất đứng đầu, không trùng. Trình duyệt chặn `localStorage` thì chỉ mất lịch sử, việc gửi vẫn chạy.
- **Trạng thái**: "Đang tải sticker..." (có spinner) / thông báo lỗi đỏ / "Không có sticker nào. Thử từ khoá khác nhé."
- **Chống kết quả về muộn**: gõ nhanh "ha" rồi "haha" — kết quả "ha" về sau không được đè lên. Mỗi lần tải đánh số thứ tự, kết quả cũ bị bỏ.
- Kết quả cache theo `view:key` trong phiên, bấm qua lại không hỏi lại server. Sticker dùng chung, không phân theo tài khoản.

---

## 7. Video, tin nhắn thoại

**Video**
- Thẻ `<video controls preload="metadata">` — chỉ tải thông tin đầu, không tải cả video khi chưa bấm.
- Rộng `min(360px, 100%)` (≤ 920px: 320px), cao tối đa 360px, nền đen.
- Lỗi phát → đánh dấu hỏng → chuyển thành thẻ tệp "Video" (giống chuỗi dự phòng của ảnh).
- Có nút thả cảm xúc.

**Tin nhắn thoại (`audio`)**
- Hiện tại **không có trình phát riêng** — hiện thành thẻ tệp nhãn "Tin nhắn thoại", bấm mở file ở tab mới.
- Xem trước / trích dẫn: `[Tin nhắn thoại]`.

---

## 8. Thẻ liên kết (chia sẻ link)

Tin chia sẻ đường dẫn của Zalo (`chat.recommended`, `chat.link`, `webcontent`) để **chính đường dẫn ở `url`**, ảnh mô tả ở `thumb_url`.

> Bẫy đã gặp: link không có đuôi ảnh, nhưng thumb có `.jpg` → phân loại theo đuôi kết luận nhầm là "ảnh" → chỉ hiện tấm thumbnail, mất luôn đường dẫn — thứ duy nhất người trực cần.

**Nhận diện là link** (`looksLikeLinkAttachment`) khi đủ tất cả:
- `url` bắt đầu bằng `http(s)://`;
- `url` **không có** đuôi tệp;
- máy chủ **không phải** máy chủ tệp của Zalo (`dlfl.me`, `zdn.vn`, `zadn.vn` — đó là tệp tải về thật, giữ dạng thẻ tệp);
- và `name` bắt đầu bằng `recommened.` (Zalo viết sai chính tả, giữ nguyên) **hoặc** có `thumb_url`.

**Hiển thị** — một thẻ bấm được, rộng tối đa 320px, bo góc 14px, nền xám nhạt khi rê chuột:

```
┌──────────────────────────────────────┐
│ [thumb]  Tiêu đề                      │
│  52×52   https://example.com/bai-viet │
└──────────────────────────────────────┘
```

- **Ảnh nhỏ** 52 × 52px, bo góc 10px, `object-fit: cover`. Ảnh lỗi → ẩn ảnh đi, thẻ vẫn còn.
- **Tiêu đề**: `name` nếu có và không phải mã nội bộ `recommened.*`; không thì **tên miền** của link; không thì "Liên kết".
- **Dòng URL** đầy đủ bên dưới; tooltip cũng là URL.
- Bấm → mở tab mới, `noopener noreferrer`, `referrerpolicy="no-referrer"`.
- Xem trước / trích dẫn: `[Liên kết]`.

---

## 9. Thẻ tệp theo định dạng

Dùng cho `file`, `audio`, và ảnh/video đã hỏng hẳn.

```
┌──────────────────────────────┐
│ ┌──┐                          │
│ │W │  bao-gia-thang-11.docx   │
│ └──┘  (Không thể xem trước)   │  ← chỉ khi hỏng, kèm ⚠ trên biểu tượng
└──────────────────────────────┘
```

- Rộng tối đa 320px, viền, bo góc 13px.
- **Biểu tượng tờ giấy gấp góc** (SVG 48 × 56), màu theo loại, bên trong là nhãn ngắn:

| Đuôi tệp | Loại (`data-kind`) | Nhãn trên biểu tượng | Màu chính | Nền giấy | Nếp gấp |
|---|---|---|---|---|---|
| `doc`, `docx`, `rtf` | word | **W** | `#2563eb` (xanh dương) | `#eff6ff` | `#bfdbfe` |
| `xls`, `xlsx`, `csv` | excel | **X** | `#15803d` (xanh lá) | `#f0fdf4` | `#bbf7d0` |
| `ppt`, `pptx` | powerpoint | **P** | `#c2410c` (cam) | `#fff7ed` | `#fed7aa` |
| `pdf` | pdf | **PDF** | `#dc2626` (đỏ) | `#fef2f2` | `#fecaca` |
| `zip`, `rar`, `7z`, `tar`, `gz` | archive | **ZIP / RAR / 7Z / TAR / GZ** | `#7c3aed` (tím) | `#f5f3ff` | `#ddd6fe` |
| `txt` | text | **TXT** | màu mặc định | | |
| Đuôi khác (≤ 5 ký tự) | file | Đuôi viết hoa, vd **JSON**, **MP3** | màu mặc định | | |
| Không có đuôi / đuôi > 5 ký tự | file | **FILE** | màu mặc định | | |

- **Tên hiển thị**: `name` của tệp; không có tên thì theo loại: "Hình ảnh" / "Video" / "Tin nhắn thoại" / "Sticker" / "Liên kết" / "Tệp đính kèm".
- **Bấm** → mở đường dẫn ở tab mới (trình duyệt tự tải hoặc xem). Không có đường dẫn → thẻ ở trạng thái mờ, không bấm được.
- Xem trước / trích dẫn: `[Tệp đính kèm]`.

**Ở khay đính kèm trước khi gửi** (khung soạn), tài liệu dùng biểu tượng emoji gọn hơn: 📕 pdf · 📘 doc/docx/rtf · 📗 xls/xlsx/csv · 📙 ppt/pptx · 📄 txt · 🗜️ zip/rar/7z/tar/gz · 📎 còn lại.

---

## 10. Danh thiếp Zalo

Danh thiếp đến dưới dạng **chuỗi JSON trong `content`**. Nhận là danh thiếp khi parse được object có đủ **3 thứ**: số điện thoại (`phone` / `mobile` / `phoneNumber`), link QR (`qrCodeUrl` / `qr_code_url` / `qrUrl`), uid (`gUid` / `uid` / `userId` / `zaloId`). Thiếu một → hiện như chữ thường.

```
┌───────────────────────────────┐
│ [QR]  DANH THIẾP ZALO          │
│       Nguyễn Văn A             │
│       0912 345 678             │
│       UID 1234567890           │
├───────────────────────────────┤
│   Gọi          Mã QR           │
└───────────────────────────────┘
```

- Tên lấy theo thứ tự `displayName` → `display_name` → `zaloName` → `zalo_name` → `name` → `fullName`; không có thì dùng số điện thoại; không có nữa thì "Danh thiếp Zalo".
- Định dạng số: `0xxxxxxxxx` → `0912 345 678`; `84xxxxxxxxx` → `+84 912 345 678`; khác thì giữ nguyên.
- Nút **Gọi** → `tel:{số}`; nút **Mã QR** → mở ảnh QR ở tab mới.
- **Copy tin nhắn** của danh thiếp ra chữ dễ đọc:
  ```
  Danh thiếp Zalo
  Tên: Nguyễn Văn A
  SĐT: 0912 345 678
  UID: 1234567890
  QR: https://...
  ```
- Xem trước trong trích dẫn: `[Danh thiếp Zalo] {tên}`; ở danh sách hội thoại: `Danh thiếp` (hoặc `Bạn: Danh thiếp`).
- Link QR cũng đi qua bộ lọc URL an toàn (mục 21) vì do người gửi soạn ra.

---

## 11. Trả lời / trích dẫn / nhảy tới tin gốc

### Bắt đầu trả lời
- Chuột phải vào tin → **Trả lời**.
- Chỉ trả lời được khi: tin đã có `msg_id` thật (không phải bong bóng tạm đang gửi) và `canQuote === true`.
- Không được → nút "Trả lời" **mờ đi** kèm tooltip: *"Tin này lưu từ trước khi có tính năng trả lời, Zalo không cho trích dẫn nữa."*

### Thanh trích dẫn trên ô soạn
```
↩  Trả lời Nguyễn Văn A                         ✕
   Nội dung tin gốc rút gọn...
```
- Tên: tin của mình → "Bạn"; tin người khác → `senderName`, không có thì tên hội thoại, không có nữa thì "Người gửi".
- Xem trước: chữ cắt 120 ký tự + "…"; tin không chữ → `[Hình ảnh]`, `[Video]`, `[Tin nhắn thoại]`, `[Sticker]`, `[Liên kết]`, `[Tệp đính kèm]`, `[Tin nhắn]`.
- Bấm ✕ → bỏ trả lời, gửi như tin thường.
- Con trỏ tự nhảy vào ô soạn, cuối dòng.
- **Đổi sang hội thoại khác → tự huỷ trả lời.**

### Khối trích dẫn trong bong bóng
- Hiện tên người gửi tin gốc + đoạn xem trước (bị cắt ngắn).
- Bong bóng vẫn hiện dù tin trả lời không có chữ (trả lời bằng mỗi ảnh), để khối trích dẫn không biến mất.
- Bong bóng tạm (đang gửi) vẽ khối trích dẫn ngay, không chờ server.

### Bấm vào khối trích dẫn → nhảy tới tin gốc
- Tin gốc chưa có trong danh sách đã tải → tự tải ngược **từng trang** (50 tin/trang), tối đa **20 trang**.
- Tìm thấy → cuộn mượt tới tin gốc (căn giữa màn hình) và **nháy viền màu nhấn 2,2 giây**. Bấm lại cùng tin vẫn nháy lại. Người dùng bật "giảm chuyển động" → viền đứng yên, không hiệu ứng.
- Sau khi nhảy, **tắt tự dính đáy** để nhịp làm mới không kéo tuột về cuối.
- Các thông báo lỗi:
  - `quote.direction` rỗng → *"Tin gốc cũ hơn dữ liệu hệ thống lưu nên không mở được."*
  - Hết tin mà không thấy → *"Không tìm thấy tin gốc trong hội thoại này."*
  - Quá 20 trang → *"Tin gốc nằm quá xa, hãy cuộn lên thêm rồi thử lại."*
- Dùng được bằng bàn phím: Tab tới khối trích dẫn, Enter.

---

## 12. Tin đã thu hồi

- Bong bóng trong suốt, chữ nghiêng màu xám: ***Tin nhắn đã bị thu hồi***.
- **Không** hiện lại nội dung, đính kèm, tên người gửi trong nhóm, hay chip cảm xúc.
- Không chuyển tiếp, không thu hồi lại được.

---

## 13. Thả cảm xúc

- **Nút 👍 (biểu tượng ngón cái)** gắn trên: bong bóng chữ, **từng** ảnh, **từng** video. Mỗi nút mở bảng riêng của nó — tin có cả chữ và 2 ảnh có 3 nút độc lập.
- Không hiện khi: tin chưa có `msg_id` (đang gửi), hoặc hội thoại OA.
- **Bảng 6 cảm xúc**:

| Mã gửi lên | Emoji | Tên |
|---|---|---|
| `LIKE` | 👍 | Thích |
| `HEART` | ❤️ | Yêu thích |
| `HAHA` | 😆 | Haha |
| `WOW` | 😮 | Wow |
| `CRY` | 😢 | Buồn |
| `ANGRY` | 😡 | Phẫn nộ |

- Bấm nút lần nữa hoặc bấm ra ngoài → đóng bảng.
- Chọn một cảm xúc → `POST /messages/{msgId}/reaction` `{ icon }`. Thành công → chip cập nhật **ngay**, không chờ nhịp làm mới.
- **Mỗi người chỉ một cảm xúc trên một tin** (như Zalo): chọn cái mới thì thay cái cũ của mình.
- **Chip tổng hợp** dưới tin: gom theo loại, ví dụ `👍 3` `❤️` (chỉ hiện số khi > 1). Rê chuột vào chip → tooltip danh sách tên người đã thả. Icon lạ không có trong bảng → hiện 👍.
- Vị trí chip: tin có chữ hoặc trích dẫn → dưới bong bóng; tin chỉ có đính kèm → ngay dưới đính kèm.
- Lỗi: "Thả cảm xúc thất bại." / "Không thể kết nối để thả cảm xúc."

---

## 14. Menu chuột phải trên tin

- **Chuột phải vào phần nội dung tin** (bong bóng/đính kèm) mở menu. Chuột phải vào khoảng trống bên cạnh vẫn là menu mặc định của trình duyệt.
- Menu **ghim theo vị trí con trỏ**, tự lùi vào nếu sát mép phải/dưới màn hình (ước lượng 220 × 108px, chừa 8px).
- Đóng khi: bấm ra ngoài, nhấn **Esc**, **cuộn khung chat** (tránh bấm "Trả lời" cho tin đã trôi đi chỗ khác), đổi hội thoại.

| Mục | Hiện khi | Hành vi |
|---|---|---|
| ↩ **Trả lời** | Luôn hiện; mờ nếu không trả lời được | Mục 11 |
| ⧉ **Copy tin nhắn** | Tin có chữ | Copy chữ gốc (danh thiếp → dạng chữ, mục 10). Trình duyệt chặn clipboard → báo *"Trình duyệt không cho copy tự động. Hãy bôi đen rồi Ctrl+C."* |
| ↪ **Chuyển tiếp** | Có `msg_id`, chưa thu hồi, `canForward`, không phải OA | Mở bảng chọn nơi nhận (dưới đây) |
| ⟲ **Thu hồi** | Tin **của mình** (`out`), có `msg_id`, chưa thu hồi, không phải OA | Hỏi xác nhận *"Thu hồi tin nhắn này? Cả hai bên sẽ thấy "tin nhắn đã bị thu hồi"."* → đổi sang trạng thái thu hồi |
| 🗑 **Xoá phía tôi** | Có `msg_id`, không phải OA | Hỏi xác nhận *"Xoá tin nhắn này khỏi phía bạn? (Đối phương vẫn thấy tin bình thường)"* → gỡ tin khỏi danh sách |

### Bảng chuyển tiếp
- Tiêu đề "Chuyển tiếp tin nhắn", dòng xem trước tin.
- Đang bật nhiều tài khoản → ghi rõ *"Gửi bằng tài khoản: {tên}"*.
- **Chỉ liệt kê hội thoại của chính tài khoản đang giữ tin** (tài khoản khác là phiên Zalo khác).
- Ô tìm **không phân biệt dấu**: gõ "nguyen" ra "Nguyễn".
- Mỗi dòng: ô tích, ảnh đại diện, tên, nhãn "Nhóm" nếu là nhóm.
- Tối đa **20 nơi nhận**; đủ 20 thì các dòng còn lại bị khoá. Bộ đếm "Đã chọn x/20 nơi nhận".
- Nút **Gửi** khoá khi chưa chọn ai; đang gửi hiện "Đang gửi…", không đóng được bảng.
- Thành công hết → đóng bảng. **Hỏng một phần → giữ bảng mở**, liệt kê từng nơi chưa nhận kèm lý do, nút đổi thành "Đóng".
- Loại chuyển tiếp được (server quyết): chữ, ảnh, tệp, video, tin thoại, sticker, đường dẫn. Không chuyển được: vị trí, bình chọn, thẻ ngân hàng...

---

## 15. Bấm vào tên / ảnh đại diện / @tên: kết bạn hay nhắn riêng

### Áp dụng ở đâu

| Điểm bấm | Trong **nhóm** | Trong hội thoại **1-1** |
|---|---|---|
| Ảnh đại diện người gửi | Mở **thẻ thành viên** (con trỏ tay) | Không làm gì |
| Tên người gửi (trên bong bóng) | Mở **thẻ thành viên** | (không có tên) |
| `@Tên` được gắn thẻ trong tin | Mở **thẻ thành viên** của người bị gắn | Không làm gì |

Không mở thẻ khi: không có uid, hoặc uid là **chính tài khoản đang dùng** (bị gắn thẻ chính mình).

### Thẻ thành viên

```
┌─────────────────────────────┐
│ (ảnh)  Nguyễn Văn A          │
├─────────────────────────────┤
│ 👤+  Kết bạn                 │   ← ẩn nếu đã là bạn
│ 💬   Nhắn tin riêng          │
│ Đang gửi lời mời…            │   ← dòng trạng thái ngay trong thẻ
└─────────────────────────────┘
```

- Ghim theo con trỏ, tự lùi vào khi sát mép (ước lượng 260 × 210px). Đóng khi bấm ra ngoài, Esc, cuộn khung chat, đổi hội thoại. Mở thẻ thì đóng menu chuột phải nếu đang mở.
- **Tên**: lấy từ danh sách thành viên nhóm đã tải (nếu có), không thì `senderName` / đoạn chữ sau `@`, không có nữa thì `ID {uid}`. Ảnh: ảnh đại diện, không có thì chữ viết tắt.
- Lúc mở thẻ, hệ thống **hỏi Zalo trạng thái bạn bè** của uid đó (`GET /friends/{uid}/status`), nhớ kết quả theo `tàiKhoản:uid` để mỗi người chỉ hỏi một lần.

**Nút "Kết bạn"**
- Ẩn khi đã là bạn.
- Đã gửi lời mời trước đó → nút mờ, chữ đổi thành **"Đã gửi lời mời"**.
- Bấm → `POST /friends/requests` với `user_id = uid` và lời nhắn mặc định **"Xin chào, kết bạn với tôi nhé!"**. Kết bạn theo **uid**, không cần số điện thoại (trong nhóm ta không biết số của họ).
- Kết quả hiện **ngay trong thẻ** (không phải dải thông báo chung ở chỗ khác): "Đang gửi lời mời…" → xanh "Đã gửi lời mời kết bạn." hoặc đỏ kèm lý do.
- Gửi xong, nút chuyển ngay sang "Đã gửi lời mời", không chờ hỏi lại.
- Thẻ đã đóng / đã mở cho người khác trong lúc chờ → kết quả bị bỏ, không hiện nhầm chỗ.

**Nút "Nhắn tin riêng"**
1. Đóng thẻ.
2. `POST /contacts/open` với `thread_id = uid`, `thread_type = user`, `name`. Dùng **tài khoản của nhóm đang mở**, không phải tài khoản đang xem ở tab Danh bạ.
3. Hội thoại 1-1 được thêm/đưa lên **đầu danh sách** (kể cả khi chưa có tin nào), chuyển sang tab "Chats" và **mở luôn** hội thoại đó.
4. Lỗi → "Không mở được hội thoại với liên hệ này." / "Không thể kết nối để mở hội thoại."

---

## 16. Thanh kết bạn trong hội thoại 1-1

Giống Zalo web: thanh nằm ngay trên ô soạn tin khi đang chat với người **chưa phải bạn bè**.

- Mở hội thoại 1-1 → tự hỏi trạng thái bạn bè.
- **Chỉ hiện khi biết chắc** người đó chưa là bạn **và** server xác nhận là người dùng thật (`can_add_friend` — loại OA và luồng hệ thống như "Truyền file"). Chưa rõ thì **không hiện gì** (thà thiếu nút còn hơn mời kết bạn một người đã là bạn).

| Trạng thái | Chữ trên thanh | Nút |
|---|---|---|
| Chưa là bạn, chưa ai mời | "Bạn chưa kết bạn với người này." | **Kết bạn** |
| Mình đã gửi lời mời | "Đã gửi lời mời kết bạn, đang chờ đồng ý." | — |
| Họ đã gửi lời mời cho mình | "Người này đã gửi lời mời kết bạn cho bạn - trả lời ở màn Danh bạ." | — |

- Bấm **Kết bạn** → chữ nút "Đang gửi..." → thành công thì chuyển sang trạng thái "Đã gửi lời mời...". Lỗi báo ở dải thông báo đỏ.

---

## 17. Khung soạn tin

### Phím tắt & gửi
- **Enter** = gửi ngay, **không hỏi xác nhận**. **Shift + Enter** = xuống dòng.
- Bảng gợi ý `@tên` đang mở thì Enter = **chọn người**, không gửi.
- Ô soạn tự giãn theo nội dung, cao tối đa 160px.
- Nút **Gửi** khoá khi: đang gửi, tài khoản không dùng được, hoặc chưa có chữ lẫn tệp.
- Placeholder: "Nhập tin nhắn, dán hoặc kéo thả ảnh/video/tài liệu vào đây".
- Đang gửi thì ô soạn và các nút bị khoá; gửi xong con trỏ quay lại ô soạn.

### Đính kèm tệp
Ba cách: nút 🖼 chọn tệp (chọn nhiều), **dán** (Ctrl+V ảnh chụp màn hình), **kéo thả** (khung soạn đổi viền khi kéo vào).

- Khay xem trước phía trên ô soạn: ảnh hiện thumbnail, video hiện khung + ▶, tài liệu hiện emoji + tên tệp. Rê chuột → "tên · dung lượng". Mỗi chip có ✕ bỏ riêng; nút **"Bỏ hết"**.
- Ghi chú dưới khay: *"Tệp gửi trước, phần chữ gửi thành tin riêng."*
- Kiểm tra **ngay tại trình duyệt** (khỏi upload xong mới bị từ chối):

| Giới hạn | Zalo cá nhân (mặc định, chỉnh trong `config/zalo.php`) | Zalo OA |
|---|---|---|
| Số tệp mỗi lần | 5 | 5 |
| Ảnh | 5 MB | 1 MB, chỉ JPG/PNG |
| Video | 15 MB | **Không gửi được video** |
| Tệp khác | 15 MB, **mọi đuôi** (RAR, 7Z, mã nguồn...) | 5 MB, chỉ PDF/DOC/DOCX/CSV |
| Tổng một lần gửi | 20 MB | 20 MB |

- Thông báo lỗi cụ thể theo từng tệp: *"Mỗi lần chỉ gửi được tối đa 5 tệp."*, *"\"a.mp4\" vượt quá 15MB."*, *"\"x\" là tệp rỗng, không gửi được."*, *"Zalo OA không gửi được video (\"a.mp4\")."*, *"Tổng dung lượng một lần gửi không quá 20MB."*
- **Kéo thả thư mục** → bị loại: *"Không gửi được thư mục "abc" - hãy nén thành ZIP/RAR rồi gửi."*
- Chọn lại đúng tệp vừa bỏ vẫn chọn được.
- **Đổi hội thoại → xoá sạch tệp đang chờ** (tránh một cú Enter gửi ảnh sang nhầm người).

### Emoji (😊)
- Bảng chia nhóm: Hay dùng, Mặt cười, Cảm xúc, Cử chỉ, Tình cảm, Đồ ăn, Hoạt động, Ký hiệu. Tab là emoji đầu của nhóm.
- Bấm emoji → **chèn đúng vị trí con trỏ**, không phải luôn nối vào cuối.
- Mở emoji thì đóng sticker và tin mẫu.

### Tin nhắn mẫu
- Nút 📋 có huy hiệu số mẫu (quá 99 → "99+"). Bấm → bảng chọn, chọn mẫu → đưa nội dung vào ô soạn.
- **Gõ nhanh**: `/mã` rồi nhấn **Space** → thay bằng nội dung mẫu có mã đó.

### Gắn thẻ thành viên `@` (chỉ nhóm)
- Gõ `@` (đầu dòng hoặc sau khoảng trắng) → bảng gợi ý thành viên nhóm (tải một lần, cache theo nhóm).
- Lọc theo tên **bắt đầu bằng** chữ đã gõ, không phân biệt dấu; tên được chứa khoảng trắng ("@Anh V"); tối đa 20 gợi ý.
- ↑ ↓ chọn, Enter chèn, Esc đóng. Gõ xuống dòng, gặp `@` khác hoặc quá 30 ký tự → đóng bảng.
- Chèn thành `@Tên ` (có dấu cách). Lúc gửi, vị trí `pos/len` được **tính lại** theo đúng nội dung cuối cùng; người dùng sửa dở tên đã chèn thì lượt gắn thẻ đó rớt, gửi như chữ thường.

### Gửi nhanh dạng khác (nút ＋, ẩn với OA)
- **Danh thiếp**: User ID + số điện thoại (tuỳ chọn).
- **Video (URL)**: URL video + URL ảnh thumbnail + chú thích (tuỳ chọn).
- **Thẻ ngân hàng**: mã BIN (vd 970436 = Vietcombank) + số tài khoản + tên chủ tài khoản (tuỳ chọn).

---

## 18. Trạng thái gửi: đang gửi, lỗi, thử lại

- Bấm gửi → **bong bóng tạm hiện ngay** (gửi lạc quan): ô soạn, tệp, trả lời được xoá; khung chat cuộn xuống đáy.
  - Ảnh/video trong bong bóng tạm hiện bằng blob cục bộ, không chờ server.
  - Tên tệp hiện đúng tên vừa gửi.
  - Gắn thẻ và trích dẫn vẽ ngay.
- Dưới bong bóng: spinner **"Đang gửi"**; bong bóng mờ đi (`opacity: .68`).
- **Lỗi** → bong bóng nền hồng `#ffe4e6`, chữ đỏ sẫm `#7f1d1d`, viền trong `#fecdd3`; dòng lỗi đỏ (lý do từ server hoặc "Gửi tin nhắn thất bại."/"Không thể kết nối để gửi tin nhắn.") + nút **"Thử lại"**.
  - Thử lại hỏi xác nhận *"Gửi lại tin nhắn này qua Zalo thật?"*, gửi lại **đúng tệp gốc** và **đúng dạng trả lời**.
- **Thành công** → hội thoại nhảy lên đầu danh sách với xem trước tin vừa gửi; tải lại tin.
  - Bong bóng tạm chỉ có chữ được thay bằng tin thật khi thấy tin `out` trùng nội dung.
  - Bong bóng tạm có tệp được giữ tối đa 15 giây rồi bỏ (lúc đó tin thật đã về); blob được giải phóng.
- Bong bóng tạm không có menu thu hồi/xoá/chuyển tiếp/cảm xúc (chưa có `msg_id`).

---

## 19. Đầu khung chat

- Ảnh đại diện + tên hội thoại.
- **Bấm đúp vào tên** → sửa tên hiển thị: Enter lưu, Esc huỷ, rời ô cũng lưu. Để trống = trả lại tên Zalo. Dòng phụ: "Enter để lưu · Esc để huỷ · Tên Zalo: {tên gốc}".
- Bật nhiều tài khoản → nhãn **"Gửi bằng {tài khoản}"** (tránh gửi nhầm danh nghĩa).
- Dòng trạng thái làm mới: "Tự làm mới sau 8s" / "Cập nhật 3s trước, nhịp 8s" / "Tạm dừng khi tab ẩn" / spinner "Đang làm mới".
- Nhóm → nút **"Nhóm"** mở bảng quản lý nhóm.
- Huy hiệu "Đã kích hoạt AI", nút tóm tắt AI, nút chạy agent, nút làm mới tin.
- Màn hẹp: nút ẩn/hiện danh sách hội thoại.

---

## 20. Cuộn, tải tin cũ, tự làm mới

- Mở hội thoại: có bộ nhớ đệm → hiện ngay tin đã tải trước đó rồi làm mới ngầm; không có → khung xương (skeleton) rồi cuộn xuống đáy.
- **Cuộn lên cách đỉnh ≤ 60px** → tải trang cũ hơn, có huy hiệu "Đang tải tin cũ hơn"; giữ nguyên vị trí đang đọc (không nhảy).
- **"Dính đáy"**: đang ở cách đáy ≤ 90px thì tin mới về tự cuộn xuống. Đã cuộn lên đọc tin cũ → không giật màn hình.
- Ảnh tải xong làm khung dài ra → tự cuộn lại xuống đáy, **chỉ khi còn dính đáy**.
- **Nhịp tự làm mới** tăng dần khi không có gì mới: 8s → 15s → 30s → 60s; có tin mới thì về lại 8s. Bật AI tự trả lời: 2s → 3s → 5s → 10s. **Tab ẩn thì tạm dừng.**
- Đổi hội thoại giữa chừng → huỷ yêu cầu đang chạy, kết quả về muộn bị bỏ.
- Tiêu đề tab trình duyệt: `(N tin nhắn mới) {tiêu đề}`, quá 99 → "99+".
- Hội thoại vừa bị ẩn bên Zalo trong lúc đang mở → đóng lặng lẽ, không báo lỗi.
- Không có tin: "Chưa đọc được tin nhắn — Bấm làm mới hoặc kiểm tra trạng thái tài khoản."

---

## 21. An toàn khi hiển thị

Bắt buộc cho hệ thống làm theo — nội dung tin do **người lạ** quyết định.

1. **Escape toàn bộ chữ** trước khi chèn link/thẻ (mục 3).
2. **Lọc scheme URL theo danh sách cho phép** cho mọi `href`/`src` lấy từ tin nhắn (đính kèm, link QR danh thiếp):
   - Cho phép: `http:`, `https:`, `mailto:`, `tel:`, `data:image/...`, và đường dẫn tương đối.
   - Gỡ ký tự điều khiển/khoảng trắng **trước** khi so scheme (`java\tscript:` vẫn chạy được trên trình duyệt).
   - Còn lại (`javascript:`, `data:text/html`, `vbscript:`...) → bỏ thành chuỗi rỗng.
   - Dùng danh sách cho phép chứ không dùng danh sách cấm — biến thể của `javascript:` là vô tận.
3. Link mở ngoài luôn có `target="_blank" rel="noopener noreferrer"`.
4. Ảnh/link CDN Zalo dùng `referrerpolicy="no-referrer"`.

---

## 22. Khác biệt Zalo cá nhân và Zalo OA

| Tính năng | Zalo cá nhân | Zalo OA |
|---|---|---|
| Thả cảm xúc | Có | **Không** (ẩn nút) |
| Thu hồi / xoá phía tôi / chuyển tiếp | Có | **Không** |
| Sticker | Có | **Không** (ẩn nút) |
| Danh thiếp / video URL / thẻ ngân hàng | Có | **Không** (ẩn nút ＋) |
| Gửi video | Có (15 MB) | **Không** |
| Gửi ảnh | 5 MB | 1 MB, JPG/PNG |
| Gửi tài liệu | Mọi đuôi, 15 MB | PDF/DOC/DOCX/CSV, 5 MB |
| Trả lời (trích dẫn) | Theo `canQuote` | Theo `canQuote` |

---

## 23. Danh sách kiểm tra cho hệ thống khác

**Hiển thị**
- [ ] Tin đến trái + ảnh đại diện; tin đi phải; tên người gửi chỉ ở tin đầu chuỗi trong nhóm.
- [ ] Đính kèm nằm trong bong bóng; tin chỉ có media thì bỏ nền bong bóng.
- [ ] Giờ `HH:mm`, chỉ hiện một lần mỗi tin.
- [ ] "Gửi bởi {nhân viên}" dưới tin đi.
- [ ] Link chỉ nhận `http(s)://`, tách dấu câu cuối, mở tab mới.
- [ ] `@Tên` dùng toạ độ `mentions`, bấm được trong nhóm.
- [ ] Phân loại đính kèm theo thuật toán mục 4, mỗi đính kèm chỉ dựng một thẻ.
- [ ] Ảnh: badge HD, bấm phóng to, chuỗi dự phòng 3 bước, nhớ cờ hỏng qua nhịp làm mới.
- [ ] **JXL → đổi `/jxl/`→`/jpg/`, `.jxl`→`.jpg`**, lỗi thì rơi về thumb, cuối cùng thành thẻ tệp.
- [ ] Sticker 150×150, nền trong suốt, không phóng to, không badge.
- [ ] Thẻ link: thumb 52×52 + tiêu đề (tên miền nếu không có) + URL; nhận diện link không có đuôi ảnh.
- [ ] Thẻ tệp: icon giấy gấp góc + nhãn W/X/P/PDF/ZIP... theo bảng màu mục 9.
- [ ] Danh thiếp: QR, tên, số định dạng, UID, nút Gọi / Mã QR.
- [ ] Tin thu hồi: chữ nghiêng "Tin nhắn đã bị thu hồi", ẩn mọi thứ khác.

**Thao tác**
- [ ] Menu chuột phải: Trả lời / Copy / Chuyển tiếp / Thu hồi / Xoá phía tôi, theo điều kiện mục 14; đóng khi cuộn/Esc.
- [ ] Trả lời: thanh trích dẫn, huỷ khi đổi hội thoại; bấm trích dẫn → nhảy tới tin gốc (≤ 20 trang) và nháy sáng.
- [ ] Cảm xúc: 6 loại, nút riêng cho bong bóng/từng ảnh/từng video, một cảm xúc mỗi người, chip gom nhóm có tooltip tên.
- [ ] Nhóm: bấm ảnh đại diện / tên / @tên → thẻ thành viên **Kết bạn** (theo uid) / **Nhắn tin riêng** (mở hoặc tạo hội thoại 1-1 rồi chuyển sang ngay).
- [ ] 1-1 với người lạ: thanh "Bạn chưa kết bạn với người này." + nút Kết bạn, chỉ khi server xác nhận.
- [ ] Bảng sticker: tìm, chip gợi ý, Gần đây (32, localStorage), tab bộ (≤ 8), bấm là gửi.
- [ ] Ô soạn: Enter gửi, Shift+Enter xuống dòng, dán/kéo thả tệp, chặn dung lượng tại trình duyệt, chặn thư mục, xoá tệp chờ khi đổi hội thoại.
- [ ] Emoji chèn tại con trỏ; tin mẫu `/mã` + Space; gợi ý `@` trong nhóm.
- [ ] Gửi lạc quan: bong bóng tạm, "Đang gửi", lỗi đỏ + "Thử lại" (gửi lại đúng tệp, đúng dạng trả lời).
- [ ] Cuộn lên tải tin cũ giữ vị trí; dính đáy ≤ 90px; nhịp làm mới giãn dần, dừng khi tab ẩn.

**An toàn**
- [ ] Escape chữ; lọc scheme URL theo danh sách cho phép; `noopener noreferrer`; `no-referrer` cho CDN.
