Commit Graph
408 Commits
Author SHA1 Message Date
ssw 44c8a39482 fix(BS-New-4): bindFlow 走 /workflow/template/Save 真持久化 start node formId
BS-New-4: 旧版 PUT /workflow/template/{id} body={onLineformId, formId, onlineFormId}
  3 字段全部被后端静默忽略 (TemplateCrForm 根本没这些字段, TemplateEntity 也没有)

根因 (jxcj 2026-06-30 实战):
  - TemplateEntity 没有 onLineformId 字段
  - TemplateCrForm 只有 enCode/fullName/type/category/flowConfig/flowXml/flowNodes
  - 真正的持久化机制: POST /workflow/template/Save 把 start node formId 写入
    TemplateNodeEntity.f_form_id (后端 TemplateJsonServiceImpl.save() 解析 flowNodes)

修: 重写 bindFlow 4 步:
  1. form 端: PUT /visualdev/Base/{formId} (enableFlow=1, flowId) (原本就有)
  2. workflow 端:
     - GET /workflow/template/Version/{flowId} 找启用版本
     - GET /workflow/template/Info/{versionId} 拿 flowNodes + flowXml
     - 修改 start node formId = formId
     - POST /workflow/template/Save body={id, flowId, flowNodes modified, isAddVersion:false}
  3. 验证: GET Info 看 start node formId 真存
  4. 重新发布 form

测试场 (jxcj) 验证:
  workflow 端: 持久化 PASS (start node formId=841604547875964997) ✓
  form 端: PUT 仍 400 (VisualdevEntity 缺 enableFlow/flowId 字段, 已知限制)
  总结: workflow 端绑定已可持久化, form 端需 web UI 兜底
2026-06-30 20:04:48 +08:00
ssw effc9efeb7 fix(BS-New-8): menu create --fullName 自动从 form.info 拿
BS-New-8: --formId 模式 (走 web Actions/Module) 仍要求 --fullName 必传
  但 web CreateMenuModal.vue 自动 form.fullName → menu.fullName
  → AI 写脚本挂菜单时, 必须先查 form.fullName, 多此一举

修: step machine 前先 fetch form.info, 自动填充 opts.fullName / opts.enCode
  - 镜像 web CreateMenuModal.vue:62-68 handleSubmit 行为
  - Mode A (--formId): 自动拿 (fullName/enCode 缺失时)
  - Mode B (无 --formId): 仍必填 (无 form 可推导)

测试场 (testspace) 验证:
  不传 --fullName --enCode → 自动拿 'BS8bTest' + 'bs8btest' + step machine PASS ✓
  只传 --fullName                  → 自动拿 enCode 'bs8btest' + step machine PASS ✓
  Mode B (无 --formId)            → 仍报 '--fullName 必填' (防 BS-50 防御)

jxcj 2026-06-30 实战教训
2026-06-30 19:26:40 +08:00
ssw 21c10c2a8b fix(BS-New-9): codegen Controller @RequestMapping 路径改写
BS-New-9: JNPF CodePreview 生成 Controller 默认 @RequestMapping('/api/example/{Class}')
  - 28 个 form 都映射到 /api/example/Team 等固定路径
  - 与 JNPF 平台 example 模块冲突, 后端注册歧义

修: 在 writeFileSync 前 post-process Controller.java
  - 检测 @RequestMapping('/api/example/{PascalClassName}')
  - 改写为 /api/{company}/{module}/{enCode}
  - 用 --enCode 参数 (form enCode) 而非 PascalCase 推导
  - fallback: opts.enCode || opts.module (用户不传 --enCode 时使用 module)

新增 --enCode 参数支持显式指定 form enCode

测试场 (testspace) 验证:
  --enCode=teamtest    → @RequestMapping('/api/ssw/testspace/teamtest')    ✓
  --enCode=projecttest → @RequestMapping('/api/ssw/testspace/projecttest') ✓
  默认 (fallback)       → @RequestMapping('/api/ssw/testspace/testspace') ✓

jxcj 2026-06-30 实战教训
2026-06-30 19:19:47 +08:00
ssw 2d9ea066e6 fix(BS-New-5): form create relationForm 强制 jnpfKey + 完整配置注入
BS-New-5: --ai-json 写 fieldRelationConfig.modelId/propsValue/relationField
  但 form 创建后字段 jnpfKey 仍是 'input', modelId 等字段为空
  → 字段关联控件被降级为普通文本框, relationForm 配置完全失效

根因:
  - 字段映射顺序: dictType > dataType > component
  - dataType=varchar 不在 dtMap → fieldComponent 不设置
  - buildFormData 不识别 AiFormModel.fieldRelationConfig → 重新生成字段时丢失
  - injectRelationForm 依赖 aiFieldsMap.get(vmodel).fieldRelationConfig
    但 buildFormData 重组字段后 vmodel 已映射到不带 relCfg 的新对象

修:
  - 加 BS-New-5 检测: fieldRelationConfig.modelId 存在 → 强制 jnpfKey=relationForm
  - 加备份注入: 遍历 aiModelList 原始字段, 直接写 __config__.modelId/propsValue/relationField

测试场 (testspace) 验证:
  f_title: jnpfKey=input ✓
  f_team_id: jnpfKey=relationForm + modelId=team + relationField=f_team_name
            + propsValue=f_team_id + columnOptions=[团队名称/团队编码] ✓

jxcj 2026-06-30 实战教训
2026-06-30 19:13:59 +08:00
ssw 4f71b40b41 fix(BS-New-6): dict typeList 递归展平 children (--recursive 默认 ON)
BS-New-6: dacli dict typeList --keyword=jxcj 永远返 0, AI 误以为没字典
  根因: web DictionaryTypeController.list() 返树形结构 (list[] 含 children[]),
        旧代码只过滤顶层 2 项 (业务字典/系统字典)
  镜像: web 端 tree util (SumTree + TreeDotUtils) 走递归
  修: --recursive 默认 ON 递归展平 children, --tree 显示原始树形
       --no-recursive 保留旧行为 (2 项)

测试场 (jxcj) 验证:
  --keyword=jxcjteamstatus → 1 个 (精确, 含 _path)
  --keyword=jxcj           → 52 个 (前缀)
  --no-recursive            → 2 个 (旧行为)
  --tree                   → 显示原始树形 (├─ 缩进)
  默认 (无 keyword)         → 156 个 (从 2 → +154 子分类)

jxcj 2026-06-30 实战教训
2026-06-30 19:08:13 +08:00
ssw 6c74c3e6aa fix(BS-New-2): codegen pom 自动补依赖 + modelVersion + 正确版本
BS-New-2: dacli form codegen --multi-module-pom 生成的 pom 不完整,
导致 mvn package 失败. 4 个修复:

