Initial commit

docs/DDNS 双模式功能测试指南.md

@@ -0,0 +1,377 @@
+# DDNS 双模式功能测试指南
+
+## 🎯 测试目标
+
+验证 DDNS 双模式架构的前端实现是否正确，包括：
+1. Tab 4 重命名为"增强"
+2. DDNS 表单支持两种模式切换
+3. 增强页服务卡片显示正确
+4. 表单验证逻辑区分模式
+
+---
+
+## 📋 前置准备
+
+### 1. 启动服务
+```bash
+cd e:\Project\MeshRay
+.\meshray.exe
+```
+
+### 2. 访问页面
+- URL: http://localhost:9531
+- 默认账号：admin / admin123
+
+### 3. 打开浏览器开发者工具（F12）
+- Console 标签 - 查看是否有 JavaScript 错误
+- Network 标签 - 查看 API 请求
+
+---
+
+## ✅ 测试用例
+
+### 测试 1：验证 Tab 名称修改
+
+**步骤**：
+1. 登录系统
+2. 点击左侧菜单"服务管理"
+3. 查看顶部的 Tab 标签
+
+**预期结果**：
+- ✅ Tab 1: "TUN" 🔌
+- ✅ Tab 2: "TURN" 🔗
+- ✅ Tab 3: "DDNS" 🌐
+- ✅ Tab 4: "增强" 🚀 ← **重点验证**
+
+**截图位置**：
+```
+[在此处粘贴 Tab 栏截图]
+```
+
+---
+
+### 测试 2：验证 Tab 3 "DDNS"说明文案
+
+**步骤**：
+1. 点击 Tab 3 "DDNS"
+2. 查看顶部的信息卡片
+
+**预期结果**：
+- ✅ 标题：**DDNS 配置（基础设施）**
+- ✅ 描述：配置 DNS 服务商对接信息，用于组网同步、内网穿透等场景
+- ✅ 列表项：
+  - 支持阿里云、腾讯云、Cloudflare
+  - 配置后可在组网创建时直接选用
+  - 也可在「增强」页创建完整的 DDNS 服务
+
+**实际结果**：
+```
+[记录实际显示的文案]
+```
+
+---
+
+### 测试 3：测试 DDNS 基础设施配置模式
+
+**步骤**：
+1. 在 Tab 3 点击"添加 DDNS"按钮
+2. 查看弹出的对话框
+
+**预期结果**：
+- ✅ 对话框标题："添加 DDNS"
+- ✅ 表单包含"配置模式"单选框
+- ✅ 默认选中"🏗️ 基础设施配置"
+- ✅ 选择基础设施模式后，显示：
+  - DNS 服务商下拉框
+  - 根域名输入框
+  - 根据服务商显示不同的认证字段（Cloudflare API Token、阿里云 AccessKey 等）
+
+**验证表单字段**：
+| 字段 | 是否显示 | 备注 |
+|------|---------|------|
+| 服务名称 | ✅ | 通用字段 |
+| 服务类型 | ✅ | 固定为 DDNS |
+| 配置模式 | ✅ | 单选框 |
+| DNS 服务商 | ✅ | 基础设施模式特有 |
+| 根域名 | ✅ | 基础设施模式特有 |
+| API Token/AccessKey | ✅ | 根据服务商显示 |
+| 主机记录 | ❌ | 全功能模式才有 |
+| 目标 IP | ❌ | 全功能模式才有 |
+
+**截图位置**：
+```
+[在此处粘贴表单截图]
+```
+
+---
+
+### 测试 4：测试 DDNS 全功能服务模式
+
+**步骤**：
+1. 在 DDNS 添加对话框中
+2. 切换配置模式为"🚀 全功能 DDNS 服务"
+
+**预期结果**：
+- ✅ 显示"选择 DDNS 配置"下拉框（从已配置的 DDNS 服务中选择）
+- ✅ 显示"记录类型"下拉框（A/AAAA/TXT/CNAME）
+- ✅ 选择 A/AAAA 记录时，显示：
+  - 主机记录输入框
+  - 目标 IP 输入框
+  - 检测端口输入框
+- ✅ 选择 TXT 记录时，显示：
+  - TXT 记录名称输入框
+  - TXT 记录值输入框
+- ✅ 选择 CNAME 记录时，显示：
+  - 目标域名输入框
+- ✅ TTL 设置下拉框
+
+**验证表单字段**：
+| 字段 | 是否显示 | 备注 |
+|------|---------|------|
+| 选择 DDNS 配置 | ✅ | 级联选择 |
+| 记录类型 | ✅ | A/AAAA/TXT/CNAME |
+| 主机记录 | ✅ | A/AAAA 模式显示 |
+| 目标 IP | ✅ | A/AAAA 模式显示 |
+| 检测端口 | ✅ | A/AAAA 模式显示 |
+| TXT 记录名称 | ✅ | TXT 模式显示 |
+| TXT 记录值 | ✅ | TXT 模式显示 |
+| 目标域名 | ✅ | CNAME 模式显示 |
+| TTL | ✅ | 通用 |
+
+**测试不同记录类型的切换**：
+1. 选择 A 记录 → 验证显示主机记录、IPv4 目标 IP
+2. 选择 AAAA 记录 → 验证显示主机记录、IPv6 目标 IP
+3. 选择 TXT 记录 → 验证显示 TXT 记录名称和值
+4. 选择 CNAME 记录 → 验证显示目标域名
+
+**截图位置**：
+```
+[在此处粘贴全功能模式表单截图]
+```
+
+---
+
+### 测试 5：验证表单验证规则
+
+**测试场景 A：基础设施模式**
+1. 切换到基础设施模式
+2. 不填写任何字段，点击提交
+
+**预期验证错误**：
+- ✅ "请输入服务名称"
+- ✅ "请选择 DNS 服务商"
+- ✅ "请输入域名"
+
+**测试场景 B：全功能模式 - A 记录**
+1. 切换到全功能模式
+2. 选择 A 记录类型
+3. 不填写字段，点击提交
+
+**预期验证错误**：
+- ✅ "请输入服务名称"
+- ✅ "请选择 DDNS 配置"
+- ✅ "请选择记录类型"
+- ✅ "请输入主机记录"
+- ✅ "请输入目标 IP"
+- ✅ "请输入检测端口"
+
+**测试场景 C：全功能模式 - TXT 记录**
+1. 切换到全功能模式
+2. 选择 TXT 记录类型
+3. 填写 TXT 记录名称为"test_invalid!@#"
+
+**预期验证错误**：
+- ✅ "只能包含字母、数字、点、下划线和连字符"
+
+**记录实际测试结果**：
+```
+[记录每个场景的实际验证结果]
+```
+
+---
+
+### 测试 6：验证增强页服务卡片
+
+**步骤**：
+1. 切换到 Tab 4 "增强"
+2. 查看页面内容
+
+**预期结果**：
+- ✅ 顶部信息卡片：
+  - 标题："增强服务"
+  - 图标：🚀
+  - 描述：基于已配置的基础设施，创建完整的业务服务
+  - 列表项：DDNS 内网穿透、自定义服务
+
+- ✅ 服务卡片网格显示：
+  - 卡片 1: "DDNS 内网穿透" 🌐
+    - 描述：基于 DDNS 配置创建 A/AAAA 记录，实现内网穿透
+    - 标签：内网穿透、DDNS
+  - 卡片 2: "自定义服务" 🔧
+    - 描述：未来扩展更多能力
+    - 标签：自定义、灵活配置
+
+- ✅ 鼠标悬停效果：
+  - 卡片上浮（translateY）
+  - 边框变蓝色
+  - 阴影加深
+  - "立即创建"按钮变蓝
+
+**截图位置**：
+```
+[在此处粘贴增强页截图]
+```
+
+---
+
+### 测试 7：测试点击增强服务卡片
+
+**步骤**：
+1. 点击"DDNS 内网穿透"卡片
+2. 观察弹出的对话框
+
+**预期结果**：
+- ✅ 对话框标题："添加 DDNS"
+- ✅ 服务名称自动填充："DDNS 内网穿透"
+- ✅ 服务类型：DDNS
+- ✅ 配置模式：全功能 DDNS 服务（默认选中）
+- ✅ 记录类型：A（默认）
+- ✅ 其他字段为空，等待用户填写
+
+**点击"自定义服务"卡片**：
+- ✅ 对话框标题："添加 TURN"或"添加 STUN"（取决于服务类型）
+- ✅ 配置模式：基础设施配置（默认）
+
+**记录实际结果**：
+```
+[记录点击卡片的实际行为]
+```
+
+---
+
+### 测试 8：检查浏览器控制台
+
+**步骤**：
+1. 按 F12 打开开发者工具
+2. 切换到 Console 标签
+3. 执行上述所有测试操作
+4. 查看是否有红色错误信息
+
+**预期结果**：
+- ✅ 无 JavaScript 运行时错误
+- ✅ 无 Vue 警告
+- ✅ 无组件未定义错误
+
+**如果看到错误，记录详细信息**：
+```
+错误信息：
+发生时的操作：
+堆栈跟踪：
+```
+
+---
+
+### 测试 9：检查 Network 请求
+
+**步骤**：
+1. 开发者工具 → Network 标签
+2. 清空之前的请求记录
+3. 点击"添加 DDNS" → 提交表单
+4. 查看发送的 API 请求
+
+**预期结果**：
+- ✅ 请求 URL: `/api/v1/services`
+- ✅ 请求方法：POST
+- ✅ 请求体包含正确的字段结构：
+```json
+{
+  "name": "测试 DDNS",
+  "type": "DDNS",
+  "config_mode": "infrastructure",
+  "provider": "cloudflare",
+  "domain": "example.com",
+  "api_token": "***",
+  "enabled": true,
+  "timeout": 10
+}
+```
+
+**对于全功能模式**：
+```json
+{
+  "name": "NAS 内网穿透",
+  "type": "DDNS",
+  "config_mode": "fullservice",
+  "ddns_config_id": "xxx-xxx-xxx",
+  "record_type": "AAAA",
+  "subdomain": "nas",
+  "target_ip": "::ffff:192.168.1.100",
+  "port": 80,
+  "ttl": 600
+}
+```
+
+**记录实际请求**：
+```
+[粘贴请求详情]
+```
+
+---
+
+## 🐛 问题记录表
+
+如果在测试中发现任何问题，请在此记录：
+
+| 编号 | 问题描述 | 复现步骤 | 严重程度 | 截图 |
+|------|---------|---------|---------|------|
+| 1 | | | 高/中/低 | |
+| 2 | | | 高/中/低 | |
+
+---
+
+## 📊 测试总结
+
+### 通过的测试项
+- [ ] Tab 名称修改
+- [ ] Tab 3 文案更新
+- [ ] 基础设施配置模式
+- [ ] 全功能服务模式
+- [ ] 表单验证规则
+- [ ] 增强页服务卡片
+- [ ] 点击卡片行为
+- [ ] 无控制台错误
+- [ ] API 请求正确
+
+### 整体评价
+```
+[对 DDNS 双模式功能的主观评价]
+例如：
+- UI 设计清晰直观
+- 两种模式切换流畅
+- 表单验证逻辑完善
+- 用户体验良好
+```
+
+### 改进建议
+```
+[提出任何改进建议]
+例如：
+1. 可以添加更多预设的 DDNS 服务商
+2. 全功能模式下可以提供快速配置向导
+3. ...
+```
+
+---
+
+## 🎯 下一步行动
+
+根据测试结果：
+1. 如果所有测试通过 → 开始后端集成开发
+2. 如果有问题 → 修复后重新测试
+3. 如果有优化建议 → 评估后决定是否实施
+
+---
+
+**测试日期**：2026-03-20  
+**测试人员**：_____________  
+**测试状态**：⏳ 进行中 / ✅ 已完成 / ❌ 阻塞