Commit Graph
20 Commits
Author SHA1 Message Date
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 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 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 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 56879227ab docs(v0.11+): plan §16.1 加 testcase → test 重命名记录 2026-06-26 08:46:39 +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 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 06aed3830c chore(v0.11+): 合并 dacli/.claude/skills/dacli-ts 到父 .claude/skills/ + Phase 3 Batch F 审计
用户拍板 (2026-06-25): 为避免重复, 把 dacli 子项目的 dacli-ts skill 移到父 .claude/skills/ 下作为实体目录 (而非原 symlink), 同时删 dacli/CLAUDE.md 和 dacli/.claude/ 目录.

变更:
1. 删除整个 dacli/.claude/ 目录 (30 个文件, 包含 settings.local.json + dacli-ts skill 全部内容)
2. 删除 dacli/CLAUDE.md (内容已并入父 CLAUDE.md)
3. 父 .claude/skills/dacli-ts 替换 symlink 为实体目录 (从 dacli/.claude/skills/dacli-ts 复制)
4. 更新 4 处文档引用 (dacli/.claude/skills/dacli-ts → .claude/skills/dacli-ts, dacli/CLAUDE.md 标注合并)
5. Phase 3 Batch F 5 个主流程 skill 审计报告 (新增 docs/skill-audit/):
   - dacli-ts.md — P0 必修 3 项 (补 30+ NEW-CMD + webapi 18 模块 + form validate deprecation)
   - ssw-h5dev-flow.md — P0 必修 5 项 (doc toc/search + form update + selector + log exception)
   - design-jnpf-execute.md — P0 必修 6 项 (删 _blindspots.ts 引用 + 补 webapi + 4 NEW-CMD)
   - form-development.md — P0 必修 3 项 (删 form msrelation 误用 + 补 form update + webapi 段)
   - form-fix.md — P0 必修 3 项 (删 dacli form fix 误用 10+ 处 + 补 form clone/update 流程)

Batch G-J 子代理审计待下一轮执行 (见 plan §12.3).

下一步: 执行 Phase 3 P0 必修 (按 audit 报告) → Phase 4 历史残留清理 → Phase 5 baseline 验证
2026-06-25 15:53:06 +08:00
ssw 3185022fdd docs(v0.11+): plan §12-18 - Phase 3-6 详细执行 + 18 webapi 模块统计
§11 补完: 38 commit 完整列表 + REFACTOR-WEBAPI 100% 闭环
§12: Phase 3 .claude/ skill sync (24 skill audit + 5 批子代理)
§13: Phase 4 历史残留清理 (_blindspots.ts/_simplify.ts + 已删资源 + 22 盲点整合)
§14: Phase 5 官方示例验证 (baseline + vitest + 14 webapi 测试 + 10 NEW-CMD 抽样)
§15: Phase 6 web 端改动 (按需触发, 当前无)
§16: P1 长尾 NEW-CMD 清单 (10 个, 按 AI 痛点驱动)
§17: 立即开始指令 (push 38 → Phase 3 → 4 → 5)
§18: 整轮完成判定 (Phase 1+2 ✅, 3-5 待执行)

作者: 2026-06-25 v0.11+ 续写
2026-06-25 15:42:58 +08:00
sswandClaude e79520cd9e docs(v0.11+): plan §11 - 完整提交记录 + webapi 化闭环
Phase 1+2 累计 28 个 commits (含本 doc):
- Phase 1 审计: 1 commit
- 端点假 PASS 修复: 1 commit
- NEW-CMD (log/di/role/apis/form/workflow/schedule/msg/monitor/bigscreen/dict): 10 commits
- REFACTOR-WEBAPI 父命令 (datasource/dict/menu/form/dm): 7 commits
- webapi 模块新建 (7 个): 1 commit
- 用户反馈后 NEW-CMD 改 webapi (dict/log/role/msg/schedule/monitor/bigscreen/workflow/di): 8 commits
- 文档更新: 3 commits

webapi 模块累计 14 个: visualDev, dataModel, dataSource, dict, menu, workflow, role, log, monitor, message, schedule, visualdata, report, di

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:32:41 +08:00
sswandClaude 90e938f384 docs(v0.11+): plan §11 - REFACTOR-WEBAPI 100% 完成 (form/datasource/dict/menu/dm)
累计 14 个父命令子命令 webapi 化, 消除 ~400 行硬编码.

剩余 P0:
- NEW-CMD 30+ 个 (form update, log exception, di/role/org CRUD, msg/storage/bigscreen/report CRUD 等)
- REFACTOR-WEBAPI 剩余 (workflow/user/log/monitor/msg/integration/schedule/storage/role/org, bigscreen/report/portal/print 独立子项目)

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:15:39 +08:00
sswandClaude 3c312d71b9 docs(v0.11+): 更新 plan §11 - 进度含 3 REFACTOR-WEBAPI 提交
Phase 2 进展 (今天完成 7 个 commit):
- 3 端点假 PASS 修复 (90a8b4e)
- 3 P0 NEW-CMD (5f663eb doc toc/search, 7b8f9b1 apis search)
- 3 P0 REFACTOR-WEBAPI:
  * datasource 4 子 (7a34ee6)
  * dict 4 子 (20ddbfb)
  * menu 5 子 (c7b24eb + 694619b)

