cloud
90 lines
2.4 KiB
Markdown
90 lines
2.4 KiB
Markdown
---
|
|
name: edge-system-test-writer
|
|
description: edge_collector 系统测试文档编写规范。用于为协议采集、边缘前端、云平台 AI 分析、WiFi/4G、内网穿透、端口转发、OTA、离线缓存、部署同步等功能编写验收测试、系统测试、测试评审清单和问题回溯记录。
|
|
---
|
|
|
|
# edge_collector 系统测试编写
|
|
|
|
## 适用范围
|
|
|
|
- 协议采集：FANUC、西门子、Modbus、OPC UA、传感器等。
|
|
- 边缘功能：WiFi、4G、内网穿透、端口转发、离线缓存、OTA、高级功能页面。
|
|
- 云平台：历史趋势、AI 分析、设备状态、配置管理。
|
|
- 部署：`package.sh`、`deploy_cloud.sh`、`scripts/migrate_edge.sh`、systemd 服务。
|
|
|
|
## 文档落点
|
|
|
|
- 通用测试方案：`docs/`
|
|
- 协议测试：`collector/docs/protocols/`
|
|
- 鲁班猫/设备测试：`docs/鲁班猫*/`
|
|
- 本地模型测试：`docs/本地模型/`
|
|
|
|
## 输出结构
|
|
|
|
```text
|
|
测试目标
|
|
测试范围
|
|
测试环境
|
|
测试数据
|
|
前置条件
|
|
测试场景
|
|
测试步骤与预期结果
|
|
异常与恢复场景
|
|
问题记录与回溯
|
|
通过标准
|
|
```
|
|
|
|
## 测试场景要求
|
|
|
|
每个功能至少覆盖：
|
|
|
|
- 正常路径。
|
|
- 参数非法或配置缺失。
|
|
- 网络断开、服务重启、进程异常退出。
|
|
- 同步/打包后动态配置是否被保留。
|
|
- 前端操作反馈、失败提示、权限控制。
|
|
- 远程目标主机差异，如 82/97/94/87 的架构和系统环境。
|
|
|
|
## 协议采集专项
|
|
|
|
测试点包括：
|
|
|
|
- 驱动能否按协议模板加载。
|
|
- 连接、读取、断线重连、设备离线恢复。
|
|
- 点位值类型是否符合 `PointData::UpdateValue` 预期。
|
|
- 用户可见协议介绍不暴露内部实现。
|
|
- ARM64/ARM32 helper 或第三方库场景要覆盖构建和运行验证。
|
|
|
|
## 前端专项
|
|
|
|
测试点包括：
|
|
|
|
- 页面不白屏。
|
|
- 按钮有 loading、成功、失败反馈。
|
|
- 弹窗使用项目统一对话框。
|
|
- 窄屏和长内容不遮挡、不溢出。
|
|
- 接口失败时展示可理解错误，不只显示通用失败。
|
|
|
|
## 验证命令
|
|
|
|
按实际改动选择：
|
|
|
|
```bash
|
|
npm run build
|
|
cmake --build build --target collector -j2
|
|
./package.sh --edge-only
|
|
bash -n scripts/<name>.sh
|
|
jq empty <config.json>
|
|
```
|
|
|
|
远程同步或重启必须等用户明确要求，并遵循对应部署 skill。
|
|
|
|
## 问题回溯
|
|
|
|
测试文档应保留问题回溯表：
|
|
|
|
```markdown
|
|
| 问题 | 影响场景 | 根因位置 | 修复提交/文件 | 回归结果 |
|
|
|------|----------|----------|----------------|----------|
|
|
```
|