109 lines
5.1 KiB
Markdown
109 lines
5.1 KiB
Markdown
# V2.0.4 周报 — 车检器测试工装项目
|
||
|
||
**报告周期**：2026年6月1日 ~ 6月5日
|
||
**项目**：vd_test_fixture（车检器自动化测试工装）
|
||
**作者**：wangfq
|
||
|
||
---
|
||
|
||
## 一、概述
|
||
|
||
本周完成 V2.0.3 波动测试模式全链路实现、继电器状态存储重构、测试操作/信息页面多项增强，以及若干关键 Bug 修复。共提交 **24 个 commits**（主仓库 19 + edc_server 子模块 4 + edc-web 1）。
|
||
|
||
---
|
||
|
||
## 二、波动测试模式（V2.0.3）
|
||
|
||
### 2.1 协议文档
|
||
- DG430 串口协议升级至 V2.0.3
|
||
- 扩展 0x4B/0x4C 字段：新增 FarTol、NearTol、StepTol、BackForth、NearStay、FarStay（6 个波动参数）
|
||
- 新增 0xB4 波动测试上报指令定义
|
||
- 第 6 章拆分为 6.1 灵敏度测试流程 + 6.2~6.4 波动测试流程
|
||
|
||
### 2.2 后端 edc_server
|
||
| 模块 | 变更 |
|
||
|------|------|
|
||
| `dg430.py` | 新增 `DG430WaveStatus` dataclass、`parse_b4_wave_status()` 解析器；扩展 `DG430FixtureParams` + `parse_4c_params()` 支持 6 个新字段 |
|
||
| `models.py` | DDL 增加 10 个新列（test_mode、data_source、remain_count、work_freq、b4_enter_dist 等）；新增 `insert_wave_data()` 存库函数；ALTER TABLE 自动迁移逻辑 |
|
||
| `handlers.py` | parse_loop 增加 0xB4 分支，波动数据路由入库；0x4C 处理传递新参数字段 |
|
||
|
||
### 2.3 前端 edc-web
|
||
- **工装参数页**：表单增加 6 个波动参数输入框，JS 适配新字段
|
||
- **测试操作页**：右侧新增「波动测试数据」显示区，实时展示 B4 上报数据
|
||
- **测试信息页**：拆为三视图标签页（全部/灵敏度测试 B2/波动测试 B4），按 `data_source` 自动切换列布局
|
||
- 波动测试数据支持 Excel 导出
|
||
|
||
---
|
||
|
||
## 三、继电器输出状态重构
|
||
|
||
### 3.1 存储层
|
||
- `tb_state_tst` 新增 `relay_code TINYINT` 列，存储原始 hex 值
|
||
- `0x00` = 无输出，`0x01` = 存在信号，`0x02` = 脉冲信号，`0x03` = 存在+脉冲
|
||
- `relay_out` VARCHAR 列保留，兼容历史数据
|
||
- B2/B4 解析后直接以 int 值写入 `relay_code`
|
||
|
||
### 3.2 前端
|
||
- 新增 `decodeRelay()` 函数：整数 → 可读文本
|
||
- 测试操作页、测试信息页（表格视图）统一使用解码显示
|
||
- **图表视图**：新增第 4 Y 轴（继电器输出），红色三角阶梯线，tooltip 自动解码
|
||
|
||
---
|
||
|
||
## 四、测试操作页面增强
|
||
|
||
| 功能 | 说明 |
|
||
|------|------|
|
||
| 自动化间隔/超时 | 新增间隔时间（秒）和超时时间（秒）参数；重写为状态机驱动，收到回复后等待间隔再发下一条，超时立即发下一条 |
|
||
| 渲染容错 | 每个 render 调用独立 try-catch，避免一处报错级联导致全部数据显示失败 |
|
||
| 初始数据加载 | 页面打开时自动请求最新测试数据，无需等待启动自动化 |
|
||
| 时间格式统一 | 所有区域统一显示 `yyyy-MM-dd HH:mm:ss`，修复 Flask jsonify "GMT" 导致的 UTC+8 时区偏移 |
|
||
|
||
---
|
||
|
||
## 五、测试信息页面增强
|
||
|
||
| 功能 | 说明 |
|
||
|------|------|
|
||
| 三视图标签页 | 全部 / 灵敏度测试 (B2) / 波动测试 (B4)，独立列布局 |
|
||
| ECharts 图表 | 表格/图表一键切换，B2 显示 8 条线（峰峰值/频率/距离/速度），B4 显示 7+1 条线（含继电器），三 Y 轴，dataZoom 缩放，保存为 2x PNG |
|
||
| 分页条数 | 搜索栏增加「每页：20/50/100」下拉框 |
|
||
| Admin 删除 | 仅 admin 可见，按设备编码/日期范围/数据来源筛选删除，确认框防误删，`tb_log` 留痕 |
|
||
|
||
---
|
||
|
||
## 六、Bug 修复
|
||
|
||
| 问题 | 根因 | 修复 |
|
||
|------|------|------|
|
||
| FarStay 字段长度 | 用户纠正：NearStay 和 FarStay 均为 2 字节 | 全量回退 1 字节改动，恢复协议+代码 2 字节设计 |
|
||
| 数据库缺列 | 旧表缺少 V2.0.3 新增字段 | 服务启动时 ALTER TABLE ADD COLUMN IF NOT EXISTS 自动迁移 |
|
||
| 时间显示偏移 8 小时 | Flask jsonify 给本地时间加 "GMT" 后缀，JS 误当 UTC 解析 | `fmtTime()` 先 strip "GMT" 再解析 |
|
||
| 测试操作三个数据区不显示 | pollProgress 共用一个 try-catch，一处报错跳过后续渲染；全部完成时 return 跳过最终渲染 | 独立 try-catch；渲染代码移到 return 之前 |
|
||
| 自动化平均值/明细不显示 | 同上（渲染代码在 return 之后） | 同上 |
|
||
|
||
---
|
||
|
||
## 七、Git 提交统计
|
||
|
||
**主仓库**（vd_test_fixture）：19 commits
|
||
**子模块**（edc_server）：4 commits
|
||
**合计**：23 commits
|
||
|
||
| 日期 | 主题 |
|
||
|------|------|
|
||
| 6/1 | 培训手册 V1.0、精简 requirements.txt |
|
||
| 6/2 | DG430 V2.0.3 协议文档、后端实现、前端同步、ALTER TABLE 迁移 |
|
||
| 6/3 | FarStay 字节修正、波动测试前端适配、三视图重构 |
|
||
| 6/4 | 自动化间隔/超时、协议文档补充灵敏度流程 |
|
||
| 6/5 | 时间格式化、分页条数、ECharts 图表、图表保存图片、admin 删除、继电器重构、时区修复、渲染容错、图表继电器系列 |
|
||
|
||
---
|
||
|
||
## 八、待办事项
|
||
|
||
- [ ] 重启 edc_server 使数据库迁移和新字段生效
|
||
- [ ] edc-web 重启（用户已手动停止）
|
||
- [ ] 端到端测试完整波动测试流程（参数设置 → 查询 → 执行 → B4 上报 → 前端展示）
|
||
- [ ] 验证图表功能在不同数据量下的表现
|