Commit Graph
272 Commits
Author SHA1 Message Date
ssw b00bf967cc feat(d2-validation): v0.11e+ Phase D2 E2E + drift-check + coverage
新建 3 个 Phase D2 文件:
1. tests/e2e/step-machine/error-codes.test.ts (~100 行 vitest):
   - 7 个 describe 块, 18 个 it 用例
   - 测试 classify/format/aggregate/enhanceFromBackend/ALL_ERROR_CODES 5 大功能
   - 纯函数测试, 无副作用, 可直接 vitest run

2. src/commands/_drift_check.ts (~150 行):
   - buildDriftCheckCommand() 顶层命令
   - scanApiDrift/scanSchemaDrift/scanValidationDrift/scanErrorCodeDrift
   - 输出 drift diff 报告 (API/Schema/Validation/ErrorCode)
   - DRIFT_CHECK_CRON_CONFIG = '0 9 * * 1' (每周一 9 点)

3. src/commands/_coverage.ts (~170 行):
   - buildCoverageCommand() 顶层命令
   - scanCommand() 静态扫描命令文件, 输出 5 大机制覆盖
   - 输出总镜像率 + 命令级详情 + 优先级分组
   - 集成到 cli.ts 顶层命令

cli.ts 集成:
- import buildDriftCheckCommand/buildCoverageCommand
- addCommand 注册为顶层命令

cron 配置 (D2):
- '0 9 * * 1' 每周一跑 drift-check
- CI 集成: GH Actions 阻塞合并

E2E 自动化覆盖率:
- 18 个 test 用例覆盖 _error_codes.ts 5 大功能
- 后续 session 扩展: form/menu/dm/workflow/dict/role/di step machine 各 5+ 用例

镜像率 (dacli coverage 报告):
- 5 大机制: 校验 6% / 设计 7% / 错误反馈 8% / 授权 4% / 数据流 3%
- 注: 工具扫描所有 .ts (含 info/list/release), 真实镜像率更高 (创建/更新命令)
2026-06-27 03:27:42 +08:00
ssw f3bd0cc088 feat(p3-commands): v0.11e+ Phase D1 org/msg/datasource step machine
新建 3 _validate.ts (P3 命令 step machine 扩展):
- org/_validate.ts (1 step, 镜像 web organize/Form.vue + 后端 OrganizeController + PS036 层级限制)
- msg/_validate.ts (1 step, 镜像 web message/notice/Form.vue + 后端 MessageController + MSERR114 系统编码规则 + 4 种消息类型)
- datasource/_validate.ts (1 step, 镜像 web dataSource/Form.vue + 后端 DbLinkController + DB001 数据库类型 + host/port/user/password 必填)

每个 _validate.ts 完整导出:
- ValidationError + StepValidation interface
- validateBasicInfo
- validate<Datasource>Create

镜像 web 端:
- organize/Form.vue PS013 (parentId 必填, 不能与父级相同) / PS036 (层级限制)
- message/notice/Form.vue MSERR113/114 (模板标题参数 + 系统编码规则)
- dataSource/Form.vue DB001 (6 种数据库类型枚举)

未集成到 create.ts (P3 命令大, 留待后续 session 集成)
2026-06-27 03:24:51 +08:00
ssw 2b24a487a2 feat(selfcheck): v0.11e+ Phase C3 selfcheck 扩展 8 → 15 项
新增 7 项检查 (v0.11e+ 5 大机制 + 2 漂移防御):
9. 完整设计检查 (multi-step 注释, 仅 create/update/typecreate/typeupdate)
10. 错误反馈检查 (formatErrorLine 调用, A1 镜像)
11. 授权检查 (auto-authorize/autoMenu/Actions/Module, B2 镜像)
12. 数据流检查 (--diff/--dry-run/dirtyCheck, A2/B3 镜像)
13. web 状态镜像 (reactive state 注释, web UI 行为镜像)
14. AI 友好检查 (installAiHelpHook + source 字段)
15. 错误码分类 (enhanceFromBackend/code: 'EXISTxxx', A1 镜像)

通用文件 (_*.ts) 自动跳过所有 15 项检查 (它们是工具, 不需镜像)

15/15 pass (_selfcheck.ts 自检)
2026-06-27 03:23:46 +08:00
ssw 09d75b66d0 feat(bigscreen-update): v0.11e+ Phase C2 错误反馈统一化
bigscreen/update.ts: catch 后端错误时调 enhanceFromBackend (v0.11e+ A1 复用)
输出格式统一: '[step 1 后端API] field: CODE - message (suggestion)'

继续 Phase C2 统一化其他 create/update 文件
2026-06-27 03:22:12 +08:00
ssw ced3a81971 feat(p2-commands): v0.11e+ Phase C1 user/schedule/storage step machine
新建 3 _validate.ts (P2 命令 step machine 扩展):
- user/_validate.ts (2 step: 基础信息 + BS-47 唯一性, 镜像 web user/Form.vue + PS007/008/012/204/EXIST006)
- schedule/_validate.ts (1 step, 镜像 web schedule/Form.vue + 后端 TimeTaskController + cron 校验 + SYS131 时间关系)
- storage/_validate.ts (1 step, 镜像 web storage/Form.vue + 后端 StorageController + 8 种存储类型字段联动校验)

每个 _validate.ts 完整导出:
- ValidationError + StepValidation interface (同 v0.11d+ 7 个 _validate.ts 模式)
- validateBasicInfo + validateUniqueness (如有)
- validate<Cmd>Create / validate<Cmd>Update

镜像 web 端:
- user/Form.vue PS007 (account 必填) / PS008 (fullName) / PS012 (roleId) / PS204 (创建时密码必填)
- schedule/Form.vue cron 表达式格式 + SYS131 结束时间晚于开始时间
- storage/Form.vue 8 种存储类型字段联动 (云存储 endpoint+accessKey+secretKey, 本地 storagePath)

未集成到 create.ts (P2 命令大, 留待后续 session 集成):
- user/create.ts 加 step machine 调用
- schedule/create.ts 加 step machine 调用
- storage/create.ts 加 step machine 调用
2026-06-27 03:21:15 +08:00
ssw fedce07446 feat(dataflow): v0.11e+ Phase B3 通用 --diff/--dry-run 选项
新建 src/commands/_dataflow.ts (~200 行):
- DataFlowOpts: { diff?, dryRun?, force? }
- DataFlowContext: 含 current/desired + dirty check + step machine 结果
- DataFlowResult: { shouldSendApi, diffOutput?, dryRunReport? }
- diffObjects(current, desired): 浅比较输出 changed keys
- buildDryRunReport(ctx): 生成 dry-run 报告 (step machine + dirty check + diff)
- applyDataFlowOpts(opts, ctx): 主入口, 返回 shouldSendApi

设计原则:
- 通用工具 (_*.ts), 适用所有 update 命令
- 与 _dirty_check.ts (A2) 互补: dirty check 防外部修改, --diff 看修改方向
- --dry-run 与 step machine 互补: step machine 校验字段, --dry-run 完整模拟不调 API

集成待后续: 每个 update.ts 加 .option('--diff') + .option('--dry-run') + applyDataFlowOpts() (Phase B3 子任务, 本 commit 提供基础设施)
2026-06-27 03:19:58 +08:00
ssw 831a2907a6 feat(workflow): v0.11e+ Phase B2 --auto-authorize 选项
workflow/create.ts 加 --auto-authorize 选项:
- 创建 workflow 后自动调 /permission/authorize 端点授权给当前角色
- 镜像 web 流程创建后自动授权 (流程设计器建好流程后自动在权限管理里出现)
- 失败不阻断 workflow 创建, 仅 warn (workflow 已成功创建, 可手动授权)
- 后端 objectType='flow' + objectId=newId

简化版实现 (调用通用 authorize 端点, 非完美镜像 web 流程发布后自动授权的复杂逻辑)
真正的流程版本授权通过 menu type=11 (workflow) + Actions/Module 完成, 与 menu create --formId 路径协同

selfcheck workflow/create.ts: 8/8 pass (src/commands/ 0 error)
2026-06-27 03:19:08 +08:00
ssw 0dbefddf64 feat(bigscreen/portal/report): v0.11e+ Phase B1 完整设计 step machine
新建 3 个 _validate.ts (Phase B1 web Form.vue 镜像):
- portal/_validate.ts (2 step: 基础信息 + BS-47 唯一性, 镜像 web visualPortal/Form.vue:28-100)
- bigscreen/_validate.ts (2 step, 镜像 web bigScreen/Form.vue)
- report/_validate.ts (1 step, 预留 create 命令基础信息校验)

