feat(menu): step machine 校验 (镜像 web Form.vue handleSubmit + 后端 ModuleController.create 4 step + 错误聚合)
v0.11d+ Phase 2.1 闭环 (镜像 + web/backend 行号标注):
**新增 _validate_menu.ts (4 step, 镜像 web Form.vue:88-270 + 后端 ModuleController.java:172-190)**:
- step 0 基础信息: 镜像 web Form.vue:88-182 schemas rules + L231 validate() + L234 enCode.replace('.', '')
- fullName 必填 + maxlength 50
- enCode 必填 + 正则 (镜像 web formValidate.ts:24-28 不允许下划线)
- type 必填且合法 (1/2/3/4/5/6/7/8/9/10/11)
- icon 必填 (低级模式)
- step 1 表单关联: 镜像 web Form.vue:230-248 handleSubmit + L338-347 fetchFeatureList (isRelease=1)
- --formId 模式: form 存在 + state=1 已发布
- webType 合法 (1/2/3 formDesign + 4 视图走低级 fallback)
- step 2 父菜单+路径: 镜像 web Form.vue:317-326 + L238-243 pageAddress 自动构造
- parentId/pcParents 存在性 + 类型合法 (type=1 目录, 不能 type=3 当 parent — BS-50 fix)
- 自动构造 pageAddress (镜像 Form.vue:238-243 type→路由前缀)
- step 3 唯一性预校验: 镜像后端 ModuleController.java:179-187 EXIST001/002/104
- fullName/enCode/urlAddress 唯一 (拉全树递归查重, 双重防御)
**create.ts 集成**:
- 新增 runStepMachine() 在发 API 前聚合校验, 失败 → 1 次报所有错 (AI 不用试错)
- --help + installAiHelpHook 同步标注 web Form.vue + 后端 ModuleController 行号
**端到端验证 (tdd10, 5/5 通过)**:
1. 成功路径 (form 已发布 + parent 是目录) → 4/4 ✓
2. type=3 当 parent → step 2 ✗ '父菜单类型必须是目录 (type=1), 当前 type=3' (BS-50 fix)
3. fullName 重复 → step 3 ✗ '菜单名称已存在 (id=..., enCode=...)'
4. enCode 含下划线 → step 0 ✗ (web formValidate 镜像)
5. type=99 非法 → step 0 ✗ '菜单类型必须是 1/2/3/4/5/6/7/8/9/10/11 之一'
**修复 type=3 当 parent bug** (jnpf-menu-display-issue 闭环):
- 旧: user 传 --pcParents=<formMenuId type=3> → 后端不会校验 → 菜单挂错位置 → 浏览器不显示
- 新: step 2 强制校验 pcParents 必须 type=1 (目录) 或 type=0 (顶级)
**MEMORY**: 新建 dacli-menu-create-step-machine-2026-06-26.md 记录设计意图 + 行号 + 反模式
设计意图: 单方法提交会绕过 web 端校验链 (validate / Generator.getData / handleSubmit),
step machine 让 dacli 1 次提交触发完整规则, AI 不用去浏览器试错.
镜像策略: 校验规则 (vmodel/正则/必填) → 镜像 JS (dacli 这边实现), schema 生成 + 后端校验 → webapi 直调.
Co-Authored-By: Claude <[email protected]>