ssw-h5dev-flow: 加 BS-52 + 4 条浏览器层铁律 + summary 自检硬关卡
根因: tds2 上一轮 e2e 报告 28/28 TC 100% PASS 但功能区空白 - dacli form create v0.7.4 补 columnList 时没补 btnsList/rowBtnsList - e2e_browser.py 'skip modal' 反当 PASS, 'create attempted' 反当 PASS - 30 张 B-TC 截图实际只有 10 个唯一 MD5 (连拍同页面 3 次) 修复: - 阶段 2.5: 5 类盲点 → 6 类, 加 BS-52 按钮存在性 (硬关卡) - 阶段 5.0: 4 条铁律 (BS-52 / skip≠PASS / create failed≠PASS / 截图去重) - 阶段 6.0: summary.html 自检硬关卡, 抽查 30% form + 截图去重 + PASS 数字可重跑 Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
4a7e365266
commit
fbc2cc8601
1 file changed
+82
-1
@@ -262,8 +262,9 @@ dacli app status # 确认登录状态
|
||||
```
|
||||
2. **exit 0** → 进阶段 3 审核
|
||||
3. **exit 1** → **阻断! 把 FAIL 项回贴给设计者, 改 design 后强制重跑** (无重试次数上限, 改对为止)
|
||||
4. 5 类盲点 (BS-23 / BS-31 / BS-32 / BS-15 / BS-V2) 必须**显式 PASS 或 N/A**, 静默跳过不算过
|
||||
4. **6 类盲点** (BS-15 / BS-23 / BS-31 / BS-32 / BS-50 / **BS-52**) + BS-V2 必须**显式 PASS 或 N/A**, 静默跳过不算过
|
||||
5. 复用规则: 详见 `dacli form lint --help` (与运行时 `dacli form validate` 共享 `_blindspots.ts`, 零 drift)
|
||||
6. **【BS-52 按钮存在性】** (2026-06-21 tds2 复盘新增): webType≠4 form 的 `columnData.btnsList` 必含"新增"按钮, `rowBtnsList` 必含"编辑"按钮. 缺一即 FAIL, 阻断阶段 3. **根因**: dacli form create v0.7.4 自动补 columnList 时**没补 btnsList/rowBtnsList**, 导致列表页顶部"新增/导入/导出"按钮和行内"编辑/删除"按钮全空白, 用户看到"功能区空白"但 e2e 报告 100% PASS. 防御: lint 阶段 2.5 必查, exit 非 0 必须修.
|
||||
|
||||
### 阶段3: 审核
|
||||
1. 创建多角色agent虚拟评审(系统架构、项目管理、UI、程序设计、质量、测试角色)
|
||||
@@ -308,6 +309,56 @@ dacli app status # 确认登录状态
|
||||
- E2E 测试:推荐用 `ssw-e2e-test` 技能的 v17 标准库(`clickMenu` / `fillByLabel` / `saveModal` 等)跑端到端;`playwright -s=dacli open ... && playwright -s=dacli eval ...` 是底层 CLI(详见 `ssw-e2e-test` 技能 `🎯 v17 JNPF 浏览器验证标准库` 段)。**仅 JNPF 平台有效**。
|
||||
4. 发现问题直接修复并验证,遇到平台、dacli相关问题、处理措施、建议、提示词优化写到 `$ccWorkDir/docs/{app_code}/debug.html`
|
||||
|
||||
#### 阶段 5.0: 浏览器层硬约束 (2026-06-21 tds2 复盘新增, 4 条铁律)
|
||||
|
||||
> ⚠️ **根因**: tds2 上一轮 e2e 报告 28/28 TC 100% PASS, summary.html 写"阶段5完成", 但用户实测发现"几乎所有功能没有新增按钮/设置功能区是空白". 复盘发现 4 类测试方法系统性漏洞, 全部让"假 PASS"混进报告. **以下 4 条铁律不可破**.
|
||||
|
||||
1. **铁律 1: BS-52 按钮存在性 (snapshot 必含"新增"按钮)**
|
||||
- E2E 浏览器层每个 form 的 TC-{name}-B1 必查: 列表页**有"新增"按钮** (button:has-text("新增") / icon-ym-generator-add)
|
||||
- **缺按钮 = FAIL** (硬关卡, 不是 skip, 不是 PASS)
|
||||
- 视图模式 (webType=4) 例外, msg="view-only (no add)" 接受
|
||||
- 验证: `dacli form info {id}` 看 `columnData.btnsList` 非空且含 "新增" 按钮配置
|
||||
|
||||
2. **铁律 2: skip modal ≠ PASS (找不到"新增"按钮必须 FAIL)**
|
||||
- 反模式 (tds2 e2e_browser.py:271): `status = "FAIL" if is_404 else "PASS"` —— 把"无新增按钮"当 skip 反算 PASS
|
||||
- **正确逻辑**: `has_add` False 且 webType≠4 → status="FAIL" msg="BS-52 FAIL: 无新增按钮"
|
||||
- 凡是测试代码里出现 "skip" / "fallback" / "if not found" 仍然 PASS 的逻辑, **必视为 bug 修复**
|
||||
|
||||
3. **铁律 3: create failed ≠ PASS (create 失败必须 FAIL, 不能用 list OK 兜底)**
|
||||
- 反模式 (tds2 e2e_browser.py:497-500): create 返 "System abnormality" → fallback "list OK" → PASS
|
||||
- **正确逻辑**: POST create HTTP 200 + body.code==200 才算 PASS, 任何 4xx/5xx/msg 含 "abnormal" / "Field cannot be empty" 都 FAIL
|
||||
- E2E 报告里出现 "create attempted: ..." 字样, 一律视为 FAIL 报告造假
|
||||
|
||||
4. **铁律 4: 截图 md5 去重 (3 张截图 MD5 不能全相同)**
|
||||
- 每个 TC 必截 3 张: list / add-modal / data
|
||||
- 3 张 MD5 不能完全相同 (反模式: 连拍同一页面 3 次当 3 张)
|
||||
- e2e 报告生成后必跑去重断言:
|
||||
```bash
|
||||
python3 -c "import hashlib,glob; m={f:hashlib.md5(open(f,'rb').read()).hexdigest() for f in glob.glob('screenshots/TC-*-*-*.png')};
|
||||
from collections import Counter; dup=[k for k,v in Counter(m.values()).items() if v>1];
|
||||
assert not dup, f'重复截图 MD5: {dup}'"
|
||||
```
|
||||
- 断言失败 → 报告作废, 强制重跑
|
||||
- **真做交互**: shot 2 必先 `page.wait_for_selector('.ant-modal', timeout=5000)` 等弹窗出现再拍
|
||||
|
||||
#### 阶段 5.0 自检命令 (写完 e2e_report.md 后必跑)
|
||||
|
||||
```bash
|
||||
# 1. BS-52 抽查: 必查 1-2 个 form 的 btnsList
|
||||
dacli form info {formId} | python3 -c "
|
||||
import json,sys; d=json.load(sys.stdin); cd=json.loads(d['columnData'])
|
||||
btns=cd.get('btnsList',[]); rows=cd.get('rowBtnsList',[])
|
||||
print('btnsList:', [b.get('label') for b in btns])
|
||||
print('rowBtnsList:', [b.get('label') for b in rows])
|
||||
assert any('新增' in b.get('label','') for b in btns), 'BS-52 FAIL: 缺新增按钮'
|
||||
assert any('编辑' in b.get('label','') for b in rows), 'BS-52 FAIL: 缺编辑按钮'
|
||||
print('BS-52 PASS')
|
||||
"
|
||||
|
||||
# 2. 截图去重断言 (见铁律 4)
|
||||
python3 -c "import hashlib,glob; from collections import Counter; m={f:hashlib.md5(open(f,'rb').read()).hexdigest() for f in glob.glob('docs/{app_code}/screenshots/TC-*-*-*.png')}; dup=[k for k,v in Counter(m.values()).items() if v>1]; assert not dup, f'BS-52 截图去重 FAIL: {dup}'; print('截图去重 PASS,', len(m), '张')"
|
||||
```
|
||||
|
||||
### 阶段6: 总结
|
||||
输出 `$ccWorkDir/docs/{app_code}/summary.html`(**HTML格式**):
|
||||
- 遇到的问题及处理措施
|
||||
@@ -316,6 +367,36 @@ dacli app status # 确认登录状态
|
||||
- claude 技能、命令、脚本提示体系修改建议
|
||||
- dacli / JNPF 平台修改建议
|
||||
|
||||
#### 阶段 6.0: summary.html 自检硬关卡 (2026-06-21 tds2 复盘新增)
|
||||
|
||||
> ⚠️ **根因**: tds2 summary.html 写"10 forms + 6 workflows + 20 menus + 12 dict + 1 dashboard, 28/28 TC PASS"——但 7 个 form 的 `columnData.btnsList=[]`, 列表页"新增"按钮空白. 报告数字漂亮, 实际功能区空白. **写完 summary.html 前必跑自检, 不通过不写"功能区完整"**.
|
||||
|
||||
**自检硬关卡 (3 条, 缺一不写总结)**:
|
||||
|
||||
1. **BS-52 全量自查**: 抽查 ≥30% form (向上取整, 至少 3 个) 的 `columnData.btnsList/rowBtnsList`, 必含 "新增"+"编辑" 按钮. 不含 → 修完再写总结.
|
||||
```bash
|
||||
# 抽 1/3 form 检查 BS-52
|
||||
N=$(dacli form list 2>/dev/null | wc -l)
|
||||
CHECK_N=$(( (N + 2) / 3 ))
|
||||
for id in $(dacli form list 2>/dev/null | awk 'NR>3 && $1 ~ /^[0-9]+$/ {print $1}' | head -$CHECK_N); do
|
||||
dacli form info $id | python3 -c "import json,sys; d=json.load(sys.stdin); cd=json.loads(d['columnData']); btns=cd.get('btnsList',[]); rows=cd.get('rowBtnsList',[]); assert any('新增' in b.get('label','') for b in btns), f'BS-52 FAIL {d[\"enCode\"]}: 缺新增按钮'; assert any('编辑' in b.get('label','') for b in rows), f'BS-52 FAIL {d[\"enCode\"]}: 缺编辑按钮'; print(f' {d[\"enCode\"]} BS-52 PASS')"
|
||||
done
|
||||
```
|
||||
|
||||
2. **截图去重自检**: 跑铁律 4 的 md5 去重断言. 通过才能写"44 截图覆盖 3 类 TC" 之类数字.
|
||||
|
||||
3. **TC PASS 数字可重跑验证**: summary 写的 `X TC PASS` 必须能跑出同样结果. 反模式: e2e 跑 1 次, summary 写 28 TC, 重跑 0 TC (因 skip 兜底). 防御: 写完数字后, 立即重跑 e2e 1 次, 数字必须 100% 一致.
|
||||
|
||||
**summary.html 数字段必含 BS-52 自检结果段**:
|
||||
```html
|
||||
<h3>X.1 BS-52 自检 (2026-06-21 防御)</h3>
|
||||
<ul>
|
||||
<li>抽样: N/M form (≥30%)</li>
|
||||
<li>结果: 全部 PASS / X 个 FAIL (列名)</li>
|
||||
<li>截图去重: 16 unique / 44 total, dup 28 (FAIL) ← 这种情况不能写"截图覆盖完整"</li>
|
||||
</ul>
|
||||
```
|
||||
|
||||
### 阶段7: 迭代
|
||||
根据总结文档、详细设计、测试用例文档,从阶段2开始迭代
|
||||
|
||||
|
||||
Reference in new issue
Block a user