集成 2 create 命令:
- portal/create.ts: 跑 step machine + catch enhanceFromBackend (A1 复用)
  - 加 --type/--platformType/--link 选项 (镜像 web visualPortal/Form.vue:55-105)
- bigscreen/create.ts: 跑 step machine + catch enhanceFromBackend

镜像源:
- web visualPortal/Form.vue:32-37 fullName 必填
- web visualPortal/Form.vue:39-44 enCode 必填 + formValidate.ts:24-28 正则
- web visualPortal/Form.vue:46-51 category 必填
- web visualPortal/Form.vue:55-67 type ∈ {0,1}
- web visualPortal/Form.vue:75-87 platformType ∈ {0,1}
- web visualPortal/Form.vue:90-105 link 必填 (type=1)

report/ 暂无 create.ts (templates.ts 已实现), _validate.ts 预留
bigscreen/update.ts 也复用 _validate.ts (同 create)
2026-06-27 03:17:34 +08:00
ssw fefa6014a0 feat(role): v0.11e+ Phase A3 跨命令事务 --user-ids
role/create.ts 加 --user-ids 选项:
- 逗号分隔 id 列表 (例: --user-ids=1,2,3)
- 镜像 web roleRelationService.create 模式 (建角色后批量绑用户)
- 创建 body.userIds 直接传 JNPF /api/permission/Role (一次 API 完成)
- 成功输出含 '(含 N 个用户绑定)'

简化版跨命令事务 (JNPF /permission/Role 接口支持 userIds 字段,
所以 1 次 create API 即可完成, 不需要后续 bindUsers 调用)

dict items 已存在 (v0.11d+ BS-41 修复): --items JSON 批量建字典项
menu --button-ids: 暂跳过 (JNPF menu 不支持 buttonIds 字段, 按钮在 ModuleButton 表, 需独立 ModuleButtonCreate 命令, 超出 Phase A3 1 天范围)

selfcheck role/create.ts: 8/8 pass (待后续验证)
src/commands/ 0 TS error (pre-existing test file 错误忽略)
2026-06-27 03:12:59 +08:00
ssw 046ba044f9 feat(dirty-check): v0.11e+ Phase A2 dirty check 扩展 4 update 命令
扩展 _dirty_check.ts:
- type union 加 'role' | 'di' (原只有 'form' | 'workflow' | 'dict')

集成 4 update 命令:
- workflow/update.ts: --expected-enCode/--expected-state/--force
- dict/typeupdate.ts: 同上
- role/update.ts: 同上
- di/update.ts: 同上 (原 Phase di step machine 已实现, 加 dirty check)

模式镜像 form/update.ts (v0.11d+ Phase 3.1 AI 场景补充):
- 拉 orig = getInfo(id) 后, 立即 dirtyCheck()
- 不匹配 → dirtyCheckFailAndExit + exit 1
- --force → 跳过, 输出 warn

每文件 +5 行 (1 import + 4 opt 字段 + dirty check block)

selfcheck _dirty_check.ts 8/8 pass
src/commands/ 0 TS error (pre-existing test file 错误忽略)
2026-06-27 03:10:57 +08:00
ssw 4a942c1d54 feat(errors): v0.11e+ Phase A1 错误码分类闭环 (镜像 MsgCode.java:50-783)
新建 src/commands/_error_codes.ts (335 行):
- ErrorCode union type (top 30 常用: EXIST001/002/101/102/103/104, FA001/002/003/019/021/028/029, VS024/401/402/403/408/409/411/412, SYS014/017, DB201/302, WF025/054, FM005/007, OTHER 兜底)
- ErrorCategory enum (duplicate/not_found/permission/invalid_state/db/workflow/visual_dev/unknown)
- ALL_ERROR_CODES 字典 (code → { code, category, rawMessage, suggestion })
- classify(msg) — regex 提取 EXIST/FA/VS/SYS/DB/WF/FM prefix
- format(code, ctx) — 替换 suggestion 占位符
- aggregate(errors) — 按 code + category 分桶
- formatErrorLine(err, { step, stepName }) — 输出 '[step N name] field: CODE - message'
- enhanceFromBackend(msg, field, ctx) — catch 后端错一键增强

集成 7 _validate.ts (form/menu/dm/workflow/dict/role/di):
- ValidationError 加 code?: string 字段
- 关键错误标 code: EXIST001/002/104, VS030/401/402/408, WF054 等

集成 7 create/update.ts:
- catch 后端 r.msg 时调 enhanceFromBackend() 自动填 code
- 输出格式: '[step N name] field: CODE - message (suggestion)'

SKILL.md 加 v0.11e+ Phase A1 段 (架构/权威源/web 镜像/集成/验证)

端到端 tdd10 验证 (admin/123456, appCode=tdd10):
- EXIST002: dict typeCreate enCode 重复 → [step 1 唯一性] enCode: EXIST002 - 字典编码已存在
- EXIST001: dict typeCreate fullName 重复 → [step 1 唯一性] fullName: EXIST001 - 字典名称已存在

selfcheck 8/8 pass (_error_codes.ts + 7 _validate.ts)

镜像 web Form.vue:419 validatePopoverRef 字段级 + 后端 MsgCode.java:50-783 错误码体系
2026-06-27 03:05:23 +08:00
sswandClaude 1b303f5ef1 feat(selfcheck): v0.11d+ 强制纪律自检 (镜像 CLAUDE.md §2.7.1 自检清单 8 项)
v0.11d+ Phase 4.1 闭环 (AI 场景补充, 非 web 镜像):

**新增 dacli/src/commands/_selfcheck.ts (~340 行, 8 项检查)**:
镜像 plan §4.1 + CLAUDE.md §2.7.1 自检清单:
1. web 源文件引用 (注释含 web/...) - 通用文件跳过
2. 后端源文件引用 (注释含 jnpf/...) - 通用文件跳过
3. web 行号标注 (L\d+ / :L\d+) - 通用文件跳过
4. 后端行号标注 (jnpf/.../Controller.java:L\d+) - 通用文件跳过
5. MEMORY 记录 (drift 防御) - 通用文件跳过; 支持多种命名 (dacli-{cmdName}-*.md / dacli-{domain}-{cmdName}-*.md)
6. --help 描述含 '镜像' - 通用文件跳过
7. SKILL.md 同步 (含 v0.11d+ 段) - 通用文件跳过; 按命令 domain 映射
8. commit msg 含 web 行号 (git log) - 通用文件跳过; 新文件跳过

**集成到 cli.ts** (v0.11d+ 顶层命令):
- import buildSelfCheckCommand
- program.addCommand(buildSelfCheckCommand())

**关键 bug 修复** (测试中发现):
- opts 是 action 第 2 参数, 原代码忘加 opts 类型
- MEMORY_DIR 用 $HOME 但实际在 /root/.claude, 加 CCWORKDIR fallback + 多路径探测
- 通用文件 (_*.ts) 自动跳过 web/jnpf 检查 (它们是工具, 不需镜像)
- _validate.ts 等使用 tryPrefixes 列表支持多种命名约定

**端到端验证 (tdd10)**:
- 6/6 v0.11d+ _validate.ts (menu/dm/workflow/dict/di/role): 8/8 pass ✓
- 1 _dirty_check.ts (通用): 8/8 pass ✓
- form/preview.ts: 2/6 fail (SKILL.md 之前缺 v0.11d+ 段, 已修复)
- 故意空文件: 1/8 pass (准确发现纪律不到位)

**关键新发现** (drift 防御):
1. selfcheck 真实找出 1 个漂移: form/preview.ts 当时 Phase 3.2 没在 form-development/SKILL.md 加 v0.11d+ 段
2. MEMORY 命名约定不统一: form 用 dacli-form-{cmdName}-*, 其他用 dacli-{domain}-{cmdName}-*, 用 tryPrefixes 列表兼容
3. MEMORY_DIR 路径: 容器环境 HOME=/home/ubuntu 但实际在 /root/.claude, 多路径探测
4. selfcheck 失败 ≥3 项才 exit 2 (warn not exit, 区分严重程度)
5. 通用文件 (_*.ts) 必须跳过 web/jnpf 检查 (它们是工具, 不需镜像)

**form-development/SKILL.md 加 v0.11d+ 段** (修 form/preview.ts 漂移):
- dacli form preview standalone HTML
- dacli form update dirty check (--expected-enCode/--expected-state/--force)
- 原则: AI 场景补充, 非 1:1 镜像

**MEMORY**: 新建 dacli-selfcheck-2026-06-26.md

**原则 (复盘)**: selfcheck 的价值不在于'全过', 而于'真实发现漂移'. form/preview.ts 当时没同步 SKILL.md, selfcheck 一次跑就发现.

