test-spec.md 7.2 KB
测试计划 — 流程管理表单运行态与业务入口优化
创建时间：2026-06-06 测试策略：按
code-copilot/rules/automated-testing-standard.md做增量验证。
1. 本轮验证范围
- 后端 Flow 插件和
forge-flow-server：流程表单版本、入口、运行态、组织填报批次、任务表单快照、待办站内信推送相关 Java/XML 编译。 - 前端流程管理：
flow/form、flow/model全屏流程设计弹窗、模型级表单设计器、BPMN 字段目录和手工动态路由清理。 - 前端流程模型：已部署模型的“发起测试”弹窗，按模型级动态表单收集变量后发起流程，并跳转“我发起的”查看流转结果。
- 前端流程表单：流程表单设计器复用低代码业务组件，字典、组织、人员等组件在设计器和运行渲染器中都能加载选项。
- 前端流程表单：动态表单字段默认下方间距为 20px，设计器右侧“表单配置”支持统一设置字段行间距。
- Flyway 脚本：
V1.0.57__add_flow_form_runtime_entry.sql新增表、字典和按钮权限；V1.0.58__remove_standalone_flow_entry_menus.sql清理误注册的独立入口/组织填报菜单。
2. P0 必跑
| 验证项 | 命令 | 期望 |
|---|---|---|
| 后端编译 | cd forge && JAVA_HOME=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home PATH=/opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home/bin:$PATH mvn -pl forge-flow/forge-flow-server -am compile -DskipTests |
Reactor BUILD SUCCESS |
| 前端构建 | source ~/.nvm/nvm.sh && nvm use v20.19.0 && NODE_OPTIONS=--max-old-space-size=8192 pnpm --dir forge-admin-ui build |
Vite build 成功，流程模型页不再引用入口配置组件或入口运行页 |
| 空白检查 | git diff --check -- forge-admin-ui/src/components/form-create/FlowFormCreateDesigner.vue forge-admin-ui/src/components/form-create/formCreateBridge.js forge-admin-ui/src/views/flow/design.vue forge-admin-ui/src/views/flow/model.vue forge-admin-ui/src/router/index.js code-copilot/changes/flow-management-form-runtime-optimization/spec.md code-copilot/changes/flow-management-form-runtime-optimization/tasks.md code-copilot/changes/flow-management-form-runtime-optimization/test-spec.md code-copilot/changes/flow-management-form-runtime-optimization/execution-log.md |
无输出，退出码 0 |
3. P1 条件验证
| 验证项 | 条件 | 当前处理 |
|---|---|---|
| Flyway 实跑 | 本地 MySQL/Redis/dev profile 可用 | 本轮未启动数据库，暂未执行迁移实跑 |
| 接口联调 | forge-flow-server、主应用鉴权和测试流程定义可用 |
本轮以编译和前端构建为阶段验证，未启动服务做 curl |
| 浏览器交互 | 前后端服务和测试数据可用 | 本轮未做 Playwright，前端 build 已覆盖 Vue 编译和路由导入 |
4. 风险回归点
PROCESS_ONLY必须保存sys_flow_form_instance快照并永久保留。BUSINESS_OBJECT/HYBRID已接入FlowBusinessObjectRuntimeAdapterImpl和DynamicCrudService，后续联调需重点验证业务对象configKey、字段映射和ai_business_flow_instance_link关联。- 组织批量填报不再作为流程管理独立页面；若具体业务应用启用该场景，后续联调需验证无负责人组织跳过告警、重复发布防重和驳回后重新提交。
- 待办站内信幂等依赖
bizType + bizKey查询，后续可补数据库唯一键强化并发幂等。 - BPMN 字段目录已覆盖审批人、候选用户、候选组和流转条件；高级消息模板字段引用仍依赖手写
${field}。 - 流程设计器和任务详情已改为弹窗；本轮通过前端构建验证模板，未做浏览器截图交互验证。
- 模型页“入口配置”已撤掉；业务入口展示位置改由低代码应用、业务对象或后续流程发起中心承载。
- 模型页“发起测试”只用于设计验证，测试业务键固定使用
FLOW_TEST:前缀，不能作为正式业务入口配置复用。 - 流程表单设计器共享低代码业务组件注册；后续浏览器联调需重点验证字典类型下拉、组织树、人员选择在不同接口权限下的加载表现。
9. 2026-06-06 流程表单设计器业务组件对齐验证范围
- 前端：流程表单设计器注册低代码业务组件分组，保留流程字段自由编辑。
- 前端：流程表单运行渲染器复用业务组件选项补齐逻辑，支持发起测试、预览、待办办理时加载系统字典、组织树和人员列表。
- 前端：流程动态表单字段默认行间距和右侧“表单配置”中的统一字段行间距配置。
- 必跑命令：
git diff --check和pnpm --dir forge-admin-ui build。
10. 2026-06-06 表单级行间距纠偏验证范围
- 前端：流程动态表单“字段行间距（px）”必须出现在 fcDesigner 右侧“表单配置”Tab，不再出现在字段属性面板。
- 前端：保存、预览刷新和配置变更时统一把表单级行间距写入所有规则的
wrap.style.marginBottom。 - 静态扫描：不得再存在
enableFormItemSpacing或formCreateWrap>style>marginBottom字段属性扩展代码。 - 必跑命令：
git diff --check、残留引用rg扫描和pnpm --dir forge-admin-ui build。
8. 2026-06-06 模型页测试发起和设计器配置区增量验证范围
- 前端：流程模型页已部署模型的更多操作增加“发起测试”，弹窗渲染模型级动态表单，提交后调用流程启动接口。
- 前端：流程设计器顶部配置区取消默认折叠，拆成“流程属性 / 表单配置 / 说明”三块，表单配置常驻展示设计、选择和预览动作。
- 必跑命令：
git diff --check和pnpm --dir forge-admin-ui build。
7. 2026-06-06 入口边界和表单设计器增量验证范围
- 前端：流程模型页移除“入口配置”动作、隐藏入口运行路由和错误运行页；流程表单设计器弹窗高度与设计器高度保持一致。
- 前端：
FlowFormCreateDesigner显式使用中文 locale，并归一化历史英文组件标题，避免动态表单选择器显示Select。 - 文档：同步修正 spec/tasks/test 里“模型页入口配置”的旧产品结论。
- 必跑命令：
git diff --check和pnpm --dir forge-admin-ui build。
5. 2026-06-06 增量验证范围
- 后端：
BUSINESS_OBJECT/HYBRID落表适配器、批量填报发布、batchItemId提交回写、消息推送相关编译。 - 前端：BPMN 节点字段目录选择、模型设计全屏弹窗、待办/已办/我发起/抄送详情弹窗、批量填报发布按钮。
- 静态检查：本轮相关前端文件和变更文档的
git diff --check。
6. 2026-06-06 启动装配增量验证范围
- 后端：
forge-flow-server引入forge-plugin-generator后的 Spring bean 装配和可执行 jar 启动。 - 必跑命令：
mvn -pl forge-flow/forge-flow-server -am package -DskipTests。 - 启动验证：
java -jar forge-flow/forge-flow-server/target/forge-flow-server.jar --server.port=0，需要 dev MySQL/Redis 可连接。 - 验证重点：
MenuRegisterAdapter、AiClientAdapter、FlowClient相关装配错误不再出现，日志出现Started ForgeFlowApplication。