剩余 P0 (下次续):
- form 22 调用 REFACTOR-WEBAPI
- 30+ P0 NEW-CMD (form update / log exception / di / role / org / msg / storage / bigscreen / report)

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:10:11 +08:00
sswandClaude 72df65eb24 docs(v0.11+): 更新 plan - Phase 1+2 实际执行进度
新增 §11 章节记录今天 (2026-06-25) 的实际执行:
- Phase 1: 23 命令审计完成 (b9c9e31)
- Phase 2: 3 处端点错误修复 + 3 个 P0 新命令 (doc toc/search, apis search)
- 列出剩余 P0 工作 (webapi 镜像 + 30+ 新命令)
- 给出下次会话优先顺序

下次 AI 续做时: 先读 §11 知道已完成什么, 避免重复.

Co-Authored-By: Claude <[email protected]>
2026-06-25 15:03:57 +08:00
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:58:32 +08:00
sswandClaude 0360c6484c docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份
用户给的 10 个要求 完整 plan 写到 dacli/docs/v0.11-next-steps-plan.md:
1. 逐个过 dacli 命令
2. 分析 web 页面, 改/删/留 + 帮助/调试/示例同步
3. webapi 镜像
4. 官方示例验证
5. .claude/** 全过
6. web 改动谨慎 (存 docs/web-patches/)
7. 用子代理 (dispatching-parallel-agents)
8. 清理历史残留
9. 已备份大胆改
10. 联动 ssw-h5dev-flow/ssw-test/no-spa-page/design-jnpf-execute

4 阶段: 命令审计 → 改/删/留 → .claude 全过 → 清理+验证+web 改动.
子代理 dispatch 协议 (5 批 Explore, 每批 5-6 命令).
clear 后直接 cat 这个文件恢复上下文.

注: 前一个 commit (0cb7c3e) 误删了 doc/v0.6-v0.8 历史 changelog, 已 revert (6ff428f).
本次 commit 仅加 plan 文件, 不动其他文件.

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:19:45 +08:00
ssw 6ff428ff3a Revert "docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份"
This reverts commit 0cb7c3ee76.
2026-06-25 14:17:49 +08:00
sswandClaude 0cb7c3ee76 docs(v0.11+): 下一阶段执行 plan - 上下文爆了前备份
用户给的 10 个要求:
1. 逐个过 dacli 命令
2. 分析 web 页面, 改/删/留 + 帮助/调试/示例同步
3. webapi 镜像
4. 官方示例验证
5. .claude/** 全过
6. web 改动谨慎 (存 docs/web-patches/)
7. 用子代理 (dispatching-parallel-agents)
8. 清理历史残留
9. 已备份大胆改
10. 联动 ssw-h5dev-flow/ssw-test/no-spa-page/design-jnpf-execute

完整 plan 写到 dacli/docs/v0.11-next-steps-plan.md:
- 4 阶段: 命令审计 → 改/删/留 → .claude 全过 → 清理+验证+web 改动
- 子代理 dispatch 协议 (5 批 Explore, 每批 5-6 命令)
- 完成标准 + 应急回滚

clear 后直接 cat 这个文件恢复上下文.

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:16:17 +08:00
sswandClaude 727b13c407 feat(v0.11+): Phase A-E AI 工作流闭环 - 源分析 + 镜像 + 新命令 + skill + 验证
按 docs/dacli/v0.11-final.md 4 阶段执行:
1. 源码分析 docs/source-analysis.md (分析 web/views/** 页面逻辑)
2. 镜像高频 webapi (dict + workflow)
3. 新增 AI 痛点驱动命令 (form selector + workflow selector)
4. 集成到 form-development / workflow-development skill
5. 用官方示例验证 (workSystem 86 form/17 flow, developSystem 4 form)

新增模块:
- src/webapi/dict.ts (15 函数镜像 web/.../systemData/dictionary.ts)
- src/webapi/workflow.ts (14 函数镜像 web/.../workFlow/template.ts)
- src/commands/form/selector.ts (formSelector 命令 + 树形平铺)
- src/commands/workflow/selector.ts (getFlowSelector 命令)

测试:
- tests/test-webapi-dict-workflow.ts (15 dict + 14 workflow 函数实测 PASS)

Skill 集成:
- .claude/skills/form-development/SKILL.md (新增 form selector 段)
- .claude/skills/workflow-development/SKILL.md (新增 workflow selector 段)

验证 (workSystem):
- form selector --json: 86 form 平铺
- workflow selector --json: 17 工作流

验证 (developSystem):
- form selector --json: 4 form
- workflow selector --json: 17 工作流 (跨应用可见)

源分析报告 docs/source-analysis.md 列出 18 个未覆盖模块 + 缺口分级 (P0/P1/P2).

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:59:32 +08:00
sswandClaude a0242714ef docs(v0.11): dacli/docs/web-patches/ 建立 - patch 文档化流程
按 feedback-web-patch-docs.md 规则, 建立 dacli/docs/web-patches/ 目录:

- README.md: 文档化规则 + 当前 patches 状态 + Phase 3 候选 (说明)
- _visualDev-api-shim.md: Phase 1 webapi/visualDev patch (commit d4506fe)
- _buildformdata-formUtils.md: Task 4-10 _buildformdata.ts patch (commit bb3ebaf~fd8ef3b)

Phase 3 候选改造 (formDesign/Form.vue / CreateMenuModal.vue / sysForm/Form.vue)
通过 Phase 1 webapi 间接覆盖 (web 端组件仍调原端点, dacli 用 webapi 调同样端点),
直接抽纯函数价值有限, 暂不执行. 如果未来 BS-48/49/50 反复修, 再启动真正 Phase 3.

升级 web 后, AI 读本目录所有 patch 文档逐个对照, 缺失的重新应用.

Co-Authored-By: Claude <[email protected]>
2026-06-25 13:12:10 +08:00