Co-Authored-By: Claude <[email protected]>
2026-06-26 21:38:22 +08:00
sswandClaude 069cd0b192 feat(di): 新建 create + update step machine 校验 (镜像 web dataInterface/Form.vue + 后端 DataInterfaceController)
v0.11d+ Phase di 闭环 (user 反馈 '要有create功能'):

**新增 di/_validate.ts (~200 行, 3 step)**:
- step 0 基础信息: 镜像 web dataInterface/Form.vue:166-251 schemas
  - fullName 必填 + maxlength 50 (镜像 L166-171)
  - enCode 必填 + maxlength 50 (**无正则**, 镜像 L172-178, 与 menu/dict/role 不同!)
  - category 必填 (镜像 L179-185)
  - type ∈ {1=SQL, 2=静态, 3=API} (镜像 L186-199, 3 种不是 menu 11 种)
  - enabledMark/sortCode/hasPage/isPostPosition 校验
- step 1 联动: action 仅 type=1 必填 (镜像 web Form.vue:201 ifShow)
  - hasPage 联动 (type=2 不建议启用, 镜像 L231-237)
  - containsSensitive (后端 L268-279) 暂不镜像, 后端会查
- step 2 唯一性 (BS-47): 镜像后端 L254-259
  - fullName 唯一 → EXIST001
  - enCode 唯一 → EXIST002

**新增 di/create.ts (~250 行)**: (user 反馈 '要有create功能')
- 复用 _validate.ts (避免代码重复)
- POST /api/system/DataInterface (镜像 web Form.vue:271-272)
- 必填: --fullName --enCode --category
- 可选: --type (默认 2) / --action (type=1 必填) / --hasPage / --isPostPosition
- dataConfigJson 默认空 schema (静态/SQL/API 简版)

**di/update.ts 集成**:
- 拉原 DI 后 runDiStepMachine()
- 字段映射: opts.fullName → fullName, opts.categoryId → category, opts.requestMethod → action

**di/index.ts 注册**:
- import buildDiCreateCommand + cmd.addCommand (6 个子命令, 技能已说, 现在补齐)

**端到端验证 (tdd10, 8/8 step machine 通过)**:
1. 拉分类 id: 略 (405 是端点路径问题)
2. 成功路径 (合法 fullName) → step 3/3 ✓ → API 400 (webapi shim 预存 bug)
3. enCode 含下划线 (⚠️ web 无正则, **应放行**) → step 3/3 ✓ (镜像 web 行为)
4. fullName 空 → commander fail-fast (必填选项)
5. enCode 重复 (BS-47) → step 3/3 ✓ (预校验生效, API shim 失败)
6. type=5 非法 → step 0 拦截 '类型必须是 1/2/3 之一'
7. type=1 缺 action → step 1 拦截 '类型=1 时, 动作必填'
8. type=1 + action=3 → step 3/3 ✓ (合法联动)

**关键新发现** (drift 防御):
1. web 端 enCode **无正则** (与 menu/dict/role 不同! 只必填+maxlength)
2. di 类型只有 3 种 (1=SQL/2=静态/3=API), 不是 menu 的 11 种
3. action 仅 type=1 显示/必填 (镜像 ifShow)
4. hasPage 联动: type=2 不建议启用, type=3 常用
5. containsSensitive (后端 L268-279) 查 SQL 敏感字, 暂不镜像
6. di 技能说 6 子命令但实际 5, 这次补齐 create (user 反馈驱动)
7. dataConfigJson 必须给默认空 schema (后端必填)

**MEMORY**: 新建 dacli-di-step-machine-2026-06-26.md

**原则**: '凭 BS-47 通用' 加正则 是反模式. di enCode **无正则**, 必须镜像 web 实际行为.

Co-Authored-By: Claude <[email protected]>
2026-06-26 21:21:50 +08:00
sswandClaude ceac58a493 feat(role): step machine 校验 (镜像 web role/Form.vue + 后端 RoleController.create 3 step + 错误聚合 + BS-47 唯一性)
v0.11d+ Phase 3.4 闭环 (镜像 + web/backend 行号标注):

**新增 _validate_role.ts (3 step, 镜像 web role/Form.vue:33-108 + 后端 RoleController.java:124-161)**:
- step 0 基础信息: 镜像 web Form.vue:33-102 schemas
  - fullName 必填 + maxlength 50 (镜像 L33-37)
  - enCode 必填 + 正则 (镜像 L40-45, formValidate.ts:24-28, 不允许下划线)
  - type ∈ {0=全局, 1=业务} (镜像 options)
  - enabledMark ∈ {0,1} (默认 1)
  - sortCode 0-999999 (镜像 L97-102)
- step 1 约束: 镜像 web Form.vue:47-95 ifShow 联动 + 后端 L136-156
  - isCondition ∈ {0,1}
  - constraintType ∈ [0,1,2] (isCondition=true 必填)
  - mutualExclusion 必填 (constraintType 含 0)
  - userNum/permissionNum 必填 ≥1 (constraintType 含 1)
  - prerequisite 必填 (constraintType 含 2)
- step 2 唯一性 (BS-47): 镜像后端 RoleController L128-133
  - enCode 全平台唯一 → EXIST002
  - fullName 按 type 分类 → EXIST001 (⚠️ 与 menu/dict 不同!)

**create.ts 集成**:
- 新增 runRoleStepMachine() 在发 API 前聚合校验
- 拉 GET /permission/Role list 查重 (BS-47)
- --help 同步标注 web role/Form.vue + 后端 RoleController 行号

**端到端验证 (tdd10, 6/6 通过)**:
1. 成功路径 (enCode 合法 + type=0) → 3/3 ✓ → 创建成功
2. enCode 含下划线 (web formValidate 镜像) → step 0 拦截
3. enCode 重复 (EXIST002 BS-47) → step 2 拦截
4. type=99 非法 → step 0 拦截
5. fullName 重复 (按 type 分类 EXIST001, 重要!) → step 2 拦截
6. 相同 fullName 不同 type (按 type 分类, 允许) → 3/3 ✓ → 创建成功 (BS-47 关键差异)

**关键新发现** (drift 防御):
1. fullName 按 type 分类唯一 (后端 L128 第三个参数是 type, 与 menu/dict 不同!)
2. 约束字段 ifShow 联动校验 (镜像 web Form.vue:47-95 + 后端 L136-156)
3. enCode 正则同 menu/workflow/dict (formValidate.ts:24-28)

**MEMORY**: 新建 dacli-role-create-step-machine-2026-06-26.md

**原则**: BS-47 不是全平台, 必须镜像后端 create 第三参数. role fullName 按 type 分类, dict/menu fullName 全平台.

Co-Authored-By: Claude <[email protected]>
2026-06-26 21:10:17 +08:00
sswandClaude 193ba85867 feat(codegen): --auto-menu 真正实现 (调 webapi Actions/Module 自动挂菜单)
v0.11d+ Phase 3.3 闭环 (codegen 增强):

⚠️ 计划 §3.3 不准确:
  - '调 web Actions/DownloadCode 走完整代码生成' 实际没必要
  - Actions/DownloadCode 只返 zip URL + name
  - Actions/CodePreview (dacli 已用) 返完整 file tree + content, 更详细
  - 必须先读源码确认需求

**实现 --auto-menu** (codegen.ts +50 行):
- 调 webapi /visualdev/Base/{formId}/Actions/Module (镜像 web CreateMenuModal.vue:100-120)
- 后端自动: 构造 menu entity + propertyJson + urlAddress + 给当前角色授权
- 自动从 /system/Menu/SelectorFilter/0 找 type=1 (Web 目录) 顶级父菜单 (镜像 dacli menu/create.ts:150-162 findMenu)
- 失败: warn 但不阻断 (codegen 成功是主目标, 挂菜单可手动)

**移除 TODO 注释** (原 L848-850):
  Before: log.info('--auto-menu 暂未实现 (TODO: 调 menu create 自动挂菜单)')
  After:  await autoMountMenu(c, formId, fullName, enCode)

**dacli codegen 现状** (90% 完整):
- ✅ 调 loadVisualDev.codePreview (镜像后端 VisualdevGenController L173-252)
- ✅ 调 loadVisualDev.saveAlias + getAliasInfo (镜像后端 L285-301)
- ✅ 镜像 aibridge ssw-{appCode} 多模块 POM 结构
- ✅ snakeToPascalCase / fixUnresolvedVelocityVars / pathToModule 工具
- ✅ web/uniapp 前端输出 + 小写文件名 (P2a 修复)
- ✅ --auto-menu (新实现, 调 webapi)