1. modelVersion 缺失: pom template 缺 <modelVersion>4.0.0</modelVersion>
   → mvn 报 'modelVersion is missing'
   → 修: 4 个 pom template 都加 modelVersion + xsi:schemaLocation

2. biz pom 缺 JNPF 平台依赖: 生成的 Service 引用 UserEntity/GeneraterSwapUtil
   /QueryAllModel, 但 biz pom 没声明 jnpf-permission-entity/jnpf-generater-base
   → mvn 报 'package jnpf.permission.entity does not exist'
   → 修: biz pom 默认加这 2 个 dep

3. dep version 缺失: 4 个 pom template 的 dep 都没 <version>
   → mvn 报 'dependencies.dependency.version is missing'
   → 修: 内部 com.jnpf:* dep 用 ${project.version}, 第三方 (fastjson/commons-lang3)
     用硬编码版本

4. fastjson 版本错: 用 ${project.version} 解析为 6.2.0-RELEASE 但 fastjson 实际
   版本不是 → mvn 报 'Could not find artifact fastjson:jar:6.2.0-RELEASE'
   → 修: fastjson = 1.2.83 (实际版本)

测试场 (testspace) 验证:
  ssw-testspace-entity: SUCCESS (3.241s)
  ssw-testspace-biz: SUCCESS (0.315s)  ← BS-New-2 关键验证点
  ssw-testspace-controller: SUCCESS (0.214s)
  BUILD SUCCESS 4.318s

jxcj 2026-06-30 实战教训
2026-06-30 19:03:24 +08:00
ssw 720c99d062 fix(BS-New-1, BS-New-3): 字典 enCode 自动 skip-duplicate + datetime 自动转 Long
BS-New-1: dict dataCreate 新增 --skip-duplicate (默认 ON)
  - 预拉已有 items 检测 enCode/fullName 冲突
  - 命中冲突的项自动跳过 (避免后端 EXIST001/EXIST002)
  - --no-skip-duplicate 保留旧行为 (强制失败)

BS-New-3: test run POST create 前自动转 ISO8601 → Long
  - 根因: 后端 VisualdevModelDataServiceImpl.swapDatetime 强制
    Long.parseLong(value), ISO8601 字符串抛 NumberFormatException
  - 镜像 web datePicker 默认 Date.now()
  - 检测 datePicker/timePicker 字段, 字符串值自动 new Date().getTime()

测试场 (testspace) 验证:
- BS-New-1: 单条/批量 重复 enCode 自动 skip ✓
- BS-New-3: 用户传 ISO8601 → Long → 数据库正确落地 ✓

jxcj 2026-06-30 实战教训
2026-06-30 18:53:38 +08:00
ssw 2499589fee auto(284e8d004cbb): session end @ 2026-06-30T17:36:03 (+1f) 2026-06-30 17:36:04 +08:00
ssw a5b91bdffa auto(284e8d004cbb): session end @ 2026-06-30T17:32:28 (+1f) 2026-06-30 17:32:29 +08:00
ssw 700ad86fd6 auto(284e8d004cbb): session end @ 2026-06-30T16:45:06 (+2f) 2026-06-30 16:45:11 +08:00
ssw b4af748a76 docs(v3.0+): § 二十三 v0.12+ 实战沉淀 (jxcj + jxcj1, 2026-06-30)
按 4 步法沉淀本次会话 + jxcj1 干净子代理 7 阶段实战:

§ 23.1 5 commit 实战 (feat 分支 → 已合并 main 2026-06-30)
  - c946299 P0 int+dictType → select
  - f173623 P1 category 自动派生 businessType
  - 1bb9d25 P1 AI 智能判断 + 缓存
  - 922c1da auto workflow/list FLOW_ID 列
  - 4e1f779 P0 form fix-entity 命令

§ 23.2 11 已知盲点 (BS-101~BS-303, 跨 appCode 通用)
  3 个 P0 已自动修复 (fix-entity + workflow list)
  4 个 P1 待改 (flowId / 表名 / TC 术语 / category)
  3 个 P2 待改 (占位符 / 异步 / dbLinkId)
  5 个新 (jxcj1, BS-104~BS-108) 待修

§ 23.4 TC-A/B/C 精确定义
  - 不要混淆 TCC (jnpf Test Case Container) vs TC-B (Browser)
  - 5 步真实操作 (currentUserInfo → 推路由 → 真实点击 → 真实 DOM → 真实业务)
  - fetch 替代 = 伪 TC-B (jxcj 2026-06-29 反模式)

§ 23.5 4 关卡 CI 强化 (v0.12+)
  - check_subagent_learnings.sh 接受 ## 0. 项目启动基线 段
  - form 0 + 基线 1 段 = 1 段 PASS (新 app 阶段 1-3 友好)
  - 模板进化: learnings.md.tmpl (301 行) + research.md.tmpl (183 行)

§ 23.6 跨 appCode 复用清单 (下次跑 tds/workSystem)
  - 6 文件 AI 会话开始自动加载
  - 16 盲点 + TC-B 5 步 + 模板 + jxcj1 实战

§ 23.7 反模式 (5 条)
§ 23.8 CI 关卡 G + jxcj 实战联动 (5 commit → 89%→94%)

权威源:
  dacli-ts/references/blindspots.md
  ssw-e2e-test/references/tc-ab-real-test.md
  ssw-loop/templates/learnings.md.tmpl
  ssw-loop/templates/docs/research.md.tmpl
  memory/dacli-jxcj-2026-06-29-regression.md
2026-06-30 16:44:24 +08:00
ssw 20b0e62312 feat(docs): 归档过期顶层入口文档 prompt.md + README.md (v3.0+) (archive)
- 移除顶层 dacli/prompt.md (v0.7.1 任务说明书, 8 父命令 / 27 子命令口径, 已全过期)
- 移除顶层 dacli/README.md (v0.7 项目入口, 误把 Java 版当生产, 结论与 v3.0 相反)
- 移到 docs/archive/deprecated-v0.6-v0.8/ 加版本后缀 (.v0.7.md / .v0.7.1.md), 避免与目录索引 README.md 同名覆盖
- 更新 docs/archive/README.md (外层索引): 文件数 23→25, 新增'项目入口文档'分类
- 更新 docs/archive/deprecated-v0.6-v0.8/README.md (内层索引): 新增'项目入口文档 (v0.7-v0.7.1, 已被 v3.0 规范替代)'段, 引用 v3.0 主规范 + dacli-ts SKILL.md 作为新权威源
- 不动其它预先存在的变更 (scripts/seed-tds-baseline.ts / snap-menu-page.mjs / .DS_Store)

