cloud
2.4 KiB
2.4 KiB
name, description
| name | description |
|---|---|
| edge-system-test-writer | 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/本地模型/
输出结构
测试目标
测试范围
测试环境
测试数据
前置条件
测试场景
测试步骤与预期结果
异常与恢复场景
问题记录与回溯
通过标准
测试场景要求
每个功能至少覆盖：
- 正常路径。
- 参数非法或配置缺失。
- 网络断开、服务重启、进程异常退出。
- 同步/打包后动态配置是否被保留。
- 前端操作反馈、失败提示、权限控制。
- 远程目标主机差异，如 82/97/94/87 的架构和系统环境。
协议采集专项
测试点包括：
- 驱动能否按协议模板加载。
- 连接、读取、断线重连、设备离线恢复。
- 点位值类型是否符合
PointData::UpdateValue预期。 - 用户可见协议介绍不暴露内部实现。
- ARM64/ARM32 helper 或第三方库场景要覆盖构建和运行验证。
前端专项
测试点包括：
- 页面不白屏。
- 按钮有 loading、成功、失败反馈。
- 弹窗使用项目统一对话框。
- 窄屏和长内容不遮挡、不溢出。
- 接口失败时展示可理解错误，不只显示通用失败。
验证命令
按实际改动选择：
npm run build
cmake --build build --target collector -j2
./package.sh --edge-only
bash -n scripts/<name>.sh
jq empty <config.json>
远程同步或重启必须等用户明确要求，并遵循对应部署 skill。
问题回溯
测试文档应保留问题回溯表：
| 问题 | 影响场景 | 根因位置 | 修复提交/文件 | 回归结果 |
|------|----------|----------|----------------|----------|