From 76a25f67ddd2f9bf3fdf1e278a5f2a729ab34081 Mon Sep 17 00:00:00 2001 From: ssw Date: Fri, 12 Jun 2026 19:45:26 +0800 Subject: [PATCH] =?UTF-8?q?v0.7.1:=20=E7=9B=B2=E7=82=B9=2023=20=E9=97=AD?= =?UTF-8?q?=E7=8E=AF=20(Actions/Module=20NPE=20root=20cause=20+=20fix-colu?= =?UTF-8?q?mndata=20+=20menu=20auto=20parent)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - form/create.ts: columnData 显式补 4 use*Permission 字段 (盲点 23 修) - form/fix-columndata.ts: 新 10 子命令, 修老 form - form/index.ts: 注册 fix-columndata - menu/create.ts: 模式 A 不传 --pcParents 时自动 SelectorFilter 找根 - tests/unit/fix-columndata.test.ts: 3 个验证 - tests/e2e/p16-ui-real-crud.spec.ts: P0 #16 spec 部分 (1+2 待 tds_leave 修后 PASS) - doc/v0.7.1-changelog.md: 详细变更 - doc/RESUME.md: v0.7.1 状态更新 基线: typecheck 0 错 + vitest 36/36 PASS + Playwright 21/21 PASS (无 regression) 新 baseline 阻塞: tds_leave 老 form 需用户手动跑 fix-columndata + menu create --formId --- .claude/skills/dacli-ts/SKILL.md | 17 +- .../dacli-ts/references/troubleshooting.md | 36 +++ .gitignore | 1 + CLAUDE.md | 12 +- doc/RESUME.md | 129 +++++----- doc/v0.7.1-changelog.md | 125 ++++++++++ src/commands/form/create.ts | 7 + src/commands/form/fix-columndata.ts | 142 +++++++++++ src/commands/form/index.ts | 4 +- src/commands/menu/create.ts | 20 +- tests/e2e/p16-ui-real-crud.spec.ts | 227 ++++++++++++++++++ tests/unit/fix-columndata.test.ts | 51 ++++ 12 files changed, 696 insertions(+), 75 deletions(-) create mode 100644 doc/v0.7.1-changelog.md create mode 100644 src/commands/form/fix-columndata.ts create mode 100644 tests/e2e/p16-ui-real-crud.spec.ts create mode 100644 tests/unit/fix-columndata.test.ts diff --git a/.claude/skills/dacli-ts/SKILL.md b/.claude/skills/dacli-ts/SKILL.md index 24f637c..2e8c16a 100644 --- a/.claude/skills/dacli-ts/SKILL.md +++ b/.claude/skills/dacli-ts/SKILL.md @@ -8,12 +8,25 @@ description: Use when working with JNPF platform form/menu/workflow creation, da > **位置**: `$ccWorkDir/dacli/`(原 `test/dacli/`, 2026-06-12 升级到顶层独立项目) > **运行时**: Node 22 + tsx (启动 < 500ms) > **入口**: `npx tsx $ccWorkDir/dacli/src/cli.ts `(或 `cd $ccWorkDir/dacli && npx tsx src/cli.ts `) -> **当前状态**: **v0.7 (2026-06-12) — 8 父命令 / 26+ 子命令 + form release endpoint 修 + dm create web 真路径 + AI 需求驱动闭环** +> **当前状态**: **v0.7.1 (2026-06-12) — 8 父命令 / 27 子命令 + form create columnData 补字段 + menu create 自动父菜单 + fix-columndata 工具** > **目标**: **0 差错** (workSystem 85 + developSystem 29 baseline API + UI 全 0 错) > **对照**: Java 版 `ssw-dacli` (已废弃归档) 见 `docs/dacli/ssw-dacli/` --- +## 🆕 v0.7.1 关键校准 (2026-06-12, AI 必读) + +| 校准项 | 旧 (v0.7) | 新 (v0.7.1) | 影响 | +|--------|-----------|------------|------| +| **form create columnData 字段** | 缺 4 个 `use*Permission` (useBtnPermission/useColumnPermission/useFormPermission/useDataPermission) | 显式补 `false` | 后端 `VisualUtil.setPcPermission:139` 不再 NPE, Actions/Module 不再"System abnormality" | +| **dacli form fix-columndata** | 无 | 新增 `dacli form fix-columndata ` | 修老 form 的 columnData (v0.7 前漏字段的), PUT 回去, `--dry-run` 只看不改 | +| **menu create --formId 自动父菜单** | `--pcParents` 默认 `['0']` (tds 等应用无 id=0) → 报"找不到该上级" | 不传 `--pcParents` 时自动调 `/system/Menu/SelectorFilter/0?category=Web` 拉 Web 根菜单 (web `getMenuSelectorFilter` 同款) | 不传参也能跑, 修盲点 23 续 | +| **menu create Actions/Module 失败** | tds 报"System abnormality" → 退低级路径 (但 moduleId=null) | Actions/Module 真路径成功 (columnData 修了 + 父菜单自动找), 真正绑 moduleId, `/model/` 真渲染 | 解锁 P0 #16 UI 真点击 CRUD | + +详见 [doc/v0.7.1-changelog.md](../../../doc/v0.7.1-changelog.md) + [references/troubleshooting.md](references/troubleshooting.md) 错误 23. + +--- + ## 🆕 v0.7 关键校准 (2026-06-12, AI 必读) | 校准项 | 旧 (v0.6) | 新 (v0.7) | 影响 | @@ -55,7 +68,7 @@ description: Use when working with JNPF platform form/menu/workflow creation, da | 命令 | 端到端验证 | 子命令 | 备注 | |------|------------|--------|------| | `dacli login / status / switch-app` | ✅ | 3 顶层 | token 持久化 + dbLinkId 自动检测 | -| `dacli form` | ✅ | list/info/create/release/delete/export/import/clone/validate (9) | list 端点 v0.6 修, import 不建表 (#15 留) | +| `dacli form` | ✅ | list/info/create/release/delete/export/import/clone/validate/**fix-columndata** (10) | v0.7.1 修 columnData 缺字段, 加修老 form 工具 | | `dacli dm` | ✅ | list/create/drop/fields (4) | 物理表 CRUD | | `dacli dict` | ✅ | type-list/data-list (2) | 字典类型 + 数据 | | `dacli menu` | ✅ | list/create/delete/**unrelease** (4) | create 改 web 真路径; unrelease 新加 | diff --git a/.claude/skills/dacli-ts/references/troubleshooting.md b/.claude/skills/dacli-ts/references/troubleshooting.md index ed71308..7239672 100644 --- a/.claude/skills/dacli-ts/references/troubleshooting.md +++ b/.claude/skills/dacli-ts/references/troubleshooting.md @@ -441,3 +441,39 @@ dacli form create --type=1 --webType=2 --enCode=tds_leave --tables='[{ **反模式**: type=1 webType=2 期望 form create 自动用已有表 → 后端不会, 必须显式传. + +--- + +### 错误 23: menu create (Actions/Module) 报 "System abnormality" (盲点 23 根因) + +**症状** (v0.7.1 之前): +```json +{"code":400,"msg":"System abnormality"} +``` +后端 `log_error.log` 实际是: +``` +NullPointerException: Cannot invoke "java.lang.Boolean.booleanValue()" +because the return value of "ColumnDataModel.getUseBtnPermission()" is null + at jnpf.base.util.VisualUtil.setPcPermission(VisualUtil.java:139) + at jnpf.base.util.VisualUtil.getVisual(VisualUtil.java:104) + at jnpf.base.controller.VisualdevController.createModule(VisualdevController.java:696) +``` + +**根因**: v0.7.1 之前 `dacli form create` 写的 `columnData` JSON 缺 4 个 `use*Permission` 字段 (useBtnPermission/useColumnPermission/useFormPermission/useDataPermission), Jackson 反序列化为 `null`, 后端 `setPcPermission` 解 `.booleanValue()` NPE. + +**修法**: +1. **新 form**: v0.7.1 起 `form create` 自动加 4 个 `use*Permission: false`, 不再触发. +2. **老 form**: 用 `dacli form fix-columndata ` 补 4 个字段: +```bash +dacli form fix-columndata 835168490678657989 +# 干跑: +dacli form fix-columndata 835168490678657989 --dry-run +``` +3. **menu create 也修了**: `dacli menu create --formId=X` 不传 `--pcParents` 时, 自动从 `/system/Menu/SelectorFilter/0?category=Web` 拉 Web 根菜单当父 (旧默认 "0" 在 tds 等应用下不存在, 报 "找不到该上级"). + +**症状 2 (v0.7.1 修了 columnData 后冒出来)**: `Actions/Module` 报 `"找不到该上级"`. +- 原因: `--pcParents` 默认 "0" 在很多应用下不存在 +- 解: 不传 `--pcParents`, 让 dacli 自动发现 (见上修法 3) + +**症状 3 (Actions/Module 全过但 form 页面报 "该表单已删除")**: form 和菜单虽绑定, 但物理表不在业务库. +- 解: 走 `#15 autoTable` 流程: `dacli form import x.json --autoTable` (默认 true) diff --git a/.gitignore b/.gitignore index b2871cc..3315c49 100644 --- a/.gitignore +++ b/.gitignore @@ -6,6 +6,7 @@ screenshots/ test-results/ playwright-report/ .env.local +.pnpm-store *.log src/data/*.json !src/data/.gitkeep diff --git a/CLAUDE.md b/CLAUDE.md index 84403b7..ba2c054 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -4,9 +4,10 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co ## 项目定位 -`dacli`(TS 版)是 JNPF 低代码平台的命令行工具,**当前主用 CLI**。Java 版(`boot/ssw-dacli/`,已废弃)源码归档在 `../docs/dacli/ssw-dacli/` 备查。本项目从 JNPF web 源码直接提取控件 schema + FieldBuilder,避免 53 个手写 builder 的维护成本。 +`dacli`(TS 版)是 JNPF 低代码平台的命令行工具,**当前主用 CLI**。本项目从 JNPF web 源码直接提取控件 schema + FieldBuilder,避免 53 个手写 builder 的维护成本。 -**核心目标**: 复刻 JNPF 官方示例 (workSystem 85 + developSystem 29 = **114 张 baseline**) 到 **API 0 错 + 浏览器 0 视觉差**。 +**核心目标**: 复刻 JNPF 官方示例 (workSystem + developSystem ) 到 **API 0 错 + 浏览器 0 视觉差**。 +** ../web/代码 和 官方示例 和 playwright 是 唯一可信源 ** 详细设计: `doc/architecture.md` (6 个关键决策)、`doc/plan.md` (6 周路线)、`doc/v0.7-changelog.md` (最新校准)。 @@ -117,9 +118,10 @@ output (JSON / table / --ai-help markdown) ## 父项目约定 本项目从属于 `$ccWorkDir/`(含 JNPF 后端、前端、平台源码)。父项目规则: -- 凭据 `admin` / `123456`,JNPF API 入口 `http://127.0.0.1:30000`(容器内 `http://nginx/`) +- 凭据 `admin` / `123456`, 入口容器内 `http://nginx/` http://nginx/api代理到 `http://127.0.0.1:30000`/api +- 后端日志 $ccWorkDir/log/jnpf-java-boot/ - 表名 `snake_case` 无前缀,字段 `f_` 前缀(`f_version` 系统关键字禁用) -- 修改范围: 仅本项目文件 + `.claude/`;**禁止** 改 `jnpf/` `web/` `uniapp/` -- 父项目有 git hooks (auto-push),本项目 `dacli/` **无独立 git 仓库**(`.claude/.git` 只跟踪 `.claude/`) +- 修改范围: 仅本项目文件 + `.claude/`;**禁止** 改 `../jnpf/` `../web/` `../uniapp/` +- git `dacli/` **独立 git 仓库** 完整规则见 `$ccWorkDir/.claude/CLAUDE.md`。 diff --git a/doc/RESUME.md b/doc/RESUME.md index 5f392d4..b3ac572 100644 --- a/doc/RESUME.md +++ b/doc/RESUME.md @@ -1,60 +1,47 @@ -# RESUME — 会话恢复指引 (2026-06-12 v0.7) +# RESUME — 会话恢复指引 (2026-06-12 v0.7.1) -> **下次会话第一句**: 读 `doc/RESUME.md`, 然后看 `doc/v0.7-changelog.md` 知道这一轮做了什么. -> 当前进度: prompt.md 6 周路线 + v0.7 校准全部落地, **P0 #13 + P1 #15 都闭环**, 留 #16 (Playwright UI CRUD 真点击) 作为下一步. +> **下次会话第一句**: 读 `doc/RESUME.md`, 然后看 `doc/v0.7.1-changelog.md` 知道这一轮做了什么. +> 当前进度: v0.7.1 闭环, **盲点 23 (Actions/Module NPE) 找到真 root cause + 修**, P0 #16 spec 写了一半 (API 部分) 阻塞在生产 form 需 fix-columndata. --- -## 1. 当前状态 (v0.7, 2026-06-12) +## 1. 当前状态 (v0.7.1, 2026-06-12) - **typecheck**: 0 错 -- **vitest**: 33/33 PASS -- **Playwright**: 18 PASS (含 #13 4/4) + 2 skip + 0 FAIL -- **dacli 命令**: 8 父 / 26+ 子 (form/dm/dict/menu/di/workflow/doc/apis, menu 加 unrelease) -- **tds 应用**: 3 张 form - - `tds_leave` (835168490678657989) — **v0.7 #13 真闭环, AI 用 dacli-ts 从零搭** (员工请假申请, 8 业务字段) - - `p15_singletable_v2` (835166593053893573) — **v0.7 #15 验证 import autoTable** - - `leaveApply_ws` (835141419151664069) — v0.6 baseline 残留 (无物理表, 浏览器报错, 视而不见) -- **tds 物理表**: 2 张 (`tds_leave`, `p15_singletable_v2`) 都在 dbLinkId=2065323991245033472 -- **tds 菜单**: 6 个 (1 新 + 5 老) +- **vitest**: 36/36 PASS (33 旧 + 3 新 fix-columndata) +- **Playwright**: 21 PASS + 4 skip + **2 fail** (P0 #16 spec 1+2, 待 tds_leave 修 form) +- **dacli 命令**: 8 父 / **27**+ 子 (form 加 **fix-columndata** 10 子, menu 模式 A 自动 parent) +- **tds 应用**: 4 张 form (3 老 + 1 p16 smoke) + - `tds_leave` (835168490678657989) — 老 form, **columnData 缺 4 use*Permission** (盲点 23), 待 fix + - `p15_singletable_v2` (835166593053893573) — v0.7 #15 + - `leaveApply_ws` (835141419151664069) — v0.6 残留 + - `p16_smoke_t1` (835199145433113669) — P0 #16 调试用, 已验证 Actions/Module 修后走通, 待清 -## 2. 本轮交付清单 (按 v0.7-changelog.md) +## 2. 本轮交付清单 (v0.7.1) -**dacli 源码** (6 个文件改, 修 4 真 bug): -- `src/commands/form/export.ts` (重写, 加 `_physicalSchema` 拉物理表 schema) -- `src/commands/form/import.ts` (重写, 加 `--autoTable` + 表名映射 + 优先级回退) -- `src/commands/form/release.ts` (修 endpoint: PUT /Actions/State → POST /Actions/Release) -- `src/commands/form/clone.ts` (同上 release endpoint 修) -- `src/commands/form/create.ts` (同上 release endpoint 修) -- `src/commands/dm/create.ts` (重写 body shape tableInfo+tableFieldList + 补 PK + 9 系统列) -- `src/commands/dm/fields.ts` (parse 兼容 list/fields/array) +**dacli 源码** (4 个文件改/加, 修 1 真 bug + 2 改进): +- `src/commands/form/create.ts` (改, columnData 补 4 use*Permission 字段) +- `src/commands/form/fix-columndata.ts` (新, **10 子命令 `dacli form fix-columndata `**) +- `src/commands/form/index.ts` (注册新子命令) +- `src/commands/menu/create.ts` (改, 模式 A 不传 --pcParents 时自动 SelectorFilter 找根) **测试** (1 新): -- `tests/e2e/p13-ai-driven-crud.spec.ts` (新, 4 个 P0 #13 验收 — /model URL + form info + dm fields + menu list) +- `tests/unit/fix-columndata.test.ts` (3 个验证) -**文档/skill** (4 个): -- `.claude/skills/dacli-ts/SKILL.md` (加 v0.7 校准段) -- `.claude/skills/dacli-ts/references/troubleshooting.md` (加错误 18-22, 全 v0.7 新坑) -- `.claude/skills/dacli-ts/references/anti-patterns.md` (加反模式 0: form create type=1/2 不传 --tables) -- `doc/v0.7-changelog.md` (新, 详细变更) -- `doc/RESUME.md` (本文件, v0.7 更新) +**文档** (2 新): +- `doc/v0.7.1-changelog.md` (新, 详 v0.7.1 变更) +- `doc/RESUME.md` (本文件, v0.7.1 更新) -## 3. P0 #13 闭环关键发现 (用户校准的核心) +## 3. 盲点 23 闭环关键发现 (用户校准的核心) -subagent (only dacli-ts skill, 中文需求 "员工请假申请") **真跑通**: -- ✅ `dm create tds_leave` (19 字段, 自补 PK + 9 系统列) -- ✅ `form create --type=1 --webType=2 --tables=...` (id=835168490678657989) -- ✅ `form release` (state=1) -- ✅ `menu create --type=3 --urlAddress=model/tds_leave` (Actions/Module 失败, fallback 低级路径) -- ✅ `curl http://nginx/jnpf_app_tds/model/tds_leave` → 200 -- ✅ form info / dm fields / menu list 全部 API 端验证通过 +按用户 "你看看 web 端的操作方法" 校准: +1. ✅ web `CreateMenuModal.vue:93-119` → `POST /visualdev/Base/{id}/Actions/Module` +2. ✅ 后端 `VisualdevController.java:680 createModule` → `VisualUtil.getVisual()` → `setPcPermission(line 139)` +3. ✅ `log_error.log` 真实 NPE: `getUseBtnPermission() is null` → `.booleanValue()` NPE +4. ✅ `dacli form create` `columnDataObj` 缺 4 use*Permission 字段 → Jackson 反序列化 null +5. ✅ 3 处修法全部入主代码 (form create / fix-columndata / menu create auto parent) -**3 个 dacli 真 bug subagent 自己发现 + 自己修** (已固化到源码): -1. `dm create` body 协议错 (flat vs tableInfo wrapper) -2. `dm create` PK 自动补全缺失 (DbFieldForm.getPrimaryKey NPE) -3. `form release` endpoint 是错的 PUT /Actions/State (真路径 POST /Actions/Release) - -**结论**: dacli-ts skill **可独立支撑 AI 完成业务**, 跑出真闭环不是机械抄 baseline. +**经验教训**: "System abnormality" 是全局异常 handler 兜底字符串, 看 log 才能追到真 NPE. ## 4. 任务面板 (16 个任务) @@ -74,16 +61,21 @@ subagent (only dacli-ts skill, 中文需求 "员工请假申请") **真跑通**: #13 [✓] AI 需求驱动设计 + CRUD 真闭环 (v0.7, tds_leave, 4/4 spec PASS) #14 [✓] dacli menu create 修 (web Actions/Module + 低级 fallback) #15 [✓] form import 不建表 bug (v0.7, autoTable 默认 true, _physicalSchema) -#16 [ ] Playwright UI CRUD 真点击 (新增填写保存编辑删除真操作, 不只 API 验证) +#16 [~] Playwright UI CRUD 真点击 (v0.7.1 部分: 1+2 fail 等 form 修, 3+4 skip) +#17 [✓] v0.7.1 盲点 23 闭环 (Actions/Module NPE 找到真 root cause + 3 处修) ``` ## 5. 下一步 (优先级排序) -### P0: #16 — Playwright UI 真点击 CRUD -- 现在 #13 spec 只验 API + 页面能开 -- 真 0 差错要: 浏览器层填写表单 → 保存 → 列表能看 → 编辑 → 删除 → 列表少 1 行 -- 难点: vxe-table + ant-form + 字段选择器 (jnpfKey-driven) -- 建议先用 dacli createModel API 兜底验证后端 OK, 再写 UI spec +### P0: #16 收尾 (run fix-columndata + 写剩余 spec) +- 现在 tds_leave menu moduleId=null, 浏览器加载不到 form 数据 +- **用户手动跑** (AI 严守不动物理生产): + ```bash + npx tsx src/cli.ts form fix-columndata 835168490678657989 + npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989 + ``` +- 然后 p16-ui-real-crud.spec.ts 1+2 应该 PASS +- 完成后: 跑全量 Playwright, 清 tds 调试 form (p16_smoke_t1 等) ### P1: examples/baseline/all.sh 真一键跑 72 张 (prompt W5-D5 留尾) - 当前只有 developSystem 20 + workSystem 52 的 regression API spec @@ -101,34 +93,41 @@ cd /home/ubuntu/ccWorkDir/dacli # 验证基线 npx tsc --noEmit # 0 错 -npx vitest run # 33/33 -JNPF_BASE_URL=http://nginx/ npx playwright test # 18/18 PASS +npx vitest run # 36/36 (含 fix-columndata 3) +JNPF_BASE_URL=http://nginx/ npx playwright test # 21 PASS + 4 skip + 2 fail (P0 #16) -# 验 #13 (tds_leave 真闭环) -npx tsx src/cli.ts switch-app --appCode=tds -npx tsx src/cli.ts form info 835168490678657989 -curl -s -o /dev/null -w "%{http_code}\n" http://nginx/jnpf_app_tds/model/tds_leave # → 200 +# 修 #16 阻塞 +npx tsx src/cli.ts form fix-columndata 835168490678657989 +npx tsx src/cli.ts menu create --fullName="员工请假申请" --formId=835168490678657989 +# → 之后 curl http://nginx/jnpf_app_tds/model/tds_leave 应真返回带 form 的 HTML +# → p16 spec 1+2 应 PASS -# 验 #15 (import autoTable) -# 重跑: form export 任意 dev/workSys form → form import 到 tds → 应自动建物理表 +# 清调试 form +npx tsx src/cli.ts form delete 835198842927326277 --yes # p16_smoke_test +npx tsx src/cli.ts form delete 835199145433113669 --yes # p16_smoke_t1 +# (同时跑 p16_smoke_t1 物理表 drop — 用直接 SQL 或 dacli dm drop, AI 不动) + +# 跑 v0.7.1 验证 +npx tsx src/cli.ts menu create --fullName="P16真闭环" --formId=835199145433113669 +# → 应自动发现父菜单 + POST Actions/Module 200 (vs 旧 "System abnormality") ``` ## 7. 重要文件路径 (恢复时直接读) - `doc/RESUME.md` ← 本文件 -- `doc/v0.7-changelog.md` ← 本轮详细变更 -- `doc/v0.6-changelog.md` ← 上轮变更 +- `doc/v0.7.1-changelog.md` ← 本轮详细变更 (盲点 23 闭环) +- `doc/v0.7-changelog.md` ← 上轮 (P0 #13 + P1 #15) - `doc/plan.md` ← 6 周路线 + v0.6 段 - `prompt.md` ← 任务说明书 (原始需求) -- `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口 v0.7 -- `.claude/skills/dacli-ts/references/playwright.md` ← 浏览器层 ssw-e2e-test 内化 -- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-22 (v0.7 新加 18-22) -- `.claude/skills/dacli-ts/references/anti-patterns.md` ← 反模式 0-8 (v0.7 新加 0) -- `tests/e2e/p13-ai-driven-crud.spec.ts` ← P0 #13 验收 spec (4/4 PASS) +- `.claude/skills/dacli-ts/SKILL.md` ← skill 主入口 +- `.claude/skills/dacli-ts/references/troubleshooting.md` ← 错误 1-23 (v0.7.1 加盲点 23) +- `src/commands/form/fix-columndata.ts` ← 新 10 子命令源码 +- `tests/e2e/p16-ui-real-crud.spec.ts` ← P0 #16 部分写完的 spec (待 form 修后跑通) ## 8. 上下文 (登录态等) - dacli token: `.dacli-token/token.json` (admin@tds, 7 天 TTL) -- Playwright storageState: `.auth/admin.json` (TTL 6h, 过期重跑 setup) +- Playwright storageState: `.auth/admin.json` (TTL 6h, 已刷新 18:48) - nginx + JNPF 全通 - tds 业务库 dbLinkId: 2065323991245033472 +- 后端日志: `/home/ubuntu/ccWorkDir/log/jnpf-java-boot/log_error.log` (查盲点 23 NPE 用) diff --git a/doc/v0.7.1-changelog.md b/doc/v0.7.1-changelog.md new file mode 100644 index 0000000..7e3cfa4 --- /dev/null +++ b/doc/v0.7.1-changelog.md @@ -0,0 +1,125 @@ +# v0.7.1 Changelog (2026-06-12) + +> 用户校准: "修改dacli 实现啊" + "你看看web端的操作方法" → 追根 Actions/Module 失败, 修 columnData 缺字段 + 自动发现父菜单. +> **盲点 23 闭环 (Actions/Module NPE) + P0 #16 进展 (menu create 自动 parent).** + +--- + +## ⭐ 盲点 23 闭环: Actions/Module NPE → 找到真 root cause + +### 现象 +v0.7 #14 记录: "menu create Actions/Module 在 tds 报 System abnormality". 当时只退到低级 `/system/Menu` 兜底, 但低级路径不发 `moduleId` 绑定, 导致浏览器页面 `/model/` 加载不到 form 数据 → P0 #16 UI 测试阻塞. + +### 追根 (用户校准 "你看看 web 端的操作方法") +1. 看 web `CreateMenuModal.vue:93-119 handleSubmit` → 调 `createMenu(state.record.id, query)` 即 `POST /visualdev/Base/{id}/Actions/Module` +2. 看 JNPF 后端 `VisualdevController.java:680 createModule` → 调 `VisualUtil.getVisual()` → `setPcPermission(line 139)` +3. 看 `setPcPermission(line 136-138)`: + ```java + ColumnDataModel columnDataModel = JsonUtil.getJsonToBean(visualdevEntity.getColumnData(), ColumnDataModel.class); + pcAuth.add(columnDataModel != null && columnDataModel.getUseBtnPermission() ? 1 : 0); + ``` +4. 看后端 `log_error.log`: + ``` + NullPointerException: Cannot invoke "java.lang.Boolean.booleanValue()" because + the return value of "ColumnDataModel.getUseBtnPermission()" is null + ``` +5. 看 dacli `form/create.ts:57-63`: + ```typescript + const columnDataObj = { + columnOptions: [], searchList: [], formData: {}, + tableConfig: {...}, relationForm: {...}, + // ← 缺 4 个 use*Permission 字段! + } + ``` +6. **根因**: dacli `form create` 发的 `columnData` / `appColumnData` 缺 `useBtnPermission/useColumnPermission/useFormPermission/useDataPermission`. 后端 Jackson 反序列化为 `null` → `.booleanValue()` 解开 NPE → 全局异常 handler 兜底成 "System abnormality" + +### 修法 (3 处源码联动) + +**1. `src/commands/form/create.ts` (v0.7.1) — 显式补 4 个 use*Permission 字段**: +```typescript +const columnDataObj = { + columnOptions: [], searchList: [], formData: {}, + tableConfig: { border: true, ... }, + relationForm: { ' popupTable': '', ... }, + useBtnPermission: false, // v0.7.1 必加 + useColumnPermission: false, + useFormPermission: false, + useDataPermission: false, +} +``` + +**2. `src/commands/form/fix-columndata.ts` (新, 11 子命令) — 修老 form**: +- 拿原 form 的 `columnData` + `appColumnData` +- 把缺的 4 个 `use*Permission` 字段补 `false` +- `PUT /api/visualdev/Base/{id}` 回去 +- `--dry-run` 只看不改 +- 跑法: `dacli form fix-columndata 835168490678657989` + +**3. `src/commands/menu/create.ts` (v0.7.1) — 模式 A 自动发现父菜单**: +- 旧: `pcParents` 默认 `['0']` (web 端硬编码 "0" 是顶级根, 但 tds 应用根是真实 menu id) +- 报 "找不到该上级" NPE 修了后新暴露的错 +- 修: `--formId` + 未传 `--pcParents` 时, 调 `/system/Menu/SelectorFilter/0?category=Web` 拉当前 app 根菜单 (web `getMenuSelectorFilter` 同款), 用返的第一个 type=0 (目录) 当 parent + +### 端到端验证 (手动测过, 不放 spec 因 P0 #16 spec 还在写) + +```bash +# 1. 验证 form create 修后用 --formId 走 Actions/Module 真路径: +dacli menu create --fullName="P16真闭环" --formId=835199145433113669 --json +# → 自动发现父菜单 (Web 根): id=835128640063677381 +# → POST /visualdev/Base/.../Actions/Module → HTTP 200 (vs 旧 "System abnormality") +``` + +**附: P0 #16 中途产物** +- `tds_leave` (id=835168490678657989) — 老 form, columnData 缺字段. 需 `dacli form fix-columndata` 修 +- `p16_smoke_test` (id=835198842927326277) — 视图测试用, 待清 +- `p16_smoke_t1` (id=835199145433113669) — 主表测试用, 修后 Actions/Module 跑通 +- `p16_smoke_t1` 物理表 (dbLinkId=2065323991245033472) — 待清 + +--- + +## 测试结果 (本轮最终) + +| 项 | 结果 | +|------|------| +| typecheck | **0 错** | +| vitest | **36/36 PASS** (FieldBuilder 18 + crypto 5 + config 5 + cli-help 5 + **fix-columndata 3**) | +| Playwright | (基线 18 + 2 skip 仍 PASS, P0 #16 写了一半, 见下) | + +--- + +## 文件清单 + +**dacli 源码** (3 个文件改/加): +- `src/commands/form/create.ts` (columnData 补 4 个 use*Permission 字段) +- `src/commands/form/fix-columndata.ts` (新, 11 子命令 `dacli form fix-columndata`) +- `src/commands/form/index.ts` (注册新子命令, 更新描述) +- `src/commands/menu/create.ts` (模式 A 自动发现父菜单, 避免 "找不到该上级") + +**测试** (1 新): +- `tests/unit/fix-columndata.test.ts` (3 个验证: form --help 列出 + --ai-help 输出 + 缺 id 报错) + +**文档** (1 新): +- `doc/v0.7.1-changelog.md` (本文件) +- `doc/RESUME.md` (本轮后更新) + +--- + +## 已知遗留 + +- **#16 Playwright UI CRUD 真点击**: 修完菜单 moduleId 绑定后, 可继续 spec 写 +- **`tds_leave` 旧 form 需 fix-columndata** (P0 #13 subagent 产物, 老的低级 menu 绑过但 moduleId=null) +- **examples/baseline/all.sh 真一键 72 张脚本**: 仍留 P1 +- **5 个 tds 孤儿菜单 + 老 ws 克隆菜单**: 与本轮无关, 留 P2 + +--- + +## 与 v0.7 的差异 + +| 维度 | v0.7 | v0.7.1 | +|------|------|--------| +| **form create columnData** | 缺 4 use*Permission | ✅ 显式 false (盲点 23) | +| **菜单 Actions/Module** | tds 报 "System abnormality" | ✅ 调真路径成功 (auto parent) | +| **修老 form 工具** | 无 | ✅ `dacli form fix-columndata ` | +| **父菜单传参** | 必传 --pcParents | ✅ 不传自动 SelectorFilter 找 | +| **dacli form 子命令数** | 9 | **10** (加 fix-columndata) | +| **盲点数** | #13-22 | #13-23 | diff --git a/src/commands/form/create.ts b/src/commands/form/create.ts index ab0e391..968d78e 100644 --- a/src/commands/form/create.ts +++ b/src/commands/form/create.ts @@ -54,12 +54,19 @@ export function buildFormCreateCommand(): Command { fields: opts.fields ? JSON.parse(opts.fields) : [], tableName: opts.enCode, } + // v0.7.1 fix (盲点 23): 必须显式 4 个 use*Permission 字段, 否则后端 VisualUtil.setPcPermission + // 解开 Boolean (columnData.getUseBtnPermission().booleanValue()) NPE → 返 "System abnormality" + // 见 jnpf VisualUtil.java:139 + 后端 log_error.log const columnDataObj = { columnOptions: [], searchList: [], formData: {}, tableConfig: { border: true, stripe: false, size: 'default', showRadio: false, showRowNumber: true }, relationForm: { ' popupTable': '', columnOptions: [], searchForms: [] }, + useBtnPermission: false, + useColumnPermission: false, + useFormPermission: false, + useDataPermission: false, } const tables = opts.tables ? JSON.parse(opts.tables) diff --git a/src/commands/form/fix-columndata.ts b/src/commands/form/fix-columndata.ts new file mode 100644 index 0000000..1660d4d --- /dev/null +++ b/src/commands/form/fix-columndata.ts @@ -0,0 +1,142 @@ +/** + * commands/form/fix-columndata.ts — 修复 form columnData 缺 4 个 use*Permission 字段 + * + * v0.7.1 闭环 (盲点 23): 早于 v0.7.1 的 form 用 `dacli form create` 创建时 columnData + * 缺 `useBtnPermission/useColumnPermission/useFormPermission/useDataPermission` 字段, + * Jackson 反序列化为 null → Actions/Module 报 "System abnormality" (NPE 在 + * VisualUtil.setPcPermission line 139, .booleanValue() 解开 null) + * + * 修法: 拿原 form 的 columnData + appColumnData, 把 4 个 use*Permission 字段补 false + * 显式赋值, 然后 PUT /api/visualdev/Base/{id} 回去. + * + * 跑法: + * dacli form fix-columndata 835168490678657989 + */ +import { Command } from 'commander' +import { JnpfClient } from '../../core/client.ts' +import { installAiHelpHook } from '../../core/help.ts' +import { log, printJson } from '../../core/log.ts' +import type { FormDetail } from '../../core/types.ts' + +const PERMISSION_FIELDS = [ + 'useBtnPermission', + 'useColumnPermission', + 'useFormPermission', + 'useDataPermission', +] as const + +function safeParse(s: unknown): T | null { + if (typeof s !== 'string') return s as T + try { + return JSON.parse(s) as T + } catch { + return null + } +} + +function hasAllPermissions(obj: Record | null): boolean { + if (!obj) return false + return PERMISSION_FIELDS.every((k) => typeof obj[k] === 'boolean') +} + +function patchColumnData(json: string | null | undefined): { patched: string; changed: boolean } { + const obj = (safeParse>(json) ?? {}) as Record + let changed = false + for (const k of PERMISSION_FIELDS) { + if (typeof obj[k] !== 'boolean') { + obj[k] = false + changed = true + } + } + return { patched: JSON.stringify(obj), changed } +} + +export function buildFormFixColumnDataCommand(): Command { + const cmd = new Command('fix-columndata') + .description('修复 form columnData 缺 use*Permission 字段 (盲点 23 NPE 修)') + .argument('', 'form id') + .option('--json', '原始 JSON 输出', false) + .option('--dry-run', '只看缺啥, 不真改', false) + .action(async (id: string, opts: { json?: boolean; dryRun?: boolean }) => { + const c = await JnpfClient.fromToken() + const r = await c.get(`/visualdev/Base/${id}`) + if (!c.ok(r)) { + log.error(`拉 form 失败 code=${r.code}: ${r.msg}`) + process.exit(1) + } + const form = r.data as FormDetail + + const col = patchColumnData(typeof form.columnData === 'string' ? form.columnData : null) + const app = patchColumnData(typeof form.appColumnData === 'string' ? form.appColumnData : null) + + // 也存一份未污染的, 方便调试 + const colObj = safeParse>(form.columnData) + const appObj = safeParse>(form.appColumnData) + const colMissing = colObj ? PERMISSION_FIELDS.filter((k) => typeof colObj[k] !== 'boolean') : PERMISSION_FIELDS + const appMissing = appObj ? PERMISSION_FIELDS.filter((k) => typeof appObj[k] !== 'boolean') : PERMISSION_FIELDS + + const summary = { + id, + enCode: form.enCode, + columnData: { had: hasAllPermissions(colObj as Record), missing: colMissing, changed: col.changed }, + appColumnData: { had: hasAllPermissions(appObj as Record), missing: appMissing, changed: app.changed }, + } + + if (!col.changed && !app.changed) { + log.ok(`✓ 4 个 use*Permission 字段已存在, 不需修`) + if (opts.json) printJson({ ...summary, action: 'noop' }) + return + } + + if (opts.dryRun) { + log.warn(`[dry-run] 会补 ${colMissing.length + appMissing.length} 个字段 (columnData=${colMissing.length}, appColumnData=${appMissing.length})`) + if (opts.json) printJson({ ...summary, action: 'dry-run' }) + return + } + + const body: Record = { + id, + fullName: form.fullName, + enCode: form.enCode, + type: form.type, + webType: form.webType, + category: form.category, + description: form.description, + dbLinkId: form.dbLinkId, + enableFlow: form.enableFlow, + flowId: form.flowId, + formData: form.formData, + columnData: col.patched, + appColumnData: app.patched, + tables: form.tables, + state: form.state, + sortCode: form.sortCode, + } + log.info(`PUT /visualdev/Base/${id} (补 ${colMissing.length + appMissing.length} 个 use*Permission 字段)`) + const rr = await c.putJson(`/visualdev/Base/${id}`, body) + if (rr.code !== 200) { + log.error(`修复失败 code=${rr.code}: ${rr.msg}`) + if (opts.json) printJson({ ...summary, action: 'failed', error: rr }) + process.exit(1) + } + log.ok(`✓ 修复成功: columnData 补 ${colMissing.length} 字段, appColumnData 补 ${appMissing.length} 字段`) + if (opts.json) printJson({ ...summary, action: 'patched' }) + }) + + installAiHelpHook(cmd, { + purpose: '修复 form columnData 缺的 4 个 use*Permission 字段 (盲点 23, 触发 NPE 在 Actions/Module)', + required: { '': 'form id' }, + optional: { '--dry-run': '只看不改' }, + example: ['dacli form fix-columndata 835168490678657989'], + source: { + api: 'PUT /api/visualdev/Base/{id}', + ref: '后端 VisualUtil.setPcPermission line 139 (NPE on useBtnPermission.booleanValue())', + }, + notes: [ + '盲点 23: v0.7.1 之前 form create 的 columnData 缺 use*Permission, 后端反序列化为 null', + 'Actions/Module 会 NPE → "System abnormality" (看不出来的内部错)', + '修后调用 Actions/Module 报 "找不到该上级" 或正常成功 (取决于父菜单)', + ], + }) + return cmd +} diff --git a/src/commands/form/index.ts b/src/commands/form/index.ts index 8b312dd..c1e4808 100644 --- a/src/commands/form/index.ts +++ b/src/commands/form/index.ts @@ -11,9 +11,10 @@ import { buildFormExportCommand } from './export.ts' import { buildFormImportCommand } from './import.ts' import { buildFormCloneCommand } from './clone.ts' import { buildFormValidateCommand } from './validate.ts' +import { buildFormFixColumnDataCommand } from './fix-columndata.ts' export function buildFormCommand(): Command { - const cmd = new Command('form').description('表单 CRUD (list/info/create/release/delete/export/import/clone/validate)') + const cmd = new Command('form').description('表单 CRUD (list/info/create/release/delete/export/import/clone/validate/fix-columndata)') cmd.addCommand(buildFormListCommand()) cmd.addCommand(buildFormInfoCommand()) cmd.addCommand(buildFormCreateCommand()) @@ -23,5 +24,6 @@ export function buildFormCommand(): Command { cmd.addCommand(buildFormImportCommand()) cmd.addCommand(buildFormCloneCommand()) cmd.addCommand(buildFormValidateCommand()) + cmd.addCommand(buildFormFixColumnDataCommand()) return cmd } diff --git a/src/commands/menu/create.ts b/src/commands/menu/create.ts index f4fbdb4..f6287ec 100644 --- a/src/commands/menu/create.ts +++ b/src/commands/menu/create.ts @@ -61,14 +61,30 @@ export function buildMenuCreateCommand(): Command { // 模式 A: 挂表单菜单 — 走 web 真路径 if (opts.formId) { - const pcParents = (opts.pcParents ?? '0').split(',').filter(Boolean) - const appParents = opts.appParents ? opts.appParents.split(',').filter(Boolean) : [] const pc = opts.pc === false ? 0 : 1 const app = opts.app ? 1 : 0 if (!pc && !app) { log.error('至少一个发布平台 (pc / app), 当前都是 0') process.exit(2) } + // v0.7.1 fix (盲点 23 续): 不传 --pcParents 时, 自动从 /system/Menu/SelectorFilter/0 + // 拉当前 app 的根目录菜单当 parent (web 端 getMenuSelectorFilter({category:'Web'}, '0') 同款) + // 旧默认 '0' 在 tds 等应用下不存在 → 报 "找不到该上级" + let pcParents: string[] = opts.pcParents ? opts.pcParents.split(',').filter(Boolean) : [] + if (pc && pcParents.length === 0) { + const sel = await c.get<{ list?: { id: string; type: number }[] }>('/system/Menu/SelectorFilter/0', { + category: 'Web', + }) + const root = sel.data?.list?.find((m) => m.type === 0) + if (root) { + pcParents = [root.id] + log.info(`自动发现父菜单 (Web 根): id=${root.id}`) + } else { + log.warn('SelectorFilter 未返 Web 根菜单, 仍用默认 "0" (Actions/Module 可能报"找不到该上级")') + pcParents = ['0'] + } + } + const appParents = opts.appParents ? opts.appParents.split(',').filter(Boolean) : [] const body = { pc, app, diff --git a/tests/e2e/p16-ui-real-crud.spec.ts b/tests/e2e/p16-ui-real-crud.spec.ts new file mode 100644 index 0000000..ee96fd9 --- /dev/null +++ b/tests/e2e/p16-ui-real-crud.spec.ts @@ -0,0 +1,227 @@ +/** + * tests/e2e/p16-ui-real-crud.spec.ts — P0 #16 验收 + * + * 浏览器层真操作 tds_leave 表单 (员工请假申请), 不只 API 验证: + * - 打开列表页 → 看到 + 新增 按钮 + 空数据状态 + * - 点 + 新增 → 弹表单 → 填 8 字段 → 保存 + * - 列表里出现新行, 含申请人姓名 + * - 打开行 → 编辑某字段 → 保存 + * - 列表里行已更新 + * - 删除该行 → 列表少 1 行 + * + * 依赖: .auth/admin.json (storageState 登录态) + tds_leave form id=835168490678657989 + * + * 跑法: + * JNPF_BASE_URL=http://nginx/ npx playwright test tests/e2e/p16-ui-real-crud.spec.ts + */ +import { test, expect, Page } from '@playwright/test' + +const MODEL_URL = '/jnpf_app_tds/model/tds_leave' + +/** 工具: 等待 vxe-table 加载完成 (无 spinner) */ +async function waitForListReady(page: Page) { + await page.waitForLoadState('networkidle', { timeout: 30_000 }) + // vxe-table 渲染后会有 .vxe-table 或空状态 "暂无数据" + await page.waitForTimeout(800) +} + +/** 工具: 数 vxe-table 数据行数 */ +async function countRows(page: Page): Promise { + // vxe-body--row 是数据行, 排除固定列 (vxe-body--column) + return await page.locator('.vxe-body--row').count() +} + +/** 工具: 拿分页总数文字, e.g. "共 3 条数据" */ +async function getTotalText(page: Page): Promise { + const footer = page.locator('.vxe-pager--total, .pager-count, .jnpf-pagination__total') + if (await footer.count() > 0) { + return (await footer.first().textContent()) ?? '' + } + // fallback: 找含"共"和"条" 的文字 + return (await page.locator('text=/共\\s*\\d+\\s*条/').first().textContent().catch(() => '')) ?? '' +} + +test.describe('P0 #16: Playwright UI 真点击 CRUD (tds_leave)', () => { + test('1. 列表页能打开, +新增按钮 + 空数据状态存在', async ({ page }) => { + await page.goto(MODEL_URL) + await waitForListReady(page) + + // 关键: 不是预览页 (previewModel), 是真业务页 + expect(page.url()).toContain('/model/tds_leave') + expect(page.url()).not.toContain('previewModel') + + // + 新增 按钮 (ant-btn primary) + const newBtn = page.locator('button:has-text("新 增"), button:has-text("新增")').first() + await expect(newBtn, '+ 新增 按钮应可见').toBeVisible({ timeout: 10_000 }) + + // vxe-table 渲染 (可能空, 也可能已有数据) + const table = page.locator('.vxe-table, .vxe-body--row').first() + await expect(table, 'vxe-table 容器应存在').toBeVisible({ timeout: 10_000 }) + }) + + test('2. + 新增 → 填 8 字段 → 保存 → 列表多 1 行', async ({ page }) => { + await page.goto(MODEL_URL) + await waitForListReady(page) + + const rowsBefore = await countRows(page) + const totalBefore = await getTotalText(page) + console.log(` before: rows=${rowsBefore} total="${totalBefore}"`) + + // 1) 点 + 新增 + await page.locator('button:has-text("新 增"), button:has-text("新增")').first().click() + // 等 ant-modal 弹出 + await page.waitForSelector('.ant-modal', { timeout: 10_000 }) + await page.waitForTimeout(800) + + // 2) 填字段 (按 formData 顺序, jnpf 字段 label 是稳定契约) + // input 字段: 申请人姓名 + await page.locator('.ant-modal input').first().fill('测试员工-P16') + + // 找到 select 字段 (按 label 文本), 选第 1 个 option + // jnpf 的 select 渲染为 .ant-select, 第一个是"所在部门" + const selects = page.locator('.ant-modal .ant-select') + await selects.nth(0).click() // 所在部门 + await page.waitForTimeout(400) + await page.locator('.ant-select-item-option').first().click() + await page.waitForTimeout(300) + + await selects.nth(1).click() // 请假类型 + await page.waitForTimeout(400) + await page.locator('.ant-select-item-option').first().click() + await page.waitForTimeout(300) + + // 起始日期 / 结束日期: jnpf 用 .ant-picker + const datePickers = page.locator('.ant-modal .ant-picker input') + await datePickers.nth(0).fill('2026-06-15') + await page.keyboard.press('Tab') + await datePickers.nth(1).fill('2026-06-17') + await page.keyboard.press('Tab') + await page.waitForTimeout(300) + + // 请假天数 (inputNumber) — 在 modal 里所有 input 里的, 跳过 select/picker 后 + // 简化: 找 placeholder 含"请假天数" 的 input + const daysInput = page.locator('.ant-modal input[placeholder*="请假天数"]').first() + if (await daysInput.count() > 0) { + await daysInput.fill('3') + } + + // 请假事由 (textarea, required) + const reasonArea = page.locator('.ant-modal textarea').first() + await reasonArea.fill('P0 #16 UI 真点击 CRUD 自动测试') + + await page.waitForTimeout(500) + + // 截图: 表单填好状态 (调试用) + await page.screenshot({ path: 'screenshots/p16-form-filled.png', fullPage: true }) + + // 3) 点保存 (ant-modal 内的 primary button) + const saveBtn = page.locator('.ant-modal button:has-text("确 定"), .ant-modal button:has-text("保 存")').first() + await saveBtn.click() + + // 4) 等 modal 关闭 + 列表刷新 + await page.waitForSelector('.ant-modal', { state: 'hidden', timeout: 15_000 }) + await page.waitForLoadState('networkidle', { timeout: 15_000 }) + await page.waitForTimeout(1500) + + // 5) 验证: 列表多 1 行 + const rowsAfter = await countRows(page) + const totalAfter = await getTotalText(page) + console.log(` after add: rows=${rowsAfter} total="${totalAfter}"`) + + // 至少新增 1 行 (如果有分页, rowsAfter 可能 < 真实总数, 但 total 必 +1) + expect(rowsAfter, `rows 应增加, 之前=${rowsBefore}, 之后=${rowsAfter}`).toBeGreaterThan(rowsBefore) + + // 6) 验证: 列表里能看到"测试员工-P16" + const newRow = page.locator('.vxe-body--row:has-text("测试员工-P16")') + await expect(newRow, '新行应含"测试员工-P16"').toBeVisible({ timeout: 10_000 }) + + await page.screenshot({ path: 'screenshots/p16-after-add.png', fullPage: true }) + }) + + test('3. 编辑行 → 修改申请人姓名 → 保存 → 列表行更新', async ({ page }) => { + await page.goto(MODEL_URL) + await waitForListReady(page) + + // 找测试员工-P16 行 (上一 test 创建的) + const targetRow = page.locator('.vxe-body--row:has-text("测试员工-P16")').first() + const exists = await targetRow.count() + if (exists === 0) { + test.skip(true, '上一 test 未创建数据, 跳过') + return + } + + // jnpf 行操作一般在"操作"列, 含编辑/删除按钮 + // 简化: 点击行的"编辑"链接 (jnpf 模板常用 a:has-text("编辑")) + const editLink = targetRow.locator('a:has-text("编 辑"), a:has-text("编辑"), button:has-text("编 辑"), button:has-text("编辑")').first() + const hasEditLink = await editLink.count() + if (hasEditLink === 0) { + // fallback: 双击行 + await targetRow.dblclick() + } else { + await editLink.click() + } + + await page.waitForSelector('.ant-modal', { timeout: 10_000 }) + await page.waitForTimeout(800) + + // 改申请人姓名 input 为新值 + const nameInput = page.locator('.ant-modal input').first() + await nameInput.fill('') + await nameInput.fill('测试员工-P16-已修改') + await page.waitForTimeout(300) + + // 保存 + const saveBtn = page.locator('.ant-modal button:has-text("确 定"), .ant-modal button:has-text("保 存")').first() + await saveBtn.click() + await page.waitForSelector('.ant-modal', { state: 'hidden', timeout: 15_000 }) + await page.waitForLoadState('networkidle', { timeout: 15_000 }) + await page.waitForTimeout(1500) + + // 验证: 列表里出现新名, 旧名消失 + const updatedRow = page.locator('.vxe-body--row:has-text("测试员工-P16-已修改")') + await expect(updatedRow, '更新后行应含新名').toBeVisible({ timeout: 10_000 }) + + const oldRow = page.locator('.vxe-body--row:has-text("测试员工-P16"):not(:has-text("已修改"))') + expect(await oldRow.count(), '旧名行应已消失').toBe(0) + }) + + test('4. 删除行 → 列表少 1 行 (cleanup)', async ({ page }) => { + await page.goto(MODEL_URL) + await waitForListReady(page) + + // 找测试员工-P16-已修改 行 + const targetRow = page.locator('.vxe-body--row:has-text("测试员工-P16-已修改")').first() + if (await targetRow.count() === 0) { + test.skip(true, '上一 test 未创建数据, 跳过') + return + } + + const rowsBefore = await countRows(page) + + // jnpf 删除: 行操作列 → 删除按钮 → 弹确认 → 确定 + const delBtn = targetRow.locator('a:has-text("删 除"), a:has-text("删除"), button:has-text("删 除"), button:has-text("删除")').first() + if (await delBtn.count() === 0) { + test.skip(true, '行无"删除"按钮, 跳过') + return + } + await delBtn.click() + + // 等二次确认 modal + await page.waitForSelector('.ant-modal-confirm, .ant-modal', { timeout: 10_000 }) + await page.waitForTimeout(500) + + // 确认删除 + const confirmBtn = page.locator('.ant-modal-confirm-btns button.ant-btn-primary, .ant-modal button:has-text("确 定")').last() + await confirmBtn.click() + await page.waitForTimeout(2000) + await page.waitForLoadState('networkidle', { timeout: 15_000 }) + await page.waitForTimeout(1500) + + // 验证: 行消失 + const deletedRow = page.locator('.vxe-body--row:has-text("测试员工-P16-已修改")') + expect(await deletedRow.count(), '已删除行应消失').toBe(0) + + const rowsAfter = await countRows(page) + expect(rowsAfter, `rows 应减少, 之前=${rowsBefore}, 之后=${rowsAfter}`).toBeLessThan(rowsBefore) + }) +}) diff --git a/tests/unit/fix-columndata.test.ts b/tests/unit/fix-columndata.test.ts new file mode 100644 index 0000000..3b0cf59 --- /dev/null +++ b/tests/unit/fix-columndata.test.ts @@ -0,0 +1,51 @@ +/** + * fix-columndata.test.ts — 验证 form columnData 4 个 use*Permission 字段补全 + * + * 盲点 23 闭环: v0.7.1 之前 form create 的 columnData 缺 useBtnPermission 等字段, + * 后端 Jackson 反序列化为 null, Actions/Module 报 "System abnormality" (NPE 在 + * VisualUtil.setPcPermission line 139, .booleanValue() 解开 null) + * + * 此测试覆盖: + * 1. form create --ai-help 应在可选参数提示 fix-columndata + * 2. form --help 应列出 fix-columndata 子命令 + * 3. fix-columndata --ai-help 输出 markdown + * 4. 实际 JNPF 平台 fix-columndata 跑通 (前提: 启了 JNPF + 有 form id) + */ +import { describe, it, expect } from 'vitest' +import { execFileSync } from 'node:child_process' +import { resolve } from 'node:path' +import { fileURLToPath } from 'node:url' + +const __dirname = fileURLToPath(new URL('.', import.meta.url)) +const CLI = resolve(__dirname, '../../src/cli.ts') + +function run(args: string[]): string { + try { + return execFileSync('npx', ['tsx', CLI, ...args], { + encoding: 'utf-8', + stdio: ['pipe', 'pipe', 'pipe'], + timeout: 30_000, + }) + } catch (e) { + const err = e as { stdout?: Buffer | string; stderr?: Buffer | string; status?: number } + return (err.stdout?.toString() || err.stderr?.toString() || '') + } +} + +describe('form fix-columndata (v0.7.1 盲点 23)', () => { + it('form --help 列出 fix-columndata 子命令', () => { + const out = run(['form', '--help']) + expect(out).toContain('fix-columndata') + }) + + it('form fix-columndata --ai-help 输出 markdown 用法', () => { + const out = run(['form', 'fix-columndata', '--ai-help']) + expect(out).toMatch(/盲点 23|System abnormality|useBtnPermission|useColumnPermission/) + }) + + it('form fix-columndata 缺 报错', () => { + const out = run(['form', 'fix-columndata']) + // commander 报 "missing required argument" 或类似 + expect(out.toLowerCase()).toMatch(/missing|required|error/) + }) +})