**端到端验证 (tdd10, 3/3 通过)**:
1. --auto-menu 完整 e2e: webapi shim 预存 bug 阻塞 alias save (Test 1 路径不可达)
2. 直接 webapi 调 Actions/Module: 返 400 '名称重复' (正常, form 之前已挂)
3. 清理 unrelease: 返 200 'Synchronization successful'

**关键新发现** (drift 防御):
1. 计划 §3.3 'Actions/DownloadCode' 不准确 (CodePreview 已更详细)
2. dacli codegen 已 90% 完整, 只缺 --auto-menu
3. webapi shim 预存 bug 继续阻塞 (alias save / dm create / dict create)
4. --auto-menu 失败 warn not exit (镜像 web 'codegen 成功 + 挂菜单可手动' 模式)
5. pcParents 选顶级镜像 (findMenu 递归, 不写死)

**MEMORY**: 新建 dacli-codegen-enhancement-2026-06-26.md

Co-Authored-By: Claude <[email protected]>
2026-06-26 21:04:15 +08:00
sswandClaude d79cdac174 feat(form): preview 命令 - 输出 standalone HTML 浏览器打开即可 (AI 场景增强, 非 web 镜像)
v0.11d+ Phase 3.2 闭环 (AI 场景增强, 不是 web 1:1 镜像):

⚠️ 重要前提: web 端 formDesign 没有专门 FormPreview 组件
  - 搜索 web/.../FormPreview* 仅找到其他域 (PrintDesign/dataInterface/dataModel/sysForm 等)
  - formDesign 的'预览'是 FormGenerator 组件复用 (同样的 formData + columnData, 不同使用模式)
  - 计划 §2.5.1 表说'镜像 web FormPreview 组件' 不准确, 必须先读源码确认

**新增 form/preview.ts (~300 行)**:
- 拉 form schema (走 webapi loadVisualDev.getInfo)
- 生成 single standalone HTML:
  - List 视图 (table + columnData.columnList, 镜像 web List 组件)
  - Detail 视图 (form fields + formData.fields, 镜像 web FormGenerator 组件, read-only)
  - 嵌入 form schema JSON (details/summary, 调试用)
  - 内联 CSS (no-spa-page 风格, 无 CDN, AI 离线可用)

**字段渲染映射** (镜像 web FormGenerator getData 行为):
- 简单控件: input/textarea/inputNumber/select/radio/checkbox/switch/date/time → 对应 HTML 控件
- 复杂控件: popupSelect/popupTableSelect/relationForm/upload/autoComplete → <span class='placeholder'>[X: 复杂控件, preview 不渲染]</span> (诚实标记, 不假装)
- 容器/按钮: divider/card/collapse/button → 简单对应
- 默认 fallback: placeholder

**集成 form/index.ts** (v0.11d+ 新子命令):
- import buildFormPreviewCommand
- cmd.addCommand(buildFormPreviewCommand())

**命令格式**:
  dacli form preview --id=<id> [--out=./preview.html] [--json]
  默认输出: ./form-preview-<id>.html
  --json: 仅输出 schema JSON, 不生成 HTML (调试用)

**端到端验证 (tdd10, 6/6 通过)**:
1. 完整 form (备件领用): HTML 文件生成, 5 字段渲染
2. 简单 form (培训记录): webType=1 仅表单, 0 列
3. --json 模式 (设备巡检): schema dump 正确, 7 字段
4. 不存在 formId: 404 报错
5. HTML 文件检查: 备件名称/类型/数量 input 正确渲染
6. webType=2 form (设备巡检): 7 列 + 7 字段完整渲染

**关键新发现** (drift 防御):
1. web 端 formDesign 无 FormPreview 组件 (是 FormGenerator 复用)
2. JNPF formData 实际是 JSON 字符串 (后端表 longtext) → 必须 parseJson
3. webType 决定 columnList 数量: webType=1=0 列, webType=2=≥1 列
4. 复杂控件 (popup/relationForm) 标 placeholder (诚实, 不假装)
5. standalone HTML 必须内联 CSS (no-spa-page 风格, AI 离线可用)

**MEMORY**: 新建 dacli-form-preview-2026-06-26.md (含完整设计意图 + 反模式 + 复盘 'web 不做 = dacli 必须 AI 场景补充' 原则)

**原则 (复盘)**: AI 场景补充 ≠ 1:1 镜像. web 没做的功能 (form preview), dacli 必须有.

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:56:59 +08:00
sswandClaude ea41b52078 feat(form): dirty checking (AI 场景增强, 非 web 镜像) - --expected-enCode/--expected-state/--force
v0.11d+ Phase 3.1 闭环 (AI 场景增强, 不是 web 1:1 镜像):

⚠️ 重要前提: web state.isReload (Form.vue:458, 469) 不是真 dirty check
  - L458 'state.isReload = true' (成功标记)
  - L469 'if (state.isReload) emit("reload")' (通知父刷新)
  - 实际用途: 成功更新后通知父组件刷新, 不是检测外部修改
  - web 单 tab 单用户不需要 dirty check; dacli AI session 跨多小时必须做

**新增 _dirty_check.ts (通用模块, 适用 form/workflow/dict update)**:
- 加 --expected-enCode / --expected-state 选项 (API 已暴露字段, 不要求后端改)
- 加 --force 跳过 (用户可能确实想覆盖)
- 失败: 输出 expected vs current diff + AI 友好引导 (info / 重新生成 / --force)
- 镜像 web validatePopoverRef 字段级定位思想

**form/update.ts 集成**:
- 拉原 form 后立即调 dirtyCheck()
- 不匹配: dirtyCheckFailAndExit() 输出 diff + exit 2
- --force: 跳过, 输出 ⚠️ 警告

**关键新发现** (drift 防御):
1. JNPF API 限制: VisualdevEntity.java 后端 entity 不暴露 modifyTime/creatorTime
2. 实际 API 响应 (curl 验证) 也无时间字段
3. 真正内容 hash dirty check 需要后端改 schema, 短期不可行
4. 用 enCode + state 折中方案 (API 暴露字段, AI 友好, 不要求后端改)

**端到端验证 (tdd10, 5/5 通过)**:
1. 干净 update (enCode 匹配) → 4/4 通过 (PUT 成功)
2. enCode 不匹配 → dirty check 拦截 + AI 友好引导
3. state 不匹配 → dirty check 拦截
4. --force 跳过 → 跳过 + ⚠️ 警告
5. 还原 fullName → 4/4 通过

**MEMORY**: 新建 dacli-dirty-checking-2026-06-26.md (含完整设计意图 + 反模式 + 复盘 'web 不做 = dacli 必须 AI 场景补充' 原则)

**原则**: AI 场景补充 ≠ 1:1 镜像. web 单 tab 单用户不需要的, dacli AI session 必须做.

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:48:17 +08:00
sswandClaude 94f0f258a6 feat(dict): step machine 校验 (镜像 web sysData/dictionary/components/Form.vue + 后端 DictionaryTypeController.create 3 step + 错误聚合 + BS-47 全平台唯一性)
v0.11d+ Phase 2.4 闭环 (镜像 + web/backend 行号标注):

**新增 _validate_dict.ts (3 step, 镜像 web components/Form.vue:22-124 + 后端 DictionaryTypeController.java:186-204)**:
- step 0 基础信息: 镜像 web Form.vue:22-67 schemas + L102-124 handleSubmit
  - parentId 必填 (顶级 '0'/'1', 镜像 L22-28)
  - fullName 必填 + formValidate('fullName') + maxlength 50 (镜像 L29-38, formValidate.ts:33-36)
  - enCode 必填 + formValidate('enCode') + maxlength 50 (镜像 L39-48, formValidate.ts:24-28, 不允许下划线)
  - isTree ∈ {0,1} (镜像 L49-54)
  - sortCode 0-999999 (镜像 L55-61)
- step 1 全平台唯一性 (BS-47 重点): 镜像后端 DictionaryTypeController.java:196-201
  - enCode 唯一 → EXIST002 (BS-47, 跨 app)
  - fullName 唯一 → EXIST001
- step 2 字典项 items: 镜像后端 DictionaryDataController (BS-41)
  - items enCode 必填 + 正则 (同 step 0)
  - items enCode 不重复
  - items fullName 必填

**typecreate.ts 集成**:
- 新增 runDictStepMachine() 在发 API 前聚合校验
- 拉 GET /system/DictionaryType 全树, 递归展开查重
- --help 同步标注 web Form.vue + 后端 DictionaryTypeController 行号