权威源: ccWorkDir/dacli/docs/尚数网基本开发规范v3.0.md (v3.0+, 2026-06-29) + ccWorkDir/.claude/skills/dacli-ts/SKILL.md

测试: PASS (纯 doc move, 无 src/commands/* 改动, 不触发 CI 关卡 G)
2026-06-30 15:16:06 +08:00
sswandClaude b1f302b3c4 testspace: 统一测试场 - 替换 developSystem 默认引导
- config.ts: DEFAULT_APP_CODE 改 testspace (统一测试场, 取代 developSystem 静默回落)
- app/login.ts|switch.ts|use.ts|logout.ts|create.ts: help/示例/AI hook 全部标注 testspace 是测试场, developSystem/workSystem 是 JNPF 只读 baseline, 禁止当测试目标
- tests/e2e/{smoke,auth.setup,baseline/template}.spec.ts: fixture 用 process.env.APP_CODE || 'testspace', 不再硬编码 developSystem

testspace app 已在 JNPF 创建 (systemId=841610403778660421), 新会话默认登录后, 自由 CRUD 不会污染 developSystem/workSystem baseline 0 差错基线。

Co-Authored-By: Claude <[email protected]>
2026-06-30 12:03:16 +08:00
ssw a68b62fd79 merge: sync main changes (3 commit + linter 改) into feat
包含:
- 9442046 B-9 tables[0].typeId='1' (后端 FlowFormDataUtil 需要)
- 707c3fb memory ssw-h5dev-flow v0.9 lint + dispatch 协议
- d22ac5f form-lint dead import + unused interface 修复
- linter 修改 3 文件 (form/index.ts / form/create.ts / workflow/list.ts)

合并后 feat 分支同时含 jxcj P0/P1 修复 + main 新改动
2026-06-30 11:19:41 +08:00
ssw 4e1f7796b9 feat(form): P0 fix-entity 命令 (jxcj 2026-06-29 后置修复)
背景: jnpf 后端 CodeGenerateFactoryV3 用 mybatis-plus generator 生成 entity + service,
  默认不加 @TableId type=IdType.ASSIGN_ID (jnpf 雪花 string id 必需).
  默认 ServletUtil.getHeader('jnpf-origin').equals('pc') 也会 NPE (curl/外调没 header).

用法:
  dacli form fix-entity                    # 扫 ./boot/ssw-{app}-entity, 加 @TableId
  dacli form fix-entity --type=biz         # 扫 ./boot/ssw-{app}-biz, 修 Service NPE
  dacli form fix-entity --type=all         # 同时修 entity + biz
  dacli form fix-entity --dry-run          # 只显示不写
  dacli form fix-entity --table=team       # 只修指定表

修复内容:
1. P0: entity f_id 字段加 @TableId(value='f_id', type=IdType.ASSIGN_ID)
2. P0: Service jnpf-origin 加 null check (避免 NPE)
3. P0: workflow list 加 FLOW_ID 列 (TemplateJsonEntity.id ≠ ID 列, 解决 launchFlow 错)

权威源: memory/dacli-jxcj-2026-06-29-regression.md §2.1
        dacli-ts/references/blindspots.md (跨 appCode 通用)
2026-06-30 11:18:12 +08:00
ssw 922c1dad72 auto(284e8d004cbb): session end @ 2026-06-30T10:09:18 (+2f) 2026-06-30 10:09:19 +08:00
ssw 1bb9d25d12 feat(form create): jxcj 2026-06-29 P1 增强 — AI 智能判断 + 缓存复用
新增能力:
1. APP_CODE_HINTS 硬编码映射 (10 个 appCode 关键词)
   - jxcj → 项目管理
   - developSystem/worksystem → 行政管理
   - tds/crm → CRM应用
   - cw/rs/ht/zc/gw → 仓库/人事/合同/资产/公文管理
2. KEYWORD_HINTS 模糊匹配 (20+ 关键词, 中英文)
   - project/admin/crm/vehicle/warehouse/sale/document 等
3. ~/.dacli-token/category-cache.json 持久化
   - 一次判断后续复用, 跨会话不重复查
4. 多策略 fallback:
   (a) APP_CODE_HINTS 硬编码
   (b) KEYWORD_HINTS 关键词
   (c) fullName 包含 appCode 子串
   (d) 兜底第一项 (车辆管理)

修复: APP_CODE_HINTS key 全部小写 (查时 .toLowerCase() 匹配, 之前大小写不一致)

验证:
  $ dacli form create --appCode=jxcj
  ℹ   AI 命中硬编码映射: jxcj → 项目管理
  ℹ   ✓ P1 自动派生 category: 项目管理 (id=9b077e...)

  $ dacli form create --appCode=developSystem
  ℹ   AI 命中硬编码映射: developSystem → 行政管理
  ℹ   ✓ P1 自动派生 category: 行政管理 (id=e43a77...)

缓存:
  ~/.dacli-token/category-cache.json:
    developSystem: {id: e43a77..., name: 行政管理}
    jxcj:         {id: 9b077e..., name: 项目管理}

权威源: memory/dacli-jxcj-2026-06-29-regression.md
2026-06-29 21:32:11 +08:00
ssw f173623f7a feat(form create): jxcj 2026-06-29 P1 完整版 — form category 自动派生
镜像 web 端 formDesign/index.vue:30-34:
  const res = await baseStore.getDictionaryData('businessType')
  categoryList.value = res; getForm().updateSchema({ field: 'category', options: res })

改动:
- 新增 autoDeriveCategoryFromBusinessType(c, appCode) helper
- 查 /system/DictionaryData/{businessType_id} 返 13 项业务分类
- 按 token.appCode 模糊匹配 → fallback 第一项
- opts.category 空时自动填, 消除 VS-CATEGORY 硬关卡

验证 (P1 完整版):
  $ dacli form create --enCode=p1Test --ai-json='[...]'
  ℹ   ✓ P1 自动派生 category: 车辆管理 (id=e17e977..., 业务分类字典 businessType)
  ✓ ✓ step machine 校验通过 (3/3)
  ✓ 创建成功: id=841389794008237381

修复原因: 之前 27 form 都传 crmOrder 通用 id (8f65...), 跨 app 共享 1 个 category
现在按 token.appCode 派生独立 category, 多 app 隔离

权威源: memory/dacli-jxcj-2026-06-29-regression.md
2026-06-29 21:22:54 +08:00
ssw c946299eed fix(form create): jxcj 2026-06-29 — dictType 自动 select + category 报错增强
P0: int + dictType 字段自动 fieldComponent=select (避免录入都是字符串)
  - 改 src/commands/form/create.ts:139-167 dtMap 逻辑
  - 优先级: dictType 字段强制 select > dataType→fieldComponent 映射
  - 镜像 web FormGenerator.vue 选字段时 dictType 字段强制 select 控件

P1: category 校验报错加 3 个可执行建议
  - 改 src/commands/form/_validate.ts:60-78
  - 加 (1) web 端建 (2) 通用 category 复用 (3) dacli form info 查 现有 id

--help 注解同步: --category 加 '推荐每个 appCode 派独立 category, 通用 8f65...=crmOrder 业务表单'

验证: jxcj 27 form 全部 jnpfKey=select + dictType 字段, TC-A/C/综合业务 21/21 PASS
权威源: memory/dacli-jxcj-2026-06-29-regression.md
2026-06-29 21:17:00 +08:00
ssw 86d7d8e690 docs(dacli/v3+webpatches): 加 webpatches 排除规则 (web/**/ssw 不触发)
用户反馈 (2026-06-29): 不是所有 web/** 路径都触发 webpatches CI 机制.
最关键: web/**/ssw/** 实际指后端 Java 业务包 (boot/ssw-{app}-biz/...),
不是 web 端源码, 不应触发 webpatches + CI 关卡 G.

**改 docs/web-patches/README.md** (新增 '排除规则' 章节):
- 路径模式表: 8 类路径分类 (前端源码✅ / 静态产物❌ / 后端 ssw❌ 等)
- 特别注意 web/**/ssw/ 模式 (实际指后端 Java)
- 判断原则: 触发 vs 不触发
- 未来自动化检查建议 (伪代码)

