Home Explore Help
Sign In
user5
/
forge_admin
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: 03bf2029e2
Branches Tags
forge_admin
/
code-copilot
/
changes
/
定时任务Flowable编排
/
execution-log.md

execution-log.md 6.4 KB
History Raw

定时任务 Flowable 编排执行记录

version: V9 status: complete baseline-created: 2026-07-21

2026-07-21 实施启动

  • 变更范围：V9 固定 Flowable 定义绑定、技术身份启动、独立 Flow 安全适配、Job 日志关联和前端入口。
  • 基线：复用 V8 Starter 47/47、Flow 12/12、Flow Reactor 32/32、Admin Reactor 43/43 成功记录。
  • 门禁：固定 processDefinitionId；首验独立 Flow 服务；只启动流程；禁止新 X-Inner-Call/直连 HTTP 旁路。
  • 风险：工作区包含 V1-V8 未提交成果，本阶段只叠加 V9，不回退、不创建 Git 提交。
  • 服务：本轮自动化阶段不启动真实 MySQL、Admin、Flow 或外部 HTTP 服务。

2026-07-21 Flow 运行时与远程适配验证

  • JobFlowRuntimeServiceTest：7/7 通过，覆盖固定定义校验、挂起/不匹配失败和 businessKey 幂等恢复。
  • RemoteJobFlowExecutorTest：6/6 通过，覆盖 FLOW_API、服务端 Bearer Token、无 X-Inner-Call、嵌套 jobInput、显式失败关闭及响应丢失恢复。
  • 修复远程状态查询 businessKey 编码，job:11:22 固定输出为 job%3A11%3A22；远程基础地址尾部斜杠已归一化。
  • 命令：mvn -Penable-tests -pl forge-flow/forge-flow-client -am -Dtest=RemoteJobFlowExecutorTest -Dsurefire.failIfNoSpecifiedTests=false test，结果 BUILD SUCCESS。
  • 命令：mvn -pl forge-flow/forge-flow-server -am -DskipTests compile，32 个 Reactor 模块全部 SUCCESS。
  • 非阻断警告：既有模块仍有 deprecated/unchecked 编译提示，本轮未新增对应调用。
  • 服务：未启动真实服务，无 PID 需要清理。

2026-07-21 Job 执行链路验证

cd forge-server
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-framework/forge-plugin-parent/forge-plugin-job \
  -Penable-tests -Dforge.test.groups= \
  -Dtest=JobFlowMigrationContractTest,JobSchedulerTest,JobConfigValidatorTest,JobFlowOrchestrationServiceTest,QuartzJobExecutorTest,JobExecutionLifecycleServiceTest test
  • 结果：48/48 通过，Failures 0、Errors 0、Skipped 0，BUILD SUCCESS。
  • 覆盖：V1.0.48 迁移合约、Quartz 固定绑定快照、FLOW 参数对象边界、可信绑定、确定性 businessKey、processInstanceId 日志终态和 SINGLE 兼容。
  • 预期日志：JobSchedulerTest 主动关闭 Scheduler 后验证异常透传，会输出一次 SchedulerException；QuartzJobExecutorTest 包含失败分支；生命周期幂等用例会输出“终态更新被忽略” WARN。均为故障注入预期，不是测试失败。

2026-07-21 Flow API 权限加固

  • 复核发现专用 Job Flow Controller 只有登录门禁、没有业务权限；已在类级增加 @SaCheckPermission("system:jobConfig:trigger")，复用既有“立即运行任务”权限。
  • 远程 FORGE_FLOW_JOB_REMOTE_TOKEN 必须属于拥有该权限的服务账号；Flowable 实际发起身份仍只取 Flow 服务技术身份配置，不取 Token 用户或请求体身份字段。
cd forge-server
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 \
  -Penable-tests -Dforge.test.groups= \
  -Dtest=JobFlowControllerSecurityContractTest test
  • 结果：1/1 通过，Failures 0、Errors 0、Skipped 0，BUILD SUCCESS。

2026-07-21 前端与聚合构建

cd forge-admin-ui
source ~/.nvm/nvm.sh
nvm use v20.19.0
pnpm exec vitest run \
  src/views/system/job-config/__tests__/job-config-form.test.js \
  src/views/system/job-config/__tests__/job-permission.test.js \
  src/views/system/__tests__/job-log-query.test.js \
  src/views/system/__tests__/job-api-token.test.js
  • 结果：4 个测试文件、25/25 用例通过；覆盖 FLOW payload、JSON 对象边界、Long ID 字符串、权限操作和日志查询。
  • 既有前端定向 ESLint 已通过；前端生产构建成功，8721 modules transformed，耗时约 2m 6s。
cd forge-server
mvn -pl forge-flow/forge-flow-server -am package -DskipTests
mvn -pl forge-admin-server -am package -DskipTests
  • Flow Server：32/32 Reactor 模块成功，BUILD SUCCESS。
  • Admin Server：43/43 Reactor 模块成功，BUILD SUCCESS。
  • 非阻断警告：既有 UserSelectModal 自动组件命名冲突、既有 CSS // 注释和部分静态/动态 import chunk 提示；均未阻断构建，本轮未扩展这些问题。

2026-07-21 最终静态门禁

rg -n '\$\{[^}]+\}' forge-server/db/migration
rg -n 'tenant_id\s*=\s*0' forge-server/db/migration/V1.0.48__add_job_flow_orchestration.sql
xmllint --noout \
  forge-server/forge-framework/forge-plugin-parent/forge-plugin-job/src/main/resources/mapper/SysJobConfigMapper.xml \
  forge-server/forge-framework/forge-plugin-parent/forge-plugin-job/src/main/resources/mapper/SysJobLogMapper.xml \
  forge-server/forge-framework/forge-plugin-parent/forge-plugin-flow/src/main/resources/mapper/FlowModelMapper.xml
rg -n 'RestTemplate|WebClient|HttpClient|OkHttpClient|openConnection' <V9生产文件>
rg -n 'X-Inner-Call|X_INNER_CALL' <V9生产文件>
rg -n 'ScriptEngine|GroovyShell|ProcessBuilder|Runtime.getRuntime().exec|SpelExpressionParser|Class.forName|.invoke(' <V9生产文件>
rg -n 'latestVersion|latest(' <V9生产文件>
git diff --check
  • Flyway placeholder：无匹配，rg 按无匹配语义返回 1，符合预期。
  • V1.0.48：无 tenant_id=0，字典数据固定 tenant_id=1，INSERT 显式列名并使用 NOT EXISTS。
  • Mapper XML：3 个文件均由 xmllint 校验通过。
  • V9 生产链路：无直连 HTTP、无 X-Inner-Call、无 latestVersion、无任意脚本/反射执行入口；既有 SINGLE/BEAN 的 Method.invoke 不属于 FLOW 新链路。
  • git diff --check：返回 0，无空白错误。

跳过项与环境状态

  • 未启动真实 MySQL、Admin、Flow、Vite 或外部 HTTP 服务；本轮新增服务 PID：无，无需清理。
  • 未执行真实 Flyway；未配置或验证 Flow 技术身份、FLOW_API 私网白名单和服务账号 Token；未执行真实已发布流程的定时/手动/Open API E2E。以上由用户侧部署环境验收。
  • 未修改 BPMN 节点配置，未新增技术节点库，未修改或清理 V1-V8 未提交成果，未创建 Git 提交。