Commit Graph
4 Commits
Author SHA1 Message Date
ssw df213fdfad fix(dacli-docs): 修审计报告 14 项 + 加 CI 校验防再漂 (P0/P1/P2 全清)
审计报告 docs/dacli-doc-audit-report.md 14 项全部采纳:

P0 (3 项事实错误, 直接误导 AI 执行):
- ANTI_PATTERN F_→f_ 前缀 (form update --fields 实际是小写)
- ANTI_PATTERN AP-fc-4 vs AP-fu-1 矛盾 (统一指向 form import --autoTable)
- ANTI_PATTERN form info <enCode> 误导 (改为 <id>, 加 enCode 自动解析 fallback)

P1 (3 项文档漂移):
- CLAUDE.md "含 FK 时必用 --fields" → 实际已废弃, 删除 + form/create.ts Commander 加 DEPRECATED
- doc/get.ts 引用 Java DocCommand.java → 改指 TS _parser.ts
- AP-fd-1 "--cascade 必带" 过度约束 → 改为可选

P2 (2 项衔接断裂):
- Source 路径 web/.../ → web/apps/jnpf-web-apps-main/src/ (73 文件)
- test/run TC-B 前置提示 (需 menu 挂载)

附加 (CI script 抓出的 8 条额外路径 drift, 已就近修正):
- di/create|export|copy: DataInterfaceController.java 路径补 jnpf-java-boot/ + jnpf/base/controller/
- print/delete|update: PrintDevController.java 同上
- org/create: OrganizeController.java 路径 jnpf/controller/ → jnpf/permission/controller/
- form/codegen|audit: FormGenerator/FormGenerator.vue 加 /components/ + /src/ 前缀
- workflow/create: flowEngine + FlowProcess 加 views/onlineDev/ + components/ 前缀
- workflow/syncForm: FlowableProcessDesigner.vue 不存在 → 改指 Form.vue
- msg/notice*: notice.ts 不存在 → 改指 msgMonitor.ts
- bigscreen/delete|update: 双前缀 web/.../src/jnpf-web-datascreen-vue3/ → jnpf/前端/
- app/login: api/auth.ts → api/core/auth.ts
- apis/refresh|status|info: Java ApiService 路径 → TS 化指向
- test/render: sysData/formDesign 加 views/ 前缀
- form/create: formDesign/Form.vue 加 views/onlineDev/ 前缀

Task 1.6 收尾: 删 core/help.ts legacy (~85 行 dead code):
- AI_FLAGS / getMeta / maybeInterceptAiHelp / renderAiHelp
- installAiHelpHook alias / _aiMeta 副作用 / AiHelp type alias

新增 docs/doc-drift-findings-2026-07-24.md (2 条无法自动修复的 docs 路径, 待人工)

新增 scripts/check-doc-drift.ts (scripts/check-doc-drift.ts, 218 行):
- 4 类检查: 命令引用 / arg-opt 一致性 / source 路径 / ANTI_PATTERNS 命令引用
- 接入 npm run doc:check
- 验证: 修复前 21 处 drift → 修复后 2 处 (已归档)

测试: typecheck 0 errors, 387/387 tests pass, doc:check 报告 2 known issues
2026-07-24 16:33:31 +08:00
ssw 23c606e73d Round 6: BS-drift-W-3 镜像 web bpmnLintUtil.ts 校验 (不自创)
镜像架构原则实践: BS-drift-W-3 (AI 节点数自由生成) 不可强约束,
硬编码角色/节点数会引入维护负担 + 漏业务专属角色 + 跨语言失败.

采用 '复用规则文字 + 引用 web 源码行号' 的务实镜像策略:

镜像源: web/packages/jnpf/plugins/jnpf-bpmn/lib/utils/bpmnLintUtil.ts
镜像 4 规则:
- 规则 1 (line 73): 必须有 start + end + approver
- 规则 2 (line 84): 只能有 1 个 start
- 规则 3 (line 106): 只能有 1 个 end
- 规则 5 (line 130+): parallel/inclusive 网关必须成对 (偶数个)

规则 4 (edges 进出线) 跳过: dacli parseFlowXml 不解析 sequenceFlow 边
(web _webapi_helpers.ts:215 注释).