**v3 主规范 §22 +§22.8 排除规则** (43 行):
- 路径模式表 (8 类, 与 README 同步)
- 特别说明 web/**/ssw/ 模式 (用户反馈)
- 引用用户原话: '不是所有路径都触发 webpatches CI'
- 判断原则
- 未来自动化检查建议 (git diff + grep)

**关键排除路径**:
- boot/**/ssw*/**/*.java (后端 Java 业务包, 走 backend-dev 流程 §六.2)
- web/apps/.../public/ssw/** (dacli 生成的静态扩展, §4.4, 走 git log)
- web/apps/.../dist/ssw/** (构建产物, 部署生成)
- uniapp/pages/ssw/** (移动端 ssw 页面, 走 uniapp 流程)

**webpatches 适用路径** (✅ 触发):
- web/.../src/**/*.vue (前端 Vue 组件)
- web/.../src/**/*.ts (前端 TS 模块)
- web/packages/jnpf/utils/src/**/*.ts (dacli 复用的前端工具)

权威源: docs/web-patches/README.md + dacli docs 尚数网基本开发规范v3.0.md §22.8
2026-06-29 18:40:03 +08:00
ssw 1e2ead67b6 docs(dacli/v3+webpatches): 集成 CI 关卡 G 到 webpatches 强制流程
按用户决策把 CI 关卡 G 集成到 webpatches 流程, 形成完整闭环:

**改 web-patches/README.md** (8 处扩展):
- §规则 加 4 步必跑 CI 关卡 G (改 web 前/后/升级后/验收流程)
- 新增 '验收 / 升级流程' 第 3 步: 必跑 CI 关卡 G
- 新增 'CI 关卡 G 集成背景 (v3.0+)' 章节: 改 web 必跑 + 基线 + 白名单限制
- patch 文档必含 'CI 关卡 G 跑通截图' (paste 真实 FAIL=0 输出)

**v3 主规范 +§二十二 webpatches 强制流程** (78 行):
- §22.1 三阶段强制流程 (改 web 前/后/升级后必跑 CI 关卡 G)
- §22.2 改 web 前必跑 (基线确认)
- §22.3 改 web 后必跑 (新改动验证, 必含截图)
- §22.4 web 升级后必跑 (升级后架构健康)
- §22.5 与 §二十 CI 关卡 G 的关系 (commit 自动 vs 手动强制)
- §22.6 反模式 (6 类, 违反都需修复)
- §22.7 与 §二十一 回归审计的联动 (双向闭环)

**同步更新 §19 版本历史** (新增 1 行 v3.0+):
- v3.0+ 第 4 行: webpatches 强制流程 (§二十二)

**v3.0+ 强制章节全景 (6 个)**:
- §四 应用隔离方案
- §十七 代码审查清单
- §十八 权威源速查
- §二十 CI 关卡 G
- §二十一 回归审计方法论
- §二十二 webpatches 强制流程 (本次新增)

**闭环防御链**:
- §二十 CI 关卡 G → git commit 自动跑 (commit-time 防御)
- §二十二 webpatches → 改 web 端必跑 (author-time 防御)
- §二十一 回归审计 → 周期审计 (audit-time 防御)

权威源: docs/web-patches/README.md + dacli/src/commands/_gate_webapi.ts
2026-06-29 18:36:50 +08:00
ssw 0d7c1657d1 docs(dacli/v3): 扩展 v3 主规范 +§二十 CI 关卡 G +§二十一 回归审计方法论
按用户决策把 v3.0+ 三大强制章节纳入主规范:

**新增 §二十 CI 关卡 G** (70 行):
- §20.1 三大检查维度 (webapi 引用率 / _validate 镜像精度 / 回归盲点扫描)
- §20.2 故意 FAIL 白名单机制 (KNOWN_FALSE_POSITIVES, v3.0+ 修 hook 误报)
- §20.3 git hooks 自动集成 (pre-commit hook)
- §20.4 用法 (DACLI_SKIP_GATE=1 / git config dacli.gate.enabled false)
- §20.5 退出码 (0=PASS / 1=FAIL 阻塞 / 2=WARN 通过)

**新增 §二十一 回归审计方法论** (66 行):
- §21.1 四步法 (盘点 → 并行审计 → 汇总报告 → 一轮一修复)
- §21.2 多重机制 (webapi 镜像 5 要素, 镜像 architecture-philosophy.md)
- §21.3 一轮一修复原则 (P0 紧急/P0 重要/P1/P2 优先级 + 单 turn 工作量)
- §21.4 防御机制 (CI 关卡 G + 白名单 + 历史归档 + 双入口 + BS-XX 编号)
- §21.5 历史归档目录 (archive/v0.11-history, skill-audit-2026-06, deprecated-v0.6-v0.8)

**同步更新 §18 权威源速查** (新增 4 行):
- §18.3 加 CI 关卡 G + pre-commit hook + webapi 模块 + 回归审计报告

**同步更新 §19 版本历史** (新增 1 行 v3.0+):
- v3.0+ 第 3 行: CI 关卡 G + 回归审计方法论

**v3.0+ 强制章节全景** (5 个):
- §四 应用隔离方案 (v3.0+ 新增)
- §十七 代码审查清单 (v3.0+ 更新)
- §十八 权威源速查 (含 §18.3 新权威源)
- §二十 CI 关卡 G (v3.0+ 新增)
- §二十一 回归审计方法论 (v3.0+ 新增)

