Skip to content

U
ubains-module-test
提交 f3035587 authored 作者: 陈泽健's avatar 陈泽健
浏览文件
操作

feat: 点击策略优化/性能测试A0027修复/报告模板与设备模拟增强 

- 执行器点击策略重排序：表格行/复选框策略提前至force点击前，
  force点击checkbox增加前后状态校验，避免隐藏复选框假成功
- 性能测试：template_resolver时间占位符升级为秒精度（修复A0027），
  body_template放宽为Any以兼容list请求体，报告面板图表加载顺序修复
- 功能测试报告模板：模型/路由/schema新增描述字段，Word/Markdown/Excel生成器适配
- 系统设置：新增钉钉对接与文档管理配置项
- 设备模拟：路由/schema/service及前端五个模拟页面增强，元素映射更新
- 杂项：安全用例脚本支持MySQL DATABASE_URL，deploy_execution.script_id改为nullable
- 同步各模块HANDOFF交接文档
Co-Authored-By: 's avatarClaude <noreply@anthropic.com>
上级 5b5b35de
显示空白字符变更
内嵌 并排
正在显示 包含 2022 行增加 和 363 行删除
.claude/skills/CreateCMD/_run_claude.bat
浏览文件 @ f3035587
@echo off
cd /d E:\github\ubains-module-test\platform-auto-test
cd /d E:\GithubData\ubains-module-test\platform-auto-test
E:\nodejs\claude.cmd --permission-mode bypassPermissions
\ No newline at end of file
Docs/PRD/功能测试/交接文档/HANDOFF_功能测试报告.md
浏览文件 @ f3035587
# HANDOFF — 功能测试报告模块会话交接文档
> **生成时间**: 2026-08-13
> **生成时间**: 2026-08-17
> **当前分支**: `platform-auto-test`
> **最近提交**: `f3f5d771` feat(frontend): 菜单重构为自动化测试父菜单，性能/功能报告独立，修复性能任务编辑详情加载
> **状态**: ✅ 功能测试报告模块全部完成（后端服务 + API + 前端页面 + ERP 上传 + ERP 配置持久化 + **报告模板配置多模板管理**）
> **部署状态**: ✅ 已部署至 192.168.5.60（Docker 容器 plat-auto-test-app，端口 80），前后端均已更新并验证通过
> **最近提交**: `ce2c75de` feat: 功能测试报告新增模板配置功能（多模板管理）
> **状态**: ✅ 功能测试报告模块全部完成（后端服务 + API + 前端页面 + ERP 上传 + ERP 配置持久化 + **报告模板配置多模板管理** + **Excel 格式适配**）
> **部署状态**: ✅ 已部署至 192.168.5.60（Docker 容器 plat-auto-test-app，端口 80），前后端均已更新，**模板创建 500 错误已修复并验证通过**
---
......@@ -47,6 +47,100 @@
6. ✅ 生成报告时下拉选择模板
7. ✅ 模板配置存储为 JSON 字段（`config` Text），与 `ErpConfig` 同模式
### 任务 3：模板创建 500 修复 + 部署 + 提交 — 2026-08-13 晚
**背景**：模板配置功能部署到 5.60 服务器（MySQL）后，创建模板报 500。
**处理过程**：
1. ✅ 定位根因 — MySQL 的 aiomysql 驱动不接受 Python dict 作为 SQL 参数（`TypeError: dict can not be used as parameter`），`_validate_config()` 返回的 dict 直接赋给了 `config` Text 列
2. ✅ 修复 — `create_template()` 和 `update_template()` 中 `json.dumps(config, ensure_ascii=False)` 序列化
3. ✅ 补全本地注册 — 本地 `main.py` import + include_router `report_template`，`models/__init__.py` import + `__all__`（服务器早已注册，本地遗漏）
4. ✅ 部署验证 — 上传修复后 `docker restart plat-auto-test-app`，创建"默认模板"（空 config 自动合并全量默认）+ "精简模板"（自定义章节开关/字体）均 200，列表返回正确，默认标记切换正常
5. ✅ Git 提交推送 — `ce2c75de`（20 文件，3118 增 / 691 删）已 push origin/platform-auto-test
**验证结果**（5.60 服务器实测）：
```
POST /templates {"name":"默认模板","is_default":true,"config":{}} → 200，自动合并完整默认配置
POST /templates {"name":"精简模板","config":{"chapters":{"attachments":false,"appendix":false},"word_style":{"font_name":"微软雅黑","font_size":10.5}}} → 200，覆盖生效
GET /templates → 返回 [精简模板(id=2), 默认模板(id=1, is_default=true)]
```
### 任务 4：功能测试用例 Excel 格式适配 — 2026-08-17
**背景**：新的测试用例文件「大亚湾一体化会议系统测试用例-260811.xlsx」与现有模板格式存在差异：
1. **多 Sheet 结构**：文件包含 3 个 Sheet（预约会议 / 会议看板 / 会议室管理），需全部读取合并
2. **新增测试结果枚举**：Sheet 中出现 `"功能验证"` 值（语义 = 通过），映射表未识别
3. **损坏的 autoFilter XML**：Excel 文件中的 autoFilter 包含非数字/非通配符的 filter val 值，导致 openpyxl 报错
**处理过程**：
1. ✅ 编写 PRD — `Docs/PRD/功能测试/需求文档/_PRD_功能测试用例Excel适配.md`
2. ✅ 编写计划执行文档 — `Docs/PRD/功能测试/需求文档/_PRD_功能测试用例Excel适配_计划执行.md`
3. ✅ 实施代码改动（3 项）：
| 改动 | 文件 | 说明 |
|------|------|------|
| 多 Sheet 遍历 | `excel_reader.py` → `read_test_cases()` | `wb.active` → 遍历 `wb.sheetnames` 所有 Sheet |
| 损坏 autoFilter 自动修复 | `excel_reader.py` → 新增 `_fix_excel_auto_filter()` | 检测到 openpyxl 报错后，通过 zipfile + lxml 移除损坏的 `<autoFilter>` 元素 |
| 新增"功能验证"映射 | `excel_reader.py` → `normalize_test_result()` | `pass_aliases` 新增 `"功能验证"` |
**验证结果**：
```
3 个 Sheet 全部正确读取
- 预约会议: 133 条
- 会议看板: 277 条
- 会议室管理: 77 条
合计: 487 条，171 个模块
测试结果分布（文件 C13 列数据）：
- 空值（公式未缓存）: 353 条
- 未验证: 132 条
- 存在疑问: 1 条
- 需规未输出: 1 条
normalize_test_result("功能验证") → '通过' ✅
旧格式兼容（单 Sheet 文件）→ 正常读取 ✅
```
**⚠️ 注意**：当前文件中测试结果列（C13）大部分为空（353/487），这是因为原始 Excel 使用了公式引用而非缓存值，`data_only=True` 模式无法获取计算结果。需要填写测试结果后再上传生成报告。
### 任务 5：功能测试报告模板优化（章节编号动态化等）— 2026-08-17
**背景**：模板配置打开/关闭章节后，主章节编号（一、二…十）和子章节前缀（1.1 / 2.1…）仍按固定序号输出，关闭章节后出现跳号（如直接"一、五、六"）。
**需求文档**：`Docs/PRD/功能测试/需求文档/_PRD_功能测试报告模板优化.md` + `_计划执行.md`（T1-T5，P0/P1）
| 范围 | 优先级 | 内容 |
|------|--------|------|
| T1 | P0 | 主章节编号动态化（一、二…按启用的章节连续编号） |
| T2 | P0 | 子章节编号动态化（前缀 `{ch_idx}.N` 跟随主章节） |
| T3 | P1 | 模板描述字段（≤200 字符，列表副标题 + 表单可编辑） |
| T4 | P1 | 模板复制功能（`POST /templates/{id}/duplicate`，名称 `_副本`/`_副本N`） |
| T5 | P0 | 向后兼容（全开时编号与改造前一致；旧模板无描述回退 `""`） |
**实施改动**（6 后端 + 2 前端文件）：
| 文件 | 改动 |
|------|------|
| `word_generator.py` | 新增 `_ZH_NUM_MAP`/`_zh_num()`，10 主章节 `_zh_num(ch_idx)` + 27 子章节 `{ch_idx}.N` |
| `markdown_generator.py` | 新增 `_ZH_NUM_MAP`/`_zh_num()`/`_title()`，同样动态化 |
| `models/report_template.py` | 新增 `description` 列（String(200)），`to_dict()`/`to_list_item()` 输出 |
| `schemas/report_template.py` | Create/Update 请求 + List/Response 增加 `description` |
| `routers/report_template.py` | create/update 支持 description；新增 duplicate 端点 |
| `database.py` | `columns_to_add` 增加 `report_templates.description`（旧库迁移） |
| `frontend/src/api/reportTemplate.ts` | description 字段 + `duplicate()` 方法 |
| `TemplateConfig.vue` | 模板描述 textarea + 列表副标题 + 复制按钮 |
**验证结果**（`临时目录/_verify_numbering.py` 全绿）：
```
PASS 1: _zh_num 工具函数（1-10 中文数字 + 超出回退阿拉伯数字）
PASS 2A: 全章节开启编号与改造前一致（一~十 / 1.1~10.4）
PASS 2B: 关闭"报告基本信息"后编号自动前移（二→一、子章节 2.1→1.1）
PASS 2C: 关闭中间章节（图表分析）编号连续无跳号（附录→九）
PASS 2D: Word 报告 34 个 Heading 编号正确（一、报告基本信息 / 1.1 报告标识 / 10.4 修订历史）
PASS 3A-3F: description 创建/更新/列表持久化 + 复制（_副本/_副本2、描述继承、is_default=False）+ 旧模板回退 ""
```
前端 `vue-tsc` 类型检查：修改文件无错误 ✅
### 参考工具 bug 修复记录
| # | 问题 | 根因 | 修复 |
......@@ -355,6 +449,44 @@ ERP 请求参数：超时 30s，最多重试 3 次（间隔 5s），4xx 错误
| **生成报告模板选择** | ✅ FunctionalReport.vue | 新增模板下拉选择器，生成时传入 template_id |
| **部署至 5.60 服务器** | ✅ 验证通过 | Docker 容器健康运行，`GET /api/functional-report/templates` 返回 `[]` |
| **缺失文件补传** | ✅ 已修复 | `performance_output.py` / `api_preset.py` / `api_preset_schema` / `api_preset_service` 一并补传 |
| **模板创建 500 修复** | ✅ 2026-08-13 已修复 | MySQL 下 config Text 列 dict→JSON 序列化（`json.dumps`），验证创建/列表/默认标记全部正常 |
| **Git 提交推送** | ✅ `ce2c75de` | 20 个文件（3118 增 / 691 删），已 push 到 origin/platform-auto-test |
| **Excel 格式适配** | ✅ **2026-08-17 完成** | 多 Sheet 遍历 + 损坏 autoFilter 自动修复 + "功能验证"结果映射，3 Sheet 共 487 条全部读取，旧格式兼容 |
---
## 六·五、Excel 格式适配详情（2026-08-17）
### 背景与需求文档
| 文档 | 说明 |
|------|------|
| `Docs/PRD/功能测试/需求文档/_PRD_功能测试用例Excel适配.md` | 需求文档（E1 多Sheet读取 / E2 "功能验证"映射 / E3 向后兼容 / E4 数据验证） |
| `Docs/PRD/功能测试/需求文档/_PRD_功能测试用例Excel适配_计划执行.md` | 计划执行文档（3 个 Phase） |
| `临时目录/大亚湾一体化会议系统测试用例-260811.xlsx` | 新格式样例文件（参考文件，勿删除） |
### 代码改动
| 改动 | 文件位置 | 说明 |
|------|---------|------|
| 多 Sheet 遍历 | `excel_reader.py` `read_test_cases()` | `ws = wb.active` → `for sheet_name in wb.sheetnames:` 循环 |
| autoFilter 修复 | `excel_reader.py` 新增 `_fix_excel_auto_filter()` | 先尝试正常 `load_workbook`，失败则 zipfile 解包移除损坏 `<autoFilter>` 元素，写临时文件 |
| 结果映射 | `excel_reader.py` `normalize_test_result()` | `pass_aliases` 新增 `"功能验证"` |
| 临时文件清理 | `excel_reader.py` `read_test_cases()` 尾部 | 修复过的情况下 `os.remove(safe_path)` |
### 验证结果（2026-08-17 实测）
```
[Sheet] 预约会议 → 133 条(未验证 11)
[Sheet] 会议看板 → 277 条(未验证 44, 存在疑问 1, 需规未输出 1)
[Sheet] 会议室管理 → 77 条(未验证 77)
合计 487 条 · 171 个模块 · 3 个 Sheet 全部读取 ✅
normalize_test_result("功能验证") → '通过' ✅
旧格式回归（单 Sheet 模板文件）→ 无影响 ✅
```
**遗留说明**：C13 测试结果列 353 条为空——原始文件用公式而非缓存值，`data_only=True` 拿不到结果；需在 Excel 中填写测试结果后重新上传生成报告。
---
......@@ -364,14 +496,12 @@ ERP 请求参数：超时 30s，最多重试 3 次（间隔 5s），4xx 错误
| 优先级 | 待办 | 说明 |
|--------|------|------|
| **P0** | 后端启动验证 | 启动后端服务，用示例 Excel 测试完整流程（上传→生成→下载） |
| **P0** | 前端联调验证 | 启动前端服务，访问 `/reports/functional`，确认上传/生成/下载/预览正常，ERP 配置页加载/保存正常 |
| **P0** | 模板配置验证 | 创建模板 → 编辑模板 → 设为默认 → 删除模板 → 生成报告时选择模板，确认样式生效 |
| **P1** | 系统设置页 ERP 配置 | 在 Settings.vue 中增加 ERP 配置项（API Key/URL/默认测试单 ID） |
| **P1** | 部署自动检查 | 增加一个部署前自动检查脚本，检测 `routers/__init__.py` 未 export 的模块，避免容器启动失败 |
| **P2** | 前端页面加载状态细化 | 上传/生成过程中的 loading 状态、进度提示等 |
| **P2** | 报告历史管理 | 支持查看历史报告列表、删除、重新生成 |
| **P3** | 批量生成 | 支持多项目批量生成报告 |
| **P3** | 「大亚湾」Excel 实际生成报告验证 | 需先在 Excel 中补全 C13 测试结果列（当前 353/487 为空，公式未缓存），再走前端上传→生成→ERP 全流程验证 |
### 踩坑记录
......@@ -389,6 +519,8 @@ ERP 请求参数：超时 30s，最多重试 3 次（间隔 5s），4xx 错误
| F10 | 部署脚本 Python SyntaxError | `replace('\', '/')` 反斜杠未转义 | 改用 `os.sep` 或 `replace('\\\\', '/')` |
| F11 | **服务器 API 路由未更新（重点）** | 部署时以为宿主机直跑 uvicorn，实际是 **Docker 容器**（`plat-auto-test-app`）在跑 | **必须 `docker restart plat-auto-test-app` 而非宿主 pkill**，且宿主 `/data/.../backend/` 是容器挂载卷，直接改文件即生效 |
| F12 | **容器启动失败 ImportError** | 服务器后端缺少本地已有的 `performance_output.py`/`api_preset.py` 及 `api_preset` schema/service（routers/__init__.py 不 export，靠 main.py 直接导入） | 补传缺失文件后再 `docker restart`，成功恢复 healthy |
| F13 | **创建模板 500 `TypeError: dict can not be used as parameter`** | MySQL 的 aiomysql 驱动不接受 Python dict 作为 SQL 参数：`_validate_config()` 返回 dict，直接赋给 `config` Text 列。SQLite 不校验类型所以本地从未报错 | 赋模型前 `json.dumps(config, ensure_ascii=False)` 序列化为 JSON 字符串（create 和 update 两处都要改），读侧 `to_dict()` 已 `json.loads` 无需改 |
| F14 | **本地 main.py 未注册 report_template 路由** | 之前只改了服务器上的 main.py（已注册），本地 `main.py` 和 `models/__init__.py` 忘记同步注册 | 本地/服务器都要注册：main.py import + include_router，models/__init__.py import + __all__ |
---
......@@ -495,11 +627,13 @@ frontend/src/views/functional-report/FunctionalReport.vue — 2026-08-13 新增
frontend/src/views/functional-report/index.vue — 2026-08-13 注释更新
```
### 文档（2 个文件）
### 文档（4 个文件）
```
Docs/PRD/功能测试/需求文档/_PRD_功能测试报告模块.md
Docs/PRD/功能测试/需求文档/_PRD_功能测试报告模块_计划执行.md
Docs/PRD/功能测试/需求文档/_PRD_功能测试用例Excel适配.md — 2026-08-17 新增
Docs/PRD/功能测试/需求文档/_PRD_功能测试用例Excel适配_计划执行.md — 2026-08-17 新增
```
---
......
HANDOFF.md
浏览文件 @ f3035587
......@@ -17,7 +17,7 @@
**当前多窗口状态**：本项目有多个窗口分工开发，交接文档分散在：
- `HANDOFF_自动化部署测试.md` — 自动化部署测试模块（最新，本次会话）
- `HANDOFF_功能测试报告.md` — 功能测试报告模块
- `Docs/PRD/功能测试/交接文档/HANDOFF_功能测试报告.md` — 功能测试报告模块
- `HANDOFF.md`（本文档）— **UI自动化用例录入优化 + 执行引擎死锁修复 + P1端到端验证通过**
- `HANDOFF_V2部署升级.md` — V2 部署详细交接
- `HANDOFF_UI自动化.md` — UI 自动化测试模块
......
HANDOFF_UI自动化.md
浏览文件 @ f3035587
# HANDOFF — UI自动化测试交接文档
> **生成时间**: 2026-08-12
> **生成时间**: 2026-08-17
> **当前分支**: `platform-auto-test`
> **最近提交**: `09346c8e` feat(element-mapping): 元素映射表扩展至v1.2 新增登录页+会议预约子页面共220元素
> **状态**: 🟡 **Phase 4 登录检测缺陷阻塞——新建会议用例步骤10（会议名称填充）因无法进入子页面而失败，待修复登录态检测逻辑**
> **最近提交**: `236b3f3b` feat(security): 安全测试 ERP 配置/上传/任务创建全链路对接
> **状态**: 🟠 **步骤12 映射错配已修复（本地验证通过），待部署到 5.60 后端到端重跑**
---
## 📊 会话进度记录
### 2026-08-12 会话 13：会议室选择修复 + 新阻塞（Phase 4 登录检测失效）
### 2026-08-17 会话 17：步骤12"时间切换为：预定会议"映射错配修复（P0 #2 闭环）
**会话目标**：修复"会议管理-新建会议-czj录入"用例步骤12（`时间切换为：预定会议`）失败问题，确保 21 步用例可端到端跑通。
**执行结果**（服务器 5.60 任务 `exec_59275a65b80040beb0491a57b4fb79dc`）：
| 步骤 | 状态 | 说明 |
|------|------|------|
| 1-6 | ✅ passed | 登录全流程 |
| 7-9 | ⏭ skipped | 页面直达导航 |
| 10 | ✅ passed | 填会议名称 |
| 11 | ✅ passed | 会议室选择（P0 #1 已修复生效） |
| **12** | ❌ **failed** | `✗ 无法点击元素（已尝试 2 个选择器）: ['.select_date .el-date-picker[type=datetimerange]', '.el-tabs__item:has-text("预定会议")']` |
| 13-21 | ⏭ skipped | 前置失败跳过 |
#### 1. 步骤12 失败根因分析 🔴
**现象**：`时间切换为：预定会议` 映射到 `.select_date .el-date-picker[type=datetimerange]`（推断为"会议列表-全部-时间"跨页条目），回退 `.el-tabs__item:has-text("预定会议")` 也超时（212s = 2次5s×多轮重试）。
**根因链**：
1. **映射错配**：步骤名 `时间切换为：预定会议` 被 jieba 分词为 `时间`+`切换为`，"切换为"无语义，仅剩"时间"弱匹配 → 命中 `会议列表-全部-时间`（跨页面层级）
2. **页面真实结构**：创建会议页时间按钮是 `<div class="time_btn">` 内两个 `.btns`（`立即开始`=button_active / `预定会议`），**不是** el-tabs 也不是 `.select_date .el-date-picker`
3. **回退选择器无效**：`.el-tabs__item:has-text("预定会议")` 在 DOM 中不存在（页面用 `.btns`，非 `el-tabs`）
4. **原有的"创建会议-选择时间"条目 `.time_btn .btns` 有缺陷**：会点到第一个 `立即开始` 按钮，无法定位第二个"预定会议"
#### 2. 真实 DOM 确认（实测直连 192.168.5.44）
```html
<div class="time_btn">
<div class="btns button_active">立即开始</div>
<div><div class="btns">预定会议</div></div> <!-- 用 :last-child 定位 -->
</div>
```
- `.time_btn > div:last-child .btns` → 精准命中"预定会议" ✅ 实测点击成功，激活态切换
- `.time_btn .btns.button_active` → "立即开始"
- **实测发现**：`:has-text("预定会议")` 定位同一节点却点击超时（Playwright has-text 行为问题），用结构选择器 `:last-child` 稳定成功
**点击"预定会议"后页面变化**：出现 `会议开始时间`（placeholder 选择时间）、`开始日期`、`结束日期` 输入框，时长选择保留，会议室列表刷新。
#### 3. 修复内容 ✅
**文件1**：`backend/app/services/element_mapping_service.py`
| 改动 | 位置 | 说明 |
|------|------|------|
| 规范化"时间切换为/选择为" | `_clean_step_name()` / `_clean_step_name_without_elem()` | `时间(切换为\|选择为)[：:]\s*` → `__SELECT_TIME__-`（占位符保护，两函数同步） |
| "预定会议"加分 | `_exact_match()` | 步骤含"预定会议"且key含"预定会议" +20.0 |
| "立即开始"加分 | `_exact_match()` | 步骤含"立即开始"且key含"立即开始" +20.0 |
| 时间族兜底加分 | `_exact_match()` | 步骤含"切换为/选择为"且key含 预定会议/立即开始/选择时间 +10.0 |
**文件2**：`backend/app/data/elements_mapping.json`（新增 2 个条目）
```json
"创建会议-预定会议": { "selector": ".time_btn > div:last-child .btns", "tier": "会议预约-创建会议" },
"创建会议-立即开始": { "selector": ".time_btn .btns.button_active", "tier": "会议预约-创建会议" }
```
#### 4. 验证结果 ✅
| 步骤名 | 命中映射键 | 选择器 |
|--------|-----------|--------|
| 时间切换为：预定会议 | 创建会议-预定会议 | `.time_btn > div:last-child .btns` |
| 时间切换为：立即开始 | 创建会议-立即开始 | `.time_btn .btns.button_active` |
| 点击选择时间 | 创建会议-选择时间 | `.time_btn .btns`（回归正常） |
| 会议室选择：北京展厅会议室 | 创建会议-会议室选择 | `.el-checkbox`（回归正常） |
- ✅ 9/9 单元测试通过（`tests/test_element_mapping_service.py`）
- ✅ 实测 `.time_btn > div:last-child .btns` 点击成功，激活态切到"预定会议"
- ✅ 点击后出现开始日期/结束日期/选择时间输入框
#### 5. 下一步待办
- [ ] **部署本修复到服务器 5.60**（element_mapping_service.py + elements_mapping.json 需 scp 上传 + 重启容器）
- [ ] **端到端重跑 21 步用例**（任务 #3）——步骤 12 已修，但需验证 13-21 步骤
- [ ] **修复步骤 13-21 剩余映射问题（P1）**：
| 步骤 | 当前误配 | 期望 |
|------|---------|------|
| 步骤13 会议议题输入 | 创建会议-新建会议 | 议题输入框（.topic_item input） |
| 步骤14/16 编辑按钮/完成按钮 | 会议室-区域树 | 参会人配置抽屉按钮 |
| 步骤15 勾选用户 | 创建会议-会议室选择 | 参会人表格复选框 |
| 步骤17/21 确定创建/确定删除 | 筛选-确定 | 创建会议页底部确定创建按钮 |
| 步骤20 取消会议按钮 | 创建会议-人员配置按钮 | 详情弹窗取消按钮 |
---
### 2026-08-13 会话 15：端到端执行验证——步骤11 会议室选择"假通过"根因分析
**会话目标**：在服务器 5.60 执行"会议管理-新建会议-czj录入"用例（任务 `exec_e2c19edb19884cd6acb40f4bb60411db`），验证 P0 修复效果；针对用户反馈"步骤截图显示会议室未选中但任务标记 passed"进行根因分析，并讨论动态数据定位的架构方案。
**执行结果**：
| 步骤 | 状态 | 耗时 | 说明 |
|------|------|------|------|
| 1-6 | passed | ~10s | 登录流程（含协议勾选） |
| 7-9 | skipped | 0 | Phase 4 直达导航 |
| 10 | passed | 10.99s | 填会议名称"测试会议czj" |
| **11** | **passed（假通过）** | **72.75s** | `✓ 点击: .el-checkbox:has-text("北京展厅会议室")`，但截图显示**未选中** |
| **12** | **failed** | 212.25s | `✗ 无法点击元素（已尝试 2 个选择器）: ['.select_date .el-date-picker[type=datetimerange]', '.el-tabs__item:has-text("预定会议")']` |
| 13-21 | skipped | 0 | 后续步骤因 12 失败跳过 |
#### 1. 步骤11 "假通过"根因分析（本次会话核心发现）🔴
**现象**：步骤 11 标记 passed，但截图显示"北京展厅会议室"复选框**未选中**。耗时 72.75s = 多轮超时耗尽后才"成功"。
**根因链**（`playwright_executor.py` `_do_click()`，lines 1291-1501）：
1. 元素映射表 `创建会议-会议室选择` → 裸 `.el-checkbox` 被注入为**最高优先级**选择器（`playwright_executor.py:1078`）
2. 页面存在**多个** `.el-checkbox`（表头全选、每一行复选框、表单其他开关），Playwright 命中**第一个匹配**（大概率是表头全选）
3. Element UI 表格复选框列带 `is-hidden` 类（视觉隐藏），策略1 普通点击失败（5s 超时）
4. **策略2 force 点击**（`playwright_executor.py:1418`）：`force=True` 跳过可见性/可点击性检查，直接对隐藏 `<input>` 执行点击 → Playwright 判定"成功" → 提前 `return`
5. **点击隐藏 checkbox 输入框不触发 Element UI 的 `toggleRowSelection`**（行选中由表格行 click 事件链路触发）→ UI 未选中，代码却记 passed
6. 策略5/6（点表格行回退）因策略2 提前 `return` 而**从未执行**
**结论**：`force=True` 让一个本应失败的点击伪装成"成功"，掩盖了真实失败。
#### 2. 关键新发现（Element Plus 源码核对 + 用户 XPath 分析）🔴
| # | 发现 | 说明 |
|---|------|------|
| 1 | `.el-checkbox:has-text("北京展厅会议室")` **语义错误** | 复选框在 `td[1]`、文字在 `td[2]`，是**兄弟关系**而非父子关系，`has-text` 匹配不到任何元素 |
| 2 | **点表格行也不一定选中** | `tr` 本身无 click 监听，选中由复选框组件 `change` 事件触发；正确做法是**定位到含文字的行，再点行内复选框**：`.el-table__row:has-text("北京展厅会议室") .el-checkbox` |
| 3 | **绝对 XPath 不可用** | 用户提供的前端定位 `//body[1]/.../micro-app[1]/.../tr[1]/td[1]/.../span[1]/span[1]` 依赖绝对位置，动态渲染下排序变化、新增层级、微前端结构调整都会导致失效 |
| 4 | **映射表对动态数据无力** | 映射表只能存静态选择器，会议室名称等**测试数据是动态的**，用例步骤（`params.selector`）才携带具体数据 |
#### 3. 修复方向（未实施，待用户确认）
**短期修复**（`_do_click()`）：
- 策略5 改为点击**行内复选框**：`.el-table__row:has-text("{target_text}")` → `.el-table__row:has-text("{target_text}") .el-checkbox`
- 策略5/6 **移到策略2（force 点击）之前**执行，避免 force 假成功提前 return
- force 点击后加 **before/after 状态校验**（仅限 checkbox 类 + 能爬到 `tr` 的选择器；校验失败不 raise，只继续走后续策略）
**步骤12 修复**（独立问题，HANDOFF 预存映射错配）：
- `.select_date .el-date-picker[type=datetimerange]` 与 `.el-tabs__item:has-text("预定会议")` 均超时，需核对映射条目
**长期方案**（架构层面，已讨论未定）：
- 参数化选择器：业务语义描述（如 `selectTableRow: {column: "会议室名称", value: "{roomName}"}`）替代硬编码选择器
- 数据驱动 + 变量替换（`{roomName}` 占位符，执行时替换）
- 测试数据自建（API 创建/清理，彻底解耦被测系统已有数据）
- 市面主流：数据驱动 / 参数化选择器 / 数据自建 / AI 视觉定位 / 混合策略；推荐先修复策略5跑通用例，再引入参数化
#### 4. 待办事项更新
**新增 P0**：
- [ ] 修复 `_do_click()` 策略5 点行内复选框 + 策略顺序调整（5/6 优先于 force 点击）
- [ ] force 点击后状态校验（before/after 对比，防假通过）
**新增 P1**：
- [ ] 修复步骤12 映射错配（选择会议时间）
---
### 2026-08-14/17 会话 16：新服务器 5.69 自动化部署包验证（从零部署）
**会话目标**：用户将 5.69 恢复快照（回到测试平台未部署状态），通过自动化部署包从零部署验证包的正确性。
**完成内容**：
#### 1. 部署包修复（2 个问题）✅
**问题1：`deploy.sh` 缺少 `mkdir -p "$PROJECT_DIR/deploy"`**
- `deploy.sh` 第 60 行缺少创建 deploy 目录，cp 命令报错
- 修复：在第 59 行后添加 `mkdir -p "$PROJECT_DIR/deploy"`
**问题2：`deploy_execution.py` 的 `script_id` 字段 `nullable=False` 与 `SET NULL` 外键冲突**
- 根因：`ForeignKey("deploy_scripts.id", ondelete="SET NULL")` 与 `nullable=False` 冲突，MySQL 严格模式报错 1830
- 修复：`deploy_execution.py` 第 51 行 `nullable=False` → `nullable=True`
- 已同步到本地仓库和部署包
#### 2. 部署包补全（backend + frontend/dist）✅
**问题**：原始部署包缺少 `backend/` 和 `frontend/dist/` 目录，但 `deploy.sh` 会从 `$SCRIPT_DIR` 复制它们。由于容器 volume 挂载 `/data/third_party/plat-auto-test/backend:/app`，backend 目录为空时 uvicorn 报 `ModuleNotFoundError: No module named 'app'`。
**解决**：
- 从本地仓库复制 `backend/app/` 和 `backend/requirements.txt` 到部署包（~3.1MB）
- 构建前端（`npm run build`，33.8s）后复制 `frontend/dist/` 到部署包
- 通过 paramiko SFTP 上传到 5.69
#### 3. 部署执行与验证 ✅
**环境**：192.168.5.69（KylinOS V10），恢复快照后的干净状态
- 13 个业务容器（cardtable, paperless, uemqx 等）正常运行
- 测试平台目录 `/data/third_party/plat-auto-test/` 不存在（干净状态）
**部署结果**：
| 检查项 | 状态 | 详情 |
|--------|------|------|
| 健康检查 | ✅ HTTP 200 | `/health` 返回正常 |
| 前端访问 | ✅ HTTP 200 | `http://192.168.5.69:8081` 可访问 |
| API 文档 | ✅ HTTP 200 | `/docs` 正常 |
| MySQL | ✅ Healthy | 端口 3307，数据初始化完成 |
| 13 个业务容器 | ✅ 全部正常运行 | 不受影响 |
| 应用日志 | ✅ 启动正常 | 数据库初始化 → 登录模板 → 消息消费循环 |
**部署耗时**：约 28 秒（镜像已加载的情况下）
**关键发现**：
- 部署包需包含 `backend/` 和 `frontend/dist/` 才能正常工作
- `deploy.sh` 的 `mkdir -p "$PROJECT_DIR/deploy"` 修复已生效
- `deploy_execution.py` 的 MySQL NOT NULL+SET NULL 冲突修复已验证
- 问题已记录到 `部署问题记录.md`
---
### 2026-08-13 会话 14：P0 全部修复完成（Phase 4 登录检测 + 会议室选择映射）
**会话目标**：修复两个 P0 阻塞问题——Phase 4 登录检测缺陷导致直达导航不触发，以及"会议室选择"步骤误配到错误层级。
**完成内容**：
#### 1. Phase 4 登录检测缺陷修复 ✅
**文件**：`backend/app/executors/playwright_executor.py`
**问题**：`_detect_login_state()` 仅凭 `.block` 元素是否存在判定登录态。SPA 登录后主页可能无 `.block` 元素，导致 `_is_logged_in` 保持 `False`，Phase 4 直达导航不触发，步骤10在主页找只存在于子应用的输入框而超时。
**根因链**：
1. 步骤6登录点击完成 → `_detect_login_state()` 判定登录（唯一依据是 `.block` 存在）
2. 登录后主页无 `.block` → `_is_logged_in` 保持 `False`
3. Phase 4 要求 `self._is_logged_in` → `False` → 直达导航跳过
4. 步骤7-9被跳过但页面仍在主页 → 步骤10填充超时
**修复**（`_detect_login_state()` 增强）：
- 新增 `_is_logged_in` 标志位，登录点击成功后（步骤名含"登录"且无报错）设置为 `True`
- 增加辅助检测：登录表单消失（`input[placeholder*="手机号"]` 不可见）、导航栏存在（`.home_nav_left`）、URL 路由变化
- 三项中任一满足即判定为已登录
**部署状态**：已部署到服务器，MD5 验证一致。
#### 2. 元素映射表"会议室选择"条目修复 ✅
**文件**：`backend/app/services/element_mapping_service.py` + `backend/app/data/elements_mapping.json`
**问题**：步骤"会议室选择：北京展厅会议室"误配到 `会议室-区域树`（`.area_block`，属于 `会议预约-会议室` 层级），而非 `创建会议-会议室选择`（`.el-checkbox`，属于 `会议预约-创建会议` 层级）。
**根因**：token 双重计数——"会议室"和"选择"两个 token 都强匹配到映射键关键词"会议室"，导致跨层级条目得分虚高。
**修复内容**（5 项改动）：
| # | 改动 | 位置 | 说明 |
|---|------|------|------|
| 1 | 强匹配去重 | `_exact_match()` | `matched_key_kws` 集合，同一 kk 只计分一次 |
| 2 | 弱匹配去重 | `_exact_match()` | 已强匹配的 kk 不再计入弱匹配 |
| 3 | 完整段加分排除"选择" | `_exact_match()` | 动作词"选择"不单独 +2.0 |
| 4 | 同义词映射 | `SYNONYM_MAP` | `会议室选择 ↔ 勾选会议室` |
| 5 | 步骤规范化 | `_clean_step_name()` / `_clean_step_name_without_elem()` | "选择会议室"/"勾选会议室" → "会议室选择"，避免动作词被剥离后只剩"会议室" |
**新增映射条目**（`elements_mapping.json`，第221个元素）：
```json
"创建会议-会议室选择": {
"selector": ".el-checkbox",
"type": "css",
"tier": "会议预约-创建会议",
"description": "创建会议 - 右侧会议室选择复选框"
}
```
**验证结果**：
- ✅ `会议室选择：北京展厅会议室` → `创建会议-会议室选择`
- ✅ `选择会议室：北京展厅会议室` → `创建会议-会议室选择`
- ✅ `勾选会议室：北京展厅会议室` → `创建会议-会议室选择`
- ✅ 9 个单元测试全部通过
- 已知 3 个预存问题（非本次回归）：
- `点击选择时间` → 会议列表-全部-时间（期望：创建会议-选择时间）
- `点击会议室列表` → 首页-置顶功能-会议室列表（期望：创建会议-会议室列表）
- `勾选房间` → 会议室-时间轴（期望：会议室-房间勾选）
#### 3. 待办事项更新
**P0 待办已全部完成**：
- ✅ Phase 4 登录检测缺陷修复（`_detect_login_state()` 增强）
- ✅ 元素映射表补充"创建会议-会议室选择"条目
- ✅ 映射服务评分去重 + 同义词 + 步骤规范化
**下一步建议**：
- 执行端到端验证：在服务器上跑"会议管理-新建会议-czj录入"用例，确认 21 步全通过
- 修复 3 个预存映射问题（补充缺失条目或调整优先级）
- 代码 commit 到远程仓库
**会话目标**：修复目标用例"会议管理-新建会议-czj录入"步骤11（会议室选择）失败问题——`.area_block` 与 `.el-checkbox:has-text("北京展厅会议室")` 均无法点击。
......@@ -1832,110 +2108,29 @@ python backend/scripts/test_smart_locate_api_direct.py
### 高优先级 (P0)
- [x] **实现用例串行执行机制** ✅ (2026-08-06)
- 添加全局执行锁，确保同一时间只有一个 UI 执行任务运行
- 新增 `GET /api/executions/running-status` API
- Execution 模型新增 `error_message` 字段
- 提交：`e0fb59f9`
- [x] **排查会议管理、通知公告菜单点击失败问题** ✅ (2026-08-06)
- 根因：功能中心抽屉内不存在"会议管理"和"通知公告"菜单名称
- 修正：会议管理 → 会议列表，通知公告 → 通知统计
- 更新 `menu_mapping.py` 直接菜单列表
- 提交：`e0fb59f9`
- [x] **排查 Docker headless 环境下用例执行失败问题** ✅ (2026-08-06)
- 根因：`query_selector()` 预检测在页面渲染完成前返回 None
- 修复：移除预检测，直接使用 `page.click()` + JS click 回退
- 新增诊断脚本 `debug_headless_click.py`
- [x] **修复智能定位微前端支持缺失** ✅ (2026-08-06)
- 根因：智能定位未遍历 iframe/微前端容器
- 修复：`keyword_matcher.py` 新增 iframe 元素遍历
- 验证：步骤9"新建会议按钮"定位成功
- [x] **实现 Claude 语义增强功能** ✅ (2026-08-06)
- PRD：`Docs/PRD/需求文档/用例管理/_PRD_智能定位Claude语义增强.md`
- 执行计划：`Docs/PRD/需求文档/用例管理/_执行计划_智能定位Claude语义增强.md`
- 调研报告：`Docs/PRD/需求文档/用例管理/_调研报告_AI自动化测试智能定位技术对比.md`
- 已实现并部署到服务器 192.168.5.60
- 支持本地/SSH/容器内3种 Claude CLI 调用方式
- 已验证：系统设置用例 6/6 步骤定位成功
- 提交：`85b7cb33`, `208d5e63`, `8cbb2e68`
- [x] **智能定位准确率提升 Phase 1-6 实现** ✅ (2026-08-06)
- Phase 1: jieba分词关键词提取优化
- Phase 2: 评分体系归一化
- Phase 3: Playwright语义定位器支持
- Phase 4: 组合选择器生成
- Phase 5: Claude语义增强优化
- Phase 6: iframe/微前端选择器穿透
- 提交：`c632f219`, `5d261143`
- [x] **端到端验证 Phase 1-6 改动** ✅ (2026-08-07)
- 模块导入验证 7/7 通过
- 各Phase功能验证通过（jieba分词/评分归一化/语义定位器/组合选择器/Claude增强/iframe穿透）
- 智能定位API响应正常
- [x] **部署 Phase 1-6 到服务器 192.168.5.60** ✅ (2026-08-07)
- SFTP上传6个改动文件
- 重建Docker镜像（含jieba依赖）
- 修复EMQX权限问题
- 服务健康检查通过
- [x] **排查执行任务 exec_5f48bf8852b54c5299fd7dd470aa4d83 失败原因** ✅ (2026-08-07)
- 用例：会议管理-新建会议-czj录入
- 步骤9点击"新建会议"可能点错元素（`div:visible:has-text` 太宽泛）
- 步骤10 `input:visible` 回退选择器匹配到错误元素
- 确认中文乱码不影响定位（只影响截图显示）
- [x] **分析智能定位选择器不准的5个核心缺陷** ✅ (2026-08-07)
- 缺陷1：回退选择器太宽泛（`input:visible`）
- 缺陷2：文本匹配不分元素类型（`div:visible:has-text` vs `button:has-text`）
- 缺陷3：无页面状态感知（点击后不验证弹窗是否打开）
- 缺陷4：选择器生成无上下文限定（无父容器范围）
- 缺陷5：用例数据本身有错（空选择器/错误选择器）
- [x] **修复智能定位选择器生成5个核心缺陷**（方案A）✅ (2026-08-10)
- 修复 `find_element_by_semantic` fill 回退：placeholder 关键词匹配
- 文本匹配优先限定元素类型：button > div
- 步骤执行后验证页面状态 + 执行级联
- 选择器生成加父容器上下文限定（`_detect_parent_container`）
- [x] **部署修复代码到服务器 192.168.5.60** ✅ (2026-08-10)
- SFTP上传 `keyword_matcher.py` 和 `smart_locate_service.py`
- 重启后端容器，健康检查通过
- [x] **方案1（元素映射表）分析 + PRD/执行计划输出** ✅ (2026-08-11)
- 对比方案1（前端key-value键值）vs 方案2（坐标定位），采纳方案1
- 解析前端元素定位键值表（新版本，100+元素，data-key/data-id/id稳定定位）
- 确认实验用例 `case_13650e0406e64779b66e6fa5de35c24a` 与验证范围（登录→功能中心→模块点击）
- PRD：`Docs/PRD/需求文档/用例管理/_PRD_元素映射表定位方案_前端key-value键值_提升定位稳定性.md`
- 执行计划：`Docs/PRD/需求文档/用例管理/_执行计划_元素映射表定位方案_前端key-value键值.md`
- [x] **实现方案1：元素映射表定位** ✅ (2026-08-11 完成)
- Phase 1: 生成映射表 JSON（`backend/app/data/elements_mapping.json`）✅
- Phase 2: 实现 `ElementMappingService`（3层匹配）✅
- Phase 3: 集成到 `playwright_executor.py`（最高优先级选择器来源）✅
- Phase 4: 本地验证 13/13 集成 + 9/9 单测 + 部署到服务器 ✅
- 映射表优先级：`element_mapping > data-testid > data-key/data-id > id > css > xpath > keyword_match > smart_locate`
- 评分公式修复：强匹配/弱匹配模型解决"会议预约"歧义
- [x] **实现方案1：元素映射表定位** ✅ (2026-08-11)
- [x] **`_do_click()` 新增策略5/6（Element UI 表格行选择回退）** ✅ (2026-08-12)
- 策略5：从 `:has-text("xxx")` 提取文本，点击 `.el-table__row:has-text("xxx")` / `tr:has-text("xxx")`
- 策略6：裸 `.el-checkbox` / `.el-checkbox__inner` 时，JS 向上找 `closest('tr, .el-table__row')` 点击行
- 已部署到服务器，但被 Phase 4 登录检测缺陷阻塞而无法验证
- [ ] **修复 Phase 4 登录检测缺陷：`_detect_login_state()` 增强** ⚠️ **P0**
- 问题：`_is_logged_in` 保持 False，因为 `.block` 元素登录后未找到
- 方案(a)：增强 `_detect_login_state()`——增加辅助信号（登录表单消失 / `.home_nav_left` 存在 / URL 路由变化）
- 方案(b)：登录成功后（步骤名含"登录"且无报错）无条件触发 Phase 4 导航
- 方案(c)：兜底——若 skip_orders 命中但 Phase 4 未导航，强制 `goto` 目标 URL
- **阻塞步骤10的根因，修复后需验证策略5/6**
- [ ] **元素映射表补充"会议预约-创建会议"层级的"会议室选择"条目** ⚠️ **P0**
- 当前"会议室选择：北京展厅会议室"误配到 `会议预约-会议室` → `会议室-区域树` → `.area_block`
- 需新增创建会议页面的房间选择表格选择器（`.el-table` / `.el-table__row`）
- 修复后配合策略5/6验证
- [x] **修复 Phase 4 登录检测缺陷：`_detect_login_state()` 增强** ✅ (2026-08-13)
- [x] **元素映射表补充"会议预约-创建会议"层级的"会议室选择"条目** ✅ (2026-08-13)
- [x] **端到端执行"新建会议"用例（任务 exec_e2c19edb...）** ✅ 已执行，但**发现问题**：步骤11 假通过（passed 但未选中）、步骤12 失败（2026-08-13）
- [ ] **修复 `_do_click()` 步骤11 假通过（2026-08-13 会话15 新增）**
- 策略5 改为点击**行内复选框**：`.el-table__row:has-text("{target_text}") .el-checkbox`
- 策略5/6 **移到策略2（force 点击）之前**执行，避免 force 假成功提前 return
- force 点击后加 **before/after 状态校验**（仅限 checkbox 类 + 能爬到 `tr` 的选择器；校验失败不 raise，只继续走后续策略）
- 根因详见会话 15 记录
- [ ] **执行器集成智能定位能力**（方案A，原推荐；已被方案1替代优先级）
- 改造 `playwright_executor.py`，选择器失败时实时调用 `match_element_by_keywords`/`find_element_by_semantic`
......@@ -1948,9 +2143,11 @@ python backend/scripts/test_smart_locate_api_direct.py
### 中优先级 (P1)
- [x] **模块选择器添加搜索功能** ✅ (2026-08-06)
- 前端模块树选择器添加 `filterable` 和 `clearable`
- 模块层级调整：会议管理等从子模块调整为一级
- 提交：`54c0b13d`
- [ ] **修复 3 个预存映射问题**（2026-08-13 确认非本次 P0 回归）
- `点击选择时间` 误配 → `会议列表-全部-时间`（期望：创建会议-选择时间）
- `点击会议室列表` 误配 → `首页-置顶功能-会议室列表`（期望：创建会议-会议室列表）
- `勾选房间` 误配 → `会议室-时间轴`（期望：会议室-房间勾选）
- 可通过补充映射条目或调整评分解决
- [ ] **重新智能定位会议管理用例，补全空选择器步骤**
- 用例 ID：`case_13650e0406e64779b66e6fa5de35c24a`
......@@ -1958,6 +2155,14 @@ python backend/scripts/test_smart_locate_api_direct.py
- 现可使用 Claude 增强智能定位补全
- ⚠️ 需先修复选择器生成5个核心缺陷（方案A），再重新定位（方案B）
- [ ] **执行服务器端到端验证：新建会议用例 21 步全通过**（2026-08-13 已执行一轮，发现步骤11 假通过 + 步骤12 失败）
- 需先修复步骤11 假通过（策略5 行内复选框 + 策略顺序调整）与步骤12 映射错配
- 修复后重新执行，确认 21 步全通过
- [ ] **修复步骤12 映射错配（选择会议时间）**（2026-08-13 会话15 新增）
- `.select_date .el-date-picker[type=datetimerange]` 与 `.el-tabs__item:has-text("预定会议")` 均超时
- 需核对映射条目，补充"创建会议-选择时间"正确选择器
- [ ] **验证智能定位选择器实际执行效果**
- 智能定位返回的选择器需实际执行用例验证
- 确认选择器能正确点击/输入目标元素
......@@ -1978,7 +2183,7 @@ python backend/scripts/test_smart_locate_api_direct.py
---
*本文档由 Claude Code 于 2026-08-12 更新。*
*本文档由 Claude Code 于 2026-08-13 更新。*
**最后状态**：
- ✅ Phase 1-6 代码实现完成（关键词/评分/语义定位器/组合选择器/Claude增强/iframe穿透）
......@@ -2006,6 +2211,11 @@ python backend/scripts/test_smart_locate_api_direct.py
- ✅ **登录流程 3 缺陷修复（复选框/弹窗确定按钮/登录成功检测）**
- ✅ **execute_case() 从不执行步骤的 CRITICAL bug 已修复（此前假 passed）**
- ✅ **`_do_click()` 新增策略5/6（Element UI 表格行选择回退）已部署**
- ❌ **Phase 4 登录检测缺陷：`_detect_login_state()` 仅凭 `.block` 判定登录，登录后 `_is_logged_in` 保持 False 导致直达导航不触发，步骤10超时**
- ⏳ 待修复 Phase 4 登录检测缺陷（`_detect_login_state()` 增加辅助信号 / 登录后无条件触发导航）
- ✅ **Phase 4 登录检测缺陷已修复：`_detect_login_state()` 增加辅助信号 + `_is_logged_in` 标志位（2026-08-13）**
- ✅ **元素映射表"会议室选择"条目已修复：新增 `创建会议-会议室选择` 条目 + 评分去重 + 同义词 + 步骤规范化（2026-08-13）**
- ✅ **端到端执行"新建会议"用例（exec_e2c19edb...）已完成（2026-08-13）**
- 🔴 **发现步骤11 会议室选择"假通过"：passed 但未选中**——根因：映射表裸 `.el-checkbox` 注入 + 策略2 force 点击跳过隐藏复选框 + 点击隐藏 input 不触发 toggleRowSelection + 策略5/6 未执行（2026-08-13 会话15）
- 🔴 **发现步骤12 失败**：`.select_date .el-date-picker[type=datetimerange]` 与 `.el-tabs__item:has-text("预定会议")` 均超时（映射错配，预存问题）
- ⏳ **待实施修复：策略5 改点行内复选框 + 策略5/6 优先于 force 点击 + force 后状态校验，然后重新执行端到端验证**
- ⏳ 待修复 3 个预存映射问题（选择时间/会议室列表/房间勾选）
- ⏳ 待 push 代码到远程仓库
\ No newline at end of file
HANDOFF_性能测试.md
浏览文件 @ f3035587
# HANDOFF_性能测试
> 生成时间：2026-08-12 15:00
> 最后更新：2026-08-17 13:45
> 当前分支：`platform-auto-test`
> 最近提交：`09346c8e feat(element-mapping): 元素映射表扩展至v1.2`
> 最近提交：`ce2c75de feat: 功能测试报告新增模板配置功能（多模板管理）`
> 主分支：`master`
---
......@@ -15,7 +16,111 @@
| Phase 2 - 压测执行引擎 | ✅ 完成 | 轻量级 asyncio + aiohttp 自研引擎 |
| Phase 3 - 后端路由 + Service | ✅ 完成 | 11 个 API 路由 + Service 层 |
| Phase 4 - 前端页面 | ✅ 完成 | 任务管理/监控/报告 三个面板 |
| Phase 5 - 集成测试 | ⏳ 待做 | 端到端验证（创建→执行→监控→报告） |
| Phase 5 - 集成测试 | ✅ 完成核心 | 真实 API（会议预约）端到端验证通过（2026-08-17） |
| Phase 6 - 响应捕获 + 跨任务引用 | ✅ 完成核心 | capture_rules + performance_task_outputs + REF 占位符（2026-08-17） |
---
## 🆕 最新会话进度（2026-08-17）
### 本次会话完成的核心工作
#### 1. 「新建会议压测」任务端到端验证通过 ✅
**任务**：`perf_5a1a3b4e00e04b2f96713f4108580d2b`（新建会议压测）
**目标接口**：`PUT https://192.168.5.44/meetingV3/api/message/book`（JWT + X-RANDOM/X-TIMESTAMP/X-SIGN 签名）
**最终配置**：concurrency=2（用户要求 2 线程快速验证）/ duration=15s / rampUp=0 / 时段 +37H~+38H / duration字段=60
**最终验证结果（干净代码，调试日志已清除）**：
| 指标 | 值 |
|------|-----|
| 总请求数 | 169 |
| 成功数 | 169（HTTP 200） |
| 失败数 | 0 |
| 错误率 | 0.0% |
| 实际 TPS | 10.96 |
| 平均响应时间 | 178.41ms（min 145 / max 231） |
| **message_ids 捕获** | ✅ `['2026-0817013311822', '2026-0817013311824']` |
捕获输出 API 验证：`GET /api/performance/tasks/{id}/outputs` → `{"total":1,"items":[{"key":"message_ids","value":[...]}]}`
#### 2. A0027「时间格式不正确」根因定位与修复 ✅（用户反馈的问题）
**现象**：服务日志持续打印 `body={"success":false,"code":"A0027","message":"时间格式不正确"}`，但 HTTP 状态 200 → 统计全"成功"，捕获为空。
**根因（双层）**：
1. **服务器上的 `template_resolver.py` 是旧版本**：`_resolve_token()` 对所有 token 用 `token.split(":")` 分割，而任务占位符是 `NOW_+30_M`（下划线分隔）→ `kind="NOW_+30_M"` 不匹配 `"NOW"` → 占位符**原样发送**（字面量 `{__NOW_+30_M__}`）→ API 返回 A0027。
- 正确版本（本地）：REF 用 `:` 分割，其余（NOW/RANDOM_NAME/RANDOM_INT/UUID/INDEX）用 `_` 分割。
2. **stale `.pyc` 字节码缓存**：修复源码后容器仍加载旧字节码（`__pycache__/template_resolver.cpython-310.pyc` mtime 早于源码修改时间），必须删除 pyc + 重启容器。
**修复步骤（5.60 服务器）**：
```bash
# 1. 通过 paramiko base64 部署正确的 template_resolver.py（本地版本）
# 2. 删除字节码缓存
docker exec plat-auto-test-app sh -c "find /app -name '*.pyc' -delete"
# 3. 重启容器
docker restart plat-auto-test-app
# 4. 验证（容器内）
python3 /tmp/test_tr.py # 输出 NOW: 2026-08-17 12:59:09（带秒）✓
```
**修复后 DBG_RESOLVE 日志确认**：`startTime: '2026-08-17 13:30:02'`（秒精度，占位符已替换）
#### 3. 会议预约 API 业务限制探测（重要经验）
探测脚本（本地 backend/meeting_test25.py 等）验证会议室 `29dcd33aa47797e7d29d79ae6711d597` 的规则：
| 错误码 | 含义 | 触发条件 | 规避方法 |
|--------|------|---------|---------|
| A0027 | 时间格式不正确 | startTime/endTime 非秒精度或占位符未解析 | 修复 resolver（已完成） |
| A0023 | 该时间段已有会议 | 目标时段与已有会议重叠 | 选无人占用时段（如 +37H 凌晨）；**注意探测脚本自己创建的会议也会占用时段** |
| A0026 | 超过会议室可预订的最大时长 | body 中 `duration=120`（该会议室上限 90 分钟） | `duration` ≤ 90 且与 start/end 跨度一致 |
| B0001 | failure | `cnum=""`（不指定会议室） | 必须携带有效会议室 ID |
**预约接口 body 必需字段**：JSON **数组** `[{...}]`、`convergentMediaTypes:"1"`、`companyNumber:"CN-WQF-UBAINS"`（JWT 声明一致）、`uid:8`（数字）、`configValueId:2`（数字）、有效 `cnum`、`participantList:[]`、秒精度时间。
#### 4. 压测任务设计注意事项（同一时段冲突问题）
**发现**：concurrent 模式下所有并发请求解析出**相同的 startTime/endTime**（`{__NOW_+37_H__}` 对所有请求解析结果相同）→ 第一批请求订走时段后，后续请求全部 A0023。
**当前状态**：2 并发时前 2 个请求成功（message_ids 捕获 2 个），其余 A0023（HTTP 200，统计不报错）。
**待优化方案**：给模板解析器增加按请求序号偏移时间的语法，例如 `{__NOW_+37_H_INDEX__}`（每请求 +1 分钟错开时段），需要在 `template_resolver.py` 的 `_resolve_token` 中处理 `parts[3] == "INDEX"` 分支（尚未实现）。
### 响应捕获（capture_rules）链路（本次已全链路验证）
```
任务 capture_rules（JSON）
→ executor._capture_response(rules, body_text, status) # JSONPath $.result[*].messageId 提取
→ self._captured.setdefault(key, []).append(value) # _capture_max=10000 上限
→ result["captured"]（execute() finally 块）
→ service._save_outputs(task_id, captured) # upsert 到 performance_task_outputs 表
→ GET /api/performance/tasks/{id}/outputs # 前端/下游任务读取
```
- 捕获仅在 HTTP 2xx 时执行；`_save_outputs` 空捕获时 early return（不写库）
- `PerformanceTaskOutput` 表（MySQL `performance_task_outputs`）按 task_id+key upsert
- 新增文件：`models/performance_output.py` / `routers/performance_output.py` / `schemas/performance_output.py`
- service 侧 `_save_outputs` 在 `run_task` 的 finally 中调用（此前服务器旧版 service 缺此函数，已部署本地新版修复）
### 服务器（192.168.5.60）部署情况
- 容器：`plat-auto-test-app`（volume mount `/data/third_party/plat-auto-test/backend:/app`，内部端口 80）
- **本次部署的文件**（paramiko + base64 方式，scp 不可用）：
- `app/executors/template_resolver.py` — 正确的 `_` 分割版本（修复 A0027）
- `app/services/performance_service.py` — 含 `_save_outputs` 的新版
- `app/executors/performance_executor.py` — 已含捕获逻辑，临时加过 DBG_RESOLVE/DBG_CAPTURE 调试日志，**现已清除**（验证 grep DBG = 0）
- **部署后处理**：删除全部 `*.pyc` + 重启容器（否则旧字节码仍生效）
- 调试日志补丁模式（本次使用后已移除）：
- `[DBG_RESOLVE]` 在 `_resolve_body` 的 resolve() 调用后打印解析结果
- `[DBG_CAPTURE]` 在 `_capture_response` 开头打印规则/状态/响应体前 200 字符
### 本地会话遗留状态
- 本地 backend 以 `python -m uvicorn app.main:app --port 8001`（无 --reload）方式运行，日志 `/tmp/backend_8001.log`
- 本地验证脚本：`backend/meeting_test22.py` ~ `meeting_test25.py`（探测 API 最小必需字段/时段/时长限制，可复用）
- 本地任务 `perf_f27debe671d84b4fb3908af5beac67ed`（同名任务）尚未做完整验证（服务器版已验证通过）
**后端代码行数**：2173 行（executor 748 + service 588 + router 296 + model 279 + schema 262）
**前端代码行数**：1768 行（index 98 + TaskList 476 + MonitorPanel 459 + ReportPanel 373 + api 121 + types 241）
......@@ -272,19 +377,50 @@ cd backend && uvicorn app.main:app --reload --port 8002
- TS2339: `tasks`/`total` 找不到 → 修复类型定义
- TS2345: `string | null` 不能赋值给 `string` → 修复 `formatTime` 参数类型
### 4. A0027 时间格式不正确（2026-08-17 已修复）
**现象**：会议预约压测全部返回 `{"success":false,"code":"A0027","message":"时间格式不正确"}`，HTTP 200 导致统计显示成功但捕获为空。
**根因**：服务器 `template_resolver.py` 旧版 `_resolve_token()` 用 `token.split(":")` 分割所有 token；任务占位符 `NOW_+30_M` 无冒号 → `kind="NOW_+30_M"` 匹配失败 → 占位符原样发送。本地版本已用 `_` 分割（仅 REF 用 `:`），部署时曾发现更早版本 `_now_str` 为 `%H:%M`（无秒）——两层问题叠加。
**修复**：部署本地正确版 `template_resolver.py` 到 5.60 → 删 `*.pyc` → 重启容器。验证 `_now_str()` → `2026-08-17 12:59:09`。
**踩坑**：
- 源码改了但容器仍旧行为 → stale `__pycache__` 字节码（mtime 早于源码），必须删 pyc + 重启
- 部署方式：paramiko exec + base64（scp 因 UTF-8 内容失败；sshpass 不在 PATH）
- 5.60 容器内部端口是 **80**（不是 8001），`docker port` 查映射
### 5. A0026 超过会议室可预订的最大时长（2026-08-17 定位）
**现象**：任务 body `duration: 120` 时全部返回 A0026。
**根因**：会议室 `29dcd33aa47797e7d29d79ae6711d597` 单次预订上限 **90 分钟**。
**修复**：`duration` 改为 60（与 start/end 跨度一致）。
### 6. A0023 该时间段已有会议（2026-08-17 规避）
**现象**：任务时段与已有会议重叠时全部 A0023。
**根因**：a) 时段本身有真实会议；b) **探测脚本自己创建的会议也占用时段**（探测 + 验证共用同一会议室时极易自我冲突）。
**修复**：改用 +37H/+38H（次日次日凌晨）无占用时段。教训：探测可用性会**污染**日程，探测与正式压测要用不同时段/会议室。
---
## 当前运行状态
### 后端
- 8001 端口：旧进程（含旧代码），无法关闭
- 8002 端口：新后端正常运行 ✅
- `GET /api/performance/tasks` → `{"total":0,"items":[]}` 正常
- `http://localhost:8002/docs` → OpenAPI 包含性能测试路由
### 生产服务器 192.168.5.60（2026-08-17 13:45）
- 容器 `plat-auto-test-app`：healthy，内部端口 80（宿主机 80）
- 部署内容：修复版 `template_resolver.py` + 含 `_save_outputs` 的 `performance_service.py` + 含捕获的 `performance_executor.py`（DBG 调试日志已清除，grep 验证 0 残留）
- 字节码缓存已清理，容器已重启加载新代码
- 任务 `perf_5a1a3b4e00e04b2f96713f4108580d2b` 验证通过（169 请求 / 0 失败 / TPS 10.96 / message_ids 捕获 2 个）
- MySQL 表 `performance_task_outputs` 已存在且有数据
### 前端
- `http://localhost:3000` → 正常
- `npm run build` → 构建通过（34.48s）
### 本地（Windows 开发机）
- 后端：`python -m uvicorn app.main:app --port 8001`（无 --reload，日志 `/tmp/backend_8001.log`）
- 前端：`http://localhost:3000`
- 本地数据库 `data/test_platform.db` 含同名任务 `perf_f27debe671d84b4fb3908af5beac67ed`（待完整回归）
---
......@@ -316,46 +452,38 @@ frontend/src/App.vue (MODIFIED: 添加侧边栏
## 下一步任务
### Phase 5 - 集成测试（P0）
端到端验证流程：
### Phase 5 - 集成测试（✅ 核心已通过，2026-08-17）
1. **创建任务** → POST `/api/performance/tasks`
- 使用 `admin@xty` / `Ubains@13579` / 验证码 `csba`
- 目标 URL：被测系统真实接口（如 `/platform/api/xxx`）
- 模式：concurrent（并发 10，时长 60s）
以下环节已在 5.60 服务器 + 真实会议预约 API 上验证通过：
- 创建/更新任务（PUT 更新 concurrency/duration/body）✅
- 执行任务（`{"message":"任务已开始执行"}` → completed）✅
- 捕获输出落库与查询（`/outputs` 返回 message_ids）✅
- 真实 API 认证（JWT + 签名）+ 模板占位符解析 ✅
2. **执行任务** → POST `/api/performance/tasks/{id}/run`
- 验证返回 `{"message": "任务已开始执行"}`
- 验证状态变为 `running`
仍待验证：
- WebSocket `/api/performance/ws/{task_id}` 实时快照推送
- 前端任务列表/监控图表/报告面板对新数据（outputs）的展示
- 本地任务 `perf_f27debe671d84b4fb3908af5beac67ed` 的完整回归
3. **实时监控** → WebSocket `/api/performance/ws/{task_id}`
- 验证每秒收到快照数据
- 验证 TPS / 响应时间 / 状态码 数据合理
### P0 - 按请求序号错开时间段（并发压测预约类接口的关键）
4. **任务完成** → 等待状态变为 `completed`
- 验证 `error_message` 为 null
- 验证 `actual_tps` 不为 null
**问题**：concurrent 模式下所有请求解析出相同 startTime → 第一批订走时段，后续全部 A0023。
5. **查看报告** → GET `/api/performance/tasks/{id}/report`
- 验证摘要、指标、快照数据完整
- 验证 P50/P90/P99 分位数合理
**方案**：`template_resolver.py` 的 `_resolve_token()` 增加 `INDEX` 后缀支持，如 `{__NOW_+37_H_INDEX__}`（token parts = `["NOW","+37","H","INDEX"]`），解析时在基准时间上再加 `request_index` 分钟。实现位置：`_resolve_token` 的 NOW 分支处理 `len(parts) > 3 and parts[3] == "INDEX"`，需要新增 `_now_with_offset` 的带 index 变体。实现后任务 body 改用该语法即可全并发成功。
6. **查看快照** → GET `/api/performance/tasks/{id}/snapshots`
- 验证快照数量 ≈ 压测时长
### P1 - 修改/取消会议压测任务
7. **前端验证**
- 任务列表显示正确
- 监控面板实时图表渲染
- 报告面板数据展示
- 修改会议：`PUT /meetingV3/api/message/{...}`（需先拿 book 的 messageId → 已可通过 REF 占位符 `{__REF:task_id:message_ids__}` 引用）
- 取消会议：需探测取消接口路径与 body 格式（`meeting_test*.py` 系列脚本可扩展）
### 后续优化（P1）
### P2 - 后续优化
- 断言规则验证（`ResultValidator` 需要在执行中启用）
- 断言规则验证（`ResultValidator` 执行中启用；注意当前 `success:false` + HTTP 200 会被 status_code 断言判成功，建议增加 response_body/JSONPath 断言 `$.success == true`）
- 更详细的错误处理（Token 过期重试、网络错误分类）
- 报告对比功能（多次执行结果对比）
- 批量导出报告
- 压力测试数据清理（定期清理旧快照）
- 压力测试数据清理（定期清理旧快照；探测脚本创建的真实会议也需清理策略）
- schemas/performance.py 服务器版同步：本地 `body_template` 已放宽为 `Optional[Any]`，服务器 schema 若仍为 `Optional[Dict]` 需同步部署
---
......
HANDOFF_设备模拟.md
浏览文件 @ f3035587
# HANDOFF — 设备模拟模块
> **生成时间**: 2026-08-06
> **生成时间**: 2026-08-13
> **当前分支**: `platform-auto-test`
> **最近提交**: `b3b54f03` feat(smart-locate, device-sim): 验证类步骤自动识别 + 设备列表增强
> **最近提交**: `26cc89c5` fix(executor): 登录检测多信号优化与设备模拟按类型批量启停
> **未提交改动**: 设备模拟相关 6 个前端文件 + 文档（见下方"会话 C"修改文件清单）
---
## 📊 会话进度记录
### 2026-08-13 会话 C：环境筛选与统计卡片联动修复（已全部完成并部署）
**会话目标**：修复设备模拟页面筛选 5.202 环境时统计卡片仍显示 540 的问题
**状态**：✅ 全部完成 — 文档 + 代码实现 + 构建 + 部署到 192.168.5.60 + 验证通过
**问题现象**：门口屏模拟页面顶部环境下拉框选择 **192.168.5.202**（0 台设备）后，统计卡片【总设备】仍显示 540。
**根因**（详见问题分析文档）：每台设备模拟页面存在**两套互不联动的环境筛选控件**：
1. **页面顶部下拉框**（`currentEnvId`）→ 变更只刷新统计卡片
2. **DeviceList 内部筛选栏**（`filterEnvConfigId`）→ 变更只刷新设备列表
且 `DeviceList.vue` 未声明 `envConfigId` prop，页面传入的 `:env-config-id` 被静默忽略，页面顶部环境选择无法传递到设备列表。
**后端验证**（确认后端无问题）：
- `door + env_328d4859a59a430ca25835f8d3c06c29(5.202)` → `total:0` ✅
- `door + env_98aea2c545b24aa29e9072e99fbef61c(5.44)` → `total:540` ✅
- `door + 无环境` → `total:540` ✅
**已修复内容**（统一为单一环境源，双向联动）：
1. **`DeviceList.vue`**（公共组件）：
- props 增加 `envConfigId?: string`（可选，不传不影响独立使用）
- emit 增加 `(e: 'env-change', envId: string)`
- `watch(() => props.envConfigId)` 同步到内部 `filterEnvConfigId` 并刷新列表
- 内部筛选栏 `@change` 由 `loadDevices` 改为 `onInternalEnvChange`（刷新列表 + emit `env-change`）
2. **四个 Sim 页面**（`DoorSim.vue` / `PaperlessSim.vue` / `CentralSim.vue` / `ClientSim.vue`）：
- 模板新增 `@env-change="onDeviceEnvChange"`
- 新增 `onDeviceEnvChange(envId)` 方法：同步 `currentEnvId` + `loadStats()`
**联带修复**：`frontend/src/views/functional-report/TemplateConfig.vue` 第 103 行 el-switch v-model 索引类型错误（TS7053），构建 `vue-tsc` 阻塞，已加 `as any` 修复。
**构建部署**：前端 `npm run build` 成功（29.34s，80 个文件），`deploy_frontend_only.py` 部署到 5.60，容器健康。
**部署后验证**（服务器端 grep 构建产物确认）：
- `DeviceList-8m7X4mUz.js`：`emits:["device-changed","env-change"]` + `watch(()=>ee.envConfigId)` 同步逻辑 ✅
- `DoorSim-B__vCye8.js`：VNode 渲染含 `"env-config-id":k.value` + `onEnvChange` 事件绑定 ✅
- `index.html` 引用 `index-Dxn_XUMs.js`（与本地产物 hash 一致，部署为最新）
**修改文件清单（本次会话）**：
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `Docs/PRD/设备模拟/问题处理/问题分析_筛选环境统计卡片不跟随.md` | 新增 | 问题分析文档（两套环境筛选不联动根因） |
| `Docs/PRD/设备模拟/执行计划/执行计划_环境筛选统一联动修复.md` | 新增 | 3 阶段执行计划文档 |
| `frontend/src/components/device/DeviceList.vue` | 修改 | envConfigId prop + watch + env-change emit + onInternalEnvChange |
| `frontend/src/views/device-sim/DoorSim.vue` | 修改 | @env-change 绑定 + onDeviceEnvChange |
| `frontend/src/views/device-sim/PaperlessSim.vue` | 修改 | 同上 |
| `frontend/src/views/device-sim/CentralSim.vue` | 修改 | 同上 |
| `frontend/src/views/device-sim/ClientSim.vue` | 修改 | 同上 |
| `frontend/src/views/functional-report/TemplateConfig.vue` | 修改 | el-switch v-model 索引类型修复（构建阻塞） |
| `deploy_frontend_only.py` | 新增 | 仅前端 dist 部署脚本（会话 B 会话中新增） |
**待办**：
- 本次改动尚未提交 git（连同会话 B 的一起），下次会话可通过 `/GitCommit` 提交
- 建议浏览器硬刷新（Ctrl+F5）验证：选 5.202 → 统计 0；选 5.44 → 统计 540；不选 → 540；DeviceList 内部切换环境与统计卡片同步
---
### 2026-08-13 会话 B：统计卡片修复 + 文档体系重构（已全部完成并部署）
**会话目标**：修复设备模拟页面顶部统计卡片（总设备/运行中/已停止）显示为 0 的问题
**状态**：✅ 全部完成 — 代码实现 + 构建 + 部署到 192.168.5.60 + API 验证通过
**已完成内容**：
#### ✅ 问题分析文档
- **`Docs/PRD/设备模拟/问题处理/问题分析_统计卡片显示为0.md`**
- 4 个根因分析：
1. 后端无专用统计 API（`list_simulators()` 返回分页数据，无法聚合统计）
2. 四个页面的 `onDeviceChanged()` 均为空函数，不响应设备变更
3. `DoorSim.vue` 的 `total`/`runningCount` ref 初始化为 0 且从未更新
4. `PaperlessSim.vue`、`CentralSim.vue`、`ClientSim.vue` 三个页面完全缺失统计卡片 UI
#### ✅ 执行计划文档
- **`Docs/PRD/设备模拟/执行计划/执行计划_统计卡片修复.md`**
- 4 阶段修复方案：
1. 后端新增 `GET /api/device-sim/devices/stats` 统计 API
2. 前端新增 `getDeviceStats()` API 封装和类型定义
3. 统一 4 个页面的统计卡片组件，改为响应式更新
4. 验证部署
#### ✅ 文档体系重组
- 所有设备模拟文档从 `Docs/PRD/需求文档/设备模拟/` 迁移到 `Docs/PRD/设备模拟/`
- 三级子目录：`需求文档/`、`执行计划/`、`问题处理/`
- 共 11 个文档已归类存放
#### ✅ Phase 1：后端统计 API（已完成）
- **`backend/app/schemas/device_sim.py`** — 新增 `DeviceStatsResponse`：
- `total` / `running` / `stopped` 三字段 + `by_type: Dict[str, dict]`（按设备类型分组统计）
- **`backend/app/services/device_sim_service.py`** — 新增 `get_device_stats()` 方法：
- 仅查询 `id, device_type, status` 三列（不加载完整 ORM 对象，性能优化）
- 从 `_running_simulators` 内存字典读取实时运行状态（与 `list_simulators()` 同模式）
- 单次遍历聚合 total/running/stopped + `by_type` 分组
- **`backend/app/routers/device_sim.py`** — 新增 `GET /devices/stats` 端点：
- 参数：`device_type`（枚举 door/paperless/central/client）+ `env_config_id`
- ⚠️ **路由顺序**：`/devices/stats`（第 233 行）必须在 `/devices/{device_id}`（第 472 行）之前注册，否则 `stats` 会被捕获为 device_id
#### ✅ Phase 2：前端 API/类型（已完成）
- **`frontend/src/types/device.ts`** — 新增 `DeviceStats` 接口（total/running/stopped/byType）
- **`frontend/src/api/deviceSim.ts`** — 新增 `getDeviceStats()` API 调用
#### ✅ Phase 3：四页面统一统计卡片（已完成）
- **`DoorSim.vue`** — `loadStats()` 接入 `getDeviceStats({ deviceType: 'door' })`，`onDeviceChanged()` / `onEnvChange()` 响应式刷新
- **`PaperlessSim.vue`** — **完整重写**：原 53 行无统计卡片，现补齐统计卡片 UI + 响应式刷新
- **`CentralSim.vue`** — **完整重写**：同上
- **`ClientSim.vue`** — **完整重写**：同上
- 四页面统一模式：统计卡片 + 环境选择器 + `loadStats()` + `onDeviceChanged()` + `onEnvChange()` + `onMounted`
#### ✅ Phase 4：构建 + 部署验证（已完成）
- 前端 `npm run build` 构建成功（34.80s，76 个文件）
- 部署脚本：**`deploy_to_560_stats.py`**（paramiko SFTP 上传 3 个后端文件 + dist，docker compose restart app）
- 已部署到 192.168.5.60，验证结果：
- 容器状态 `Up (healthy)`，健康检查 `{"status":"healthy"}`
- stats API 路由注册成功：`/api/device-sim/devices/stats`
- **API 实际返回**：`{"total":1080,"running":0,"stopped":1080,"byType":{"door":{"total":540,...},"paperless":{"total":540,...}}}`
- 数据库 1080 台设备（540 door + 540 paperless）统计正确，卡片不再显示 0
**修改文件清单**：
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `backend/app/schemas/device_sim.py` | 修改 | 新增 `DeviceStatsResponse` |
| `backend/app/services/device_sim_service.py` | 修改 | 新增 `get_device_stats()` |
| `backend/app/routers/device_sim.py` | 修改 | 新增 `GET /devices/stats` 端点（路由顺序在 `/devices/{device_id}` 之前） |
| `frontend/src/types/device.ts` | 修改 | 新增 `DeviceStats` 类型 |
| `frontend/src/api/deviceSim.ts` | 修改 | 新增 `getDeviceStats()` |
| `frontend/src/views/device-sim/DoorSim.vue` | 修改 | 统计卡片接入真实数据 + 响应式刷新 |
| `frontend/src/views/device-sim/PaperlessSim.vue` | 重写 | 补齐统计卡片 UI + 响应式刷新 |
| `frontend/src/views/device-sim/CentralSim.vue` | 重写 | 补齐统计卡片 UI + 响应式刷新 |
| `frontend/src/views/device-sim/ClientSim.vue` | 重写 | 补齐统计卡片 UI + 响应式刷新 |
| `deploy_to_560_stats.py` | 新增 | 统计卡片修复部署脚本 |
| `Docs/PRD/设备模拟/问题处理/问题分析_统计卡片显示为0.md` | 新增 | 统计卡片问题分析 |
| `Docs/PRD/设备模拟/执行计划/执行计划_统计卡片修复.md` | 新增 | 4 阶段修复计划 |
| `Docs/PRD/需求文档/设备模拟/` (原目录) | 移动 | 全部移到 `Docs/PRD/设备模拟/` 子目录 |
**待办**：本次改动（9 个后端/前端文件 + 部署脚本）尚未提交 git，下次会话可通过 `/GitCommit` 提交。
---
### 2026-08-13 会话 A：全部启动/停止改为操作全量设备
**会话目标**：将【全部启动】/【全部停止】按钮从操作当前分页改为操作该模块下所有设备
**已完成内容**：
#### ✅ 后端 Service 新增全量查询方法
- **`start_all_by_device_type(device_type, env_config_id)`** — 按设备类型查询数据库全量设备 ID，调用 `batch_start_simulators`
- **`stop_all_by_device_type(device_type, env_config_id)`** — 同上，调用 `batch_stop_simulators`
- 支持可选 `env_config_id` 筛选（配合前端筛选栏的环境过滤）
#### ✅ 后端 Schema 新增
- **`BatchAllOperationRequest`** — 含 `device_type`（必填，枚举 door/paperless/central/client）和 `env_config_id`（可选）
#### ✅ 后端 API 路由新增
- `POST /api/device-sim/devices/batch/start-all` — 按设备类型全部启动
- `POST /api/device-sim/devices/batch/stop-all` — 按设备类型全部停止
#### ✅ 前端 API 封装
- `startAllDevices(deviceType, envConfigId?)` / `stopAllDevices(deviceType, envConfigId?)`
#### ✅ 前端 DeviceList.vue 改造
- `handleStartAll()` / `handleStopAll()` 改为调用新 API，不再取当前分页的 `devices` 列表
- 同步传递 `filterEnvConfigId`，配合环境筛选栏实现按环境过滤
- 四个设备页面（门口屏/无纸化/中控/集控客户端）共用该组件，自动统一生效
**修改文件清单**：
| 文件 | 变更类型 | 说明 |
|------|----------|------|
| `backend/app/services/device_sim_service.py` | 修改 | 新增 `start_all_by_device_type()` / `stop_all_by_device_type()` |
| `backend/app/schemas/device_sim.py` | 修改 | 新增 `BatchAllOperationRequest` Schema |
| `backend/app/routers/device_sim.py` | 修改 | 新增 `POST /devices/batch/start-all` 和 `stop-all` 端点 |
| `frontend/src/api/deviceSim.ts` | 修改 | 新增 `startAllDevices()` / `stopAllDevices()` API |
| `frontend/src/components/device/DeviceList.vue` | 修改 | 全部启动/停止改为调用全量 API |
**验证情况**：后端 Python 语法检查通过，前端 TypeScript 检查通过，`npm run build` 构建成功（31.20s）。
---
### 2026-08-06 会话 B：中控设备多类型主题上报 — 代码实现
**会话目标**：按执行计划实现中控设备 7 种主题类型上报的 4 个阶段
......@@ -113,8 +308,8 @@
**会话目标**：输出 PRD 需求文档和执行计划文档
**已完成内容**：
1. ✅ PRD 需求文档 — `Docs/PRD/需求文档/设备模拟/_PRD_需求优化_中控设备多类型主题上报.md`
2. ✅ 执行计划文档 — `Docs/PRD/需求文档/设备模拟/_执行计划_中控设备多类型主题上报.md`
1. ✅ PRD 需求文档 — `Docs/PRD/设备模拟/需求文档/_PRD_需求优化_中控设备多类型主题上报.md`
2. ✅ 执行计划文档 — `Docs/PRD/设备模拟/执行计划/_执行计划_中控设备多类型主题上报.md`
3. ✅ 初步代码实现（已部署到 192.168.5.60 但需按新计划重构）
---
......@@ -232,9 +427,15 @@
| 文档 | 路径 |
|------|------|
| 设备模拟 PRD | `Docs/PRD/需求文档/设备模拟/_PRD_需求文档_设备模拟模块.md` |
| 中控多类型 PRD | `Docs/PRD/需求文档/设备模拟/_PRD_需求优化_中控设备多类型主题上报.md` |
| 中控多类型执行计划 | `Docs/PRD/需求文档/设备模拟/_执行计划_中控设备多类型主题上报.md` |
| 设备模拟 PRD | `Docs/PRD/设备模拟/需求文档/_PRD_需求文档_设备模拟模块.md` |
| 中控多类型 PRD | `Docs/PRD/设备模拟/需求文档/_PRD_需求优化_中控设备多类型主题上报.md` |
| 中控多类型执行计划 | `Docs/PRD/设备模拟/执行计划/_执行计划_中控设备多类型主题上报.md` |
| 统计卡片问题分析 | `Docs/PRD/设备模拟/问题处理/问题分析_统计卡片显示为0.md` |
| 统计卡片修复计划 | `Docs/PRD/设备模拟/执行计划/执行计划_统计卡片修复.md` |
| 统计卡片部署脚本 | `deploy_to_560_stats.py` |
| 环境筛选问题分析 | `Docs/PRD/设备模拟/问题处理/问题分析_筛选环境统计卡片不跟随.md` |
| 环境筛选修复计划 | `Docs/PRD/设备模拟/执行计划/执行计划_环境筛选统一联动修复.md` |
| 前端部署脚本 | `deploy_frontend_only.py` |
---
......
backend/app/config.py
浏览文件 @ f3035587
......@@ -74,6 +74,16 @@ class Settings:
ERP_TYPE_ID: int = int(os.getenv("ERP_TYPE_ID", "2"))
ERP_IMAGE_URL_PREFIX: str = os.getenv("ERP_IMAGE_URL_PREFIX", "https://office.ubainsyun.com:5015/")
# 钉钉对接配置
DINGTALK_APP_KEY: str = os.getenv("DINGTALK_APP_KEY", "")
DINGTALK_APP_SECRET: str = os.getenv("DINGTALK_APP_SECRET", "")
DINGTALK_AGENT_ID: int = int(os.getenv("DINGTALK_AGENT_ID", "0"))
# 文档管理配置
DOCUMENT_UPLOAD_DIR: str = os.getenv("DOCUMENT_UPLOAD_DIR", "./data/documents/upload")
DOCUMENT_OUTPUT_DIR: str = os.getenv("DOCUMENT_OUTPUT_DIR", "./data/documents/output")
DOCUMENT_MAX_SIZE_MB: int = int(os.getenv("DOCUMENT_MAX_SIZE_MB", "50"))
class Config:
"""Pydantic 配置"""
env_file = ".env"
......
backend/app/data/elements_mapping.json
浏览文件 @ f3035587
{
"version": "1.2",
"updated_at": "2026-08-11",
"updated_at": "2026-08-17",
"source": "前端开发人员提供 - 门户首页+功能中心元素定位键值表 + 会议预约子页面元素定位键值表 + 登录页DevTools捕获",
"source_files": [
"web/pc-vue2-platform/src/views/Home/index.vue",
......@@ -835,6 +835,18 @@
"tier": "会议预约-创建会议",
"description": "创建会议 - 时间选择按钮组"
},
"创建会议-预定会议": {
"selector": ".time_btn > div:last-child .btns",
"type": "css",
"tier": "会议预约-创建会议",
"description": "创建会议 - 时间选择按钮组中的\"预定会议\"按钮"
},
"创建会议-立即开始": {
"selector": ".time_btn .btns.button_active",
"type": "css",
"tier": "会议预约-创建会议",
"description": "创建会议 - 时间选择按钮组中的\"立即开始\"按钮"
},
"创建会议-主题名称": {
"selector": ".topic_item",
"type": "css",
......@@ -901,6 +913,12 @@
"tier": "会议预约-创建会议",
"description": "创建会议 - 右侧参会人表格"
},
"创建会议-会议室选择": {
"selector": ".el-checkbox",
"type": "css",
"tier": "会议预约-创建会议",
"description": "创建会议 - 右侧会议室选择复选框"
},
"会议模板-搜索": {
"selector": ".search .el-input",
"type": "css",
......@@ -1380,6 +1398,18 @@
"type": "css",
"tier": "会议预约-会议列表",
"description": "会议列表[历史] - 评价弹窗星级评分"
},
"创建会议-编辑会议室": {
"selector": ".room .delimg",
"type": "css",
"tier": "会议预约-创建会议",
"description": "创建会议 - 左侧会议室框中的编辑按钮（点击切换右侧到参会人配置模式）"
},
"创建会议-确定创建": {
"selector": ".btn button.el-button",
"type": "css",
"tier": "会议预约-创建会议",
"description": "创建会议 - 底部\"确定创建\"按钮"
}
}
}
\ No newline at end of file
backend/app/database.py
浏览文件 @ f3035587
......@@ -140,6 +140,8 @@ async def _ensure_columns(conn) -> None:
("performance_tasks", "capture_rules", "JSON"),
# 性能测试：任务关联的接口预设（旧库升级）
("performance_tasks", "preset_id", "VARCHAR(64) DEFAULT NULL"),
# 功能测试报告模板：描述字段（旧库升级）
("report_templates", "description", "VARCHAR(200) DEFAULT ''"),
]
def _do_ensure(sync_conn) -> None:
......
backend/app/executors/playwright_executor.py
浏览文件 @ f3035587
......@@ -1412,59 +1412,26 @@ class PlaywrightExecutor:
last_error = e
logger.debug(f"⚠ 主页面点击失败 {selector}: {e}")
# 策略2: 主页面force点击（忽略遮挡）
if not force:
try:
self._page.click(selector, timeout=5000, force=True)
logger.debug(f"✓ 主页面force点击成功: {selector}")
self._wait_for_loading_overlay()
return
except Exception as e2:
last_error = e2
logger.debug(f"⚠ 主页面force点击失败 {selector}: {e2}")
# 策略3: iframe 中点击
for frame in self._page.frames:
if frame == self._page.main_frame:
continue
try:
frame.wait_for_selector(selector, state="visible", timeout=5000)
frame.click(selector, timeout=5000, force=True)
logger.debug(f"✓ iframe 中点击成功: {selector}")
self._wait_for_loading_overlay()
return
except Exception as e3:
last_error = e3
continue
# 策略4: JS 点击回退（处理元素被遮挡或不可操作的情况）
try:
el = self._page.query_selector(selector)
if el:
self._page.evaluate('(el) => el.click()', el)
logger.debug(f"✓ JS点击成功: {selector}")
self._wait_for_loading_overlay()
return
except Exception as e4:
last_error = e4
logger.debug(f"⚠ JS点击失败 {selector}: {e4}")
# ==================== 策略5: Element UI 表格行选择回退 ====================
# ==================== 策略5（提前）: Element UI 表格行选择回退 ====================
# Element UI 表格的选择列复选框带 is-hidden class（隐藏列），直接点击
# .el-checkbox:has-text("X") 会失败。从选择器中提取目标文本，
# 点击包含该文本的表格行（行点击会触发选中）。
# 点击包含该文本的表格行或行内复选框（行点击会触发选中）。
# 放在策略2（force点击）之前执行，避免 force 点击隐藏 checkbox 假成功
m = re.search(r':has-text\("([^"]+)"\)', selector)
if m:
target_text = m.group(1)
row_selectors = [
# 优先：点击行内复选框（含文本的行内的复选框）
f'.el-table__row:has-text("{target_text}") .el-checkbox',
# 次选：点击整行
f'.el-table__row:has-text("{target_text}")',
# 最后：点击 tr
f'tr:has-text("{target_text}")',
f'.el-table__row:has-text("{target_text}") .el-checkbox',
]
for row_sel in row_selectors:
try:
row_el = self._page.query_selector(row_sel)
if row_el and row_el.is_visible():
if row_el:
row_el.scroll_into_view_if_needed()
self._page.wait_for_timeout(200)
row_el.click(force=True)
......@@ -1475,8 +1442,9 @@ class PlaywrightExecutor:
last_error = e5
logger.debug(f"⚠ 表格行点击失败 {row_sel}: {e5}")
# 策略6: 若选择器是隐藏复选框，尝试点击其所在表格行
# 策略6（提前）: 若选择器是隐藏复选框，尝试点击其所在表格行
# 覆盖 .el-checkbox 无 :has-text 的情况（如勾选用户 admin@xty12）
# 也放在策略2之前，避免 force 点击假成功
if selector in (".el-checkbox", ".el-checkbox__inner", "input[type=checkbox]"):
try:
row_el = self._page.evaluate(
......@@ -1498,6 +1466,97 @@ class PlaywrightExecutor:
last_error = e6
logger.debug(f"⚠ 点击复选框所在行失败 {selector}: {e6}")
# 策略2: 主页面force点击（忽略遮挡）
# 注意：对 checkbox 类元素，force 点击隐藏 input 可能不触发框架事件，
# 因此需要加 before/after 状态校验
if not force:
try:
# force 点击前：记录 checkbox 选中状态（仅限 checkbox 类元素 + 能爬到 tr）
checkbox_checked_before = None
if selector in (".el-checkbox", ".el-checkbox__inner", "input[type=checkbox]"):
try:
el = self._page.query_selector(selector)
if el:
checkbox_checked_before = self._page.evaluate(
"""(sel) => {
const el = document.querySelector(sel);
if (!el) return null;
const row = el.closest('tr, .el-table__row');
if (!row) return null;
const cb = row.querySelector('.el-checkbox');
return cb ? cb.classList.contains('is-checked') : null;
}""",
selector,
)
except Exception:
pass
self._page.click(selector, timeout=5000, force=True)
self._page.wait_for_timeout(300)
# force 点击后：校验 checkbox 状态是否变化
if checkbox_checked_before is not None:
try:
checked_after = self._page.evaluate(
"""(sel) => {
const el = document.querySelector(sel);
if (!el) return null;
const row = el.closest('tr, .el-table__row');
if (!row) return null;
const cb = row.querySelector('.el-checkbox');
return cb ? cb.classList.contains('is-checked') : null;
}""",
selector,
)
if checked_after is not None and checked_after == checkbox_checked_before:
logger.debug(f"⚠ force 点击后 checkbox 状态未变化（假通过），继续尝试后续策略: {selector}")
# 不 return，继续走后续策略
else:
logger.debug(f"✓ 主页面force点击成功，checkbox 状态已变化: {selector}")
self._wait_for_loading_overlay()
return
except Exception:
# 校验失败不阻塞，视为 force 点击成功
logger.debug(f"✓ 主页面force点击成功（校验跳过）: {selector}")
self._wait_for_loading_overlay()
return
else:
logger.debug(f"✓ 主页面force点击成功: {selector}")
self._wait_for_loading_overlay()
return
except Exception as e2:
last_error = e2
logger.debug(f"⚠ 主页面force点击失败 {selector}: {e2}")
# 策略3: iframe 中点击
for frame in self._page.frames:
if frame == self._page.main_frame:
continue
try:
frame.wait_for_selector(selector, state="visible", timeout=5000)
frame.click(selector, timeout=5000, force=True)
logger.debug(f"✓ iframe 中点击成功: {selector}")
self._wait_for_loading_overlay()
return
except Exception as e3:
last_error = e3
continue
# 策略4: JS 点击回退（处理元素被遮挡或不可操作的情况）
try:
el = self._page.query_selector(selector)
if el:
self._page.evaluate('(el) => el.click()', el)
logger.debug(f"✓ JS点击成功: {selector}")
self._wait_for_loading_overlay()
return
except Exception as e4:
last_error = e4
logger.debug(f"⚠ JS点击失败 {selector}: {e4}")
# 注：策略5（表格行点击）和策略6（复选框所在行点击）已前移到策略2（force点击）之前，
# 以避免 force 点击隐藏 checkbox 假成功
raise Exception(f"✗ 无法点击元素（已尝试 {len(selectors)} 个选择器）: {selectors} 最后错误: {last_error}")
def _do_fill(self, params: dict, force: bool = False) -> None:
......
backend/app/executors/template_resolver.py
浏览文件 @ f3035587
......@@ -5,7 +5,7 @@
模块描述：性能测试请求体模板变量替换器
支持占位符：
- {__NOW__} → 当前时间 "YYYY-MM-DD HH:mm"
- {__NOW__} → 当前时间 "YYYY-MM-DD HH:mm:ss"
- {__NOW_+N_H__} → 当前时间 + N 小时
- {__NOW_+N_M__} → 当前时间 + N 分钟
- {__NOW_+N_D__} → 当前时间 + N 天
......@@ -153,8 +153,8 @@ class TemplateResolver:
# ---------- 时间相关 ----------
def _now_str(self) -> str:
"""当前时间字符串 YYYY-MM-DD HH:mm"""
return datetime.now().strftime("%Y-%m-%d %H:%M")
"""当前时间字符串 YYYY-MM-DD HH:mm:ss"""
return datetime.now().strftime("%Y-%m-%d %H:%M:%S")
def _now_with_offset(self, delta: str, unit: str) -> str:
"""
......@@ -179,7 +179,7 @@ class TemplateResolver:
base += timedelta(days=n)
else: # 默认分钟
base += timedelta(minutes=n)
return base.strftime("%Y-%m-%d %H:%M")
return base.strftime("%Y-%m-%d %H:%M:%S")
# ---------- 随机值相关 ----------
......
backend/app/models/deploy_execution.py
浏览文件 @ f3035587
......@@ -50,7 +50,7 @@ class DeployExecution(Base):
)
script_id: Mapped[str] = mapped_column(
String(64), ForeignKey("deploy_scripts.id", ondelete="SET NULL"),
nullable=False, comment="关联的脚本配置 ID"
nullable=True, comment="关联的脚本配置 ID"
)
server_id: Mapped[str] = mapped_column(
String(64), nullable=False, comment="关联的目标服务器 ID"
......
backend/app/models/report_template.py
浏览文件 @ f3035587
......@@ -38,6 +38,7 @@ class ReportTemplate(Base):
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True, comment="主键")
name: Mapped[str] = mapped_column(String(100), nullable=False, comment="模板名称")
description: Mapped[str] = mapped_column(String(200), nullable=True, default="", comment="模板描述")
is_default: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, comment="是否默认模板")
config: Mapped[str] = mapped_column(Text, nullable=False, default="{}", comment="完整配置JSON字符串")
created_at: Mapped[Optional[datetime]] = mapped_column(
......@@ -56,6 +57,7 @@ class ReportTemplate(Base):
return {
"id": self.id,
"name": self.name,
"description": self.description or "",
"is_default": self.is_default,
"config": json.loads(self.config) if self.config else {},
"created_at": self.created_at.strftime(DATE_FORMAT) if self.created_at else None,
......@@ -68,6 +70,7 @@ class ReportTemplate(Base):
return {
"id": self.id,
"name": self.name,
"description": self.description or "",
"is_default": self.is_default,
"updated_at": self.updated_at.strftime(DATE_FORMAT) if self.updated_at else None,
}
\ No newline at end of file
backend/app/routers/device_sim.py
浏览文件 @ f3035587
......@@ -25,7 +25,7 @@ from app.schemas.device_sim import (
ManualReportRequest, TestConnectionResponse,
TopicTemplateResponse, TopicTemplateListResponse,
BatchOperationRequest, BatchAllOperationRequest, BatchOperationResponse,
DeviceImportResponse,
DeviceImportResponse, DeviceStatsResponse,
)
from app.services.device_sim_service import DeviceSimService
......@@ -230,6 +230,28 @@ async def list_simulators(
raise HTTPException(status_code=500, detail=f"获取模拟设备列表失败: {str(e)}")
@router.get("/devices/stats", response_model=DeviceStatsResponse)
async def get_device_stats(
device_type: Optional[str] = Query(None, pattern="^(door|paperless|central|client)$", description="设备类型筛选"),
env_config_id: Optional[str] = Query(None, description="环境配置筛选"),
service: DeviceSimService = Depends(get_device_sim_service)
):
"""
获取设备统计信息
返回总设备数、运行中、已停止数量，以及按设备类型的分组统计。
注意：必须注册在 /devices/{device_id} 之前，避免 stats 被识别为 device_id。
"""
try:
return await service.get_device_stats(
device_type=device_type,
env_config_id=env_config_id,
)
except Exception as e:
logger.error(f"获取设备统计失败: {e}")
raise HTTPException(status_code=500, detail=f"获取设备统计失败: {str(e)}")
@router.post("/devices", response_model=SimulatorResponse, status_code=201)
async def create_simulator(
data: SimulatorCreate,
......
backend/app/routers/report_template.py
浏览文件 @ f3035587
......@@ -136,6 +136,7 @@ async def create_template(
name=request.name,
is_default=is_default,
config=json.dumps(config, ensure_ascii=False),
description=request.description or "",
)
db.add(template)
await db.commit()
......@@ -177,6 +178,9 @@ async def update_template(
if request.name is not None:
template.name = request.name
if request.description is not None:
template.description = request.description
if request.config is not None:
template.config = json.dumps(_validate_config(request.config), ensure_ascii=False)
......@@ -252,3 +256,44 @@ async def delete_template(template_id: int, db: AsyncSession = Depends(get_db)):
logger.info(f"删除默认模板后，自动将 {first.name} (id={first.id}) 设为默认")
return {"success": True, "message": "模板已删除"}
# ==================== 复制模板 ====================
@router.post("/{template_id}/duplicate", response_model=ReportTemplateResponse, summary="复制模板")
async def duplicate_template(template_id: int, db: AsyncSession = Depends(get_db)):
"""
复制报告模板
复制后的模板：
- 名称自动加"副本"后缀（已存在同名则追加序号）
- config 与 description 完整继承
- is_default 强制设为 False
"""
template = await db.get(ReportTemplate, template_id)
if not template:
raise HTTPException(status_code=404, detail=f"模板不存在: {template_id}")
# 生成不重复的名称
base_name = template.name
new_name = f"{base_name}_副本"
num = 2
while True:
result = await db.execute(select(ReportTemplate).where(ReportTemplate.name == new_name))
if not result.scalar_one_or_none():
break
new_name = f"{base_name}_副本{num}"
num += 1
new_template = ReportTemplate(
name=new_name,
is_default=False,
config=template.config,
description=template.description or "",
)
db.add(new_template)
await db.commit()
await db.refresh(new_template)
logger.info(f"复制报告模板: {template.name} → {new_template.name} (id={new_template.id})")
return new_template.to_dict()
\ No newline at end of file
backend/app/routers/system.py
浏览文件 @ f3035587
......@@ -14,6 +14,7 @@ import platform
import sys
import time
from pathlib import Path
from typing import Optional
from fastapi import APIRouter, Depends
from sqlalchemy import func, select, text
......@@ -23,6 +24,8 @@ from app.config import settings
from app.database import get_db
from app.models.module import Module
from app.models.test_case import TestCase
from app.models.dingtalk_config import DingTalkConfig
from app.schemas.dingtalk_config import DingTalkConfigResponse, DingTalkConfigUpdateRequest
logger = logging.getLogger(__name__)
......@@ -107,3 +110,76 @@ async def get_system_info(db: AsyncSession = Depends(get_db)):
"playwright_headless": settings.PLAYWRIGHT_HEADLESS,
"frontend_version": "1.0.0",
}
# ==================== 钉钉对接配置 ====================
@router.get("/dingtalk-config", response_model=DingTalkConfigResponse, summary="获取钉钉对接配置")
async def get_dingtalk_config(db: AsyncSession = Depends(get_db)):
"""
获取当前钉钉对接配置
优先从数据库读取，若数据库无记录则回退到环境变量默认值。
"""
result = await db.execute(select(DingTalkConfig).where(DingTalkConfig.id == 1))
config = result.scalar_one_or_none()
if config:
# 数据库有记录，但空字段回退到环境变量默认值（保证配置自动填充）
return DingTalkConfigResponse(
app_key=config.app_key or settings.DINGTALK_APP_KEY or "",
app_secret=config.app_secret or settings.DINGTALK_APP_SECRET or "",
agent_id=config.agent_id or settings.DINGTALK_AGENT_ID or 0,
)
# 数据库无记录，回退到环境变量
return DingTalkConfigResponse(
app_key=settings.DINGTALK_APP_KEY or "",
app_secret=settings.DINGTALK_APP_SECRET or "",
agent_id=settings.DINGTALK_AGENT_ID or 0,
)
@router.put("/dingtalk-config", response_model=DingTalkConfigResponse, summary="更新钉钉对接配置")
async def update_dingtalk_config(request: DingTalkConfigUpdateRequest, db: AsyncSession = Depends(get_db)):
"""
更新钉钉对接配置（持久化到数据库）
更新后的配置会持久化到数据库，服务重启后依然有效。
"""
# 从数据库读取或创建新记录
result = await db.execute(select(DingTalkConfig).where(DingTalkConfig.id == 1))
config = result.scalar_one_or_none()
if not config:
# 新记录：先用环境变量默认值填充，再用请求值覆盖
config = DingTalkConfig(
id=1,
app_key=settings.DINGTALK_APP_KEY or "",
app_secret=settings.DINGTALK_APP_SECRET or "",
agent_id=settings.DINGTALK_AGENT_ID or 0,
)
db.add(config)
# 更新字段
if request.app_key is not None:
config.app_key = request.app_key
settings.DINGTALK_APP_KEY = request.app_key
if request.app_secret is not None:
config.app_secret = request.app_secret
settings.DINGTALK_APP_SECRET = request.app_secret
if request.agent_id is not None:
config.agent_id = request.agent_id
settings.DINGTALK_AGENT_ID = request.agent_id
await db.commit()
await db.refresh(config)
logger.info("钉钉对接配置已更新（持久化到数据库）")
return DingTalkConfigResponse(
app_key=config.app_key or settings.DINGTALK_APP_KEY or "",
app_secret=config.app_secret or settings.DINGTALK_APP_SECRET or "",
agent_id=config.agent_id or settings.DINGTALK_AGENT_ID or 0,
)
backend/app/schemas/device_sim.py
浏览文件 @ f3035587
......@@ -193,6 +193,20 @@ class SimulatorListResponse(BaseModel):
total: int = Field(default=0, description="总数")
class DeviceStatsResponse(BaseModel):
"""设备统计响应"""
total: int = Field(default=0, description="总设备数")
running: int = Field(default=0, description="运行中设备数")
stopped: int = Field(default=0, description="已停止设备数")
by_type: Dict[str, dict] = Field(default={}, description="按设备类型分组统计: {type: {total, running, stopped}}")
model_config = ConfigDict(
alias_generator=to_camel,
populate_by_name=True,
)
# ==================== 上报记录 Schema ====================
class ReportLogResponse(BaseModel):
......
backend/app/schemas/performance.py
浏览文件 @ f3035587
......@@ -49,7 +49,7 @@ class PerformanceTaskCreate(BaseModel):
method: str = Field("GET", description="HTTP方法 (GET/POST/PUT/DELETE)")
headers: Dict[str, str] = Field(default_factory=dict, description="自定义请求头")
body: Optional[Any] = Field(None, description="请求体（支持 dict 或 list）")
body_template: Optional[Dict[str, Any]] = Field(None, description="请求体模板")
body_template: Optional[Any] = Field(None, description="请求体模板")
# 压测配置
mode: str = Field("concurrent", description="压测模式: concurrent/qps/step")
......@@ -87,7 +87,7 @@ class PerformanceTaskUpdate(BaseModel):
method: Optional[str] = Field(None, description="HTTP方法")
headers: Optional[Dict[str, str]] = Field(None, description="自定义请求头")
body: Optional[Any] = Field(None, description="请求体（支持 dict 或 list）")
body_template: Optional[Dict[str, Any]] = Field(None, description="请求体模板")
body_template: Optional[Any] = Field(None, description="请求体模板")
mode: Optional[str] = Field(None, description="压测模式")
concurrency: Optional[int] = Field(None, ge=1, le=500, description="并发数")
qps_target: Optional[int] = Field(None, ge=1, description="目标QPS")
......@@ -116,7 +116,7 @@ class PerformanceTaskResponse(BaseModel):
method: str = "GET"
headers: Dict[str, str] = {}
body: Optional[Any] = None
body_template: Optional[Dict[str, Any]] = None
body_template: Optional[Any] = None
mode: str = "concurrent"
concurrency: int = 10
qps_target: int = 100
......
backend/app/schemas/report_template.py
浏览文件 @ f3035587
......@@ -16,6 +16,7 @@ from pydantic import BaseModel, Field
class ReportTemplateCreateRequest(BaseModel):
"""创建报告模板请求"""
name: str = Field(..., min_length=1, max_length=100, description="模板名称")
description: Optional[str] = Field(None, max_length=200, description="模板描述")
is_default: bool = Field(False, description="是否设为默认模板")
config: Dict = Field(default_factory=dict, description="模板完整配置(章节开关/样式/默认值)")
......@@ -23,6 +24,7 @@ class ReportTemplateCreateRequest(BaseModel):
class ReportTemplateUpdateRequest(BaseModel):
"""更新报告模板请求"""
name: Optional[str] = Field(None, min_length=1, max_length=100, description="模板名称")
description: Optional[str] = Field(None, max_length=200, description="模板描述")
is_default: Optional[bool] = Field(None, description="是否设为默认模板")
config: Optional[Dict] = Field(None, description="模板完整配置")
......@@ -31,6 +33,7 @@ class ReportTemplateListItem(BaseModel):
"""报告模板列表项（不含 config 详情）"""
id: int = Field(..., description="模板ID")
name: str = Field(..., description="模板名称")
description: Optional[str] = Field(None, description="模板描述")
is_default: bool = Field(False, description="是否默认模板")
updated_at: Optional[str] = Field(None, description="更新时间")
......@@ -39,6 +42,7 @@ class ReportTemplateResponse(BaseModel):
"""报告模板完整响应"""
id: int = Field(..., description="模板ID")
name: str = Field(..., description="模板名称")
description: Optional[str] = Field(None, description="模板描述")
is_default: bool = Field(False, description="是否默认模板")
config: Dict = Field(default_factory=dict, description="模板完整配置")
created_at: Optional[str] = Field(None, description="创建时间")
......
backend/app/services/device_sim_service.py
浏览文件 @ f3035587
......@@ -393,6 +393,71 @@ class DeviceSimService:
return items, total
async def get_device_stats(
self,
device_type: Optional[str] = None,
env_config_id: Optional[str] = None,
) -> dict:
"""
获取设备统计信息（总设备/运行中/已停止，支持按类型分组）
Args:
device_type: 设备类型筛选（不传则统计全部类型）
env_config_id: 环境配置筛选
Returns:
dict: {
"total": int, "running": int, "stopped": int,
"by_type": {door: {total, running, stopped}, ...}
}
"""
conditions = []
if device_type:
conditions.append(DeviceSimulator.device_type == device_type)
if env_config_id:
conditions.append(DeviceSimulator.env_config_id == env_config_id)
# 查询全部设备（不分页，仅取统计所需列）
query = select(DeviceSimulator.id, DeviceSimulator.device_type, DeviceSimulator.status)
if conditions:
query = query.where(and_(*conditions))
result = await self.db.execute(query)
rows = result.all()
# 以内存 _running_simulators 为准修正实时运行状态
running_ids = set()
with _running_simulators_lock:
for rid, sim in _running_simulators.items():
if sim.is_running():
running_ids.add(rid)
# 聚合统计
total = len(rows)
running = 0
stopped = 0
by_type: dict = {}
type_order = ["door", "paperless", "central", "client"]
for rid, rtype, rstatus in rows:
is_running = rid in running_ids
if is_running:
running += 1
else:
stopped += 1
t = rtype or "unknown"
group = by_type.setdefault(t, {"total": 0, "running": 0, "stopped": 0})
group["total"] += 1
if is_running:
group["running"] += 1
else:
group["stopped"] += 1
return {
"total": total,
"running": running,
"stopped": stopped,
"by_type": by_type,
}
async def get_simulator(self, device_id: str) -> Optional[DeviceSimulator]:
"""
获取模拟设备详情
......@@ -1232,7 +1297,7 @@ async def message_consumer_loop():
db.add(log)
# 更新设备统计
query = select(DeviceSimulator).where(DeviceSimulator.id == msg.device_id)
query = select(DeviceSimulator).where(DeviceSimulator.device_id == msg.device_id)
result = await db.execute(query)
sim = result.scalar_one_or_none()
if sim:
......
backend/app/services/element_mapping_service.py
浏览文件 @ f3035587
......@@ -43,6 +43,12 @@ SYNONYM_MAP = {
"新建": "创建",
"创建": "新建",
"新增": "创建",
# P0 修复：创建会议页的"会议室选择：北京展厅会议室"步骤。
# 在创建会议页，房间选择是通过右侧会议室表格行的勾选实现的，
# 语义上等价于"勾选会议室"，必须命中"创建会议-会议室选择"条目。
# 同时避免误配同义词"会议预约-会议室"层级的"会议室-区域树"。
"会议室选择": "勾选会议室",
"勾选会议室": "会议室选择",
}
# 映射表优先级（最高）
......@@ -232,6 +238,9 @@ class ElementMappingService:
strong_count = 0
weak_count = 0
# 已匹配过的映射键关键词（避免同一 kk 被多个 token 重复计分）
matched_key_kws = set()
for sk in step_keywords:
if len(sk) < 2:
continue
......@@ -243,9 +252,12 @@ class ElementMappingService:
strong_hit = False
for var in variants:
for kk in key_kws:
if kk in matched_key_kws:
continue # 同一映射键关键词只计分一次，避免"会议室"被多 token 重复命中
if var == kk or kk in var:
score += len(kk) * 2.0
strong_count += 1
matched_key_kws.add(kk)
strong_hit = True
break
if strong_hit:
......@@ -255,8 +267,11 @@ class ElementMappingService:
continue
# 弱匹配：步骤关键词是映射键关键词的子串
# 已匹配过强匹配的 kk 不再计入弱匹配（same-key 防重复）
for kk in key_kws:
if sk in kk:
if kk in matched_key_kws or sk in kk:
if kk in matched_key_kws:
continue
score += 1.0
weak_count += 1
break
......@@ -310,11 +325,32 @@ class ElementMappingService:
score += 1.0
# 完整映射键段出现在步骤中，额外加分（更精确的命中）
# 注意：'选择' 是动作词，不单独加分
for kk in key_kws:
if len(kk) >= 3 and kk in step_clean:
if len(kk) >= 3 and kk != "选择" and kk in step_clean:
score += 2.0
break
# 选择时间特殊处理：步骤名含"选择时间"时，优先含"选择时间"关键词的条目
# 解决"点击选择时间"被动作词剥离后只剩"时间"，误配"会议列表-全部-时间"的问题
# 期望命中"创建会议-选择时间"（选择器 .time_btn .btns）
if "选择时间" in step_name and "选择时间" in key:
score += 8.0
# 时间切换特殊处理：步骤名含"预定会议"/"立即开始"时，优先同名词精确条目
# 解决"时间切换为：预定会议"误配"会议列表-全部-时间"（仅"时间"+"会议"两个弱匹配）的问题
# 期望命中"创建会议-预定会议"/"创建会议-立即开始"（.time_btn 内的两个具体按钮）
# 注意：不能加给"创建会议-选择时间"（.time_btn .btns 会点到第1个"立即开始"）
if "预定会议" in step_name and "预定会议" in key:
score += 20.0
if "立即开始" in step_name and "立即开始" in key:
score += 20.0
# "时间切换为/时间选择为"步骤且条目在创建会议tier的"选择时间"族（预定会议/立即开始/选择时间）
# 给兜底加成，确保压过"会议列表-全部-时间"等跨页弱匹配
if ("切换为" in step_name or "选择为" in step_name) and (
"预定会议" in key or "立即开始" in key or "选择时间" in key):
score += 10.0
if score > best_score:
best_score = score
best_key = key
......@@ -411,6 +447,19 @@ class ElementMappingService:
"""清理步骤描述：去除动作词、标点、元素类型词"""
# 去除【】内容保留（如"点击【新建会议】" -> "新建会议"）
cleaned = step_name
# "时间切换为：预定会议" / "时间选择为：立即开始" 规范化为"选择时间-预定会议"等
# 否则"时间切换为"被 jieba 分词为"时间"+"切换为"，"切换为"无意义，只剩"时间"弱匹配
# 导致"时间切换为：预定会议"误配"会议列表-全部-时间"（仅"时间"+"会议"两个弱匹配）
# 使用 __SELECT_TIME__ 占位符保护，避免后续"选择"被动作词剥离
cleaned = re.sub(r"时间(切换为|选择为)[：:]\s*", "__SELECT_TIME__-", cleaned)
# "选择会议室"/"勾选会议室" 规范化为 "会议室选择"
# 否则动作词"选择/勾选"被下方 ^ 前缀正则剥离后只剩"会议室"，丢失语义
# （"会议室选择"是创建会议页选房间的动作，不能坍缩成"会议室"去匹配区域树）
cleaned = re.sub(r"(选择|勾选)会议室", "会议室选择", cleaned)
# "选择开始时间"/"选择结束时间" 规范化为"选择时间"并按占位符保护
# 否则"选择"被剥离后只剩"开始时间"/"时间"，token"时间"弱匹配"选择时间"仅1次
# 达不到 2 弱匹配阈值，或强匹配"开始时间"误配"会议列表-全部-时间"
cleaned = re.sub(r"选择(开始|结束)?时间", "__SELECT_TIME__", cleaned)
# 去除常见动作前缀
# 注意："验证"不能作为动作词去除，否则会破坏"验证码"（如"输入验证码：csba"）
for action_word in ["点击", "单击", "双击", "输入", "填写", "填入", "选择",
......@@ -423,17 +472,30 @@ class ElementMappingService:
cleaned = cleaned.replace(elem_word, "")
# 去除括号和引号
cleaned = re.sub(r"[【】\[\]（）()\"']", "", cleaned)
# 恢复"选择时间"占位符（__SELECT_TIME__-预定会议 → 选择时间-预定会议）
cleaned = cleaned.replace("__SELECT_TIME__", "选择时间")
return cleaned.strip()
@staticmethod
def _clean_step_name_without_elem(step_name: str) -> str:
"""清理步骤描述：仅去除动作词和标点，保留元素类型词用于匹配"""
cleaned = step_name
# "时间切换为：预定会议" / "时间选择为：立即开始" 规范化为"选择时间-预定会议"等
# 与 _clean_step_name 保持同步（两个清理函数必须同规则，否则 token 不一致导致匹配漂移）
# 使用 __SELECT_TIME__ 占位符保护（含义：选择时间）
cleaned = re.sub(r"时间(切换为|选择为)[：:]\s*", "__SELECT_TIME__-", cleaned)
# "选择会议室"/"勾选会议室" 规范化为 "会议室选择"
# 与 _clean_step_name 保持同步，避免动作词剥离后"会议室"变成孤立 token
cleaned = re.sub(r"(选择|勾选)会议室", "会议室选择", cleaned)
# "选择开始时间"/"选择结束时间" 规范化为"选择时间"并按占位符保护（与 _clean_step_name 同步）
cleaned = re.sub(r"选择(开始|结束)?时间", "__SELECT_TIME__", cleaned)
for action_word in ["点击", "单击", "双击", "输入", "填写", "填入", "选择",
"打开", "展开", "收起", "导航到", "进入", "按下", "勾选",
"取消", "悬停", "滚动", "等待", "检查", "查看"]:
cleaned = re.sub(rf"^{action_word}", "", cleaned)
cleaned = re.sub(r"[【】\[\]（）()\"']", "", cleaned)
# 恢复"选择时间"占位符
cleaned = cleaned.replace("__SELECT_TIME__", "选择时间")
return cleaned.strip()
@staticmethod
......
backend/app/services/functional/excel_reader.py
浏览文件 @ f3035587
......@@ -13,8 +13,13 @@
"""
import re
import io
import os
import zipfile
import tempfile
from dataclasses import dataclass, field
from typing import List, Optional
from lxml import etree
import openpyxl
......@@ -114,6 +119,59 @@ def _extract_case_number_from_steps(steps: str) -> List[str]:
return re.findall(pattern, steps)
def _fix_excel_auto_filter(file_path: str) -> str:
"""
修复 Excel 文件中损坏的 autoFilter XML
某些 Excel 文件的 autoFilter 中包含非数字/非通配符的 filter val，
导致 openpyxl 的 non-read_only 模式报错。本函数通过移除损坏的
autoFilter 元素来修复，不影响其他数据。
Args:
file_path: 原始 Excel 文件路径
Returns:
修复后的临时文件路径（如果无需修复则返回原路径）
"""
# 先尝试正常打开，成功则跳过修复
try:
wb = openpyxl.load_workbook(file_path, data_only=True)
wb.close()
return file_path
except Exception:
pass
ns = 'http://schemas.openxmlformats.org/spreadsheetml/2006/main'
fixed = False
with zipfile.ZipFile(file_path, 'r') as zin:
data = {}
for name in zin.namelist():
data[name] = zin.read(name)
for name in list(data.keys()):
if name.startswith('xl/worksheets/') and name.endswith('.xml'):
root = etree.fromstring(data[name])
# 查找并移除 autoFilter 元素
for af in root.findall(f'{{{ns}}}autoFilter'):
root.remove(af)
fixed = True
if fixed:
data[name] = etree.tostring(root, xml_declaration=True, encoding='UTF-8', standalone=True)
if not fixed:
return file_path
# 写入临时文件
with tempfile.NamedTemporaryFile(delete=False, suffix='.xlsx', mode='wb') as tmp:
tmp_path = tmp.name
with zipfile.ZipFile(tmp, 'w', zipfile.ZIP_DEFLATED) as zout:
for name, content in data.items():
zout.writestr(name, content)
return tmp_path
def _get_cell_value(row, col_idx: int, default: str = "") -> str:
"""
获取单元格值，处理 None 和空值
......@@ -153,7 +211,11 @@ def _get_int_cell_value(row, col_idx: int, default: int = 0) -> int:
def read_test_cases(file_path: str) -> List[TestCase]:
"""
读取测试用例Excel文件
读取测试用例Excel文件（支持多个 Sheet）
遍历工作簿中所有 Sheet，合并读取所有测试用例数据。
每个 Sheet 结构与数据起始行保持一致（表头第3行，数据第4行起）。
自动修复损坏的 autoFilter XML（某些 Excel 导出文件常见问题）。
Args:
file_path: Excel文件路径
......@@ -161,11 +223,16 @@ def read_test_cases(file_path: str) -> List[TestCase]:
Returns:
测试用例列表
"""
wb = openpyxl.load_workbook(file_path, data_only=True)
ws = wb.active
# 修复损坏的 autoFilter（如果存在）
safe_path = _fix_excel_auto_filter(file_path)
wb = openpyxl.load_workbook(safe_path, data_only=True)
test_cases = []
# 遍历所有 Sheet，合并读取（多 Sheet 文件如：预约会议/会议看板/会议室管理）
for sheet_name in wb.sheetnames:
ws = wb[sheet_name]
for row in ws.iter_rows(min_row=CASE_DATA_START_ROW):
serial_number = _get_int_cell_value(row, CASE_COL_SERIAL_NUMBER)
......@@ -195,6 +262,14 @@ def read_test_cases(file_path: str) -> List[TestCase]:
test_cases.append(case)
wb.close()
# 清理临时文件
if safe_path != file_path:
try:
os.remove(safe_path)
except Exception:
pass
return test_cases
......@@ -299,7 +374,7 @@ def normalize_test_result(result: str) -> str:
result = result.strip()
# 通过结果映射
pass_aliases = {"通过", "Pass", "PASS", "pass", "成功", "P", "√", "✓", "是", "yes", "Yes", "YES"}
pass_aliases = {"通过", "Pass", "PASS", "pass", "成功", "P", "√", "✓", "是", "yes", "Yes", "YES", "功能验证"}
if result in pass_aliases:
return TEST_RESULT_PASS
......
backend/app/services/functional/markdown_generator.py
浏览文件 @ f3035587
......@@ -92,6 +92,16 @@ def render_markdown_table(headers: List[str], rows: List[List[str]]) -> str:
return "\n".join(lines)
_ZH_NUM_MAP = {1: "一", 2: "二", 3: "三", 4: "四", 5: "五", 6: "六", 7: "七", 8: "八", 9: "九", 10: "十"}
def _zh_num(n: int) -> str:
"""整数转中文数字（1-10），超出返回阿拉伯数字"""
return _ZH_NUM_MAP.get(n, str(n))
def _title(num: int, name: str, level: int = 2) -> str:
"""生成章节标题（序号动态生成中文数字）"""
return f"{'#' * level} {_zh_num(num)}、{name}"
def generate_markdown_report(
template_path: str,
......@@ -130,11 +140,6 @@ def generate_markdown_report(
# 章节动态序号计数器（仅对启用章节自增）
ch_idx = 0
def _title(num: int, zh_num: str, name: str, level: int = 2) -> str:
"""生成章节标题（用序号+中文数字组合）"""
return f"{'#' * level} {num}.{zh_num} {name}"
# 获取当前日期
current_date = datetime.now().strftime(DATE_FORMAT)
report_number = get_report_number(project_name, current_date)
......@@ -148,8 +153,8 @@ def generate_markdown_report(
# ==================== 一、报告基本信息 ====================
if chapters.get("report_basic_info", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "一", "报告基本信息", level=2))
content_parts.append("### 1.1 报告标识\n")
content_parts.append(_title(ch_idx, "报告基本信息", level=2))
content_parts.append(f"### {ch_idx}.1 报告标识\n")
headers = ["项目", "内容"]
rows = [
......@@ -161,7 +166,7 @@ def generate_markdown_report(
]
content_parts.append(render_markdown_table(headers, rows) + "\n")
content_parts.append("### 1.2 测试概览\n")
content_parts.append(f"### {ch_idx}.2 测试概览\n")
headers = ["项目", "内容"]
rows = [
["项目名称", project_name],
......@@ -172,7 +177,7 @@ def generate_markdown_report(
]
content_parts.append(render_markdown_table(headers, rows) + "\n")
content_parts.append("### 1.3 被测系统信息\n")
content_parts.append(f"### {ch_idx}.3 被测系统信息\n")
headers = ["项目", "内容"]
# 提取自动填充数据
system_version = extract_version_info_from_bug_list(bugs) if bugs else defaults.get("system_version", DEFAULT_SYSTEM_VERSION)
......@@ -196,9 +201,9 @@ def generate_markdown_report(
# ==================== 二、测试执行摘要 ====================
if chapters.get("execution_summary", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "二", "测试执行摘要", level=2))
content_parts.append(_title(ch_idx, "测试执行摘要", level=2))
content_parts.append("### 2.1 测试结果统计\n")
content_parts.append(f"### {ch_idx}.1 测试结果统计\n")
total = case_analysis.total_cases
headers = ["统计项", "数量", "占比"]
unexecuted = case_analysis.unverified_cases + case_analysis.undeveloped_cases
......@@ -212,7 +217,7 @@ def generate_markdown_report(
]
content_parts.append(render_markdown_table(headers, rows) + "\n")
content_parts.append("### 2.2 BUG统计汇总\n")
content_parts.append(f"### {ch_idx}.2 BUG统计汇总\n")
total_bugs = bug_analysis.total_bugs
headers = ["BUG等级", "数量", "占比", "已关闭", "未关闭"]
rows = []
......@@ -234,7 +239,7 @@ def generate_markdown_report(
])
content_parts.append(render_markdown_table(headers, rows) + "\n")
content_parts.append("### 2.3 测试结论\n")
content_parts.append(f"### {ch_idx}.3 测试结论\n")
if bug_analysis.remaining_bugs == 0 and case_analysis.failed_cases == 0:
conclusion = "✓ **测试通过** - 系统功能正常，无致命/严重缺陷，可以发布"
elif case_analysis.failed_cases > 0:
......@@ -253,9 +258,9 @@ def generate_markdown_report(
# ==================== 三、测试范围 ====================
if chapters.get("test_scope", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "三", "测试范围", level=2))
content_parts.append(_title(ch_idx, "测试范围", level=2))
content_parts.append("### 3.1 测试模块覆盖\n")
content_parts.append(f"### {ch_idx}.1 测试模块覆盖\n")
headers = ["序号", "功能模块", "用例数量", "通过", "失败", "未执行", "覆盖率"]
module_rows = []
for i, (module_name, stat) in enumerate(case_analysis.module_stats.items(), 1):
......@@ -273,10 +278,10 @@ def generate_markdown_report(
# ==================== 四、测试用例执行详情 ====================
if chapters.get("case_details", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "四", "测试用例执行详情", level=2))
content_parts.append(_title(ch_idx, "测试用例执行详情", level=2))
# 通过用例列表
content_parts.append("### 4.1 通过用例列表\n")
content_parts.append(f"### {ch_idx}.1 通过用例列表\n")
passed_cases = [c for c in cases if c.test_result == TEST_RESULT_PASS]
if passed_cases:
headers = ["序号", "用例编号", "功能模块", "用例名称", "用例等级", "测试结果"]
......@@ -297,7 +302,7 @@ def generate_markdown_report(
content_parts.append("*无通过用例*\n")
# 失败用例列表
content_parts.append("### 4.2 失败用例列表\n")
content_parts.append(f"### {ch_idx}.2 失败用例列表\n")
failed_cases = [c for c in cases if c.test_result == TEST_RESULT_FAIL]
if failed_cases:
headers = ["序号", "用例编号", "功能模块", "用例名称", "用例等级", "关联BUG"]
......@@ -320,7 +325,7 @@ def generate_markdown_report(
content_parts.append("*无失败用例*\n")
# 未执行用例列表
content_parts.append("### 4.3 未执行用例列表\n")
content_parts.append(f"### {ch_idx}.3 未执行用例列表\n")
unexecuted_cases = [c for c in cases if c.test_result in [TEST_RESULT_UNVERIFIED, TEST_RESULT_UNDEVELOPED]]
if unexecuted_cases:
headers = ["序号", "用例编号", "功能模块", "用例名称", "用例等级", "未执行原因"]
......@@ -344,9 +349,9 @@ def generate_markdown_report(
# ==================== 五、BUG详细列表 ====================
if chapters.get("bug_list", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "五", "BUG详细列表", level=2))
content_parts.append(_title(ch_idx, "BUG详细列表", level=2))
content_parts.append("### 5.1 BUG详细记录\n")
content_parts.append(f"### {ch_idx}.1 BUG详细记录\n")
if bugs:
headers = ["序号", "BUG等级", "BUG状态", "BUG名称", "BUG类型", "提单人员", "负责人员"]
rows = []
......@@ -364,7 +369,7 @@ def generate_markdown_report(
else:
content_parts.append("*无BUG记录*\n")
content_parts.append("### 5.2 遗留BUG说明\n")
content_parts.append(f"### {ch_idx}.2 遗留BUG说明\n")
remaining_bugs = [b for b in bugs if b.bug_status in REMAINING_BUG_STATUS]
if remaining_bugs:
headers = ["BUG编号", "BUG等级", "问题描述", "遗留原因", "后续计划"]
......@@ -384,36 +389,36 @@ def generate_markdown_report(
# ==================== 六、图表分析 ====================
if chapters.get("chart_analysis", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "六", "图表分析", level=2))
content_parts.append(_title(ch_idx, "图表分析", level=2))
# 添加图表
if "bug_level" in chart_paths:
content_parts.append("### 6.1 BUG等级分布\n")
content_parts.append(f"### {ch_idx}.1 BUG等级分布\n")
# 获取图表相对路径
chart_rel_path = _get_relative_chart_path(chart_paths["bug_level"], output_path)
content_parts.append(f"![BUG等级分布]({chart_rel_path})\n")
if "test_result" in chart_paths:
content_parts.append("### 6.2 用例执行结果分布\n")
content_parts.append(f"### {ch_idx}.2 用例执行结果分布\n")
chart_rel_path = _get_relative_chart_path(chart_paths["test_result"], output_path)
content_parts.append(f"![用例执行结果分布]({chart_rel_path})\n")
if "pass_rate" in chart_paths:
content_parts.append("### 6.3 用例执行情况统计\n")
content_parts.append(f"### {ch_idx}.3 用例执行情况统计\n")
chart_rel_path = _get_relative_chart_path(chart_paths["pass_rate"], output_path)
content_parts.append(f"![用例执行情况统计]({chart_rel_path})\n")
if "bug_by_module" in chart_paths:
content_parts.append("### 6.4 各模块BUG分布\n")
content_parts.append(f"### {ch_idx}.4 各模块BUG分布\n")
chart_rel_path = _get_relative_chart_path(chart_paths["bug_by_module"], output_path)
content_parts.append(f"![各模块BUG分布]({chart_rel_path})\n")
# ==================== 七、测试执行记录 ====================
if chapters.get("execution_records", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "七", "测试执行记录", level=2))
content_parts.append(_title(ch_idx, "测试执行记录", level=2))
content_parts.append("### 7.1 执行时间统计\n")
content_parts.append(f"### {ch_idx}.1 执行时间统计\n")
headers = ["统计项", "时间"]
rows = [
["测试开始时间", current_date],
......@@ -423,7 +428,7 @@ def generate_markdown_report(
]
content_parts.append(render_markdown_table(headers, rows) + "\n")
content_parts.append("### 7.2 执行人员分工\n")
content_parts.append(f"### {ch_idx}.2 执行人员分工\n")
headers = ["测试人员", "负责模块", "执行用例数", "发现BUG数"]
rows = [
["自动化工具", "全模块", str(case_analysis.total_cases), str(bug_analysis.total_bugs)]
......@@ -433,23 +438,23 @@ def generate_markdown_report(
# ==================== 八、测试附件 ====================
if chapters.get("attachments", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "八", "测试附件", level=2))
content_parts.append(_title(ch_idx, "测试附件", level=2))
content_parts.append("### 8.1 测试截图\n")
content_parts.append(f"### {ch_idx}.1 测试截图\n")
content_parts.append("*无测试截图*\n")
content_parts.append("### 8.2 测试日志\n")
content_parts.append(f"### {ch_idx}.2 测试日志\n")
content_parts.append("*无测试日志*\n")
# ==================== 九、风险评估与建议 ====================
if chapters.get("risk_assessment", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "九", "风险评估与建议", level=2))
content_parts.append(_title(ch_idx, "风险评估与建议", level=2))
content_parts.append("### 9.1 质量风险分析\n")
content_parts.append(f"### {ch_idx}.1 质量风险分析\n")
content_parts.append("*无特别风险*\n")
content_parts.append("### 9.2 发布建议\n")
content_parts.append(f"### {ch_idx}.2 发布建议\n")
# 根据测试结果自动生成发布建议
if case_analysis.failed_cases == 0 and bug_analysis.remaining_bugs == 0:
recommendation = "- [x] **建议发布** - 质量达标，风险可控"
......@@ -466,15 +471,15 @@ def generate_markdown_report(
recommendation = "- [x] **建议发布** - 质量达标，风险可控"
content_parts.append(recommendation + "\n")
content_parts.append("### 9.3 改进建议\n")
content_parts.append(f"### {ch_idx}.3 改进建议\n")
content_parts.append("待补充\n")
# ==================== 十、附录 ====================
if chapters.get("appendix", True):
ch_idx += 1
content_parts.append(_title(ch_idx, "十", "附录", level=2))
content_parts.append(_title(ch_idx, "附录", level=2))
content_parts.append("### 10.1 用例与BUG关联表\n")
content_parts.append(f"### {ch_idx}.1 用例与BUG关联表\n")
headers = ["用例编号", "用例名称", "关联BUG编号", "BUG状态"]
rows = []
for case_number, bug_list in case_bug_link.items():
......@@ -491,13 +496,13 @@ def generate_markdown_report(
else:
content_parts.append("*无关联数据*\n")
content_parts.append("### 10.2 术语表\n")
content_parts.append(f"### {ch_idx}.2 术语表\n")
content_parts.append("*无术语定义*\n")
content_parts.append("### 10.3 参考文档\n")
content_parts.append(f"### {ch_idx}.3 参考文档\n")
content_parts.append("*无参考文档*\n")
content_parts.append("### 10.4 修订历史\n")
content_parts.append(f"### {ch_idx}.4 修订历史\n")
headers = ["版本", "修订日期", "修订人", "修订内容"]
rows = [
["v1.0", current_date, "自动化工具", "自动生成初始报告"]
......
backend/app/services/functional/word_generator.py
浏览文件 @ f3035587
......@@ -75,6 +75,14 @@ from .config import (
)
_ZH_NUM_MAP = {1: "一", 2: "二", 3: "三", 4: "四", 5: "五", 6: "六", 7: "七", 8: "八", 9: "九", 10: "十"}
def _zh_num(n: int) -> str:
"""整数转中文数字（1-10），超出返回阿拉伯数字"""
return _ZH_NUM_MAP.get(n, str(n))
def _set_cell_border(cell):
"""
设置单元格边框
......@@ -360,8 +368,8 @@ def generate_report(
# ==================== 一、报告基本信息 ====================
if chapters.get("report_basic_info", True):
ch_idx += 1
_add_title_local("一、报告基本信息", level=2)
_add_title_local("1.1 报告标识", level=3)
_add_title_local(f"{_zh_num(ch_idx)}、报告基本信息", level=2)
_add_title_local(f"{ch_idx}.1 报告标识", level=3)
headers = ["项目", "内容"]
rows = [
......@@ -373,7 +381,7 @@ def generate_report(
]
_create_table_local(headers, rows)
_add_title_local("1.2 测试概览", level=3)
_add_title_local(f"{ch_idx}.2 测试概览", level=3)
headers = ["项目", "内容"]
rows = [
["项目名称", project_name],
......@@ -384,7 +392,7 @@ def generate_report(
]
_create_table_local(headers, rows)
_add_title_local("1.3 被测系统信息", level=3)
_add_title_local(f"{ch_idx}.3 被测系统信息", level=3)
headers = ["项目", "内容"]
# 提取自动填充数据
system_version = extract_version_info_from_bug_list(bugs) if bugs else _system_version
......@@ -410,9 +418,9 @@ def generate_report(
# ==================== 二、测试执行摘要 ====================
if chapters.get("execution_summary", True):
ch_idx += 1
_add_title_local("二、测试执行摘要", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、测试执行摘要", level=2)
_add_title_local("2.1 测试结果统计", level=3)
_add_title_local(f"{ch_idx}.1 测试结果统计", level=3)
total = case_analysis.total_cases
headers = ["统计项", "数量", "占比"]
unexecuted = case_analysis.unverified_cases + case_analysis.undeveloped_cases
......@@ -426,7 +434,7 @@ def generate_report(
]
_create_table_local(headers, rows)
_add_title_local("2.2 BUG统计汇总", level=3)
_add_title_local(f"{ch_idx}.2 BUG统计汇总", level=3)
total_bugs = bug_analysis.total_bugs
headers = ["BUG等级", "数量", "占比", "已关闭", "未关闭"]
rows = []
......@@ -448,7 +456,7 @@ def generate_report(
])
_create_table_local(headers, rows)
_add_title_local("2.3 测试结论", level=3)
_add_title_local(f"{ch_idx}.3 测试结论", level=3)
if bug_analysis.remaining_bugs == 0 and case_analysis.failed_cases == 0:
conclusion = "✓ 测试通过 - 系统功能正常，无致命/严重缺陷，可以发布"
elif case_analysis.failed_cases > 0:
......@@ -467,9 +475,9 @@ def generate_report(
# ==================== 三、测试范围 ====================
if chapters.get("test_scope", True):
ch_idx += 1
_add_title_local("三、测试范围", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、测试范围", level=2)
_add_title_local("3.1 测试模块覆盖", level=3)
_add_title_local(f"{ch_idx}.1 测试模块覆盖", level=3)
headers = ["序号", "功能模块", "用例数量", "通过", "失败", "未执行", "覆盖率"]
module_rows = []
for i, (module_name, stat) in enumerate(case_analysis.module_stats.items(), 1):
......@@ -487,10 +495,10 @@ def generate_report(
# ==================== 四、测试用例执行详情 ====================
if chapters.get("case_details", True):
ch_idx += 1
_add_title_local("四、测试用例执行详情", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、测试用例执行详情", level=2)
# 通过用例列表
_add_title_local("4.1 通过用例列表", level=3)
_add_title_local(f"{ch_idx}.1 通过用例列表", level=3)
passed_cases = [c for c in cases if c.test_result == TEST_RESULT_PASS]
if passed_cases:
headers = ["序号", "用例编号", "功能模块", "用例名称", "用例等级", "测试结果"]
......@@ -511,7 +519,7 @@ def generate_report(
_add_paragraph_local("无通过用例")
# 失败用例列表
_add_title_local("4.2 失败用例列表", level=3)
_add_title_local(f"{ch_idx}.2 失败用例列表", level=3)
failed_cases = [c for c in cases if c.test_result == TEST_RESULT_FAIL]
if failed_cases:
headers = ["序号", "用例编号", "功能模块", "用例名称", "用例等级", "关联BUG"]
......@@ -534,7 +542,7 @@ def generate_report(
_add_paragraph_local("无失败用例")
# 未执行用例列表
_add_title_local("4.3 未执行用例列表", level=3)
_add_title_local(f"{ch_idx}.3 未执行用例列表", level=3)
unexecuted_cases = [c for c in cases if c.test_result in [TEST_RESULT_UNVERIFIED, TEST_RESULT_UNDEVELOPED]]
if unexecuted_cases:
headers = ["序号", "用例编号", "功能模块", "用例名称", "用例等级", "未执行原因"]
......@@ -558,9 +566,9 @@ def generate_report(
# ==================== 五、BUG详细列表 ====================
if chapters.get("bug_list", True):
ch_idx += 1
_add_title_local("五、BUG详细列表", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、BUG详细列表", level=2)
_add_title_local("5.1 BUG详细记录", level=3)
_add_title_local(f"{ch_idx}.1 BUG详细记录", level=3)
if bugs:
headers = ["序号", "BUG等级", "BUG状态", "BUG名称", "BUG类型", "提单人员", "负责人员"]
rows = []
......@@ -578,7 +586,7 @@ def generate_report(
else:
_add_paragraph_local("无BUG记录")
_add_title_local("5.2 遗留BUG说明", level=3)
_add_title_local(f"{ch_idx}.2 遗留BUG说明", level=3)
remaining_bugs = [b for b in bugs if b.bug_status in REMAINING_BUG_STATUS]
if remaining_bugs:
headers = ["BUG编号", "BUG等级", "问题描述", "遗留原因", "后续计划"]
......@@ -598,31 +606,31 @@ def generate_report(
# ==================== 六、图表分析 ====================
if chapters.get("chart_analysis", True):
ch_idx += 1
_add_title_local("六、图表分析", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、图表分析", level=2)
# 添加图表
if "bug_level" in chart_paths:
_add_title_local("6.1 BUG等级分布", level=3)
_add_title_local(f"{ch_idx}.1 BUG等级分布", level=3)
_add_image(doc, chart_paths["bug_level"])
if "test_result" in chart_paths:
_add_title_local("6.2 用例执行结果分布", level=3)
_add_title_local(f"{ch_idx}.2 用例执行结果分布", level=3)
_add_image(doc, chart_paths["test_result"])
if "pass_rate" in chart_paths:
_add_title_local("6.3 用例执行情况统计", level=3)
_add_title_local(f"{ch_idx}.3 用例执行情况统计", level=3)
_add_image(doc, chart_paths["pass_rate"])
if "bug_by_module" in chart_paths:
_add_title_local("6.4 各模块BUG分布", level=3)
_add_title_local(f"{ch_idx}.4 各模块BUG分布", level=3)
_add_image(doc, chart_paths["bug_by_module"])
# ==================== 七、测试执行记录 ====================
if chapters.get("execution_records", True):
ch_idx += 1
_add_title_local("七、测试执行记录", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、测试执行记录", level=2)
_add_title_local("7.1 执行时间统计", level=3)
_add_title_local(f"{ch_idx}.1 执行时间统计", level=3)
headers = ["统计项", "时间"]
rows = [
["测试开始时间", current_date],
......@@ -632,7 +640,7 @@ def generate_report(
]
_create_table_local(headers, rows)
_add_title_local("7.2 执行人员分工", level=3)
_add_title_local(f"{ch_idx}.2 执行人员分工", level=3)
headers = ["测试人员", "负责模块", "执行用例数", "发现BUG数"]
rows = [
["自动化工具", "全模块", str(case_analysis.total_cases), str(bug_analysis.total_bugs)]
......@@ -642,23 +650,23 @@ def generate_report(
# ==================== 八、测试附件 ====================
if chapters.get("attachments", True):
ch_idx += 1
_add_title_local("八、测试附件", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、测试附件", level=2)
_add_title_local("8.1 测试截图", level=3)
_add_title_local(f"{ch_idx}.1 测试截图", level=3)
_add_paragraph_local("无测试截图")
_add_title_local("8.2 测试日志", level=3)
_add_title_local(f"{ch_idx}.2 测试日志", level=3)
_add_paragraph_local("无测试日志")
# ==================== 九、风险评估与建议 ====================
if chapters.get("risk_assessment", True):
ch_idx += 1
_add_title_local("九、风险评估与建议", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、风险评估与建议", level=2)
_add_title_local("9.1 质量风险分析", level=3)
_add_title_local(f"{ch_idx}.1 质量风险分析", level=3)
_add_paragraph_local("无特别风险")
_add_title_local("9.2 发布建议", level=3)
_add_title_local(f"{ch_idx}.2 发布建议", level=3)
# 根据测试结果自动生成发布建议
if case_analysis.failed_cases == 0 and bug_analysis.remaining_bugs == 0:
recommendation = "建议发布 - 质量达标，风险可控"
......@@ -675,15 +683,15 @@ def generate_report(
recommendation = "建议发布 - 质量达标，风险可控"
_add_paragraph_local(recommendation)
_add_title_local("9.3 改进建议", level=3)
_add_title_local(f"{ch_idx}.3 改进建议", level=3)
_add_paragraph_local("待补充")
# ==================== 十、附录 ====================
if chapters.get("appendix", True):
ch_idx += 1
_add_title_local("十、附录", level=2)
_add_title_local(f"{_zh_num(ch_idx)}、附录", level=2)
_add_title_local("10.1 用例与BUG关联表", level=3)
_add_title_local(f"{ch_idx}.1 用例与BUG关联表", level=3)
headers = ["用例编号", "用例名称", "关联BUG编号", "BUG状态"]
rows = []
for case_number, bug_list in case_bug_link.items():
......@@ -700,13 +708,13 @@ def generate_report(
else:
_add_paragraph_local("无关联数据")
_add_title_local("10.2 术语表", level=3)
_add_title_local(f"{ch_idx}.2 术语表", level=3)
_add_paragraph_local("无术语定义")
_add_title_local("10.3 参考文档", level=3)
_add_title_local(f"{ch_idx}.3 参考文档", level=3)
_add_paragraph_local("无参考文档")
_add_title_local("10.4 修订历史", level=3)
_add_title_local(f"{ch_idx}.4 修订历史", level=3)
headers = ["版本", "修订日期", "修订人", "修订内容"]
rows = [
["v1.0", current_date, "自动化工具", "自动生成初始报告"]
......
backend/scripts/create_security_cases.py
浏览文件 @ f3035587
......@@ -1789,10 +1789,21 @@ SECURITY_CASES = [
def create_security_modules_and_cases():
"""创建安全测试模块和用例"""
# 连接数据库
# 连接数据库（支持环境变量 DATABASE_URL 覆盖，用于 Docker/MySQL 部署）
db_url = os.environ.get("DATABASE_URL")
if not db_url:
db_path = os.path.join(os.path.dirname(__file__), "..", "data", "test_platform.db")
db_url = f"sqlite:///{os.path.abspath(db_path)}"
# 本脚本使用同步 SQLAlchemy 会话；若 DATABASE_URL 是异步 aiomysql URL，
# 需翻译成同步 pymysql URL（模块导入仍用原 env，此处仅用于同步引擎）
if db_url.startswith("mysql+aiomysql://"):
sync_url = "mysql+pymysql://" + db_url[len("mysql+aiomysql://"):]
print(f" 数据库: {db_url} → (同步引擎切换为 {sync_url})")
db_url = sync_url
else:
print(f" 数据库: {db_url}")
engine = create_engine(db_url)
Session = sessionmaker(bind=engine)
session = Session()
......
frontend/src/api/deviceSim.ts
浏览文件 @ f3035587
......@@ -20,6 +20,7 @@ import type {
TestConnectionResponse,
TopicTemplateListResponse,
DeviceImportResponse,
DeviceStats,
} from '@/types/device'
const BASE = '/api/device-sim'
......@@ -149,6 +150,17 @@ export function getTopicTemplates(deviceType: string): Promise<TopicTemplateList
return request.get(`${BASE}/topic-templates/${deviceType}`)
}
// ==================== 统计 API ====================
/** 获取设备统计信息 */
export function getDeviceStats(params?: { deviceType?: string; envConfigId?: string }): Promise<DeviceStats> {
// 转换参数名为 snake_case（后端要求），与 listSimulators() 保持一致
const snakeParams: Record<string, any> = {}
if (params?.deviceType !== undefined) snakeParams.device_type = params.deviceType
if (params?.envConfigId !== undefined) snakeParams.env_config_id = params.envConfigId
return request.get(`${BASE}/devices/stats`, { params: snakeParams })
}
// ==================== 批量操作 API ====================
/** 批量启动设备 */
......
frontend/src/api/reportTemplate.ts
浏览文件 @ f3035587
......@@ -61,6 +61,7 @@ export interface ReportTemplateConfig {
export interface ReportTemplateListItem {
id: number
name: string
description?: string
is_default: boolean
updated_at?: string
}
......@@ -69,6 +70,7 @@ export interface ReportTemplateListItem {
export interface ReportTemplateResponse {
id: number
name: string
description?: string
is_default: boolean
config: ReportTemplateConfig
created_at?: string
......@@ -78,6 +80,7 @@ export interface ReportTemplateResponse {
/** 创建模板请求 */
export interface ReportTemplateCreateRequest {
name: string
description?: string
is_default?: boolean
config: ReportTemplateConfig
}
......@@ -85,6 +88,7 @@ export interface ReportTemplateCreateRequest {
/** 更新模板请求 */
export interface ReportTemplateUpdateRequest {
name?: string
description?: string
is_default?: boolean
config?: ReportTemplateConfig
}
......@@ -145,5 +149,14 @@ export const reportTemplateApi = {
async setDefault(id: number): Promise<ReportTemplateResponse> {
const response = await request.put(`/api/functional-report/templates/${id}/default`)
return response as any
},
/**
* 复制模板
* @param id 原模板 ID
*/
async duplicate(id: number): Promise<ReportTemplateResponse> {
const response = await request.post(`/api/functional-report/templates/${id}/duplicate`)
return response as any
}
}
\ No newline at end of file
frontend/src/api/system.ts
浏览文件 @ f3035587
......@@ -37,4 +37,24 @@ export const systemApi = {
const response = await request.get('/api/system/info')
return response as any
},
/**
* 获取钉钉对接配置
*/
async getDingTalkConfig(): Promise<{ app_key: string; app_secret: string; agent_id: number }> {
const response = await request.get('/api/system/dingtalk-config')
return response as any
},
/**
* 更新钉钉对接配置
*/
async updateDingTalkConfig(config: {
app_key?: string
app_secret?: string
agent_id?: number
}): Promise<any> {
const response = await request.put('/api/system/dingtalk-config', config)
return response as any
},
}
frontend/src/components/device/DeviceList.vue
浏览文件 @ f3035587
......@@ -10,7 +10,7 @@
<div class="device-list">
<!-- 筛选栏 -->
<div class="filter-bar">
<el-select v-model="filterEnvConfigId" placeholder="选择环境" clearable style="width: 200px" @change="loadDevices">
<el-select v-model="filterEnvConfigId" placeholder="选择环境" clearable style="width: 200px" @change="onInternalEnvChange">
<el-option v-for="env in envConfigs" :key="env.id" :label="env.name" :value="env.id" />
</el-select>
<el-select v-model="filterStatus" placeholder="状态" clearable style="width: 120px" @change="loadDevices">
......@@ -391,7 +391,7 @@
</template>
<script setup lang="ts">
import { ref, onMounted, computed } from 'vue'
import { ref, onMounted, computed, watch } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { Plus, Upload, ArrowDown, Check } from '@element-plus/icons-vue'
import {
......@@ -418,14 +418,24 @@ import { DEVICE_TYPE_LABELS, CENTRAL_DEVICE_TYPES } from '@/types/device'
const props = defineProps<{
deviceType: DeviceType
envConfigId?: string
}>()
const emit = defineEmits<{
(e: 'device-changed'): void
(e: 'env-change', envId: string): void
}>()
const deviceTypeLabel = computed(() => DEVICE_TYPE_LABELS[props.deviceType])
// 同步父组件传入的环境选择到内部筛选变量
watch(() => props.envConfigId, (newVal) => {
if (newVal !== undefined) {
filterEnvConfigId.value = newVal || ''
}
loadDevices()
})
// 设备列表
const loading = ref(false)
const devices = ref<Simulator[]>([])
......@@ -519,6 +529,12 @@ const importFileList = ref<any[]>([])
const importResult = ref<DeviceImportResponse | null>(null)
const downloadingTemplate = ref(false)
/** 内部环境筛选变化：刷新列表 + 通知父页面刷新统计卡片 */
function onInternalEnvChange() {
loadDevices()
emit('env-change', filterEnvConfigId.value)
}
/** 加载设备列表 */
async function loadDevices() {
loading.value = true
......
frontend/src/types/device.ts
浏览文件 @ f3035587
......@@ -243,3 +243,15 @@ export interface DeviceImportResponse {
results: DeviceImportRowResult[]
message: string
}
/** 设备统计 */
export interface DeviceStats {
total: number
running: number
stopped: number
byType: Record<string, {
total: number
running: number
stopped: number
}>
}
\ No newline at end of file
frontend/src/views/Execution.vue
浏览文件 @ f3035587
......@@ -279,8 +279,8 @@
<el-form-item label="执行名称">
<el-input v-model="runConfig.name" placeholder="可选，留空自动生成" />
</el-form-item>
<!-- UI用例显示浏览器模式选项，安全测试不显示 -->
<el-form-item label="浏览器模式" v-if="currentType !== 'security'">
<!-- UI用例显示浏览器模式选项，安全/接口测试不显示 -->
<el-form-item label="浏览器模式" v-if="currentType === 'ui'">
<el-switch v-model="runConfig.headless" active-text="无头" inactive-text="有头" />
</el-form-item>
<!-- 安全测试显示配置选择 -->
......@@ -294,7 +294,7 @@
/>
</el-select>
</el-form-item>
<el-form-item label="执行环境" v-if="currentType !== 'security'">
<el-form-item label="执行环境" v-if="currentType === 'ui'">
<el-select v-model="runConfig.environment" style="width: 100%">
<el-option label="默认环境" value="default" />
<el-option label="测试环境" value="test" />
......@@ -369,6 +369,7 @@ import {
createSecurityExecution,
runSecurityExecution,
} from '@/api/security'
import { apiTestApi } from '@/api/apiTest'
import { WebSocketClient } from '@/utils/websocket'
import StepDetailPanel from '@/components/StepDetailPanel.vue'
......@@ -390,8 +391,12 @@ const currentPage = ref(1)
const pageSize = ref(10)
const filterStatus = ref('')
/** 当前用例类型（来自路由参数，默认 ui） */
const currentType = computed(() => (route.params.type as string) || 'ui')
/** 当前用例类型（来自路由参数，默认 ui；接口测试模块固定为 api） */
const currentType = computed(() => {
// 接口测试模块路由 /api-test/execution → 固定为 api
if (route.path.startsWith('/api-test')) return 'api'
return (route.params.type as string) || 'ui'
})
const activeExecution = ref<any>(null)
const runDialogVisible = ref(false)
......@@ -772,6 +777,32 @@ const createAndRunExecution = async () => {
ElMessage.info('安全测试已启动，请等待...')
startPolling()
await loadExecutions()
} else if (currentType.value === 'api') {
// 接口测试走 apiTestApi
const execResponse: any = await apiTestApi.createExecution({
case_ids: selectedCases.value,
name: runConfig.value.name || `接口测试-${new Date().toLocaleString()}`,
})
const execId = execResponse.execution_id
// 获取完整执行记录
const fullExec = await executionApi.get(execId)
activeExecution.value = fullExec
runDialogVisible.value = false
selectedCases.value = []
runConfig.value.name = ''
// 触发接口测试执行
apiTestApi.runExecution(execId).then(() => {
ElMessage.success('接口测试执行完成')
loadExecutions()
}).catch((error: any) => {
console.warn('接口测试执行异常:', error.message)
loadExecutions()
})
ElMessage.info('接口测试已启动，请等待...')
startPolling()
await loadExecutions()
} else {
// UI用例走 executionApi
execution = await executionApi.create({
......
frontend/src/views/device-sim/CentralSim.vue
浏览文件 @ f3035587
......@@ -11,14 +11,30 @@
<div class="page-header">
<h2>中控设备模拟</h2>
<div class="header-actions">
<el-select v-model="currentEnvId" placeholder="选择环境" clearable style="width: 220px">
<el-select v-model="currentEnvId" placeholder="选择环境" clearable style="width: 220px" @change="onEnvChange">
<el-option v-for="env in envConfigs" :key="env.id" :label="env.name" :value="env.id" />
</el-select>
</div>
</div>
<!-- 统计卡片 -->
<div class="stats-row">
<div class="stat-card">
<div class="stat-value">{{ total }}</div>
<div class="stat-label">总设备</div>
</div>
<div class="stat-card running">
<div class="stat-value">{{ runningCount }}</div>
<div class="stat-label">运行中</div>
</div>
<div class="stat-card stopped">
<div class="stat-value">{{ total - runningCount }}</div>
<div class="stat-label">已停止</div>
</div>
</div>
<!-- 设备列表 -->
<DeviceList device-type="central" @device-changed="onDeviceChanged" />
<DeviceList device-type="central" :env-config-id="currentEnvId" @device-changed="onDeviceChanged" @env-change="onDeviceEnvChange" />
</div>
</template>
......@@ -26,22 +42,47 @@
import { ref, onMounted } from 'vue'
import { ElMessage } from 'element-plus'
import DeviceList from '@/components/device/DeviceList.vue'
import { listEnvConfigs } from '@/api/deviceSim'
import { listEnvConfigs, getDeviceStats } from '@/api/deviceSim'
import type { EnvConfig } from '@/types/device'
const envConfigs = ref<EnvConfig[]>([])
const currentEnvId = ref('')
const total = ref(0)
const runningCount = ref(0)
async function loadStats() {
try {
const stats = await getDeviceStats({ deviceType: 'central', envConfigId: currentEnvId.value || undefined })
total.value = stats.total
runningCount.value = stats.running
} catch (e: any) {
// 静默失败，不影响设备列表加载
}
}
function onDeviceChanged() {}
function onEnvChange() {
loadStats()
}
function onDeviceChanged() {
loadStats()
}
/** DeviceList 内部环境筛选变化时，同步页面顶部环境选择并刷新统计 */
function onDeviceEnvChange(envId: string) {
currentEnvId.value = envId
loadStats()
}
onMounted(async () => {
try {
const res = await listEnvConfigs({ limit: 100 })
envConfigs.value = res.items
if (res.items.length > 0) currentEnvId.value = res.items[0].id
// 不自动选中环境，默认不传 envConfigId 查全部设备
} catch (e: any) {
ElMessage.error('加载环境配置失败')
}
await loadStats()
})
</script>
......@@ -50,4 +91,13 @@ onMounted(async () => {
.page-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 16px; }
.page-header h2 { font-size: 20px; font-weight: 600; color: #303133; margin: 0; }
.header-actions { display: flex; align-items: center; gap: 12px; }
.stats-row { display: flex; gap: 16px; margin-bottom: 16px; }
.stat-card { flex: 1; padding: 16px 20px; background: #f5f7fa; border-radius: 8px; text-align: center; }
.stat-card .stat-value { font-size: 28px; font-weight: 700; color: #303133; }
.stat-card .stat-label { font-size: 13px; color: #909399; margin-top: 4px; }
.stat-card.running { background: #f0f9eb; }
.stat-card.running .stat-value { color: #67c23a; }
.stat-card.stopped { background: #f4f4f5; }
.stat-card.stopped .stat-value { color: #909399; }
</style>
\ No newline at end of file
frontend/src/views/device-sim/ClientSim.vue
浏览文件 @ f3035587
......@@ -11,14 +11,30 @@
<div class="page-header">
<h2>集控客户端模拟</h2>
<div class="header-actions">
<el-select v-model="currentEnvId" placeholder="选择环境" clearable style="width: 220px">
<el-select v-model="currentEnvId" placeholder="选择环境" clearable style="width: 220px" @change="onEnvChange">
<el-option v-for="env in envConfigs" :key="env.id" :label="env.name" :value="env.id" />
</el-select>
</div>
</div>
<!-- 统计卡片 -->
<div class="stats-row">
<div class="stat-card">
<div class="stat-value">{{ total }}</div>
<div class="stat-label">总设备</div>
</div>
<div class="stat-card running">
<div class="stat-value">{{ runningCount }}</div>
<div class="stat-label">运行中</div>
</div>
<div class="stat-card stopped">
<div class="stat-value">{{ total - runningCount }}</div>
<div class="stat-label">已停止</div>
</div>
</div>
<!-- 设备列表 -->
<DeviceList device-type="client" @device-changed="onDeviceChanged" />
<DeviceList device-type="client" :env-config-id="currentEnvId" @device-changed="onDeviceChanged" @env-change="onDeviceEnvChange" />
</div>
</template>
......@@ -26,22 +42,47 @@
import { ref, onMounted } from 'vue'
import { ElMessage } from 'element-plus'
import DeviceList from '@/components/device/DeviceList.vue'
import { listEnvConfigs } from '@/api/deviceSim'
import { listEnvConfigs, getDeviceStats } from '@/api/deviceSim'
import type { EnvConfig } from '@/types/device'
const envConfigs = ref<EnvConfig[]>([])
const currentEnvId = ref('')
const total = ref(0)
const runningCount = ref(0)
async function loadStats() {
try {
const stats = await getDeviceStats({ deviceType: 'client', envConfigId: currentEnvId.value || undefined })
total.value = stats.total
runningCount.value = stats.running
} catch (e: any) {
// 静默失败，不影响设备列表加载
}
}
function onDeviceChanged() {}
function onEnvChange() {
loadStats()
}
function onDeviceChanged() {
loadStats()
}
/** DeviceList 内部环境筛选变化时，同步页面顶部环境选择并刷新统计 */
function onDeviceEnvChange(envId: string) {
currentEnvId.value = envId
loadStats()
}
onMounted(async () => {
try {
const res = await listEnvConfigs({ limit: 100 })
envConfigs.value = res.items
if (res.items.length > 0) currentEnvId.value = res.items[0].id
// 不自动选中环境，默认不传 envConfigId 查全部设备
} catch (e: any) {
ElMessage.error('加载环境配置失败')
}
await loadStats()
})
</script>
......@@ -50,4 +91,13 @@ onMounted(async () => {
.page-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 16px; }
.page-header h2 { font-size: 20px; font-weight: 600; color: #303133; margin: 0; }
.header-actions { display: flex; align-items: center; gap: 12px; }
.stats-row { display: flex; gap: 16px; margin-bottom: 16px; }
.stat-card { flex: 1; padding: 16px 20px; background: #f5f7fa; border-radius: 8px; text-align: center; }
.stat-card .stat-value { font-size: 28px; font-weight: 700; color: #303133; }
.stat-card .stat-label { font-size: 13px; color: #909399; margin-top: 4px; }
.stat-card.running { background: #f0f9eb; }
.stat-card.running .stat-value { color: #67c23a; }
.stat-card.stopped { background: #f4f4f5; }
.stat-card.stopped .stat-value { color: #909399; }
</style>
\ No newline at end of file
frontend/src/views/device-sim/DoorSim.vue
浏览文件 @ f3035587
......@@ -41,7 +41,7 @@
</div>
<!-- 设备列表 -->
<DeviceList device-type="door" :env-config-id="currentEnvId" @device-changed="onDeviceChanged" />
<DeviceList device-type="door" :env-config-id="currentEnvId" @device-changed="onDeviceChanged" @env-change="onDeviceEnvChange" />
</div>
</template>
......@@ -49,7 +49,7 @@
import { ref, onMounted } from 'vue'
import { ElMessage } from 'element-plus'
import DeviceList from '@/components/device/DeviceList.vue'
import { listEnvConfigs } from '@/api/deviceSim'
import { listEnvConfigs, getDeviceStats } from '@/api/deviceSim'
import type { EnvConfig } from '@/types/device'
const envConfigs = ref<EnvConfig[]>([])
......@@ -57,24 +57,39 @@ const currentEnvId = ref('')
const total = ref(0)
const runningCount = ref(0)
async function loadStats() {
try {
const stats = await getDeviceStats({ deviceType: 'door', envConfigId: currentEnvId.value || undefined })
total.value = stats.total
runningCount.value = stats.running
} catch (e: any) {
// 静默失败，不影响设备列表加载
}
}
function onEnvChange() {
// 环境切换时重新加载
loadStats()
}
function onDeviceChanged() {
// 设备变化时刷新统计
loadStats()
}
/** DeviceList 内部环境筛选变化时，同步页面顶部环境选择并刷新统计 */
function onDeviceEnvChange(envId: string) {
currentEnvId.value = envId
loadStats()
}
onMounted(async () => {
try {
const res = await listEnvConfigs({ limit: 100 })
envConfigs.value = res.items
if (res.items.length > 0 && !currentEnvId.value) {
currentEnvId.value = res.items[0].id
}
// 不自动选中环境，默认不传 envConfigId 查全部设备
} catch (e: any) {
ElMessage.error('加载环境配置失败')
}
await loadStats()
})
</script>
......
frontend/src/views/device-sim/EnvConfig.vue
浏览文件 @ f3035587
......@@ -90,6 +90,23 @@
</el-col>
</el-row>
<!-- 主题前缀配置（多主题） -->
<el-divider content-position="left">主题前缀配置</el-divider>
<el-row :gutter="16">
<el-col :span="12" v-for="dt in DEVICE_TYPES" :key="dt">
<el-form-item :label="DEVICE_TYPE_LABELS[dt]">
<el-input v-model="form.topics![dt]" :placeholder="`device/${dt}`" size="small" />
</el-form-item>
</el-col>
</el-row>
<el-alert
type="info"
:closable="false"
show-icon
title="各设备类型使用独立的 MQTT 主题前缀，留空默认按 device/{设备类型} 生成"
style="margin-bottom: 8px"
/>
<!-- 默认主题参数配置 -->
<el-divider content-position="left">默认主题参数</el-divider>
<el-row :gutter="16">
......@@ -179,6 +196,20 @@ import {
testEnvConnection,
} from '@/api/deviceSim'
import type { EnvConfig, EnvConfigCreate } from '@/types/device'
import { DEVICE_TYPE_LABELS } from '@/types/device'
/** 支持配置主题前缀的设备类型（按固定顺序展示） */
const DEVICE_TYPES = ['door', 'paperless', 'central', 'client'] as const
/** 由主题前缀自动生成默认多主题映射 */
function defaultTopics(): Record<string, string> {
return {
door: 'device/door',
paperless: 'device/paperless',
central: 'device/central',
client: 'device/client',
}
}
const loading = ref(false)
const configs = ref<EnvConfig[]>([])
......@@ -196,6 +227,7 @@ const defaultForm = (): EnvConfigCreate => ({
password: 'mqtt@webpassw0RD',
useTls: false,
clientIdPrefix: 'sim',
topics: defaultTopics(),
defaultTopicParams: {
company_id: '',
room_ids: [''],
......@@ -251,6 +283,7 @@ function openEditDialog(row: EnvConfig) {
password: '',
useTls: row.useTls,
clientIdPrefix: row.clientIdPrefix,
topics: row.topics ? { ...row.topics } : defaultTopics(),
defaultTopicParams: row.defaultTopicParams ? {
company_id: row.defaultTopicParams.company_id || '',
room_ids: row.defaultTopicParams.room_ids?.length ? [...row.defaultTopicParams.room_ids] : [''],
......
frontend/src/views/device-sim/PaperlessSim.vue
浏览文件 @ f3035587
......@@ -11,14 +11,30 @@
<div class="page-header">
<h2>无纸化模拟</h2>
<div class="header-actions">
<el-select v-model="currentEnvId" placeholder="选择环境" clearable style="width: 220px">
<el-select v-model="currentEnvId" placeholder="选择环境" clearable style="width: 220px" @change="onEnvChange">
<el-option v-for="env in envConfigs" :key="env.id" :label="env.name" :value="env.id" />
</el-select>
</div>
</div>
<!-- 统计卡片 -->
<div class="stats-row">
<div class="stat-card">
<div class="stat-value">{{ total }}</div>
<div class="stat-label">总设备</div>
</div>
<div class="stat-card running">
<div class="stat-value">{{ runningCount }}</div>
<div class="stat-label">运行中</div>
</div>
<div class="stat-card stopped">
<div class="stat-value">{{ total - runningCount }}</div>
<div class="stat-label">已停止</div>
</div>
</div>
<!-- 设备列表 -->
<DeviceList device-type="paperless" @device-changed="onDeviceChanged" />
<DeviceList device-type="paperless" :env-config-id="currentEnvId" @device-changed="onDeviceChanged" @env-change="onDeviceEnvChange" />
</div>
</template>
......@@ -26,22 +42,47 @@
import { ref, onMounted } from 'vue'
import { ElMessage } from 'element-plus'
import DeviceList from '@/components/device/DeviceList.vue'
import { listEnvConfigs } from '@/api/deviceSim'
import { listEnvConfigs, getDeviceStats } from '@/api/deviceSim'
import type { EnvConfig } from '@/types/device'
const envConfigs = ref<EnvConfig[]>([])
const currentEnvId = ref('')
const total = ref(0)
const runningCount = ref(0)
async function loadStats() {
try {
const stats = await getDeviceStats({ deviceType: 'paperless', envConfigId: currentEnvId.value || undefined })
total.value = stats.total
runningCount.value = stats.running
} catch (e: any) {
// 静默失败，不影响设备列表加载
}
}
function onDeviceChanged() {}
function onEnvChange() {
loadStats()
}
function onDeviceChanged() {
loadStats()
}
/** DeviceList 内部环境筛选变化时，同步页面顶部环境选择并刷新统计 */
function onDeviceEnvChange(envId: string) {
currentEnvId.value = envId
loadStats()
}
onMounted(async () => {
try {
const res = await listEnvConfigs({ limit: 100 })
envConfigs.value = res.items
if (res.items.length > 0) currentEnvId.value = res.items[0].id
// 不自动选中环境，默认不传 envConfigId 查全部设备
} catch (e: any) {
ElMessage.error('加载环境配置失败')
}
await loadStats()
})
</script>
......@@ -50,4 +91,13 @@ onMounted(async () => {
.page-header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 16px; }
.page-header h2 { font-size: 20px; font-weight: 600; color: #303133; margin: 0; }
.header-actions { display: flex; align-items: center; gap: 12px; }
.stats-row { display: flex; gap: 16px; margin-bottom: 16px; }
.stat-card { flex: 1; padding: 16px 20px; background: #f5f7fa; border-radius: 8px; text-align: center; }
.stat-card .stat-value { font-size: 28px; font-weight: 700; color: #303133; }
.stat-card .stat-label { font-size: 13px; color: #909399; margin-top: 4px; }
.stat-card.running { background: #f0f9eb; }
.stat-card.running .stat-value { color: #67c23a; }
.stat-card.stopped { background: #f4f4f5; }
.stat-card.stopped .stat-value { color: #909399; }
</style>
\ No newline at end of file
frontend/src/views/functional-report/TemplateConfig.vue
浏览文件 @ f3035587
......@@ -33,10 +33,13 @@
:class="{ active: selectedId === tpl.id }"
@click="selectTemplate(tpl.id)"
>
<div class="template-left">
<div class="template-info">
<span class="template-name">{{ tpl.name }}</span>
<el-tag v-if="tpl.is_default" size="small" type="success" class="default-tag">默认</el-tag>
</div>
<div v-if="tpl.description" class="template-desc" :title="tpl.description">{{ tpl.description }}</div>
</div>
<div class="template-actions">
<el-tooltip content="设为默认" placement="top">
<el-button
......@@ -49,6 +52,16 @@
<el-icon><Star /></el-icon>
</el-button>
</el-tooltip>
<el-tooltip content="复制模板" placement="top">
<el-button
size="small"
circle
text
@click.stop="handleDuplicate(tpl)"
>
<el-icon><CopyDocument /></el-icon>
</el-button>
</el-tooltip>
<el-tooltip content="删除" placement="top">
<el-button
size="small"
......@@ -94,6 +107,13 @@
</el-form-item>
</el-col>
</el-row>
<el-row :gutter="20">
<el-col :span="18">
<el-form-item label="模板描述">
<el-input v-model="editForm.description" type="textarea" :rows="2" maxlength="200" show-word-limit placeholder="模板用途说明（可选）" />
</el-form-item>
</el-col>
</el-row>
<!-- ===== 报告章节开关 ===== -->
<el-divider content-position="left">报告章节开关</el-divider>
......@@ -291,7 +311,7 @@
import { reactive, ref, onMounted, watch } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { Plus, Delete, Star } from '@element-plus/icons-vue'
import { Plus, Delete, Star, CopyDocument } from '@element-plus/icons-vue'
import {
reportTemplateApi,
type ReportTemplateListItem,
......@@ -303,6 +323,7 @@ import {
interface EditForm {
name: string
description: string
is_default: boolean
config: ReportTemplateConfig
}
......@@ -395,6 +416,7 @@ const saving = ref(false)
/** 编辑表单数据 */
const editForm = reactive<EditForm>({
name: '',
description: '',
is_default: false,
config: createDefaultConfig(),
})
......@@ -422,6 +444,7 @@ async function loadTemplateDetail(id: number) {
try {
const detail: ReportTemplateResponse = await reportTemplateApi.get(id)
editForm.name = detail.name
editForm.description = detail.description || ''
editForm.is_default = detail.is_default
// 合并配置，确保所有字段存在
editForm.config = deepClone(mergeConfig(detail.config))
......@@ -506,6 +529,7 @@ async function handleSave() {
try {
await reportTemplateApi.update(selectedId.value, {
name: editForm.name,
description: editForm.description,
is_default: editForm.is_default,
config: editForm.config,
})
......@@ -534,6 +558,19 @@ async function handleSetDefault(tpl: ReportTemplateListItem) {
}
}
/** 复制模板 */
async function handleDuplicate(tpl: ReportTemplateListItem) {
try {
const result = await reportTemplateApi.duplicate(tpl.id)
ElMessage.success(`已复制模板「${result.name}」`)
await loadTemplates()
selectedId.value = result.id
await loadTemplateDetail(result.id)
} catch (err: any) {
ElMessage.error('复制模板失败：' + (err?.message || '未知错误'))
}
}
/** 删除模板 */
async function handleDelete(tpl: ReportTemplateListItem) {
try {
......@@ -566,6 +603,7 @@ function handleReset() {
if (!originalSnapshot) return
const snapshot = JSON.parse(originalSnapshot)
editForm.name = snapshot.name
editForm.description = snapshot.description
editForm.is_default = snapshot.is_default
editForm.config = snapshot.config
ElMessage.success('已重置到上次保存状态')
......@@ -642,6 +680,14 @@ onMounted(() => {
border-color: #409eff;
}
.template-left {
display: flex;
flex-direction: column;
gap: 2px;
flex: 1;
min-width: 0;
}
.template-info {
display: flex;
align-items: center;
......
frontend/src/views/performance/ReportPanel.vue
浏览文件 @ f3035587
......@@ -250,12 +250,13 @@ async function loadReport() {
try {
const res = await getReport(taskId.value)
report.value = res
// 先隐藏骨架屏让图表 div 渲染到 DOM，再初始化图表（v-if/v-else-if 互斥，否则 ref 为 undefined）
loading.value = false
await nextTick()
initCharts()
updateCharts()
} catch (e: any) {
ElMessage.error('加载报告失败: ' + (e.response?.data?.detail || e.message || ''))
} finally {
loading.value = false
}
}
......
frontend/src/views/system/Settings.vue
浏览文件 @ f3035587
<!--
页面名称：Settings.vue
页面描述：系统配置页面（待完善）
页面描述：系统配置页面（钉钉对接配置）
路径：/system/settings
@author czj
@date 2026-07-09
@date 2026-08-13
-->
<template>
<div class="settings-page">
<el-empty description="系统配置页面 - 待实现" />
<el-card shadow="never">
<template #header>
<div class="card-header">
<span>钉钉对接配置</span>
</div>
</template>
<el-form
ref="formRef"
:model="form"
:rules="rules"
label-width="140px"
label-position="right"
style="max-width: 600px"
>
<el-form-item label="AppKey" prop="app_key">
<el-input
v-model="form.app_key"
type="password"
show-password
placeholder="请输入钉钉应用 AppKey"
clearable
/>
</el-form-item>
<el-form-item label="AppSecret" prop="app_secret">
<el-input
v-model="form.app_secret"
type="password"
show-password
placeholder="请输入钉钉应用 AppSecret"
clearable
/>
</el-form-item>
<el-form-item label="AgentId" prop="agent_id">
<el-input-number
v-model="form.agent_id"
:min="0"
:max="999999999"
:step="1"
style="width: 100%"
/>
</el-form-item>
<el-form-item>
<el-button type="primary" :loading="saving" @click="handleSave">
{{ saving ? '保存中...' : '保存配置' }}
</el-button>
<el-button @click="handleReset">重置</el-button>
</el-form-item>
</el-form>
</el-card>
</div>
</template>
<script setup lang="ts">
/**
* 系统配置页面
*
* 功能：
* 1. 加载时自动获取当前钉钉对接配置（从数据库 / 环境变量回退）
* 2. 修改后保存到数据库，重启后持久化
*/
import { reactive, ref, onMounted } from 'vue'
import { ElMessage } from 'element-plus'
import { systemApi } from '@/api/system'
// ==================== 类型定义 ====================
interface DingTalkConfigForm {
app_key: string
app_secret: string
agent_id: number
}
// ==================== 响应式数据 ====================
const formRef = ref()
const saving = ref(false)
const form = reactive<DingTalkConfigForm>({
app_key: '',
app_secret: '',
agent_id: 0,
})
/** 原始数据快照，用于重置 */
let originalSnapshot = ''
// ==================== 表单校验规则 ====================
const rules = {
app_key: [{ required: true, message: '请输入钉钉 AppKey', trigger: 'blur' }],
app_secret: [{ required: true, message: '请输入钉钉 AppSecret', trigger: 'blur' }],
agent_id: [{ required: true, message: '请输入钉钉 AgentId', trigger: 'blur' }],
}
// ==================== 方法 ====================
/** 加载配置 */
async function loadConfig() {
try {
const res = await systemApi.getDingTalkConfig()
Object.assign(form, res)
originalSnapshot = JSON.stringify(res)
} catch (err: any) {
ElMessage.error('加载钉钉配置失败：' + (err?.message || '未知错误'))
}
}
/** 保存配置 */
async function handleSave() {
const valid = await formRef.value?.validate().catch(() => false)
if (!valid) return
saving.value = true
try {
await systemApi.updateDingTalkConfig({
app_key: form.app_key,
app_secret: form.app_secret,
agent_id: form.agent_id,
})
ElMessage.success('钉钉配置已保存')
originalSnapshot = JSON.stringify({ ...form })
} catch (err: any) {
ElMessage.error('保存钉钉配置失败：' + (err?.message || '未知错误'))
} finally {
saving.value = false
}
}
/** 重置表单到加载时的值 */
function handleReset() {
const snapshot = JSON.parse(originalSnapshot)
Object.assign(form, snapshot)
formRef.value?.clearValidate()
}
// ==================== 生命周期 ====================
onMounted(() => {
loadConfig()
})
</script>
<style scoped>
.settings-page {
padding: 40px;
max-width: 800px;
}
.card-header {
font-size: 16px;
font-weight: 600;
}
</style>
\ No newline at end of file
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑！
请 注册 或者 后发表评论