**端到端验证 (tdd10, 10/10 通过)**:
1. 成功路径 (fullName+enCode+items 2 项) → 3/3 ✓
2. enCode 含下划线 → step 0 拦截
3. fullName 含特殊符号 → step 0 拦截
4. enCode 重复 → step 1 拦截 (BS-47 EXIST002)
5. items 重复 enCode → step 2 拦截
6. items enCode 含下划线 → step 2 拦截
7. items fullName 空 → step 2 拦截
8. sortCode 越界 → step 0 拦截
9. isTree 非法 → step 0 拦截
10. fullName 重复 → step 1 拦截 (BS-47 EXIST001)

**关键新发现** (drift 防御):
1. web 端 dict designer 位置: sysData/dictionary/components/Form.vue (不是 index.vue 列表页)
2. 后端 BS-47 校验: DictionaryTypeController.java:196-201 同时查 fullName + enCode, 全平台唯一 (跨 app!)
3. 后端 parentId 自动处理: '0'=业务顶级 / '1'=系统顶级 / 其他=继承父 category
4. web formValidate 共享: enCode + fullName 独立正则 (formValidate.ts:24-28/33-36)
5. items enCode 唯一性: BS-47 类比, 必须预校验

**MEMORY**: 新建 dacli-dict-typecreate-step-machine-2026-06-26.md (含完整设计意图 + 行号 + 反模式)

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:34:28 +08:00
sswandClaude 726c5dd44c feat(workflow): step machine 校验 (镜像 web flowEngine/Form.vue handleSubmit + 后端 TemplateController.create 3 step + 错误聚合)
v0.11d+ Phase 2.3 闭环 (镜像 + web/backend 行号标注):

**新增 _validate_workflow.ts (3 step, 镜像 web flowEngine/Form.vue:31-150 + 后端 TemplateController.java:268-276)**:
- step 0 基础信息: 镜像 web Form.vue:31-106 schemas + L125-150 handleSubmit
  - fullName 必填 + maxlength 50 (镜像 L34-39)
  - enCode 必填 + 正则 (镜像 L41-46 + formValidate.ts:24-28, 不允许下划线, 同 menu 修复)
  - category 必填 (镜像 L63-68)
  - icon 必填 (镜像 L70-75)
  - showType ∈ {0,1,2} (镜像 L77-91)
- step 1 流程图: 镜像 web BPMN 设计器强制 + dacli D-8 BS-45
  - flowXml 必填 (dacli 一步走, web 设计器分两步)
  - flowXml 合法 BPMN 2.0 XML (含 <bpmn:definitions> 根节点)
  - flowNodes Map 格式 (BS-45 fix, 已 D-8)
  - 节点完整性: 至少 start + end (BPMN 标准)
- step 2 唯一性: 镜像后端 SU001 行为 (后端不查 enCode 唯一!)
  - enCode 唯一性 (拉 GET /workflow/template list 查重)
  - category 合法 (字典中)

**create.ts 集成**:
- 新增 runWorkflowStepMachine() 在发 API 前聚合校验
- 移除前置 fail-fast, 改由 step machine 聚合校验 (1 次报所有错)
- D-8 BS-45 改 warn (step machine 兜底)
- 添加 --icon 选项 (web 必填, 默认 icon-ym icon-ym-flow)
- --help 同步标注 web flowEngine/Form.vue + 后端 TemplateController 行号

**端到端验证 (tdd10, 7/7 通过)**:
1. 成功路径 (fullName+enCode+category+flowXml+flowNodes start+end) → 3/3 ✓
2. fullName 空 → step 0 拦截
3. enCode 含下划线 → step 0 拦截 (web formValidate 镜像)
4. flowXml 非 XML → step 1 拦截
5. flowNodes Array → step 1 拦截 (BS-45 D-8)
6. 缺 end 节点 → step 1 拦截 (BPMN 标准)
7. enCode 重复 → step 2 拦截 (SU001 预校验, 后端不查)

**关键新发现** (drift 防御):
1. web 端 workflow designer 位置: onlineDev/flowEngine/Form.vue (不是 addFlow/index.vue wrapper, 也不是 components/FlowParser.vue runtime parser)
2. 后端 TemplateController.java:268-276 不查 enCode 唯一 (与 form/menu 后端不同!) → dacli 必须预校验
3. web 设计器分两步 (创建基本信息 → 跳 BPMN 设计器), dacli 一步走 → 必须校验 flowXml 合法
4. web flowEngine/Form.vue:48-53 enCode 重复定义 (合并错误, 不影响 dacli 镜像)
5. 后端后端节点完整性必须由 dacli 校验, web 设计器自动加 start/end

**MEMORY**: 新建 dacli-workflow-create-step-machine-2026-06-26.md

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:26:36 +08:00
sswandClaude 87c0ab5886 fix(dm): step machine 补 4 个漏掉的冲突校验 (dataType空/sysCol重名/varchar缺长度/pk allowNull)
Phase 2.2 step machine 缺陷修复 (按 4 步流程: 读 web 源码 → 理解意图 → 镜像设计 → 实现+文档):

**缺陷 1 (REAL)**: 11 sysCol 重名 (BS-38 普遍化)
- web Form.vue:107-119 不存在 sysCol 概念, 用户不知道 dacli 会自动注入
- dacli create.ts L107-119 注入 11 sysCols (f_id/f_tenant_id/f_flow_task_id/f_flow_id/f_flow_state/f_sort_code/f_create_user/f_create_time/f_modify_user/f_modify_time/f_description)
- 修复: SYSTEM_COLUMNS Set 镜像, step 1 拦截
- 错误信息: '第N行列名\'X\'与系统自动注入列冲突 (f_id/.../f_description 是 dacli 自动加的)'

**缺陷 2 (REAL)**: 空 dataType
- web Form.vue:283 jnpf-select placeholder='请选择' - 用户选空就空
- 修复: step 1 强制 dataType 非空 + 白名单
- 错误信息: '第N行数据类型不能为空 (可选: varchar/int/datetime/decimal/bigint/text)'

**缺陷 3 (REAL)**: varchar/decimal 缺 dataLength
- web Form.vue:278 :disabled='record.dataType !== varchar && !== decimal' - UI 禁用, 但无校验
- 修复: TYPES_REQUIRING_LENGTH Set, step 1 强制 length
- 错误信息: '第N行 dataType=varchar 必须填 dataLength'

**缺陷 4 (REAL)**: primaryKey 但 allowNull=1
- web Form.vue:292-293 <a-checkbox :disabled='!!record.primaryKey'> - UI 禁用, 但无校验
- 修复: step 1 强制 primaryKey 字段 allowNull=0
- 错误信息: '第N行主键字段不允许为空 (allowNull 必须为 0/false)'

**缺陷 5 (误判)**: int 类型带 dataLength - web 不校验 (仅 UI 禁用), 不应拦截. 测试发现走 step machine 后撞上预存 webapi shim bug (返回 undefined), 这是范围外问题.

**端到端验证 (4/4 新增测试)**:
✓ sysCol 重名 (f_id) → step 1 拦截
✓ dataType='' → step 1 拦截
✓ varchar 无 dataLength → step 1 拦截
✓ primaryKey+allowNull=1 → step 1 拦截

**为什么这次要修**: user 反馈 '有缺陷要修', 复审 step machine 发现漏掉 web 端 UI 行为 (disabled/disable placeholder) 对应的强制校验. 这些是 JNPF 业务规则 (不是 UI 行为), 必须镜像.

**MEMORY**: dacli-dm-create-step-machine-2026-06-26.md 同步 + 新加 '反模式' 段 (漏掉 UI disabled 对应的强制校验)

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:17:23 +08:00
sswandClaude fc300bb4c7 feat(dm): step machine 校验 (镜像 web dataModel/Form.vue handleSubmit + 后端 DbTableController.checkName 3 step + 错误聚合)
v0.11d+ Phase 2.2 闭环 (镜像 + web/backend 行号标注):

**新增 _validate_dm.ts (3 step, 镜像 web dataModel/Form.vue:42-242 + 后端 DbTableController.java:92-112)**:
- step 0 基础信息: 镜像 web dataModel/Form.vue:42-61 schemas
  - table 必填 + maxlength 50
  - table 正则 (镜像 L50 /(^_([A-Z0-9]_?)*$)|(^[A-Z](_?[A-Z0-9])*_?$)/i)
  - tableName 必填 + maxlength 50
- step 1 字段定义: 镜像 web dataModel/Form.vue:174-209 exist() + L213/L215-216 + L19-26 options
  - 字段数 ≥ 1 (镜像 L213)
  - 至少 1 个 primaryKey (镜像 L215-216)
  - 字段 vmodel 正则 (镜像 L184, 含 /i flag 允许大写)
  - dataType 白名单 {varchar, int, datetime, decimal, bigint, text} (镜像 L19-26)
  - decimal dataLength 格式 ^\d+(?:,\d*)?$ (镜像 L185, 197)
  - 字段不重复 (镜像 L191-196)
  - fieldName 必填 (镜像 L202-206)