权威源: docs/cmd-review/regression-2026-06-29.md (381 行审计报告, 本规范章节引用)
2026-06-29 18:33:44 +08:00
ssw f115fe1e26 feat(dacli): CI 关卡 G 加故意 FAIL 白名单 (修 hook 误报)
按 cmd-review/regression-2026-06-29 §4.4 修复 hook 误报问题.

**问题**:
- di/_validate.ts web 端明确无 formValidate 正则 (架构差异, 不是漏校验)
- 之前 hook 把 di 当作真实 FAIL 阻塞 commit, 需要 DACLI_SKIP_GATE=1 才能提交
- 浪费 CI 体验, 掩盖真正应该阻塞的问题

**修复**: 加 KNOWN_FALSE_POSITIVES 白名单机制

**新增**:
- const KNOWN_FALSE_POSITIVES: Record<cmd, reason>
  - di: web 端 di/Form.vue:172-178 明确无 formValidate 正则
- getKnownReason(cmd): 查表获取原因
- checkCommandDir/checkValidate: 白名单命中 → FAIL 转 WARN + 填充 knownReason
- 汇总新增 knownFalsePositives / realFailures 字段
- 退出码: realFailures > 0 才 FAIL, 否则根据 WARN 决定
- 输出新增 '白名单详情' 段, 标注每条已知故意 FAIL 的原因

**CI 关卡 G 输出增强**:
- status 列加 '(已知)' 标签 (白名单命中)
- 汇总新增 2 行: 白名单命中 / 真实 FAIL
- 总体: WARN (有白名单) 但不阻塞 commit
- 改进建议新增 '已知故意 FAIL (白名单)' 类别, 明确指引

**实测验证**:
- 之前: di FAIL → 退出码 1 (阻塞 commit, 需 DACLI_SKIP_GATE=1)
- 现在: di 转 WARN → 退出码 2 (不阻塞 commit, 自动通过 hook)

**扩展指南**: 添加新白名单需明确 web 端架构差异, 避免掩盖真实问题
格式: KNOWN_FALSE_POSITIVES[cmd] = 'web 端 xxx/Form.vue:XX 明确...'

测试: TS 编译干净 + 真实 FAIL=0 + exit code 2 (WARN, 不阻塞)
2026-06-29 18:31:05 +08:00
ssw 3eb31b02c2 feat(dacli): 扩大 4 个弱镜像 _validate.ts (bigscreen/datasource/msg/schedule)
CI 关卡 G 镜像统计前后:
- bigscreen: 3 → 4
- datasource: 1 → 36
- msg: 1 → 17
- schedule: 1 → 26

每个字段错误信息加 '镜像 web Form.vue:XX-L' 引用, 整体镜像水平 ~14/文件.
2026-06-29 18:27:53 +08:00
ssw cf5847d09c feat(dacli): 扩大 _validate.ts web 镜像 (4 文件, CI 关卡 G 89%→94%)
按 cmd-review/regression-2026-06-29 §4.4 扩大 web 镜像, 4 个 _validate.ts 升级.

重写 user/_validate.ts (133 行 → 231 行, 修复最严重盲点):
- 之前: mirror_comments=3 / line_ref=no / ENCODE_REGEXP=no (3 NO)
- 现在: mirror_comments=17 / line_ref=yes / ENCODE_REGEXP=yes (全 YES)
- 镜像 web permission/user/Form.vue:22-160 schemas 完整 (8 字段 + 2 条件)
- enabledMark 修复 {0=禁用 1=启用 2=锁定} (web L62-72, 修复 v0.11e+ 漏 2)
- 加 FULLNAME_REGEXP (镜像 web formValidate.ts:33-36)

加精确行号引用 (3 文件):
- datasource/_validate.ts: web dataCenter/dataSource/Form.vue:36-90
- msg/_validate.ts: web msgCenter/{notice/msgTemplate/sendConfig}/Form.vue
- schedule/_validate.ts: web teamwork/schedule/Form.vue:63-150

CI 关卡 G: 17/18 _validate.ts PASS = 94% (仅 di 故意不改)
2026-06-29 18:19:41 +08:00
ssw d5e82ceb9c auto(284e8d004cbb): session end @ 2026-06-29T18:09:29 (+3f) 2026-06-29 18:09:30 +08:00
test 63a30c6800 test hook skip 2026-06-29 18:08:45 +08:00
ssw baf90faaad refactor(dacli): 移除 init --restart 虚假 flag (v3.0+)
用户反馈: --restart 历史目的是 JVM 进程级重启, 但 90% 场景根本不需要重启 JVM.

**移除**:
- .option('--restart', ...) flag
- InitAppOpts.restart 字段
- if (opts.restart) dry-run 逻辑
- installAiHelpHook --restart 引用 + example
- healthCheck 不通时的 --restart 推荐指引 (改为手动 nohup)

**保留**:
- --auto-recover (真工作, v0.11e+ B-2 fix, 检测 system 缺失时自动重建)
- 健康检查 (baseUrl + form list)
- system 缺失检测

**未来扩展** (v0.12+ 可能加, 不在本 turn 范围):
- --reload-config 调 POST /actuator/refresh (Spring Cloud RefreshScope, 替代 dry-run)
- --reload-ds 重新连接数据源
- --reload-menu 重建菜单/权限缓存

**用户决策 (2026-06-29)**: 删 --restart, 有需要场景再加. 务实.

测试: TS 编译干净 + init --help 不显示 --restart + init 实测仍工作 (健康检查 + system 完整)
2026-06-29 18:05:01 +08:00
ssw 0a0c690c16 feat(dacli): 新增 dacli app use <code> 一体化命令 (v3.0+ P1)
cmd-review/app.md P1 建议: AI 工作流痛点是切换 appCode 需要 2 步:
  1. dacli app switch --appCode=X (重新登录)
  2. dacli app context --json (拿环境快照)

v3.0+ 一体化命令: 一步完成 switch + context + CurrentUser 验证.

**新增 src/commands/app/use.ts** (181 行):
- 3 步流程:
  1. switch — 复用 JnpfClient.login 重新登录新 appCode
  2. context — lazy import loadAppContext, 拿 dbLinkId/enCode/表单/菜单/警告
  3. CurrentUser — 走 webapi/user.getUserInfoApi 服务器端确认 (token+appCode+用户身份)
- 容错: switch 失败 exit 1; context/CurrentUser 失败仅 warning 不阻断
- 输出: --json 输出完整 AppContext + currentUser, 供 AI 一站式使用
- 选项 --no-current-user: 跳过 CurrentUser 验证 (快但弱验证)
- 选项 --account / --password: 自定义凭据

