jnpf-flow-engine 镜像（JNPF 独立流程引擎）

它是什么

jnpf-workflow-admin-1.0.0-RELEASE.jar = 官方 Flowable 7.0.1 引擎 + JNPF 定制层。
原为无源码黑盒 jar；**2026-07-17（任务 B）已反编译重建为仓库内自有源码工程 jnpf-flow-engine/**
（41 个 Java 类 + 官方 liquibase 4.27.0 源码打 3 处达梦补丁，详见 jnpf-flow-engine/README.md），
本镜像现打包该自有工程的构建产物，引擎侧 bug 可修、Flowable 版本可升。

REST 层：admin/controller/{Definition,Instance,Task}Controller（/api/Flow/* 27 端点）+
admin/handle/GlobalExceptionHandler + admin/result/Result（{success,code,msg,data} 包装）。

被 jnpf-flowable(30004) 经 config.FlowDomain（Nacos system-config.yaml，值 http://jnpf-infra:31000）
以固定 URL 直连调用（客户端代码见 jnpf-flowable-entity/.../FlowAbleUrl.java，19 个调用点）。

不能换官方 flowable-rest 镜像：调用的是上述自定义 API（路径+包装格式），与官方 REST API 不兼容。

重建镜像

自 2026-07-17（任务 B）起，jar 取自**自有源码工程** jnpf-flow-engine/（黑盒反编译重建，
可修可升，见 jnpf-flow-engine/README.md）。prepare-context.sh 取源规则：默认用自建产物
jnpf-flow-engine/target/，**产物不存在直接报错、不静默降级黑盒**（以免交付机把黑盒当自建引擎误发）。

make flow-engine                     # = mvn -f jnpf-flow-engine/pom.xml clean package（构建自建产物）
docker/flow-engine/prepare-context.sh   # 暂存 jar 到 context/（产物缺失会报错提示）
docker compose build cx-flow-engine   # 在仓库根执行
# 以上三步等价于 `make prepare && docker compose build cx-flow-engine`

回滚到黑盒 jar（**必须显式**，脚本不再自动降级）：
FLOWAPI_JAR=~/Infra/jnpf/flowApi/jnpf-workflow-admin-1.0.0-RELEASE.jar ./prepare-context.sh。

配置

• conf/application-dev.yml 烧录进镜像 /opt/flow-engine/config/：数据源已切 PG 的 jnpf_flow 库
  （随 postgres_pgdata 卷，70 张 ACT_* 表，Flowable 7 同版本 schema，启动时自动校验）
• 环境变量覆盖（默认不用设，勿设空值）：FLOW_DB_URL / FLOW_DB_USER / FLOW_DB_PASSWORD
• 引擎不连 Nacos、无 Sa-Token 校验（调用方透传的 Authorization 头仅透传）

端口与健康检查

• 31000：HTTP API + springdoc（/doc.html、/v3/api-docs）
• healthcheck 用 /v3/api-docs（无 actuator）

交付

docker save cx/flow-engine:1.0.0 | gzip > cx-flow-engine-1.0.0.tar.gz，现场 docker load（amd64）。
宿主 ~/Infra/jnpf/flowApi 保留作回滚锚点（其 application-dev.yml 仍指向远程 MySQL，
回滚时注意数据面在 PG/MySQL 间的一致性）。