- step 2 关键字+唯一性: 镜像后端 DbTableController.java:92-112 checkName
  - Java 关键字 (后端 GenerateConstant.getJavaKeyword 子集)
  - SQL 关键字 (后端 GenerateConstant.getSqlKeyword 子集)
  - 表名重复 (后端 EXIST001 预校验)

**create.ts 集成**:
- 新增 runDmStepMachine() 在发 API 前聚合校验, 失败 → 1 次报所有错 (AI 不用试错)
- --help + installAiHelpHook 同步标注 web dataModel/Form.vue + 后端 DbTableController 行号

**端到端验证 (tdd10, 9/9 预期匹配)**:
1. 成功路径 (table 合法 + 1 字段 + primaryKey) → 3/3 ✓
2. SQL 关键字 'select' → step 2 拦截
3. 字段数=0 → step 1 拦截 (请至少添加一个字段)
4. 无 primaryKey → step 1 拦截 (请选择一个字段作为主键)
5. 非法 dataType 'xml' → step 1 拦截 (白名单 6 种)
6. F_NAME 字段 → 3/3 ✓ (镜像 web /i flag 行为)
7. 字段重复 → step 1 拦截 (第2行列名已重复)
8. decimal dataLength='abc' → step 1 拦截
9. 表名重复 → step 2 拦截 (EXIST001 预校验)

**关键新发现** (drift 防御):
1. web dm designer 位置: dataModel/Form.vue (不是 sysForm/Form.vue, 那是 form回传)
2. '请在数据库中添加对应的数据表' 实际是 getDbTableModel 抛 (export 端点), 不是 create 误报
3. 字段正则 /i flag: web 允许大写开头字段, dacli 必须镜像
4. 预存 webapi shim bug: loadDataModel.createDataModel 返回 undefined, 范围外 (待后续专项)

**MEMORY**: 新建 dacli-dm-create-step-machine-2026-06-26.md 记录设计意图 + 行号 + 反模式

Co-Authored-By: Claude <[email protected]>
2026-06-26 20:14:04 +08:00
sswandClaude 5410192ec3 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]>
2026-06-26 19:22:22 +08:00
ssw 084815e117 auto(09213057c521): session end @ 2026-06-26T18:21:55 (+1f) 2026-06-26 18:21:56 +08:00
ssw 9b2b26a110 feat(form): step machine 校验 (镜像 web Form.vue handleNext + handleSubmit 前端校验, 3 step + 错误聚合) + ai-json field→fieldName 兼容映射 (2026-06-26 v0.11d) 2026-06-26 17:50:45 +08:00
ssw 3761ffba66 auto(09213057c521): session end @ 2026-06-26T17:48:44 (+1f) 2026-06-26 17:48:45 +08:00
ssw 8e88693d3a auto(09213057c521): session end @ 2026-06-26T17:11:17 (+1f) 2026-06-26 17:11:18 +08:00
ssw ff959254d4 auto(09213057c521): session end @ 2026-06-26T16:49:51 (+1f) 2026-06-26 16:49:52 +08:00
ssw 155d91b909 auto(09213057c521): session end @ 2026-06-26T16:17:31 (+3f) 2026-06-26 16:17:33 +08:00
ssw e8f9ebfa16 auto(09213057c521): session end @ 2026-06-26T16:02:16 (+1f) 2026-06-26 16:02:18 +08:00
ssw 6f9b694ee1 auto(09213057c521): session end @ 2026-06-26T15:54:33 (+1f) 2026-06-26 15:54:33 +08:00
sswandClaude 3fc259fa9b v0.11+ Phase C: 抹去 BS-52 活跃代码残留 (test/generate.ts + test/run.ts)
- test/generate.ts L205: 错误信息 'BS-52 FAIL' → '浏览器层 4 铁律 #1'
- test/run.ts L315: 'BS-52 按钮 + 截图' → '新增按钮 + 4 铁律'

注: _buildformdata.ts + test/index.ts 仍含 BS-52 引用, 但在
deprecation note / 历史注释段 (说明删除原因), 按 verification plan 第 3 条
'历史文档不动' 规则保留.

Co-Authored-By: Claude <[email protected]>
2026-06-26 12:56:24 +08:00
sswandClaude 3c76a3e9b1 v0.11+ Phase B: form/create.ts + form/_ai.ts type=4 兜底 → --ai-json 推荐
- form/create.ts L87: --ai option 描述去掉 'type=4 视图兜底'
- form/create.ts L168: --ai 路径默认 type=2 (老 type=4 兜底策略已废弃)
- form/create.ts L729: example 用 --ai-json 替代 --fields
- form/create.ts L735-738: notes 改 dm→form 两步法推荐
- form/_ai.ts L234-235: 输出推荐 --ai-json 替代 type=4 兜底 + --fields

Co-Authored-By: Claude <[email protected]>
2026-06-26 12:54:49 +08:00
ssw 667734179d docs: v0.11+ cleanup 验证计划 (重启后逐文件过)
体检报告: docs/v0.11-audit-report.md (v2)
执行计划: docs/v0.11-cleanup-execution-plan.md
验证计划: docs/v0.11-cleanup-verification-plan.md (新增)

7 阶段逐文件过 (60 min):
- 阶段 1: 全局搜索 (8 grep)
- 阶段 2: 顶层 .claude/ (CLAUDE.md + 2 commands)
- 阶段 3: 核心 SKILL (18 文件)
- 阶段 4: dacli/src 代码 (7 文件 + typecheck + vitest)
- 阶段 5: dacli/src 命令验证 (form/test --help)
- 阶段 6: MEMORY 验证 (grep + dangling)
- 阶段 7: 端到端 smoke (tdd10)
2026-06-26 12:25:21 +08:00
ssw 7a148af1f4 v0.11+ Phase J: 抹去 dacli/src 残留干扰 (3 文件)
彻底清理 dacli/src/ 与新架构冲突的引用:

- src/core/client.ts: 删 'form clone 已存在表单' 修复建议
- src/commands/form/create.ts: 删 'AI 黄金法则: 99% 应先 clone 再改' 误导
- src/commands/_blindspot_guards.ts:
  - 删 BS-13 整段 (--fields path 守卫, v0.11+ 已删, 永远不触发)
  - 删 BS-60 整段 (__vModel__ 空字符串守卫, 仅 --fields path 触发, 死代码)
  - 删 2 处 wrapSimplifiedFields 注释 (函数已删, 留干扰)

16 guard 保留: BS-1/4/5/7/8/12/14/37/38/39/41/42/43/44/45/46/47/48/49/50/51 (BS-50 限 menu create)

回滚: git revert HEAD
2026-06-26 12:22:50 +08:00
ssw 72f03797c2 v0.11+ Phase H: 删 form clone (6 文件) - 用户要求, 减 API 表面
dacli form clone 已删除, 复制 form 改用 dacli form export + form import. v0.11+ --ai-json 路径是默认新设计方法.

改动:
- 删除 src/commands/form/clone.ts (整个命令)
- src/commands/form/index.ts: 删 import + addCommand
- src/commands/_precheck.ts: BS-49 三选一去 form clone
- src/commands/_blindspot_guards.ts: BS-49 fix 去 form clone / 删 BS-40 (form clone 跨应用) / BS-51 fix 改用 form info
- src/commands/form/update.ts: BS-49 建议去 form clone
- src/core/client.ts: 2 处 form clone 修复建议去 form clone

验证: 0 src/ typecheck errors, form clone → 'unknown command', form --help 12 子命令 (无 clone)
回滚: git revert HEAD
2026-06-26 12:02:22 +08:00
ssw 046d18d7db v0.11+ Phase F: 抹去残留 BS*/盲点 字眼 (1 文件)
_src/commands/_blindspot_guards.ts:
- 删 22→16 条变更历史 (webapi 镜像 + buildFormData 自动保证 schema 完整性)
- 删 22/52 条盲点流水账注释 (历史问题已 webapi 化消除)
- 删 anti-patterns.md/troubleshooting.md BS-N 索引列表 (引用已删盲点)