**改 src/commands/app/index.ts**:
- 注册 buildAppUseCommand (放 context 之后, 让 --help 优先显示)
- 父命令 description 加 v3.0+ 一体化 use 标记

**实测验证** (jxcj 切换):
- [1/3] 切换成功 (admin @ jxcj, dbLinkId=2071492464356302848)
- [2/3] context 加载 (1 enCode, 1 表, 0 workflow, 1 警告)
- [3/3] CurrentUser 验证 (admin 管理员)
- 总耗时: **517ms** (一次调用拿全)

**附带修复**: report/list.ts 加 initReportWebapi import (CI 关卡 G 标 FAIL 时还原的改动)

测试: TS 编译干净 + 3 步流程 PASS + CurrentUser 集成正确

详见 docs/cmd-review/regression-2026-06-29.md §4.2
2026-06-29 17:58:02 +08:00
sswandClaude f32faa69e5 fix(dacli/webapi): 报表 API 镜像路径从 jnpf-web-datareport 改为主 webapp
jnpf-web-datareport 是 jQuery 老项目, 没有 src/api/ 目录 (只有 src/index.js)
原路径 /jnpf/前端/jnpf-web-datareport/src/api/index.js 永远 ENOENT, 任何
dacli report 命令触发 initWebapi 都炸

新路径 /web/apps/jnpf-web-apps-main/src/api/onlineDev/report.ts 是 Vue 3 主
webapp 的报表 API 客户端, 导出 getReportList/getReportInfo/delReport/copy/
getData/saveVersion 等 6 个函数, 走 /api/Report 端点 (被 nginx 代理到报表服务 32000)

验证: loadWebModule 成功, 6 个函数都拿到, dacli report list --json 不再 ENOENT

Co-Authored-By: Claude <[email protected]>
2026-06-29 17:48:53 +08:00
ssw c70ffb7844 auto(284e8d004cbb): session end @ 2026-06-29T17:47:59 (+1f) 2026-06-29 17:47:59 +08:00
ssw a0a51afc78 feat(dacli): 新增 dacli user info 子命令 (v3.0+ 双入口)
用户反馈: dacli app context --json 把 CurrentUser 集成进去后, 大 JSON (含 menuList/permissionList) 不方便调试.
用户决定: 做双入口, dacli user info 单独入口 (聚焦, 小 JSON).

**新增 src/commands/user/info.ts**:
- 无 id → CurrentUser (走 webapi/user.getUserInfoApi, 镜像 web/api/core/user.ts:10-15)
- 有 id → 特定用户详情 (走 webapi/user.loadUser.getUserInfo, 镜像 web/api/permission/user.ts)
- 选项 --backend <0|1>: CurrentUser 用, 默认 1 (与 web 端后台管理端一致)
- 选项 --json: 原始 JSON 输出 (含 menuList/permissionList)
- 默认输出聚焦字段: userId/userAccount/userName/isAdmin/systemCode/systemId/hasBackend

**改 src/commands/user/index.ts**:
- 注册 buildUserInfoCommand (放最前, --help 优先显示)
- 父命令 description 加 v3.0+ 双入口标记
- 现有 19 个子命令 (list/create/update/...) 完全保留

**双入口设计 (v3.0+)**:
- dacli user info — 聚焦, 小 JSON, 调试 / 单命令调用
- dacli app context --json — 含 currentUser, 一站式 AI 工作流
- AI 可按场景选择入口

**应用隔离 (v3 §4)**:
- systemId 从 token.json 自动读 (HTTP App-Code 头)
- 不需要手动传 --appCode
- 与 web 端 user.ts 语义对齐

**实测**:
- dacli user info → userId=349057407209541, userAccount=admin, systemCode=jxcj ✓
- dacli user info --json → 完整响应 (menuList 12 个菜单 + permissionList) ✓
- dacli app context --json → currentUser 字段仍正常 ✓

测试: TS 编译干净 + 19 子命令 --help 正常 + user info 实测通过

详见 docs/cmd-review/regression-2026-06-29.md §4.2 CurrentUser 集成
2026-06-29 17:47:36 +08:00
ssw 2350da48f9 feat(dacli): webapi/user.ts + app context 集成 CurrentUser API (v3.0+ P0)
用户反馈: 浏览器登录监测到 /api/oauth/CurrentUser?systemCode=X&isBackend=Y 是关键请求,
服务器端同时验证 token + appCode + 用户身份. dacli app context 应走 webapi 镜像 (不直接 curl).

**新增 webapi/user.ts 扩展** (CurrentUser 相关, v3.0+):
- getUserInfoApi(c, params) — 镜像 web/api/core/user.ts:10-15, GET /api/oauth/CurrentUser?systemCode=&isBackend=&_t=
- getConfig / getLoginConfig / unlockApi — 其他 web 端 core/user.ts 函数
- 与现有 loadUser Proxy 不同: CurrentUser 不走 _loader.ts dynamic import
  (web 端依赖 window.location.pathname, dacli 没 window)
  直接用 JnpfClient + defHttp shim 模式, 接受 appCode 参数从 token.json 拿

**改 app/context.ts 集成 CurrentUser**:
- 新增 tryFetchCurrentUser(c, appCode) — 调用 webapi/user.getUserInfoApi
- 失败容错: 不抛错, 写入 warnings, currentUser = undefined
- 新增 currentUser 字段到 AppContext 输出 (含 userInfo/menuList/permissionList/sysConfigInfo 等)

**改 src/core/types.ts**:
- AppContext 新增 currentUser?: { id/account/realName/roleId/roleName/organizeId/isBackend/systemCode ... }

**实测验证**:
- dacli app context --json 返回完整 CurrentUser 响应 (systemCode=jxcj 回显 ✓)
- 包含 userInfo (userAccount=admin, userName=管理员, isAdministrator=true)
- 包含 menuList (12 个菜单树) + permissionList (权限) + sysConfigInfo (sysVersion V6.2.0)
- AI 现在可以从 context 拿到 server 确认的 user info + menu 权限 (比读本地 token 更可靠)

测试: TS 编译干净 + 实际跑通 (jxcj token, server 返完整 user/menu/permission)

详见 docs/cmd-review/regression-2026-06-29.md §4.2
2026-06-29 17:39:15 +08:00
ssw 72ced8a42e feat(dacli): webapi 镜像 org 命令 (CI 关卡 G 总体 FAIL=0) 2026-06-29 17:31:43 +08:00
ssw 6b2becd458 feat(dacli): webapi 镜像 print/portal/report (CI 关卡 G 从 3 FAIL 到 0) 2026-06-29 17:29:43 +08:00
ssw 2663b8c487 auto(284e8d004cbb): session end @ 2026-06-29T17:17:50 (+4f) 2026-06-29 17:17:51 +08:00
ssw 8c10df63b3 feat(dacli): CI 关卡 G 自动检查 webapi 镜像架构 (regression audit §4.4 落地)
v3.0+ regression audit §4.4 建议的防御机制, 现已实现:

**新增 src/commands/_gate_webapi.ts** (310 行):
- 自动检查 3 大维度:
  1. 命令 webapi 引用率 (app/dict/menu/form 应有, apis/doc 元工具 0 正确)
  2. _validate.ts 镜像精度 ("镜像 web" 注释数 + 精确行号 + ENCODE_REGEXP 复用)
  3. 回归盲点扫描 (找无 webapi 引用的命令 + 缺镜像注释的 _validate + BS-56 硬编码正则)
- 退出码: 0=PASS / 1=FAIL(阻塞) / 2=WARN(提示)
- 用法: `npx tsx src/commands/_gate_webapi.ts` (CI 集成入口)

**初始扫描结果** (基线):
- 命令: PASS 18 / WARN 2 / FAIL 4 / 总 24
- _validate.ts: 总 18, 镜像注释率 18/18 (100%), ENCODE_REGEXP 复用率 8/18 (44%)
- 总体: FAIL

**当前违规清单** (后续 turn 修复):
- P0 缺 webapi: org / portal / print / report
- BS-56 缺 ENCODE_REGEXP: datasource / di / dict / form / menu / msg / role / schedule
- (这些是历史 _validate.ts 升级遗漏, 不是本次 turn 引入)

**防御价值**:
- 未来所有新代码改动自动检查, 防止重蹈"经验复刻"覆辙
- 新增 _validate.ts 不带"镜像 web" 注释会被 WARN
- 处理 enCode 但硬编码正则会被 FAIL (BS-56 防御)
- 无 webapi 引用的新命令会被 FAIL (P0 防御)

测试: TS 编译干净 + 实际跑通 (输出 24 命令 + 18 _validate 检查)

详见 docs/cmd-review/regression-2026-06-29.md §4.4
2026-06-29 17:12:43 +08:00
ssw 676fce5778 feat(dacli): _loader.ts 加 @vben/request shim (让 web logoutApi 真正工作)
task 26 发现新缺口: web 端 auth.ts:1 import { ContentTypeEnum } from '@vben/request',
@vben/request 是 Vben 业务包, 依赖 axios + Vue + Vite, Node 直接 import 会失败.
本 turn 修复闭环: web logoutApi 现在真正能调通 (之前虽然命令可用, 但远程会失败).

**新增**:
- src/webapi/_vben_request_shim.ts (41 行)
  - 镜像 web/packages/effects/request/src/request-client/enum.ts:1-31
  - 导出: ResultEnum (FORBIDDEN/SUCCESS/TOKEN_ERROR/TOKEN_LOGGED/TOKEN_TIMEOUT)
  - 导出: RequestEnum (DELETE/GET/POST/PUT)
  - 导出: ContentTypeEnum (FORM_DATA/FORM_URLENCODED/JSON/OCTET_STREAM)

**改 src/webapi/_loader.ts**:
- 加规则 5: from '@vben/request' → from '<vben request shim path>'
- 加 LoadOptions.vbenRequestShimPath 配置项 (默认 _vben_request_shim.ts)
- 加 SHIM_DIR + VBEN_REQUEST_SHIM_PATH 常量

**v3.0+ 价值兑现**:
- 之前 webapi/auth.logoutApi 只是声明, web logoutApi 实际失败
- 现在 app/logout.ts 端到端跑通: web logoutApi 调用成功 + 清本地 token
- 解锁未来更多 @vben/request 依赖的 web 模块镜像 (如字典/工作流可能用到)

测试: TS 编译干净 + 端到端 PASS
- web logoutApi 调用成功 ✓
- 本地 token 清成功 ✓
- JSON 输出结构化 ✓

详见 docs/cmd-review/regression-2026-06-29.md §4.2
2026-06-29 17:04:41 +08:00
ssw 4c97a04332 auto(284e8d004cbb): session end @ 2026-06-29T17:03:58 (+1f) 2026-06-29 17:03:58 +08:00
ssw ed70bc041f feat(dacli): v3.0+ 新增 dacli app logout 子命令 (regression audit P2)
cmd-review/app.md 已识别缺口: web 端有 logoutApi, dacli 无 logout 命令.
v3.0+ 新增, 走 webapi/auth.logoutApi (web 端 POST /api/oauth/Logout 镜像).

**新增**:
- src/commands/app/logout.ts (138 行)
  - 流程 3 步: web logoutApi + 清本地 token + 提示重新登录
  - 选项 --no-remote-logout: 跳过 web logoutApi, 仅清本地 (断网场景)
  - 选项 --json: 输出结构化结果
- src/commands/app/index.ts: 注册 buildAppLogoutCommand()

**webapi 价值兑现**:
- webapi/auth.logoutApi 之前只是声明 (cmd-review 已识别)
- 现在被 app/logout.ts 实际调用, 形成完整链路
- 复用 web 端 logoutApi (POST /api/oauth/Logout + withCredentials)

**容错**:
- web logoutApi 失败非致命, 仍清本地 token (避免用户卡死循环)
- 已验证: 远程 500/网络断 都能清本地成功

