docs: add app URL setting docs + separate version update page

tanviet12 · claude · tanviet12 · commit b45df8b6dea5 · 2026-03-26T22:24:53.000+07:00
- Add "URL ứng dụng" section to general-settings.md with priority fallback explanation
- Add info boxes in notifications.md linking to app URL config
- Create dedicated guide/updates.md page (moved from installation.md)
- Update sidebar config and installation.md "next steps"

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts
@@ -25,6 +25,7 @@ export default defineConfig({
           { text: 'Cài đặt', link: '/guide/installation' },
           { text: 'Tên miền & SSL', link: '/guide/domain-ssl' },
           { text: 'Thiết lập ban đầu', link: '/guide/initial-setup' },
+          { text: 'Cập nhật phiên bản', link: '/guide/updates' },
         ],
       },
       {
diff --git a/docs/guide/installation.md b/docs/guide/installation.md
@@ -108,39 +108,6 @@ docker compose logs app -f    # Chỉ xem app
 docker compose logs nginx -f  # Chỉ xem nginx
 ```
 
-## Cập nhật phiên bản mới
-
-```bash
-cd /opt/cqa
-docker compose pull
-docker compose up -d
-```
-
-## Tự động cập nhật (tùy chọn)
-
-Thêm [Watchtower](https://containrrr.dev/watchtower/) để VPS tự động pull image mới và restart khi có bản cập nhật.
-
-Chạy lệnh sau trên VPS để cập nhật file docker-compose.yml (đã bao gồm Watchtower + label):
-
-```bash
-cd /opt/cqa
-curl -sfL https://raw.githubusercontent.com/tanviet12/chat-quality-agent/main/docker-compose.hub.yml -o docker-compose.yml
-docker compose up -d
-```
-
-::: info Lệnh trên an toàn
-File `.env` (chứa secrets, database password) không bị ảnh hưởng. Dữ liệu MySQL nằm trong Docker volume, không bị mất.
-:::
-
-Watchtower sẽ kiểm tra Docker Hub mỗi 5 phút. Khi phát hiện image mới, tự pull và restart container **app + nginx** (có label). MySQL không có label nên không bị update, dữ liệu an toàn.
-
-::: tip Xem log Watchtower
-```bash
-docker compose logs watchtower -f
-```
-Thấy dòng `Found new ...` nghĩa là đã tự cập nhật thành công.
-:::
-
 ## Gỡ cài đặt
 
 ```bash
@@ -157,3 +124,4 @@ rm -rf /opt/cqa
 
 - [Tên miền & SSL](/guide/domain-ssl) — Trỏ domain và bật HTTPS
 - [Thiết lập ban đầu](/guide/initial-setup) — Tạo admin, cấu hình AI
+- [Cập nhật phiên bản](/guide/updates) — Cập nhật thủ công hoặc tự động
diff --git a/docs/guide/updates.md b/docs/guide/updates.md
@@ -0,0 +1,45 @@
+# Cập nhật phiên bản
+
+## Thông báo trên giao diện
+
+CQA tự động kiểm tra phiên bản mới mỗi khi bạn đăng nhập (cache 1 giờ). Khi có bản cập nhật:
+
+- **Chip phiên bản** ở header chuyển sang màu vàng (bình thường là xanh)
+- **Banner thông báo** hiện bên dưới header với link đến changelog
+
+Bấm vào chip phiên bản để xem chi tiết thay đổi trong bản mới.
+
+## Cập nhật thủ công
+
+```bash
+cd /opt/cqa
+docker compose pull
+docker compose up -d
+```
+
+Lệnh trên sẽ pull image mới từ Docker Hub và restart container. Dữ liệu MySQL không bị ảnh hưởng.
+
+## Tự động cập nhật (tùy chọn)
+
+Thêm [Watchtower](https://containrrr.dev/watchtower/) để VPS tự động pull image mới và restart khi có bản cập nhật.
+
+Chạy lệnh sau trên VPS để cập nhật file docker-compose.yml (đã bao gồm Watchtower + label):
+
+```bash
+cd /opt/cqa
+curl -sfL https://raw.githubusercontent.com/tanviet12/chat-quality-agent/main/docker-compose.hub.yml -o docker-compose.yml
+docker compose up -d
+```
+
+::: info Lệnh trên an toàn
+File `.env` (chứa secrets, database password) không bị ảnh hưởng. Dữ liệu MySQL nằm trong Docker volume, không bị mất.
+:::
+
+Watchtower sẽ kiểm tra Docker Hub mỗi 5 phút. Khi phát hiện image mới, tự pull và restart container **app + nginx** (có label). MySQL không có label nên không bị update, dữ liệu an toàn.
+
+::: tip Xem log Watchtower
+```bash
+docker compose logs watchtower -f
+```
+Thấy dòng `Found new ...` nghĩa là đã tự cập nhật thành công.
+:::
diff --git a/docs/usage/general-settings.md b/docs/usage/general-settings.md
@@ -1,6 +1,6 @@
 # Cấu hình chung
 
-Vào menu **Cài đặt** (icon bánh răng ở sidebar) > tab **Cấu hình chung**.
+Vào menu **Cài đặt** (icon bánh răng ở sidebar) > tab **Chung**.
 
 ![Cấu hình chung](/screenshots/cau-hinh-chung.png)
 
@@ -12,6 +12,7 @@ Vào menu **Cài đặt** (icon bánh răng ở sidebar) > tab **Cấu hình chu
 | **Múi giờ** | Ảnh hưởng đến thời gian hiển thị và lịch chạy công việc | Asia/Ho_Chi_Minh |
 | **Ngôn ngữ** | Giao diện Tiếng Việt hoặc English | Tiếng Việt |
 | **Tỉ giá USD → VND** | Dùng để quy đổi chi phí AI sang VND | 26,000 |
+| **URL ứng dụng** | URL truy cập CQA, dùng để tạo link trong thông báo Telegram/Email | (không có) |
 
 ## Tỉ giá USD → VND
 
@@ -21,6 +22,22 @@ Chi phí AI (Claude, Gemini) được tính bằng USD. CQA quy đổi sang VND
 - Bạn có thể cập nhật theo tỉ giá thực tế
 - Ảnh hưởng đến hiển thị trong **Dashboard** và **Chi phí AI**
 
+## URL ứng dụng
+
+Cấu hình URL để hệ thống gửi link chính xác qua [Telegram và Email](/usage/notifications).
+
+- Nhập URL truy cập CQA của bạn, ví dụ: `https://cqa.sepay.vn`
+- URL phải bắt đầu bằng `http://` hoặc `https://`, không có dấu `/` ở cuối
+- Link trong thông báo sẽ dẫn thẳng đến trang kết quả trên CQA
+
+::: tip Thứ tự ưu tiên
+1. **URL ứng dụng** trong Cài đặt (ưu tiên cao nhất)
+2. Biến môi trường `APP_URL` trong file `.env`
+3. Fallback: `http://localhost:8080`
+
+Nếu bạn đã cấu hình domain + SSL, hãy nhập URL ở đây để link trong thông báo trỏ đúng.
+:::
+
 ## Lưu cấu hình
 
 Bấm **Lưu cấu hình** sau khi thay đổi. Cấu hình có hiệu lực ngay lập tức, không cần khởi động lại.
diff --git a/docs/usage/notifications.md b/docs/usage/notifications.md
@@ -37,6 +37,10 @@ Bot sẽ gửi tin nhắn vào group gồm:
 - Danh sách vấn đề phát hiện (nếu có)
 - Link xem chi tiết trên CQA
 
+::: info Cấu hình link
+Link trong thông báo dùng URL từ **Cài đặt > Chung > [URL ứng dụng](/usage/general-settings#url-ung-dung)**. Nếu chưa cấu hình, link sẽ trỏ về localhost.
+:::
+
 ## Email
 
 ### Thiết lập
@@ -80,7 +84,7 @@ Bạn có thể viết template riêng thay vì dùng mặc định:
 | `failed` | Số cuộc chat không đạt |
 | `issues` | Số vấn đề phát hiện |
 | `content` | Nội dung đánh giá chi tiết |
-| `link` | URL xem kết quả trên hệ thống |
+| `link` | URL xem kết quả trên hệ thống (dùng [URL ứng dụng](/usage/general-settings#url-ung-dung) đã cấu hình) |
 
 Cú pháp dùng trong template: bọc tên biến trong dấu ngoặc nhọn kép, ví dụ: `{` `{job_name}` `}`
 

Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,7 @@ export default defineConfig({`
`25`	`25`	`{ text: 'Cài đặt', link: '/guide/installation' },`
`26`	`26`	`{ text: 'Tên miền & SSL', link: '/guide/domain-ssl' },`
`27`	`27`	`{ text: 'Thiết lập ban đầu', link: '/guide/initial-setup' },`
	`28`	`+ { text: 'Cập nhật phiên bản', link: '/guide/updates' },`
`28`	`29`	`],`
`29`	`30`	`},`
`30`	`31`	`{`