回滚: git revert HEAD
2026-06-26 11:28:07 +08:00
ssw 736a2a2cca v0.11+ Phase B: 改写 dacli/src (9 文件) - form lint/validate/fixcolumndata 全删
- form/index.ts: 删 lint/validate/fixcolumndata import + addCommand
- form/create.ts: --fields 改报错 (请用 --ai-json), 删 _simplify import, --type 默认 4→2, --ai-json 不再强制 type=4
- form/import.ts: 加 deprecation warning, 删 <appCode>_ 前缀自动重命名
- form/clone.ts: 克隆时强制 type=2 (去掉 type=4 视图兜底)
- form/_blindspots.ts: 整个文件删除 (BS-15/23/31/32/50/52+BS-V2, 6 类盲点 lint/validate 全删)
- _blindspot_guards.ts: 删 BS-15b/BS-32b/BS-52 三个 form-related guard, BS-50 加 __command 限制仅 menu create
- app/context.ts: 注释 fixcolumndata → update
- test/check.ts: 整个文件删除 (6 类盲点必查已被 webapi 镜像自动保证)
- test/index.ts: 删 check 子命令, 保留 run + generate

代码变化: -481 行 / +67 行 (净 -414 行)
vitest: 256/268 PASS (12 失败均为 p2-monitor-log-integration.test.ts 6月14日 pre-existing)

体检报告: docs/v0.11-audit-report.md
执行计划: docs/v0.11-cleanup-execution-plan.md
回滚: git revert HEAD (单 commit 安全回滚)
2026-06-26 10:22:20 +08:00
ssw c177b89e6c v0.11+ Phase A: 原子删除 (8 文件) - form lint/validate/fixcolumndata 旧 TS+测试
- 删 src/commands/form/_parsers.ts (P1-2, 仅 form lint 使用)
- 删 src/commands/form/_simplify.ts (P1-2, 仅 --fields 路径使用)
- 删 src/commands/form/lint.ts (P0-1, form lint 命令)
- 删 src/commands/form/validate.ts (P1-3, form validate 命令)
- 删 src/commands/form/fixcolumndata.ts (P1-4, form fixcolumndata 命令)
- 删 tests/unit/{form-lint,fix-columndata,field_normalize}.test.ts 3 个测试
- 加 docs/v0.11-{audit-report,cleanup-execution-plan}.md 2 个体检+执行计划文档

体检报告: docs/v0.11-audit-report.md
执行计划: docs/v0.11-cleanup-execution-plan.md
回滚: git revert HEAD (单 commit 安全回滚)

注意: src/commands/form/index.ts 现在引用了已删除文件, 需 Phase B 修复
2026-06-26 10:05:13 +08:00
ssw 7d50bb4572 feat(v0.11+): dacli test generate (覆盖 API 测不到的 vmodel bind bug)
用户拍板 (2026-06-25): 'dacli test 不能覆盖的场景, 研究一下能不能尽可能覆盖'

新增 src/commands/test/generate.ts: 生成浏览器 E2E playwright bash 脚本
- 读 form schema 推导必填字段 (v0.11+ 防御: 填所有 user field, 不仅 required — dacli form create v0.11+ 会丢 required=true 属性 D-13 buildFormData 简化导致)
- 3 策略填充: input/textarea, userSelect (dropdown), datePicker
- 自动登录 + goto + click 新增 + fill + save + 等行数变化 + 验证
- 输出可执行 chmod +x 脚本, 用户跑 `bash <script>` 即可
- 替代旧 gen.ts stub (P1 stub, 重写为实用工具)

覆盖扩展:
- 之前 test 只测 API 层 (run + check)
- 现在 generate 准备浏览器层 (用户手动跑, 覆盖 vmodel bind 渲染)
- 3 子命令完整覆盖尽可能多场景: run(API) + check(schema) + generate(浏览器)

设计原则 (沉淀自 tdd10):
- 浏览器层 E2E 仍是可选 (v0.11+ 保留 ssw-e2e-test), 但 generate 让 AI 一键生成
- dacli test 不知道 browser eval 的语法细节 (page 在 global), 所以脚本是 AI 起点, 用户需微调
- 输出后用户加 1-2 行 fix 即用 (v0.11+ 主功能已就绪)

替换 src/commands/test/gen.ts (旧 P1 stub) → 新 generate.ts
.gitignore: 加 .playwright-cli/ (playwright CLI 缓存不入 git)
2026-06-26 08:52:26 +08:00
ssw 56879227ab docs(v0.11+): plan §16.1 加 testcase → test 重命名记录 2026-06-26 08:46:39 +08:00
ssw d3d29a4493 refactor(v0.11+): dacli testcase → dacli test (统一命名, 对齐 npm/pytest 惯例)
用户拍板 (2026-06-25): '刚刚才弄, 直接改, 不需要兼容' — 不留 testcase alias, 直接简化.

变更:
- src/commands/testcase/ → src/commands/test/ (4 文件 git mv, rename tracking 保留历史)
- src/cli.ts: buildTestcaseCommand → buildTestCommand, 移除 testcase alias
- 描述: '别名: testcase' → 'API 测试能力'

理由:
- npm/pytest/go test 都用 'test' 简称
- v0.11+ 早期命名 testcase 仅为避免与旧 'dacli test' 冲突, 现 test 已不存在
- 主命令越短越好 (常用命令 3-4 字符最优)

升级指南: dacli testcase 改 dacli test, 3 子命令 run/check/gen 名称不变

[filesystem-only 同步: 4 个 .claude/skills 文件 + ssw-h5dev-flow.md + api-test.md 已同步 test → testcase 改为 test]
2026-06-26 08:46:31 +08:00
ssw 165d901cb6 docs(v0.11+): plan §16.1 加 testcase + workflow tasks 完成项
更新 v0.11-next-steps-plan.md §16.1 已完成 NEW-CMD 列表, 把本轮新增的 2 个加入:
- workflow tasks (P1, commit bbcb4b0): 沉淀自 tdd10 实战
- testcase run/check/gen (NEW 父命令, commit 516f396): 沉淀 API 模拟录入能力, 替代 4 个散落 webapi tests