**已知问题 (polish doc)**:
- web 端 auth.ts: import { ContentTypeEnum } from '@vben/request'
- _loader.ts 当前未处理 @vben/* Vben alias (只处理了 #/ lodash-es jnpf/utils)
- 导致 web logoutApi 当前会失败 (但 dacli 容错正确, 清本地成功)
- v0.12+ 路线: _loader.ts 加 @vben/request shim

测试: TS 编译干净 + 3 项验证 PASS
- dacli app --help 显示 logout 命令 ✓
- dacli app logout --no-remote-logout 端到端流程正常 ✓
- 远程失败时本地仍清成功 ✓

详见 docs/cmd-review/regression-2026-06-29.md §4.2 问题 2
2026-06-29 17:01:00 +08:00
ssw a4d258147e feat(dacli): v3.0+ 镜像 web Form.vue 完整 schema (regression audit P1)
升级 3 个 _validate.ts, 镜像 web 端 Form.vue schemas + 加精确行号引用:

**report/_validate.ts** (镜像 web onlineDev/report/Form.vue:26-58):
- 旧版只有 2 字段 (fullName/enCode), 漏 3 字段 (category/sortCode/description)
- maxlength 错误: 旧版 50 → web report 是 100
- enCode 正则硬编码 → 统一 ENCODE_REGEXP (BS-56, 与 dict/menu/print 一致)
- 加精确行号引用 (L26-58)

**org/_validate.ts** (镜像 web permission/organize/OrganizeForm.vue:31-72):
- 旧版只有 4 字段 (fullName/enCode/parentId/category), 漏 2 字段 (sortCode/description)
- enCode 正则硬编码 → 统一 ENCODE_REGEXP (BS-56)
- category 扩展: web 端也支持 'group'/'company'/'department' 字符串值
- 加精确行号引用 (L31-72)

**storage/_validate.ts** (web 端无 Form.vue, 标注镜像源):
- 关键发现: web/apps/jnpf-web-apps-main/src 搜 storage/*Form.vue 无结果
- 这是真正的经验复刻源点 (web 无对应页面, 只能镜像后端 StorageController + ssw-common Java)
- 之前只有基础字段校验, 漏 sortCode/description/enabledMark + BS-56 enCode 正则
- 加精确镜像源注释, 警告 web 端无 Form.vue
- 加 ENCODE_REGEXP (BS-56) + sortCode 0-999999 + description ≤ 200 + enabledMark ∈ {0,1}

**v3.0+ 价值**:
- BS-56 防御强化: 所有 _validate.ts 共享 ENCODE_REGEXP 常量
- web 镜像精度提升: 9/12 _validate.ts 有精确行号引用 (从 4/12 起步)
- 镜像源透明化: storage 标注 web 无 Form.vue, 不让 AI 误以为有 web 镜像

测试: TS 编译干净 + 3 命令族 --help 正常

回归审计报告: docs/cmd-review/regression-2026-06-29.md (381 行)
2026-06-29 16:55:56 +08:00
ssw 7b95ae6d10 feat(dacli): v3.0+ webapi 镜像化 (app 命令族, regression audit P0)
新增 webapi 镜像模块 + app 命令 webapi 化 (详见 docs/cmd-review/regression-2026-06-29.md):

**新增 webapi 模块** (2 文件):
- src/webapi/auth.ts: 镜像 web/api/core/auth.ts (loginApi + logoutApi + saasLoginApi + getTenantMobileCode + applySaasApi)
  - 6 个便捷包装函数 + AuthApi namespace 类型 + loadWebModule 真 import
- src/webapi/system.ts: 镜像 web/api/system/system.ts (15 函数)
  - getSystemList / getAuthSystemList / create / update / getInfo / delSystem
  - copySystem / exportSystem / getAppAuth / saveAppAuth / changeAppAuth / getDevUser
  - getSystemSelector / getSystemlist / setPin

**重构 app 命令** (3 文件):
- app/list.ts: webapi/system.getSystemList (替代直接 c.get)
- app/info.ts: webapi/system.getInfo (替代直接 c.get)
- app/create.ts: webapi/system.getSystemList + create + saveAppAuth (step 1 + 4)
  - step 2/3 保留 c.postJson (ssw-common 特有, web 无等价)
  - step 5 保留 JnpfClient.login (有 encryptPassword 加密逻辑)
- 修复历史 TS 错误: installAiHelpHook.source 无 webapi 字段, 用 web 字段
- 修复历史 TS 错误: ClientOptions 无 checkSystem 字段, 用 any cast 透传

**应用隔离价值**:
- 之前缺失能力恢复: copySystem / exportSystem / saveAppAuth / changeAppAuth / setPin
- 与 web 端 schema 漂移风险消除 (复用 web 端类型 + query 参数处理 + 错误响应)

测试: TS 编译干净 + 3 项验证 PASS
- dacli app list 走 webapi 返回 11 个应用 ✓
- dacli app info 走 webapi 返回完整字段 ✓
- dacli apis list --tag=system 走 OR 匹配返回 364 API ✓

留给下个 turn: storage/org/report _validate.ts 补 formValidate + 校验项 (task 25)
2026-06-29 16:50:37 +08:00
ssw fddf8b5c03 feat(dacli): v3.0+ regression audit fixes (P0 紧急)
回归审计报告 + 修复 (详见 docs/cmd-review/regression-2026-06-29.md):

**新增**:
- docs/cmd-review/regression-2026-06-29.md (381 行, 3 批 25 文件审计)
- docs/archive/README.md + 3 个归档子目录 (v0.11-history, skill-audit, deprecated-v0.6-v0.8)
- src/commands/integration/_validate.ts (镜像 web sendConfig/Form.vue:42-50, 7 字段 + BS-56)
- src/commands/print/_validate.ts (独立 _validate, 8 字段 + 条件校验 commonUse=1→icon, category=2→formId)

**v3.0+ 关键改进**:
- print 从借用 report 改为独立 _validate (避免字段覆盖不全)
- integration 从无校验改为完整 step machine (BS-56 + messageSource + messageType)
- 归档顶层 7 个 v0.11 历史 plan + skill-audit 26 文件 + deprecated 23 文件
  (避免 AI 误读历史为待执行任务)

v3 §四 应用隔离方案 + §16.6 文档审查 + §17.4 历史归档 同步更新

测试: 6 项验证 PASS (TS 编译干净 / 命令加载 / 新选项 / 条件校验 / BS-56 / tag OR 匹配)
2026-06-29 16:41:22 +08:00
ssw bb2be67bf0 auto(284e8d004cbb): session end @ 2026-06-29T16:39:21 (+2f) 2026-06-29 16:39:21 +08:00
ssw c9285962dd auto(284e8d004cbb): session end @ 2026-06-29T15:59:01 (+24f) 2026-06-29 15:59:01 +08:00
ssw 49893fa873 auto(284e8d004cbb): session end @ 2026-06-29T15:56:29 (+34f) 2026-06-29 15:56:29 +08:00
ssw 0738d60f80 auto(284e8d004cbb): session end @ 2026-06-29T15:33:12 (+1f) 2026-06-29 15:33:13 +08:00
ssw 6819b31f22 auto(284e8d004cbb): session end @ 2026-06-29T15:28:21 (+1f) 2026-06-29 15:28:22 +08:00
ssw 842ecf6c17 docs(v3.0): § 11.3 backend-dev 加 'jxcj 2026-06-29 端到端验证 200'
配套 commit d196426 (.claude 仓库端到端实战教训):
- 4 个 Java 模板更新 (entity extends SuperBaseEntity, controller @DS + 反射设 id, service-impl 实战注释)
- SKILL.md 加 § 端到端实战教训 (6 个关键点 + 7 步端到端跑通流程)
- v3.0 引用实战验证 (jxcj 2026-06-29 /api/ssw/jxcj/team/list 200)
2026-06-29 15:27:30 +08:00
ssw 5cce45183a auto(284e8d004cbb): session end @ 2026-06-29T15:24:30 (+1f) 2026-06-29 15:24:31 +08:00