196 lines
4.7 KiB
Markdown
196 lines
4.7 KiB
Markdown
# 05 修复验收测试计划
|
||
|
||
生成时间：2026-06-22
|
||
|
||
## 1. 验收目标
|
||
|
||
修复完成后，必须证明以下目标同时成立：
|
||
|
||
1. RTCP frame 自动进入 LinuxCNC kinematics WASM 边界。
|
||
2. 3D 预览首屏和程序运行后均可见。
|
||
3. HOME 后 JOG 坐标连续。
|
||
4. 原已通过功能不回归。
|
||
|
||
## 2. 本地静态和 Node 测试
|
||
|
||
### 2.1 构建
|
||
|
||
```bash
|
||
npm --prefix web-rtcp-5axis-sim-plan/app run build
|
||
```
|
||
|
||
预期：
|
||
|
||
```text
|
||
exit code 0
|
||
无 TypeScript/ES module 打包错误
|
||
```
|
||
|
||
### 2.2 状态和 runtime smoke
|
||
|
||
按项目已有测试能力执行：
|
||
|
||
```bash
|
||
node web-rtcp-5axis-sim-plan/tests/node/verify_rtcp_store.mjs
|
||
node web-rtcp-5axis-sim-plan/tests/node/verify_five_axis_session.mjs
|
||
node web-rtcp-5axis-sim-plan/tests/node/verify_linuxcnc_kinematics_runtime.mjs
|
||
node web-rtcp-5axis-sim-plan/tests/node/verify_linuxcnc_task_hal_runtime.mjs
|
||
node web-rtcp-5axis-sim-plan/tests/node/verify_full_execution_boundary.mjs
|
||
```
|
||
|
||
如某个测试依赖本地构建产物缺失，应先按项目原有构建流程补齐，不要跳过。
|
||
|
||
## 3. 浏览器自动化验收
|
||
|
||
### 3.1 D1 验收：首屏 kinematics 自动 ready
|
||
|
||
打开本地或部署页面后等待最多 8 秒，断言：
|
||
|
||
```js
|
||
const state = window.webRtcp5AxisSimulation.getState();
|
||
state.kinematicsRuntimeReadiness.loaded === true
|
||
state.sourceMode === "source-derived-kinematics-wasm"
|
||
state.frameSourceMode === "source-derived-kinematics-wasm"
|
||
state.rtcpFrame.semanticBoundary === "linuxcnc_kinematics_wasm_c_abi"
|
||
```
|
||
|
||
DOM 断言：
|
||
|
||
```js
|
||
document.querySelector('[data-rtcp-diagnostic="boundary"]').textContent.includes("linuxcnc_kinematics_wasm_c_abi")
|
||
document.querySelector('[data-rtcp-diagnostic="kinematics-ready"]').textContent.includes("ready")
|
||
```
|
||
|
||
禁止状态：
|
||
|
||
```text
|
||
fixture_frame_ui_plumbing_not_linuxcnc_kinematics_proof
|
||
```
|
||
|
||
不得作为稳定态出现。
|
||
|
||
### 3.2 D2 验收：预览非空
|
||
|
||
断言 canvas dataset：
|
||
|
||
```js
|
||
canvas.dataset.threeReady === "true"
|
||
Number(canvas.dataset.threeSceneObjects) > 0
|
||
canvas.dataset.threeRenderer === "webgl" || canvas.dataset.threeRenderer === "2d-fallback"
|
||
```
|
||
|
||
像素断言：
|
||
|
||
```js
|
||
const stats = readCanvasPixelStats(canvas)
|
||
stats.nonBlackRatio > 0.02
|
||
stats.averageLuminance > 5
|
||
```
|
||
|
||
截图人工检查：
|
||
|
||
```text
|
||
能看到工作台/坐标轴/刀具或 TCP 点/路径
|
||
```
|
||
|
||
至少覆盖：
|
||
|
||
```text
|
||
首屏
|
||
加载 LinuxCNC vendored 程序后
|
||
Run 后
|
||
Open 本地 G-code 后
|
||
Audit 后
|
||
```
|
||
|
||
### 3.3 D3 验收：HOME/JOG 坐标连续
|
||
|
||
自动化步骤：
|
||
|
||
```js
|
||
click POWER
|
||
click MANUAL
|
||
click HOME
|
||
const home = state.axisPose
|
||
click X+
|
||
assert state.axisPose.x === home.x + state.machine.jogIncrement
|
||
assert state.axisPose.y === home.y
|
||
assert state.axisPose.z === home.z
|
||
click Y-
|
||
assert state.axisPose.y === home.y - state.machine.jogIncrement
|
||
assert state.axisPose.x === home.x + state.machine.jogIncrement
|
||
```
|
||
|
||
允许浮点误差：
|
||
|
||
```text
|
||
abs(actual - expected) <= 0.001
|
||
```
|
||
|
||
人工检查：
|
||
|
||
```text
|
||
DRO 中 X/Y/Z 数字连续变化，没有跳到 0/1 局部原点。
|
||
```
|
||
|
||
## 4. 全功能回归清单
|
||
|
||
修复完成后，至少回归以下功能：
|
||
|
||
| 功能 | 预期 |
|
||
| --- | --- |
|
||
| 主界面九大区域 | 全部存在 |
|
||
| POWER on/off | taskState 正确 |
|
||
| E-STOP/RESET | 急停和复位正确 |
|
||
| AUTO/MANUAL/JOG/MDI | 模式切换正确 |
|
||
| HOME | allHomed=true，DRO 到 HOME pose |
|
||
| JOG X+/X-/Y+/Y- | DRO 连续变化 |
|
||
| MDI M428 | RTCP on，tcp-xyzac |
|
||
| MDI M429 | RTCP off，identity |
|
||
| MDI M430 | userk |
|
||
| TCP/IDENTITY 侧栏按钮 | RTCP 状态正确 |
|
||
| Rapid/Feed/Spindle override | 数值可调 |
|
||
| Flood/Mist | 状态可切换 |
|
||
| View X/Y/Z/Fit/Clear/Full | preview state 正确，画面仍可见 |
|
||
| Profile xyzac/xyzbc 切换 | INI 与 runtime 重新 ready |
|
||
| Stage LinuxCNC sources | staged files/gcode 数量正常 |
|
||
| Load vendored G-code | programSource 正确，G-code 行显示 |
|
||
| Run/Pause/Resume/Step/Stop/Reload | runState 和 activeLine 正确 |
|
||
| Open local G-code | programSource=operator-file |
|
||
| Save/Restore Session | OPFS 保存恢复正确 |
|
||
| Audit Full Boundary | 审计入口可执行，结果可诊断 |
|
||
|
||
## 5. QA 报告复跑
|
||
|
||
修复后建议复用或更新：
|
||
|
||
```text
|
||
/home/mes123456/cnc_wams/qa/web-rtcp-5axis-site-test/run-site-test.mjs
|
||
```
|
||
|
||
重点更新：
|
||
|
||
1. 首屏等待稳定后，不再把 D1 作为 WARN，而是强制 PASS/FAIL。
|
||
2. canvas 检查加入像素统计。
|
||
3. HOME/JOG 检查使用稳定态并验证连续坐标。
|
||
4. 重新生成 Word 报告，文件名建议：
|
||
|
||
```text
|
||
web-rtcp-5axis-site-test-report-2026-06-22-after-working1-fix.docx
|
||
```
|
||
|
||
## 6. 验收通过定义
|
||
|
||
```text
|
||
P0: D1 PASS
|
||
P0: D2 PASS
|
||
P1: D3 PASS
|
||
全功能回归无新增 FAIL
|
||
console error = 0
|
||
page error = 0
|
||
request failure = 0
|
||
```
|
||
|
||
如果 headless WebGL 不稳定，必须证明 2D fallback 可见且自动化 pixel 检查通过。
|
||
|