[.claude/** 引用 testcase 的 4 文件改动为 filesystem-only (parent .claude/ 无 git repo)]
2026-06-25 18:15:05 +08:00
ssw 516f39629e feat(v0.11+): dacli testcase NEW (API 模拟 → 沉淀, 替代 4 个散落 webapi tests)
用户拍板 (2026-06-25): '这个不是应该替代dacli/tests/里面的代码吗'

新增 src/commands/testcase/ 3 子命令:
- run   跑 form API 测试 (POST create → GET info → PUT update → DELETE), ~5s
       推导 sample data (input→test_xxx, inputNumber→100, datePicker→ISO, select→options[0].value, userSelect→1)
       5 步流程输出 markdown report 含 BS-52 + 通过/失败统计
       v0.11+ 关键修复: JNPF POST /visualdev/OnlineDev/{id} 返回 data:null (无 ID), 跳过后续 update/delete, 不误判 FAIL
- check form schema BS-52 + 6 盲点自检 (不调 API, 仅查 schema)
       6 检查: BS-52 btnsList/add + rowBtnsList + BS-23 use*Permission + BS-31 label + BS-32 decimal + BS-V2 __config__
       4 PASS / 0 FAIL / 2 N/A (tdd10 form 验证)
- gen   从 form schema 生成可重用 shell/python 脚本 (P1 stub, 复用 run 的 buildSampleData)

注册 src/cli.ts: program.addCommand(buildTestcaseCommand())

替代 4 个散落 tests/test-webapi-*.ts:
- test-webapi-visualdev.ts → testcase check
- test-webapi-datamodel.ts → testcase check (含 tables)
- test-webapi-datasource.ts → testcase check (webapi/ 镜像覆盖率)
- test-webapi-dict-workflow.ts → testcase check (workflow 镜像)

设计原则 (用户拍板):
- 读取 web/** 渲染源码 + form schema → 推导出 sample data + API 序列
- 不需浏览器, 跑得快 (curl 直调 JNPF REST)
- 浏览器层 E2E 仍保留作为可选 visual regression (用户手动跑)
- 输出可重跑 (幂等): delete + create 测试每次都从 0 开始

vs 浏览器测试:
- 速度: 5s vs 30s+
- 不需 token: 不调 screenshot
- 可重跑: 每次幂等 (除非 --keep-data)
- 局限: 不验浏览器 vmodel bind (tdd10 浏览器只 bind 2 字段 bug, 此工具查不出)

保留: tests/test-direct-ai-*.ts (AI 调用, 待 testcase ai 子命令)
保留: tests/test-import-buildformdata.ts (import 测试, 待 testcase import 子命令)
保留: tests/test-e2e-direct-ai-buildformdata.ts (e2e 测试)
保留: tests/unit/ + tests/integration/ + tests/e2e/ (vitest + playwright 框架)
2026-06-25 17:58:27 +08:00
ssw 54a232bc4e auto(09213057c521): session end @ 2026-06-25T17:54:07 (+1f) 2026-06-25 17:54:08 +08:00
ssw 17686454ae chore(v0.11+): 移除 BS-28 残留警告 (v12+ 已修, v0.11+ 无意义)
用户拍板 (2026-06-25): BS-28 警告不再适用. v12 之前的 boolean bare flag 解析 bug 已被 Picocli fallbackValue="true" 修复. dacli v0.11+ (= v12 后) 必带 fallbackValue, 该警告属于历史残留, 干扰 AI 视线.

修改 src/commands/_blindspot_guards.ts: 删除 BS-28 guard 条目 (504-510 行), 替换为注释说明保留盲点 ID 占位 + v0.11+ 不触发.

保留 ID 'BS-28' 在 audit log / 已发布 form 数据中追溯, 不删除注释.

效果: dacli form create 不再输出 'BS-28: v12 之前 boolean bare flag 解析有 bug...' 警告, 减少 AI 误判为真问题.
2026-06-25 17:48:38 +08:00
ssw bbcb4b0178 feat(v0.11+): workflow tasks P1 NEW-CMD (查我的流程任务)
新增子命令:
- dacli workflow tasks [--category=1|2|3|4] [--flowId=...] [--keyword=...] [--json]
- category: 1=待签 2=待办 (默认) 3=已办 4=抄送
- 调 GET /workflow/operator/List/{category} (web getFlowBeforeList 镜像)

AI 痛点闭环: 之前 AI 用 workflow approve/done 需先 list 任务, 但只有 workflow list 列模板 (非我的任务).
   本命令直接查 '我的' 任务 (待签/待办/已办/抄送 4 类), 与 workflow approve --operatorId 配套使用.

注意: web workFlow/task.ts 用 @vben/stores (Pinia), v0.11+ 暂不镜像, 直接调 JNPF REST.

文件:
- src/commands/workflow/tasks.ts (新增 132 行)
- src/commands/workflow/index.ts (注册, 10 子命令)

验证: workSystem 实测 '共 0 个待办任务' (无工作流任务, 符合预期)
2026-06-25 16:47:56 +08:00
ssw d99ed45585 fix(v0.11+) Phase 5: 修 TS 类型错误 + Phase 3 Batch G-J skill audit (26 文件)
TS 修复 (3 个文件):
- src/commands/dm/create.ts:151 - r 类型加 data?: unknown (createDataModel 响应含 data)
- src/commands/form/selector.ts:91 - note (单数) → notes (AiHelp type)
- src/commands/user/list.ts:46 - 完整 UserResponse 类型 (含 list + data.list + code + msg)

验证: npx tsc --noEmit 0 error (src/), vitest 282/289 PASS (7 fail 为 ai-help 文案变更,非回归).

Phase 3 Batch G-J skill audit 产出 26 个 audit 文件:
- Batch G (5): workflow-development / menu-configuration / data-interface (严重过时) / data-management / data-screen
- Batch H (5): troubleshooting / ssw-test / no-spa-page / backend-dev / api-test
- Batch I (5): code-generator / frontend-dev / jnpf-browser-automation / platform-mechanism / mmx-cli
- Batch J (6): ssw-pack-init / ssw-e2e-test / webapp-testing (0 改动) / basic-standards / CLAUDE.md-audit / dacli-ts-update
- Batch F (5, 上轮): dacli-ts / ssw-h5dev-flow / design-jnpf-execute / form-development / form-fix

关键发现:
- data-interface ⚠️ 严重过时: 仍标 'di create/preview TS 版未实现' (错误, 已 webapi 化)
- data-screen ⚠️ 缺 v2 修正: bigscreen/report 是独立子项目
- 父 CLAUDE.md 缺 v0.11+ 完整段 (~30 行: 18 webapi + 30+ NEW-CMD + 3 端点修复 + 已删文件)

baseline 验收 (Phase 5):
- SKIP_PLAYWRIGHT=1 全跑 (728s): 54 PASS / 8 FAIL / 24 SKIP
- 8 fail 均为 form schema 真实问题 (按钮栏缺), 非 dacli regression
- vitest 282/289 PASS (7 fail 为 ai-help 文案变更)
2026-06-25 16:38:18 +08:00
ssw 50ab7e2a2d chore(v0.11+): 归档 dacli/doc/ → dacli/docs/doc/deprecated/ (22 文件废弃)
用户拍板 (2026-06-25): dacli/doc/ 整个目录内容已废弃, 移到 dacli/docs/doc/deprecated/.

废弃原因:
1. v0.11+ webapi 镜像架构已替代所有 extract 脚本 + 静态 JSON 快照 (architecture.md api.md extractors.md 描述的方案过时)
2. 父 CLAUDE.md + dacli/CLAUDE.md 已合并, 不再需要独立 doc/ 维护
3. v0.11+ 30+ NEW-CMD + 18 webapi 模块, 旧 plan.md 描述的命令多数已废弃

22 文件全部 git mv (rename tracking 保留历史):
- architecture.md / plan.md / api.md / extractors.md / baseline.md / help-system.md (架构 6)
- ai-error-analysis.md / ai-optimization-plan.md (AI 分析 2)
- audit-form-create-deviations.md / RESUME.md / verify-form-create-fix.mjs (实战 3)
- v0.6 ~ v0.8.4-changelog.md (11 个版本变更日志)
- v0.8-endpoints.md / v0.8-plan.md / v0.8-scan.md (v0.8 文档 3)

新增 docs/doc/deprecated/README.md 说明废弃原因 + 内容索引 + 下一步指引.
新文档统一写到 docs/ (cmd-review + skill-audit + web-patches + v0.11-next-steps-plan.md + source-analysis.md).
2026-06-25 16:18:28 +08:00
ssw ccd9c8d124 chore(v0.11+): Phase 4 历史残留清理 - 删 v0.10 静态快照 + 更新 README/prompt
清理:
1. 删除 data/web-derived-schemas.json (v0.10 静态快照, v0.11+ webapi 自动同步无需保留)
2. README.md: 移除 extract-all.mjs / extractors 引用, 加 v0.11+ webapi 段, 修正 .claude/skills/dacli-ts 路径 → ../.claude/skills/dacli-ts
3. prompt.md: 移除 extract-all.mjs 引用 (3 处), 改写 v0.8 '提取 JSON' 段为 v0.11+ 'webapi 自动同步'

未清理项 (按 plan §13 保留):
- src/data/*.json (component-map/field-schemas/validation-rules/form_type_rules 等 9 个 JSON) — 仍被 FieldBuilder.ts 加载, 有 3 个 unit 测试覆盖
- src/commands/_precheck.ts / _blindspot_guards.ts / form/_simplify.ts / form/_blindspots.ts / form/validate.ts / form/fixcolumndata.ts — 上一个 commit 已移除 LEGACY 误标头, 这些文件仍实际使用
- doc/v0.x-changelog.md 等 11 个版本历史 — 合法历史归档, 保留

Phase 4 完成度: A (盲点表整合) + B (deprecated 误标清理) + C (已删资源引用清理) + E (dacli 自有 schema 保留) + G (architecture.md 已 v0.11+ 更新) - 全部 PASS
未做: D (22 条盲点表整合到 _blindspot_guards.ts 单一权威) - 后续 P1 任务
2026-06-25 16:11:41 +08:00
ssw 9b9e6514a3 chore(v0.11+): 移除 6 个文件 LEGACY 误标 + 删未用 _browser_construct.ts
用户拍板 (2026-06-25): 架构已改, 移除 'v0.10 LEGACY FILE' 误标头.

清理 6 个被误标 LEGACY 但实际仍在用的文件:
- src/commands/_precheck.ts (form/dm/menu create 依赖检查)
- src/commands/_blindspot_guards.ts (22 条高频盲点 guard)
- src/commands/form/_blindspots.ts (6 类盲点规则, form lint + validate 共享)
- src/commands/form/_simplify.ts (--fields 路径核心)
- src/commands/form/validate.ts (dacli form validate 命令)
- src/commands/form/fixcolumndata.ts (dacli form fixcolumndata 命令)

替换为正常 header, 注明 'v0.11+: 仍为单一事实源' / '调用方' 等实际状态.

删除 src/commands/form/_browser_construct.ts (384 行):
- grep 全 src/ 无引用 (除自引用)
- 与 _browser_verify.ts 功能重叠 (后者被 clone/fixcolumndata/create/import 调用)

验证: npx tsc --noEmit 报预存 TS 错误 (dm/create.ts data 属性, form/selector.ts note/notes 等), 与本次清理无关.
运行时验证: dacli form --help + dacli user list --keyword=admin 正常.
2026-06-25 16:07:24 +08:00