未来 v0.22+ 用 webapi loader 整个 import bpmnLintUtil.ts (含边校验),
需先用 shim 把 flowNodes 转 ElementRegistry-like 结构.

5 类漂移全部 RESOLVED:
- BS-drift-M-1/2, BS-drift-W-1/2/4 (Round 5)
- BS-drift-W-3 (Round 6 镜像修复) ✓ NEW

vitest: 62/62 PASS (22 menu + 31 workflow drift + 9 validator 单元测试), 419ms

改动:
- workflow/_webapi_helpers.ts: 加 validateFlowNodeStructure (镜像 4 规则)
- workflow/create.ts: step 4/6 调用 mirror validator
- tests/integration/drift/workflow-validator.spec.ts (NEW): 9 单元测试
- tests/integration/drift/workflow-drift.spec.ts: BS-W-3 切到 RESOLVED via mirror
- docs/drift/2026-07-14-round6-w3-mirror-summary.md (NEW): 完整总结
2026-07-14 08:52:16 +08:00
ssw cfd1fa9211 P1-6 修复: workflow parseFlowXml 跨行匹配 + 4 种 gateway 节点 (2026-07-02)
FINDING-F3: parseFlowXml 解析不完整
  - 单行正则 \s+ 不匹配跨行 id 属性 → JNPF FlowXmlUtil 输出带换行缩进时漏解析
  - 不匹配 parallelGateway/inclusiveGateway/exclusiveGateway/eventGateway
  - 复杂流程 (含条件分支) 网关节点全丢, launch 条件路由失效

修复:
- 正则改 [\s\S]*? 跨行匹配
- 加 4 种 gateway 节点 (parallel/inclusive/exclusive/event)
- 类型映射: parallelGateway → type='parallel', inclusiveGateway → 'inclusive', etc.

testspace 验证 (3 单元测试):
- Test 1 单行 BPMN: 3 nodes (start + task + end) ✓
- Test 2 跨行 BPMN: 2 nodes (旧版 0) ✓
- Test 3 含网关: 6 nodes (旧版 4, 漏 g1/g2) ✓
- 网关类型映射: exclusive/parallel 正确 ✓

审计: dacli/docs/cmd-review/v0.14-rollout-audit-2026-07-02.md §4.1 F3
2026-07-02 12:20:42 +08:00
sswandClaude 9d390dd8e0 docs(bigscreen): v0.14 端点修正 + 完整构造大屏文档 + 36 组件 metadata
## 文档更新
- docs/cmd-review/bigscreen.md: 加 v0.14 章节 (端点修正 30000 jnpf-visualdata, webapi 镜像, construct 命令 22 options, 7 步流程)
- docs/cmd-review/bigscreen-components.md: 新建, 36 组件 metadata (prop/类型/dataType 推荐/option keys/分类列表)
- docs/cmd-review/v0.14-webapi-rollout-plan.md: §2.1 端点修正 (30000 不是 32000), §2.5 webapi/role.ts 是 loadRole (webapi/permission.ts 是 loadOrg)
- docs/cmd-review/v0.13-webapi-form-workflow-refactor.md: §8.1 端点修正 + web 真实 url 来源

## 端到端验证 (testspace, 2026-07-01)
- 5 组件大屏构造 (bar/text/map/video/table, dataType=0): ✓ PASS
- --from-json 路径 (2 组件): ✓ PASS
- --validate-only 路径: ✓ PASS
- TC-C dacli test render --module=bigscreen (4 关卡 list/form/必填/schema): ✓ PASS
- TC-C dacli test render --module=bigscreen --id=X (5 关卡 + 单条 schema): ✓ PASS
- dataType=1 缺 url 校验 (5 项失败阻断): ✓ PASS

## 端点修正
- 错误: /api/visual/* → 32000 jnpf-datareport-univer (报表)
- 正确: /api/visual/* → 30000 jnpf-visualdata (大屏独立微服务)
- web 端 public/config.js 设 window.$website.url = '/api/blade-visual', nginx 代理转发

Co-Authored-By: Claude <[email protected]>
2026-07-01 17:27:48 +08:00