Compare commits
220 Commits
55b9c201d6
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| d97e69d124 | |||
| 74b30adb6e | |||
| 36aa94db7d | |||
| 49d056be09 | |||
| a5e2540c8f | |||
| 93f3823a06 | |||
| 4af6776164 | |||
| 732655e776 | |||
| 5eed5f0b26 | |||
| 529f73f8f5 | |||
| 6f180522f3 | |||
| 84be9c658a | |||
| 647f06836f | |||
| 26532a64c3 | |||
| 7524e5f7bf | |||
| 789cb90af3 | |||
| a9d21ec46c | |||
| f0d704d1b9 | |||
| 653866c852 | |||
| e19bac805e | |||
| a25e7ce4b7 | |||
| b489f3d834 | |||
| 4abe9f8ce6 | |||
| b89447556f | |||
| 93b5433f1e | |||
| 57812f0edc | |||
| 546a8228b0 | |||
| ddaf536419 | |||
| 9cfef7e931 | |||
| 88ab0b8f0e | |||
| fdb97def4d | |||
| 6d16206a08 | |||
| 14a825d0a0 | |||
| 3ca082408c | |||
| e5781ddd02 | |||
| 3927146f08 | |||
| e361d3a9ad | |||
| 33fccb6541 | |||
| 3cf58fe72c | |||
| 7a97b712b4 | |||
| 90a6f97040 | |||
| f7d96489d0 | |||
| be9767cbe3 | |||
| 6f5b1f7117 | |||
| adae344323 | |||
| 8091aaf7fa | |||
| dd3b048899 | |||
| f01b7abda0 | |||
| 0f153d658e | |||
| cc5cb83500 | |||
| 2f97124ba1 | |||
| c6bfcebcad | |||
| 1b02036153 | |||
| b4baca5d94 | |||
| 1dd65b0142 | |||
| e63b3a3373 | |||
| d87d0e2185 | |||
| 3e642a8aae | |||
| 3afc55817e | |||
| 0d952acc00 | |||
| 5a5aedcbb7 | |||
| d3ec7581fd | |||
| 0cf6536a59 | |||
| e0e92a88b4 | |||
| ccb179d84a | |||
| 0ee919b89e | |||
| 9be0a39c0f | |||
| 1be949cc04 | |||
| c95eaee0a5 | |||
| d697885df6 | |||
| 98ce37c11b | |||
| e8af5b0a74 | |||
| aae418653e | |||
| 5c4894d40a | |||
| 4f9e4abfc2 | |||
| dccca17314 | |||
| b15acfa2f3 | |||
| e6c73a4f88 | |||
| ffb2f042d0 | |||
| 6512a706fa | |||
| 61b8658f44 | |||
| d78de96530 | |||
| 3a04b869fe | |||
| fda9e20fe5 | |||
| 1b4dab9701 | |||
| a6eced0761 | |||
| e9357e2eef | |||
| f8ef09ebdc | |||
| 53f3c258a9 | |||
| 9a99754f72 | |||
| 8e5e2410d1 | |||
| 3090906f9e | |||
| b1c818fb2d | |||
| 702b5e9229 | |||
| 2ff826505f | |||
| fa3c92b698 | |||
| b7fbae4cae | |||
| 2db44a6231 | |||
| f7675c9c2f | |||
| 7b01e918e4 | |||
| f5f4754e5f | |||
| 2507d6c435 | |||
| 11e668a455 | |||
| afee2d5083 | |||
| 97a0eb12ae | |||
| ade4c928bb | |||
| 997d51c5a4 | |||
| 191c2baf60 | |||
| 6e144447ee | |||
| 9dbba1b272 | |||
| bbdeee3af7 | |||
| bcfb8f7102 | |||
| afc1a8ca62 | |||
| fa63d1c654 | |||
| 285d601c3d | |||
| b409f9757f | |||
| 1a57000458 | |||
| 1102601424 | |||
| add67353b0 | |||
| eba9ce1fc1 | |||
| 9526e43a15 | |||
| 0e0311abbd | |||
| 1a0985ffa5 | |||
| bc9ae8cf44 | |||
| 980d83ed15 | |||
| 1f2365fa26 | |||
| 24160db684 | |||
| a132e67a20 | |||
| 03a514e57f | |||
| 8df60e810c | |||
| c4ef673b0a | |||
| 21a181f44b | |||
| 378fd74682 | |||
| 49e745912d | |||
| 0106088084 | |||
| ffe89e62bf | |||
| 850c6501b2 | |||
| e26d5d5bfb | |||
| 32d12440e0 | |||
| 1eb690124b | |||
| 0e457d9945 | |||
| daad6ea196 | |||
| a573d8fa2c | |||
| d1cdcc70b4 | |||
| 8a6c94ebde | |||
| 4a2080a4f6 | |||
| 5b06aeceff | |||
| 2fc093f25e | |||
| 0400d92a15 | |||
| f90e11686e | |||
| ea69edf18b | |||
| 5e55f7f37f | |||
| 2da1a0ef29 | |||
| 1d1ae9c717 | |||
| 2d1e9d143b | |||
| 46ff5c5779 | |||
| ccbed82498 | |||
| 8b28595f9e | |||
| 624ffe8a15 | |||
| 75f942bca0 | |||
| 63e6522f3b | |||
| 3e4264d9e0 | |||
| ba8177e9d4 | |||
| ce544fa65e | |||
| f18d998337 | |||
| 6e096dce1d | |||
| c9be9bc125 | |||
| 25494efadf | |||
| 8fe377b0c8 | |||
| d71ad6f461 | |||
| b0daaaab0f | |||
| f281de1c5a | |||
| 4400eabc66 | |||
| 303b4d0240 | |||
| b5a6388024 | |||
| c339efcdcb | |||
| 74478f030e | |||
| 9765872382 | |||
| 05181d75bf | |||
| 869790d04f | |||
| eabebae361 | |||
| 687ade7513 | |||
| 3e24f135ad | |||
| 6f34be15eb | |||
| 8c3f3944be | |||
| 61e51abeb6 | |||
| 4319178b66 | |||
| 418b0b6458 | |||
| 22d481e1cb | |||
| 6c6038350a | |||
| 5f320503ee | |||
| 1ff0d334d0 | |||
| d3b88467e0 | |||
| da3ad35821 | |||
| 9aea6c1cd0 | |||
| c379f5b1ea | |||
| bac69d85a7 | |||
| bd4c642766 | |||
| a51f35317f | |||
| dbf5b6c86a | |||
| ccd74710fa | |||
| 62188a557f | |||
| d218c2ba6f | |||
| b6e6964913 | |||
| 4b2cedfd1d | |||
| d91da77038 | |||
| 718c5a5b9b | |||
| 2b0b673ce9 | |||
| fcc5719bc6 | |||
| e55072598e | |||
| c1ff0db96b | |||
| c5b7b68210 | |||
| 8bdde45e89 | |||
| 5eb95a4ef4 | |||
| b05f0e89b5 | |||
| ade5e91ac1 | |||
| 5f7e226fa0 | |||
| c5bfbd3ca3 | |||
| 5bf641838a | |||
| 3b4d3dbd24 |
@@ -1,4 +1,11 @@
|
|||||||
# eip4-platform CI:编译+单测+ArchUnit+对拍冒烟(公司自建 Git 服务可换 Jenkins,步骤同 scripts/ci.sh)
|
# eip4-platform CI(Gitea Actions)。
|
||||||
|
#
|
||||||
|
# P0 修复(2026-06-24 架构评审):原 .github/workflows/ci.yml 在私有 Gitea 上是孤儿
|
||||||
|
# (GitHub Actions 不会跑),且 java-version 写死 17(项目 JDK21)。本文件迁到 Gitea 规范位置
|
||||||
|
# .gitea/workflows/,JDK 升 21。
|
||||||
|
#
|
||||||
|
# 前置条件:Gitea 实例需已启用 Actions 且注册了带 `ubuntu-latest` 标签的 act_runner;
|
||||||
|
# 否则本工作流不会被调度(纯文件存在不等于会跑)。详见仓库 Actions 设置。
|
||||||
name: ci
|
name: ci
|
||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
@@ -23,9 +30,9 @@ jobs:
|
|||||||
- uses: actions/setup-java@v4
|
- uses: actions/setup-java@v4
|
||||||
with:
|
with:
|
||||||
distribution: temurin
|
distribution: temurin
|
||||||
java-version: "17"
|
java-version: "21"
|
||||||
cache: maven
|
cache: maven
|
||||||
- name: 编译+单测+对拍冒烟
|
- name: 编译+单测(含 ArchUnit)+对拍冒烟
|
||||||
env:
|
env:
|
||||||
CI_PG_HOST: localhost
|
CI_PG_HOST: localhost
|
||||||
CI_PG_PORT: "5433"
|
CI_PG_PORT: "5433"
|
||||||
53
.gitea/workflows/parity-nightly.yml
Normal file
53
.gitea/workflows/parity-nightly.yml
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
# eip4-platform 夜间对拍(Gitea Actions)。
|
||||||
|
#
|
||||||
|
# P1 修复(§10.2「逐行对拍框架已冻结」):push CI(ci.yml)只在有提交时跑对拍,无提交的日子不跑;
|
||||||
|
# 本工作流按 cron 每夜跑一次全量对拍——直连 JDBC(基线)vs 引擎 REST(被测)逐行逐列 diff,
|
||||||
|
# ParityCli 任一实体不一致即退出码 2 → 本 job 红(「本次 vs 基线 diff 非 0 即阻断」由 ParityCli 退出码内建)。
|
||||||
|
# 即便没人提交代码,也能捕获引擎/转换器/运行库的隐性漂移。
|
||||||
|
#
|
||||||
|
# 触发:每日 18:00 UTC(02:00 CST)+ 手动 workflow_dispatch。
|
||||||
|
# 前置条件:Gitea 实例需启用 Actions 且注册带 `ubuntu-latest` 标签的 act_runner;否则不会被调度。
|
||||||
|
#
|
||||||
|
# 注:--seed --all + --privilege 为硬门(本 job 跑这两项)。更广的 --discover(发现式抽样)/
|
||||||
|
# --realprivilege(客户库真实规则)退出语义偏探索性,暂未纳入硬门 job,见 §10.2 follow-up。
|
||||||
|
name: parity-nightly
|
||||||
|
on:
|
||||||
|
schedule:
|
||||||
|
- cron: "0 18 * * *"
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
nightly-parity:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
services:
|
||||||
|
postgres:
|
||||||
|
image: postgres:15
|
||||||
|
env:
|
||||||
|
POSTGRES_USER: ci
|
||||||
|
POSTGRES_HOST_AUTH_METHOD: trust
|
||||||
|
ports: ["5433:5432"]
|
||||||
|
options: >-
|
||||||
|
--health-cmd "pg_isready -U ci" --health-interval 5s
|
||||||
|
--health-timeout 5s --health-retries 20
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-java@v4
|
||||||
|
with:
|
||||||
|
distribution: temurin
|
||||||
|
java-version: "21"
|
||||||
|
cache: maven
|
||||||
|
- name: 全量对拍(种子 21 实体 + C2 权限,逐行 diff,不一致即红)
|
||||||
|
env:
|
||||||
|
CI_PG_HOST: localhost
|
||||||
|
CI_PG_PORT: "5433"
|
||||||
|
CI_PG_USER: ci
|
||||||
|
CI_DB: eip4parity
|
||||||
|
CI_PORT: "8090"
|
||||||
|
run: bash scripts/ci.sh
|
||||||
|
- name: 归档对拍报告
|
||||||
|
if: always()
|
||||||
|
uses: actions/upload-artifact@v4
|
||||||
|
with:
|
||||||
|
name: parity-reports-${{ github.run_id }}
|
||||||
|
path: parity-reports/parity-*.json
|
||||||
|
if-no-files-found: ignore
|
||||||
5
.gitignore
vendored
5
.gitignore
vendored
@@ -8,6 +8,8 @@ parity-reports/
|
|||||||
.DS_Store
|
.DS_Store
|
||||||
|
|
||||||
# C3 卫生:可再生噪声(2026-06-13)
|
# C3 卫生:可再生噪声(2026-06-13)
|
||||||
|
# 运行时日志(logback 滚动文件;§10.2 可观测性)
|
||||||
|
logs/
|
||||||
__pycache__/
|
__pycache__/
|
||||||
*.pyc
|
*.pyc
|
||||||
/data/
|
/data/
|
||||||
@@ -26,3 +28,6 @@ tools/s3_rewriter/output/分级清单.csv
|
|||||||
# Office 临时锁文件 / 系统垃圾
|
# Office 临时锁文件 / 系统垃圾
|
||||||
~$*
|
~$*
|
||||||
.DS_Store
|
.DS_Store
|
||||||
|
|
||||||
|
# A10 部署本地密钥(只提交 .env.example)
|
||||||
|
deploy/.env
|
||||||
|
|||||||
39
CONTRIBUTING.md
Normal file
39
CONTRIBUTING.md
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
# 贡献约定(eip4-platform / eip4-web 通用)
|
||||||
|
|
||||||
|
> 新人先读 `docs/新人上手.md`(环境)与 `docs/架构设计.md`(红线)。本文只讲协作流程。
|
||||||
|
|
||||||
|
## 分支与合并
|
||||||
|
|
||||||
|
- **main 不直接提交功能代码**;从 main 拉分支,前缀语义:`feat/`、`fix/`、`docs/`、`chore/`、`deploy/` + 短横线主题(如 `feat/approval-closure`)。
|
||||||
|
- 完成后 **`--no-ff` 合回 main 并 push**(保留合并节点,按批次可回溯),或走 Gitea Web UI 发 PR。合并后**删除本地/远端特性分支**。
|
||||||
|
- 一个分支一个主题;跨仓联动改动(platform+web)用同名分支便于对照。
|
||||||
|
|
||||||
|
## 提交信息
|
||||||
|
|
||||||
|
- 格式:`type(scope): 中文摘要`(如 `fix(report): 套打打印按选中行主键直接渲染`)。
|
||||||
|
- 正文写清:做了什么 / 为什么 / **验证证据**(单测数、live e2e 结论)。没验证的事不写「已完成」。
|
||||||
|
|
||||||
|
## 质量门(合并前自查清单)
|
||||||
|
|
||||||
|
1. **TDD**:新功能/修 bug 先写测试看它红,再实现变绿;禁止事后补「恒绿」测试。
|
||||||
|
2. **后端**:改动模块 `mvn -pl <模块> -am test` 绿;合并前全 reactor `mvn clean install` 绿(含 ArchUnit 边界规则)。
|
||||||
|
3. **前端**:`tsc -b` 干净 + `npx vitest run` 绿 + `npm run build` 成功。
|
||||||
|
4. **作者/评审分离**:合并前过一遍独立 code review(他人或 agent 对抗评审);涉及鉴权/SQL/脚本执行/DDL 的改动**必须加安全评审**。
|
||||||
|
5. **转换器改动**:重转重导后在运行库 live 验证(浏览器真渲染,不止单测),再合并。
|
||||||
|
6. **保真层改动**:默认禁止重写;确需改(如安全修)须登记 `docs/迁移手册.md` 并跑对拍回归。
|
||||||
|
|
||||||
|
## CI
|
||||||
|
|
||||||
|
- `.gitea/workflows/ci.yml`(构建+测试)与 `parity-nightly.yml`(夜间对拍)已就位,**待注册 runner 后生效**。
|
||||||
|
- runner 生效前,合并到 main 前请手跑 `bash scripts/ci.sh` 等价把关。
|
||||||
|
- **托管注记**:当前远端为私人 Gitea(见 `docs/新人上手.md` §1 警示)。workflow 是 Gitea Actions(GHA 兼容)语法——若迁 GitHub 可近乎原样复用(挪到 `.github/workflows/`),迁 GitLab/Jenkins 需转换;团队化后 runner 应部署在团队基础设施。
|
||||||
|
|
||||||
|
## 文档纪律
|
||||||
|
|
||||||
|
- 进度只回写 `docs/项目进度与路线-总览-*.md`(唯一权威);README 索引随之更新。
|
||||||
|
- 一次性 plan/报告完成后 `git mv` 入 `docs/归档/`,并同步改所有引用路径(grep 验证零断链)。
|
||||||
|
- 文档声明「已完成」必须附 git 证据(commit/merge 哈希)。
|
||||||
|
|
||||||
|
## 红线速查(详见 docs/架构设计.md 与 docs/新人上手.md §6)
|
||||||
|
|
||||||
|
JDK 21(严禁 26)|保真层不重写不改包名|DDL 走守卫单点|Flowable 不自动改表|AI 恒人审、对外严禁承诺全自动开发|amis 锁 6.13.0 本地 SDK。
|
||||||
44
README.md
44
README.md
@@ -12,7 +12,9 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供
|
|||||||
| platform-auth | 数据权限真实现(C2 已替换桩)+ P2 组织/权限 | |
|
| platform-auth | 数据权限真实现(C2 已替换桩)+ P2 组织/权限 | |
|
||||||
| platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 |
|
| platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 |
|
||||||
| platform-flow-gateway | P3 占位:Flowable 网关 | |
|
| platform-flow-gateway | P3 占位:Flowable 网关 | |
|
||||||
| platform-ai | P5 占位:MCP Server | |
|
| platform-ai | P5 AI Agent 开发底座:草稿/变更包/本地门禁/自动修复/人工部署包 | Agent 不直连线上执行生产变更 |
|
||||||
|
| platform-cli | EIP4 Agent 受控命令入口:`init` 一键接入(Claude Code/Codex/OpenCode)、环境探测、AI 自动开发、发布编排 | Agent 优先通过 CLI/API 操作 |
|
||||||
|
| platform-mcp | EIP4 MCP server(stdio):把 AI/元数据 REST 端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 经标准协议接入 | 忠实转发 REST,复用人审红线,不另开权限面 |
|
||||||
| platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 |
|
| platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 |
|
||||||
| platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 |
|
| platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 |
|
||||||
|
|
||||||
@@ -75,6 +77,46 @@ java -cp "$CP" com.eip4.platform.parity.selfcheck.ParityCli --privilege # C
|
|||||||
# 指向 eip4dev 自对拍:
|
# 指向 eip4dev 自对拍:
|
||||||
mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.selfcheck.ParityCli" \
|
mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.selfcheck.ParityCli" \
|
||||||
"-Dexec.args=--discover --jdbc=jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 --engine=http://localhost:8093 --out=parity-reports/eip4dev"
|
"-Dexec.args=--discover --jdbc=jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 --engine=http://localhost:8093 --out=parity-reports/eip4dev"
|
||||||
|
|
||||||
|
# EIP4 Agent CLI
|
||||||
|
mvn -pl platform-cli package
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add --name local --base-url http://localhost:8084 --use
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084
|
||||||
|
|
||||||
|
# 一键把 agent skills 装到目标项目,让 Claude Code / Codex / OpenCode 都能驱动平台开发
|
||||||
|
# Claude Code → .claude/skills/<name>/SKILL.md(原生 skill);Codex/OpenCode → 根 AGENTS.md(内嵌全文)
|
||||||
|
# base URL 按 current env(或 --base-url/--env)渲染;skills 已随 jar 打包,无需仓库在场
|
||||||
|
# 详见 docs/skills/README.md
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar init --dir <你的项目>
|
||||||
|
|
||||||
|
# 查看内置 agent skills / 校验目标项目是否已安装(缺失退出码非 0,便于 CI 把关)
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills list
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills check --dir <你的项目>
|
||||||
|
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package --task-id ait-xxx --change-set-id aics-xxx --output target/ai-runs/package.json
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify --package-file target/ai-runs/package.json
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release export --package-file target/ai-runs/package.json --output target/ai-runs/package.eip4pkg.json
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-preview --package-file target/ai-runs/package.eip4pkg.json
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff --left target/ai-runs/package-old.json --right target/ai-runs/package.json
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan --package-file target/ai-runs/package.eip4pkg.json --output target/ai-runs/rollback-plan.json
|
||||||
|
|
||||||
|
# EIP4 MCP server(stdio):把下面这些 AI/元数据端点包成 MCP 工具,供 Claude Code/Codex/OpenCode 用标准协议调用
|
||||||
|
mvn -pl platform-mcp package
|
||||||
|
claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8093
|
||||||
|
# 或设 EIP4_BASE_URL;默认 http://localhost:8084。手动启动:java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar
|
||||||
|
|
||||||
|
# Typed page schema
|
||||||
|
curl http://localhost:8084/api/page/schema/components
|
||||||
|
curl -X POST http://localhost:8084/api/page/schema/validate \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
--data-binary @target/ai-runs/page-schema.json
|
||||||
|
|
||||||
|
# AI tools / employees / ACL
|
||||||
|
curl http://localhost:8084/api/ai/tools
|
||||||
|
curl http://localhost:8084/api/ai/employees
|
||||||
|
curl -X POST http://localhost:8084/api/ai/tools/access-check \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"employeeId":"agent-developer","toolName":"local.apply","grantedScopes":["ai:local:apply"],"targetEnv":"local","productionWrite":false}'
|
||||||
```
|
```
|
||||||
|
|
||||||
## tools/
|
## tools/
|
||||||
|
|||||||
34
deploy/.env.example
Normal file
34
deploy/.env.example
Normal file
@@ -0,0 +1,34 @@
|
|||||||
|
# EIP4 生产编排环境变量样例(A10 W4)。复制为 deploy/.env 并改成真值;.env 切勿入库。
|
||||||
|
#
|
||||||
|
# cp deploy/.env.example deploy/.env
|
||||||
|
|
||||||
|
# ── 安全(必填,application-prod.yml 无默认,缺失即 fail-fast)──────────────────
|
||||||
|
# JWT 签名密钥:强随机 ≥32 字节。生成: openssl rand -base64 48
|
||||||
|
EIP4_AUTH_JWT_SECRET=CHANGE_ME_strong_random_at_least_32_bytes_0123456789abcdef
|
||||||
|
|
||||||
|
# ── 数据库 ───────────────────────────────────────────────────────────────────
|
||||||
|
# 生产:指向【客户既有 eip3 库】(保真层在其上运行,EIP4 只新增平台表)。
|
||||||
|
# 自测/演示:用内置 postgres 服务 → jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
|
||||||
|
EIP4_DB_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
|
||||||
|
EIP4_DB_USERNAME=eip4
|
||||||
|
EIP4_DB_PASSWORD=eip4
|
||||||
|
|
||||||
|
# 内置 postgres 服务凭据(仅自测演示用;生产用客户 PG 时可删 postgres 服务并忽略这三项)
|
||||||
|
POSTGRES_USER=eip4
|
||||||
|
POSTGRES_PASSWORD=eip4
|
||||||
|
POSTGRES_DB=eip4
|
||||||
|
|
||||||
|
# ── flowable-service 双数据源(env 驱动)────────────────────────────────────────
|
||||||
|
# ACT_ 工作流引擎库(Flowable 运行时表);生产指客户 PG 的 flowable schema
|
||||||
|
FLOWABLE_JDBC_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=flowable
|
||||||
|
FLOWABLE_JDBC_USER=eip4
|
||||||
|
FLOWABLE_JDBC_PASS=eip4
|
||||||
|
# biz 客户业务库(只读,候选人/组织解析直查 SYS_* 组织表);生产指客户 eip3 库
|
||||||
|
BIZ_JDBC_URL=jdbc:postgresql://postgres:5432/eip4?currentSchema=eip3
|
||||||
|
BIZ_JDBC_USER=eip4
|
||||||
|
BIZ_JDBC_PASS=eip4
|
||||||
|
|
||||||
|
# ── 单源托管 ─────────────────────────────────────────────────────────────────
|
||||||
|
HTTP_PORT=80
|
||||||
|
# 前端构建产物路径(相对 deploy/docker-compose.yml);先 `cd eip4-web && npm run build` 生成
|
||||||
|
WEB_DIST=../../eip4-web/dist
|
||||||
52
deploy/README.md
Normal file
52
deploy/README.md
Normal file
@@ -0,0 +1,52 @@
|
|||||||
|
# EIP4 生产部署(A10 MVP:W1 Flyway + W2 容器化 + W3 nginx 单源 + W4 compose)
|
||||||
|
|
||||||
|
> 对应设计 `docs/plans/2026-06-25-A10-生产上线工程化-design.md`。本目录是 **MVP 编排骨架**。
|
||||||
|
> ✅ **平台表(sys_*)由 W1 Flyway 在 platform-app 启动时自建**(含自建 `eip3` schema)——内置演示 postgres 从零即可起平台层,无需先跑 bootstrap。
|
||||||
|
> ℹ️ **flowable-service 例外**:引擎 `databaseSchemaUpdate=false` 是任务红线(严禁引擎自动改表),故其 `flowable` schema 必须【预置备】Flowable 6.8.1 DDL(生产=客户既有 flowable schema)。空演示库无法起 flowable-service,详见下「验证状态」。
|
||||||
|
|
||||||
|
## 拓扑
|
||||||
|
`nginx`(单源:serve 前端 dist + 反代 `/api`→platform-app、`/flowable`→flowable-service)→ `platform-app:8084` + `flowable-service:8089` → PostgreSQL。
|
||||||
|
|
||||||
|
## 一、Docker Compose(推荐)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1) 产后端 jar
|
||||||
|
mvn -pl platform-app,flowable-service -am package -DskipTests
|
||||||
|
# 2) 产前端 dist
|
||||||
|
( cd ../../eip4-web && npm ci && npm run build )
|
||||||
|
# 3) 配置(强随机密钥 + DB 指向;生产指客户 PG)
|
||||||
|
cp deploy/.env.example deploy/.env && $EDITOR deploy/.env
|
||||||
|
# 4) 起栈
|
||||||
|
docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build
|
||||||
|
# 健康/日志
|
||||||
|
docker compose -f deploy/docker-compose.yml ps
|
||||||
|
docker compose -f deploy/docker-compose.yml logs -f platform-app
|
||||||
|
```
|
||||||
|
|
||||||
|
**生产数据库(D2/D6)**:保真层跑在**客户既有 eip3 库**上,EIP4 只新增平台表。生产请把 `.env` 的 `EIP4_DB_URL` 指向客户 PG,并可删除 compose 内置 `postgres` 服务(仅自测演示用空库)。
|
||||||
|
|
||||||
|
**内置演示库 schema(W4)**:`.env.example` 用 `currentSchema=eip3` / `currentSchema=flowable`。platform-app 的 Flyway 会自建 `eip3` 并落平台表;但 flowable 的 Liquibase 不自建 schema,故内置 postgres 经 `deploy/postgres-init/01-create-schemas.sql` 在首次初始化预建 `eip3`+`flowable` 两 schema。生产指客户库时这些 schema 已存在,无需 init 脚本。
|
||||||
|
|
||||||
|
**flowable-service 引擎库**:`databaseSchemaUpdate=false`(任务红线)→ 引擎不自建 ACT_/FLW_ 表。空 `flowable` schema 启动会报 `relation "flw_channel_definition" does not exist`。要起 flowable-service 需先把 Flowable 6.8.1 引擎 DDL 灌入 `flowable` schema(生产=客户既有引擎库;演示如需自洽可把对应 create SQL 追加到 `postgres-init/`)。
|
||||||
|
|
||||||
|
**密钥(D4)**:`EIP4_AUTH_JWT_SECRET` 等敏感项 `application-prod.yml` 无默认值,缺失即启动失败(fail-safe)。用 `openssl rand -base64 48` 生成。
|
||||||
|
|
||||||
|
## 二、systemd 裸 jar(D3 兜底:客户禁 Docker 时)
|
||||||
|
|
||||||
|
见 `deploy/systemd/*.service` 头部安装说明:jar→`/opt/eip4/`,env→`/etc/eip4/*.env`(chmod 600),`systemctl enable --now`。前端 dist 用宿主 nginx serve(参考 `deploy/nginx.conf`,upstream 改为 `127.0.0.1:8084/8089`)。
|
||||||
|
|
||||||
|
## 三、待办(后续批次,见 A10 design)
|
||||||
|
- **W5**:PG/Flowable 迁移 runbook 在准生产真跑 + 回退验证(含 flowable 引擎库 DDL 置备)。
|
||||||
|
- **W6**:性能/并发基线 + nginx upstream 权重灰度切流(eip3↔eip4)。
|
||||||
|
|
||||||
|
> ✅ **残留收敛已完成(2026-06-25)**:与 `db/migration` 重复的 3 份 `bootstrap-*.sql`(page-schema/datastatus/ai-agent)已删;`ci.sh` 改指 `db/migration/V1`;`AiAgentDdlTest` 迁入 platform-app 守 V3;`SchemaImportCli` 内联 DDL 经 `PlatformMigrationDdlGuardTest` 钉死 ≡ V1。db/migration 为平台表 DDL 唯一真相。
|
||||||
|
|
||||||
|
## 验证状态(诚实记录,2026-06-25 本地真验)
|
||||||
|
- ✅ `docker build` 两镜像通过:`platform-app` 727MB / `flowable` 641MB(JRE21 + 非 root + COPY 预构建 jar)。
|
||||||
|
- ✅ **整栈 `docker compose up` 对内置空 postgres 真起**(本地 Docker daemon + PG 15.15):
|
||||||
|
- platform-app 在 **prod profile** 下启动,**W1 Flyway 在 Spring Boot 启动时自建 `eip3` schema 并应用 V1-V3**(9 张 sys_* 表,`flyway_schema_history` v1/v2/v3 全 success);`/actuator/health/readiness` = `{"status":"UP"}`。
|
||||||
|
- nginx 单源验证:`GET /` → 200 SPA;`/api/meta/entities` 经反代到 platform-app → **401**(prod 严格认证链生效,印证 P0 fail-safe 修复在运行态成立)。
|
||||||
|
- postgres-init 预建 schema 生效:`no schema has been selected` 报错消除。
|
||||||
|
- ⚠️ **flowable-service 在空演示库无法起**(by design):引擎 `databaseSchemaUpdate=false` 红线 → 不自建表,空 `flowable` schema 报 `flw_channel_definition does not exist`。生产用客户既有引擎库即正常;演示自洽需向 `postgres-init/` 追加 Flowable 6.8.1 DDL。
|
||||||
|
- ℹ️ 登录 `/api/auth/login` 在空演示库返 401 属预期(无客户 SYS_USER 数据);保真层业务端点同理需客户数据。
|
||||||
|
- 提示:`docker build` 前需先产 jar(步骤 1);`compose --build` 会自动 build。`.env` 已 gitignore(含密钥,勿入库)。
|
||||||
83
deploy/docker-compose.yml
Normal file
83
deploy/docker-compose.yml
Normal file
@@ -0,0 +1,83 @@
|
|||||||
|
# EIP4 生产编排骨架(A10 W4)。四服务:nginx 单源 + platform-app + flowable-service + postgres。
|
||||||
|
#
|
||||||
|
# 用法(见 deploy/README.md):
|
||||||
|
# 1) 先产 jar: mvn -pl platform-app,flowable-service -am package -DskipTests
|
||||||
|
# 2) 先产前端: (cd ../../eip4-web && npm ci && npm run build) # 生成 eip4-web/dist
|
||||||
|
# 3) 配 .env: cp deploy/.env.example deploy/.env && 改强随机密钥/DB
|
||||||
|
# 4) 起栈: docker compose -f deploy/docker-compose.yml --env-file deploy/.env up -d --build
|
||||||
|
#
|
||||||
|
# 边界(见 A10 design D2/D6):保真层跑【客户既有 eip3 库】,生产请把 EIP4_DB_URL 指向客户 PG;
|
||||||
|
# 下面的 postgres 服务仅自测/演示用(空库)。平台表(sys_*)由 platform-app 的 W1 Flyway
|
||||||
|
# 在启动时自建(含自建 eip3 schema);flowable 的 Liquibase 不自建 schema,故演示库经
|
||||||
|
# postgres-init/ 预建 eip3+flowable 两 schema(见该脚本注释)。生产指客户库时无需这些。
|
||||||
|
services:
|
||||||
|
postgres: # D6:仅自测演示;生产用客户 PG,把 EIP4_DB_URL 指过去并删本服务
|
||||||
|
image: postgres:15
|
||||||
|
environment:
|
||||||
|
POSTGRES_USER: ${POSTGRES_USER:-eip4}
|
||||||
|
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-eip4}
|
||||||
|
POSTGRES_DB: ${POSTGRES_DB:-eip4}
|
||||||
|
volumes:
|
||||||
|
- pgdata:/var/lib/postgresql/data
|
||||||
|
- ./postgres-init:/docker-entrypoint-initdb.d:ro # 首次初始化预建 eip3+flowable schema
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-eip4}"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 5s
|
||||||
|
retries: 12
|
||||||
|
networks: [eip4]
|
||||||
|
|
||||||
|
platform-app:
|
||||||
|
build:
|
||||||
|
context: ../platform-app
|
||||||
|
environment:
|
||||||
|
SPRING_PROFILES_ACTIVE: prod
|
||||||
|
SERVER_PORT: 8084
|
||||||
|
EIP4_AUTH_JWT_SECRET: ${EIP4_AUTH_JWT_SECRET} # 强制(application-prod.yml 无默认,缺失 fail-fast)
|
||||||
|
EIP4_DB_URL: ${EIP4_DB_URL}
|
||||||
|
EIP4_DB_USERNAME: ${EIP4_DB_USERNAME}
|
||||||
|
EIP4_DB_PASSWORD: ${EIP4_DB_PASSWORD}
|
||||||
|
EIP4_FILE_ROOT: /data/files
|
||||||
|
volumes:
|
||||||
|
- filedata:/data/files
|
||||||
|
depends_on:
|
||||||
|
postgres:
|
||||||
|
condition: service_healthy
|
||||||
|
networks: [eip4]
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
flowable-service:
|
||||||
|
build:
|
||||||
|
context: ../flowable-service
|
||||||
|
environment:
|
||||||
|
SERVER_PORT: 8089
|
||||||
|
# flowable-service 双数据源(env 驱动):ACT_ 引擎库 + biz 客户库(候选人解析直查组织表)
|
||||||
|
FLOWABLE_JDBC_URL: ${FLOWABLE_JDBC_URL}
|
||||||
|
FLOWABLE_JDBC_USER: ${FLOWABLE_JDBC_USER}
|
||||||
|
FLOWABLE_JDBC_PASS: ${FLOWABLE_JDBC_PASS}
|
||||||
|
BIZ_JDBC_URL: ${BIZ_JDBC_URL}
|
||||||
|
BIZ_JDBC_USER: ${BIZ_JDBC_USER}
|
||||||
|
BIZ_JDBC_PASS: ${BIZ_JDBC_PASS}
|
||||||
|
depends_on:
|
||||||
|
postgres:
|
||||||
|
condition: service_healthy
|
||||||
|
networks: [eip4]
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
nginx: # 单源:serve 前端 dist + 反代 /api、/flowable
|
||||||
|
image: nginx:alpine
|
||||||
|
ports:
|
||||||
|
- "${HTTP_PORT:-80}:80"
|
||||||
|
volumes:
|
||||||
|
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
||||||
|
- ${WEB_DIST:-../../eip4-web/dist}:/usr/share/nginx/html:ro
|
||||||
|
depends_on: [platform-app, flowable-service]
|
||||||
|
networks: [eip4]
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
volumes:
|
||||||
|
pgdata:
|
||||||
|
filedata:
|
||||||
|
|
||||||
|
networks:
|
||||||
|
eip4:
|
||||||
48
deploy/nginx.conf
Normal file
48
deploy/nginx.conf
Normal file
@@ -0,0 +1,48 @@
|
|||||||
|
# EIP4 单源托管(A10 W3)。挂载为 nginx:alpine 的 /etc/nginx/conf.d/default.conf。
|
||||||
|
# 一个源:静态 SPA(eip4-web/dist)+ 反代 /api→platform-app(唯一后端入口)。
|
||||||
|
# flowable-service:8089 无鉴权,绝不经 nginx 对外(见下 /flowable/ 说明)。
|
||||||
|
# 消除 dev 的 vite proxy 依赖;切流灰度(W6)可在此用 upstream 权重双跑(eip3↔eip4)。
|
||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
server_name _;
|
||||||
|
|
||||||
|
# 附件上传/导出:放宽请求体上限(与保真层附件大小对齐,按需调)
|
||||||
|
client_max_body_size 50m;
|
||||||
|
|
||||||
|
gzip on;
|
||||||
|
gzip_types text/css application/javascript application/json image/svg+xml;
|
||||||
|
gzip_min_length 1024;
|
||||||
|
|
||||||
|
# 后端 REST(现代层 + 保真层引擎)
|
||||||
|
location /api/ {
|
||||||
|
proxy_pass http://platform-app:8084;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Real-IP $remote_addr;
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_set_header X-Forwarded-Proto $scheme;
|
||||||
|
proxy_read_timeout 130s; # 略大于 statement_timeout(120s),避免反代先于 DB 超时切断
|
||||||
|
}
|
||||||
|
|
||||||
|
# 🔴 工作流引擎(flowable-service:8089)绝不对外暴露。
|
||||||
|
# flowable-service 进程无 Spring Security,鉴权唯一落点=platform-app 网关的超管门
|
||||||
|
# (ProcessModelerController.requireSuperAdmin);裸直达 8089 会绕过所有鉴权,
|
||||||
|
# 匿名即可部署/覆盖生产 BPMN、办结/终止任意任务(安全评审 Critical#1)。
|
||||||
|
# 前端只经 /api/workflow/*(网关)访问流程能力,不需要 /flowable/ 直达。
|
||||||
|
# 若确需内网调试直达,改为 `internal;` 仅供内部子请求,严禁对公网 proxy_pass。
|
||||||
|
location /flowable/ {
|
||||||
|
return 404;
|
||||||
|
}
|
||||||
|
|
||||||
|
# 静态资源:带 hash 的构建产物可长缓存
|
||||||
|
location /assets/ {
|
||||||
|
root /usr/share/nginx/html;
|
||||||
|
expires 7d;
|
||||||
|
add_header Cache-Control "public, immutable";
|
||||||
|
}
|
||||||
|
|
||||||
|
# SPA:其余路由回退 index.html(amis 前端 history 路由)
|
||||||
|
location / {
|
||||||
|
root /usr/share/nginx/html;
|
||||||
|
try_files $uri $uri/ /index.html;
|
||||||
|
}
|
||||||
|
}
|
||||||
12
deploy/postgres-init/01-create-schemas.sql
Normal file
12
deploy/postgres-init/01-create-schemas.sql
Normal file
@@ -0,0 +1,12 @@
|
|||||||
|
-- 内置 postgres 演示服务初始化(A10 W4)。仅在数据卷首次初始化时由
|
||||||
|
-- postgres 镜像的 /docker-entrypoint-initdb.d 自动执行一次。
|
||||||
|
--
|
||||||
|
-- 为何需要:.env.example 把 EIP4_DB_URL / FLOWABLE_JDBC_URL / BIZ_JDBC_URL 指向
|
||||||
|
-- currentSchema=eip3 与 currentSchema=flowable。platform-app 的 Flyway 会自建 eip3
|
||||||
|
-- 并落平台表;但 flowable-service 的 Liquibase 架构管理器【不会自建 schema】,
|
||||||
|
-- 缺失即报 "no schema has been selected to create in" 启动崩溃。故演示库在此预建两 schema。
|
||||||
|
--
|
||||||
|
-- 生产边界(见 A10 design D2/D6):生产把这些 URL 指向【客户既有 PG】,
|
||||||
|
-- 其 eip3/flowable schema 已存在,无需本脚本;本脚本仅服务内置演示 postgres。
|
||||||
|
CREATE SCHEMA IF NOT EXISTS eip3;
|
||||||
|
CREATE SCHEMA IF NOT EXISTS flowable;
|
||||||
19
deploy/systemd/eip4-flowable.service
Normal file
19
deploy/systemd/eip4-flowable.service
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
# EIP4 flowable-service systemd 单元(A10 W4·D3 兜底)。
|
||||||
|
# 安装同 eip4-platform.service:jar→/opt/eip4/flowable-service.jar,env→/etc/eip4/flowable.env。
|
||||||
|
[Unit]
|
||||||
|
Description=EIP4 flowable-service
|
||||||
|
After=network-online.target
|
||||||
|
Wants=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
User=eip4
|
||||||
|
Group=eip4
|
||||||
|
EnvironmentFile=/etc/eip4/flowable.env
|
||||||
|
Environment=SPRING_PROFILES_ACTIVE=prod
|
||||||
|
ExecStart=/usr/bin/java -jar /opt/eip4/flowable-service.jar
|
||||||
|
SuccessExitStatus=143
|
||||||
|
Restart=on-failure
|
||||||
|
RestartSec=5
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
27
deploy/systemd/eip4-platform.service
Normal file
27
deploy/systemd/eip4-platform.service
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
# EIP4 platform-app systemd 单元(A10 W4·D3 兜底:禁 Docker 的客户用裸 jar + systemd)。
|
||||||
|
# 安装:
|
||||||
|
# sudo cp platform-app/target/platform-app-*.jar /opt/eip4/platform-app.jar
|
||||||
|
# sudo install -d -o eip4 -g eip4 /opt/eip4 /var/lib/eip4/files
|
||||||
|
# sudo cp deploy/.env.example /etc/eip4/platform.env # 改成真值,chmod 600
|
||||||
|
# sudo cp deploy/systemd/eip4-platform.service /etc/systemd/system/
|
||||||
|
# sudo systemctl daemon-reload && sudo systemctl enable --now eip4-platform
|
||||||
|
[Unit]
|
||||||
|
Description=EIP4 platform-app
|
||||||
|
After=network-online.target
|
||||||
|
Wants=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
User=eip4
|
||||||
|
Group=eip4
|
||||||
|
# /etc/eip4/platform.env 提供 EIP4_AUTH_JWT_SECRET / EIP4_DB_* / SERVER_PORT 等(chmod 600)
|
||||||
|
EnvironmentFile=/etc/eip4/platform.env
|
||||||
|
Environment=SPRING_PROFILES_ACTIVE=prod
|
||||||
|
Environment=EIP4_FILE_ROOT=/var/lib/eip4/files
|
||||||
|
# JDK21 路径按宿主调整
|
||||||
|
ExecStart=/usr/bin/java -jar /opt/eip4/platform-app.jar
|
||||||
|
SuccessExitStatus=143
|
||||||
|
Restart=on-failure
|
||||||
|
RestartSec=5
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=multi-user.target
|
||||||
178
docs/AI_AGENT_AUTO_DEVELOPMENT.md
Normal file
178
docs/AI_AGENT_AUTO_DEVELOPMENT.md
Normal file
@@ -0,0 +1,178 @@
|
|||||||
|
> 📌 **现状以总览为准(2026-06-21)**:正文若称「只覆盖最简单 CRUD recipe」已过时——现已有 maintenance-crud / tree-crud / master-detail-v1 多类 recipe。**对外口径红线仍有效**(AI 辅助 + 人审、非全自动开发)。进度见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B2。
|
||||||
|
|
||||||
|
# AI Agent 辅助开发运行说明(生成草稿 + 本地验证 + 人工复核发布)
|
||||||
|
|
||||||
|
> **能力边界(对外口径,红线)**:本能力是「**AI 辅助生成草稿 + 人工复核发布**」,**不是** AI 全自动开发。当前只覆盖最简单的 CRUD recipe,存量复杂场景未取得数据;按《EIP3架构决策会纪要》红线,**严禁在报价/合同中承诺「AI 全自动开发 / 人力大幅下降」**。线上变更一律输出人工部署包、由人工复核后发布。
|
||||||
|
|
||||||
|
`platform-ai` 的辅助开发入口是 `POST /api/ai/features/auto-develop`。它只在本地环境执行草稿生成、本地落库、smoke 和自动修复;线上变更只输出人工部署包,不连接线上环境执行,须人工复核后发布。
|
||||||
|
|
||||||
|
## 本地运行配置
|
||||||
|
|
||||||
|
`local` 和 `dev` profile 已开启 JDBC 持久化:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
eip4:
|
||||||
|
ai:
|
||||||
|
store: jdbc
|
||||||
|
```
|
||||||
|
|
||||||
|
平台表(`sys_ai_task`、`sys_ai_draft`、`sys_ai_change_set`、`sys_ai_run`、`sys_ai_feature_package`、`sys_ai_revision`、`sys_ai_audit_log`)由 **W1 Flyway 在启动时幂等建表**——单一真相 `platform-app/src/main/resources/db/migration/V3__sys_ai_agent.sql`(A10 W1 收敛后取代原 `spring.sql.init` + 已删的 `bootstrap-ai-agent.sql`)。因此本地启动即用 JDBC 持久化开发证据;默认 profile 不强制写远端验证库,避免误把开发证据写到共享环境。
|
||||||
|
|
||||||
|
建议使用独立 worktree 做 Agent 功能开发,避免占用当前任务目录:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git worktree add ../eip4-platform-ai-agent -b ai/agent-dev
|
||||||
|
cd ../eip4-platform-ai-agent
|
||||||
|
```
|
||||||
|
|
||||||
|
运行态验证要先构建依赖模块并启动重新打包后的 jar,避免 `spring-boot:run -pl platform-app` 读取本地 Maven 仓库里的旧 `platform-ai`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
|
||||||
|
/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local
|
||||||
|
```
|
||||||
|
|
||||||
|
## 请求示例
|
||||||
|
|
||||||
|
推荐优先使用 `platform-cli`,让 Agent 通过稳定命令入口操作自动开发链路:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mvn -pl platform-cli package
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||||
|
--base-url http://localhost:8093 \
|
||||||
|
--objective "新增客户等级维护功能" \
|
||||||
|
--feature-name "客户等级维护" \
|
||||||
|
--table-name EIP4AI_CUSTOMER_LEVEL \
|
||||||
|
--entity-name "客户等级" \
|
||||||
|
--template-id eip4ai-customer-level \
|
||||||
|
--menu-name "客户等级维护" \
|
||||||
|
--field NAME:名称:string:100:true \
|
||||||
|
--field CODE:编码:string:64:true \
|
||||||
|
--field ENABLED:启用:boolean::false \
|
||||||
|
--page-recipe maintenance-crud-v1 \
|
||||||
|
--max-repair-attempts 2 \
|
||||||
|
--output target/ai-runs/customer-level.json
|
||||||
|
```
|
||||||
|
|
||||||
|
树形维护页使用 `tree-crud-v1`。如果字段列表没有显式提供 `PARENTID`,生成器会自动补一个父级字段,
|
||||||
|
页面使用 `/api/entity/{table}/tree?parentKey=PARENTID&idKey={table}_ID&perPage=2000`
|
||||||
|
作为树数据接口,并把 `PARENTID` 从树列表列中隐藏:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||||
|
--base-url http://localhost:8093 \
|
||||||
|
--objective "新增组织分类树形维护功能" \
|
||||||
|
--feature-name "组织分类维护" \
|
||||||
|
--table-name EIP4AI_ORG_CATEGORY \
|
||||||
|
--entity-name "组织分类" \
|
||||||
|
--template-id eip4ai-org-category \
|
||||||
|
--menu-name "组织分类维护" \
|
||||||
|
--field NAME:名称:string:100:true \
|
||||||
|
--field CODE:编码:string:64:true \
|
||||||
|
--page-recipe tree-crud-v1 \
|
||||||
|
--max-repair-attempts 2 \
|
||||||
|
--output target/ai-runs/org-category-tree.json
|
||||||
|
```
|
||||||
|
|
||||||
|
本地门禁通过后,可以把最终变更包封装成功能包快照,并保存一个里程碑 revision:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package \
|
||||||
|
--base-url http://localhost:8093 \
|
||||||
|
--task-id ait-xxx \
|
||||||
|
--change-set-id aics-xxx \
|
||||||
|
--output target/ai-runs/customer-level-package.json
|
||||||
|
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai revision \
|
||||||
|
--base-url http://localhost:8093 \
|
||||||
|
--task-id ait-xxx \
|
||||||
|
--package-id aipkg-xxx \
|
||||||
|
--note "本地门禁通过,待人工部署" \
|
||||||
|
--output target/ai-runs/customer-level-revision.json
|
||||||
|
```
|
||||||
|
|
||||||
|
底层 REST API 仍可直接调用:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST http://localhost:8093/api/ai/features/auto-develop \
|
||||||
|
-H 'Content-Type: application/json' \
|
||||||
|
-d '{
|
||||||
|
"baseUrl": "http://localhost:8093",
|
||||||
|
"generateDeploymentPackage": true,
|
||||||
|
"maxRepairAttempts": 2,
|
||||||
|
"feature": {
|
||||||
|
"objective": "新增客户等级维护功能",
|
||||||
|
"featureName": "客户等级维护",
|
||||||
|
"tableName": "EIP4AI_CUSTOMER_LEVEL",
|
||||||
|
"entityName": "客户等级",
|
||||||
|
"templateId": "eip4ai-customer-level",
|
||||||
|
"menuName": "客户等级维护",
|
||||||
|
"pageRecipe": "maintenance-crud-v1",
|
||||||
|
"fields": [
|
||||||
|
{"column": "NAME", "label": "名称", "type": "string", "length": 100, "required": true},
|
||||||
|
{"column": "CODE", "label": "编码", "type": "string", "length": 64, "required": true},
|
||||||
|
{"column": "ENABLED", "label": "启用", "type": "boolean", "required": false}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}'
|
||||||
|
```
|
||||||
|
|
||||||
|
`maxRepairAttempts` 可省略,默认 2;设为 0 时只跑首轮开发和本地门禁,失败后由调用方手动调用 repair 接口。
|
||||||
|
|
||||||
|
## 自动链路
|
||||||
|
|
||||||
|
1. 创建 `AiTask`。
|
||||||
|
2. 读取 `/api/ai/page-recipes` 中的 EIP4 页面 recipe,确认当前页面类型的 UI/UE 约束。
|
||||||
|
3. 生成 `ENTITY`、`PAGE_SCHEMA`、`SERVICEFLOW`、`MENU`、`TEST` 草稿。`PAGE_SCHEMA`
|
||||||
|
先生成 EIP4 PageBlueprint,再由平台编译器输出 amis schema;草稿 metadata 保留 blueprint 证据。
|
||||||
|
未指定 `feature.pageRecipe` 时默认使用 `maintenance-crud-v1`;树形维护页应指定 `tree-crud-v1`。
|
||||||
|
4. 对草稿执行基础门禁,包括 page-recipe、amis schema、typed page schema、服务流 XML、实体字段、smoke 计划和 render plan。
|
||||||
|
5. 生成待人审 `AiChangeSet`。
|
||||||
|
6. 生成 release plan。
|
||||||
|
7. 本地 apply:实体走本机 `/api/meta/entity`,页面/服务流写本地库;如果本地最小库缺少 `sys_menu`,菜单发布标记为 `SKIPPED`,不阻断本地 gate,部署包仍保留菜单 SQL 供线上人审。
|
||||||
|
8. 本地 smoke:只允许 `localhost`、`127.0.0.1`、`::1` baseUrl;HTTP 状态必须匹配,且 JSON 响应体存在 `status` 时必须为 0。
|
||||||
|
`TEST` 草稿同时包含 `renderTests`,给 Playwright 渲染验收提供 recipe、schemaUrl、previewUrl、预期组件、CRUD 名、数据 API、列、动作和关键文本。
|
||||||
|
9. 若失败,自动生成 repair plan 并执行修复重试。
|
||||||
|
10. 生成线上人工部署包,包含 manifest、SQL 草案、回滚 SQL 和本地执行证据。
|
||||||
|
11. 可选:生成功能包快照并保存 revision,用于后续导出、差异比较和回滚扩展。
|
||||||
|
|
||||||
|
返回体中的关键字段:
|
||||||
|
|
||||||
|
- `originalChangeSetId`: 首轮自动生成的变更包。
|
||||||
|
- `changeSetId`: 最终用于部署包的变更包;如果修复生成了替代草稿,可能不同于 `originalChangeSetId`。
|
||||||
|
- `repairExecutions`: 每轮自动修复证据。
|
||||||
|
- `deploymentPackage.requiresHumanApproval`: 固定为 `true`,线上发布必须人工审批。
|
||||||
|
|
||||||
|
## 功能包和 revision
|
||||||
|
|
||||||
|
P2 第一版新增功能包快照和里程碑版本:
|
||||||
|
|
||||||
|
- `POST /api/ai/tasks/{taskId}/change-sets/{changeSetId}/feature-package`
|
||||||
|
- `GET /api/ai/tasks/{taskId}/feature-packages`
|
||||||
|
- `POST /api/ai/tasks/{taskId}/feature-packages/{packageId}/revisions`
|
||||||
|
- `GET /api/ai/tasks/{taskId}/revisions`
|
||||||
|
|
||||||
|
功能包封装部署包、manifest、本地 evidence、SQL 草案和回滚 SQL。revision 当前保存功能包 JSON 快照,作为后续差异比较和回滚执行的基础。生产执行仍不自动化,必须人审。
|
||||||
|
|
||||||
|
## LLM 修复
|
||||||
|
|
||||||
|
默认使用确定性修复规则。需要外部 LLM 参与时设置:
|
||||||
|
|
||||||
|
```properties
|
||||||
|
EIP4_AI_LLM_REPAIR_ENABLED=true
|
||||||
|
EIP4_AI_LLM_REPAIR_ENDPOINT=http://127.0.0.1:18081/ai-agent/repair
|
||||||
|
EIP4_AI_LLM_REPAIR_API_KEY=...
|
||||||
|
EIP4_AI_LLM_REPAIR_MODEL=...
|
||||||
|
```
|
||||||
|
|
||||||
|
外部服务契约见 `docs/AI_AGENT_REPAIR_CONTRACT.md`。LLM 只能返回草稿补丁,不能要求平台执行生产命令。
|
||||||
|
|
||||||
|
## 线上边界
|
||||||
|
|
||||||
|
可靠路径是:本地 `auto-develop` 通过后,人工检查部署包,再由现有发布流程上线。功能上线后如果发现 bug,Agent 可以基于线上错误日志、导出的 run evidence 或人工复现结果生成新的本地任务并修复,但仍应先在本地验证,再输出人工部署包。
|
||||||
|
|
||||||
|
## 当前验证结论与遗留项
|
||||||
|
|
||||||
|
已在 `local` profile 验证完整自动开发链路:实体创建、默认服务流发布、页面 schema 发布、实体列表/树列表、默认搜索流和新增数据 smoke 均通过,最终状态为 `READY_FOR_HUMAN_REVIEW`。`local` 最小库没有菜单表,因此菜单 apply 为 `SKIPPED`,这是预期的本地边界。
|
||||||
|
|
||||||
|
遗留项是全局 metadata 辅助读路径仍有部分 SQL 写死 `eip3.` schema;在 `local/eip4m0` 下会出现非阻断 warning。AI 主链路已规避/修正必要路径,后续如果要让所有后台辅助解析在 `local` 最小库完全无噪声,需要单独做一次 schema 兼容清理。
|
||||||
215
docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md
Normal file
215
docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md
Normal file
@@ -0,0 +1,215 @@
|
|||||||
|
# AI Agent 借鉴 NocoBase 的落地路线
|
||||||
|
|
||||||
|
日期:2026-06-17
|
||||||
|
|
||||||
|
本文记录 EIP4 对 NocoBase AI + no-code 体系的可借鉴点和落地顺序。目标不是照搬 NocoBase 的 TypeScript 插件运行时,而是吸收它的工程边界:核心平台稳定、业务能力包化、AI 通过受控 CLI/API 操作、所有变更可审计、可验证、可回滚。
|
||||||
|
|
||||||
|
参考:
|
||||||
|
|
||||||
|
- NocoBase README: https://github.com/nocobase/nocobase
|
||||||
|
- NocoBase Plugin Development: https://docs.nocobase.com/plugin-development/
|
||||||
|
- NocoBase Project Structure: https://docs.nocobase.com/plugin-development/project-structure
|
||||||
|
- NocoBase AI Builder: https://docs.nocobase.com/ai-builder/
|
||||||
|
- NocoBase AI Plugin Development: https://docs.nocobase.com/ai-dev/
|
||||||
|
- NocoBase CLI: https://docs.nocobase.com/api/cli/
|
||||||
|
- NocoBase Skills: https://github.com/nocobase/skills
|
||||||
|
|
||||||
|
## 一、判断
|
||||||
|
|
||||||
|
NocoBase 最核心的启发是:AI 不应该默认直接写一堆业务代码,而是基于平台已有的可配置能力工作。AI 负责把自然语言需求转换为数据模型、页面配置、工作流、权限和发布包,人负责审核关键边界。
|
||||||
|
|
||||||
|
EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署包这些受控对象,因此更适合走“AI 操作元数据和发布包”的路线,而不是引入一套新的插件运行时。
|
||||||
|
|
||||||
|
## 二、可借鉴点
|
||||||
|
|
||||||
|
| NocoBase 做法 | EIP4 对应落点 | 处理方式 |
|
||||||
|
|---|---|---|
|
||||||
|
| AI 基于 no-code 基础设施工作 | `platform-ai` 生成实体/页面/服务流/菜单草稿 | 已落地,继续收敛到受控接口 |
|
||||||
|
| CLI 作为 Agent 操作入口 | `platform-cli` | P1 建立,后续扩展环境/发布/回滚 |
|
||||||
|
| Skills 让 Agent 理解平台 | `docs/skills/` | P1 建立规范骨架 |
|
||||||
|
| 插件生命周期 | EIP4 `FeaturePackage` 生命周期 | P2 设计和持久化 |
|
||||||
|
| 版本控制/里程碑回滚 | `SYS_AI_REVISION` / release evidence | P2-P3 |
|
||||||
|
| FlowEngine 的可配置模型 | EIP4 typed page schema + component registry | P4 借鉴思想,不照搬实现 |
|
||||||
|
|
||||||
|
## 三、落地顺序
|
||||||
|
|
||||||
|
### P0:AI 辅助开发主链路(人工复核发布)
|
||||||
|
|
||||||
|
状态:已完成。
|
||||||
|
|
||||||
|
完成内容:
|
||||||
|
|
||||||
|
- `POST /api/ai/features/auto-develop`
|
||||||
|
- 草稿生成、变更包、release plan、本地 apply、smoke、自动修复、人工部署包
|
||||||
|
- JDBC 审计和运行证据
|
||||||
|
- 本地 jar 验证通过
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- 本地可从一段功能需求生成可审核部署包
|
||||||
|
- 线上执行仍停在人审边界
|
||||||
|
|
||||||
|
### P1:受控入口和 Agent 知识包
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- 建立 `platform-cli`,让 Agent 通过命令调用 EIP4,而不是直接猜 HTTP 接口或直连数据库。
|
||||||
|
- 建立 `docs/skills/`,把 EIP4 的环境管理、自动开发、发布管理写成 Agent 可复用的操作规程。
|
||||||
|
|
||||||
|
本阶段交付:
|
||||||
|
|
||||||
|
- `eip4 env status`
|
||||||
|
- `eip4 ai auto-develop`
|
||||||
|
- `docs/skills/eip4-env-manage.md`
|
||||||
|
- `docs/skills/eip4-ai-feature-development.md`
|
||||||
|
- `docs/skills/eip4-release-manage.md`
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- CLI 单测覆盖命令解析和请求组装
|
||||||
|
- README 和自动开发文档给出 CLI 用法
|
||||||
|
- Agent 后续操作优先引用 Skills 和 CLI
|
||||||
|
|
||||||
|
### P2:FeaturePackage 和里程碑版本
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- 把 AI 生成结果从松散的 draft/change-set 升级为稳定的 `FeaturePackage`。
|
||||||
|
- 保存里程碑版本,支持本地回滚和线上部署前差异确认。
|
||||||
|
|
||||||
|
建议对象:
|
||||||
|
|
||||||
|
- `FeaturePackage`: manifest、entity、serviceflow、page schema、menu、acl、sql、rollback、smoke、evidence
|
||||||
|
- `SYS_AI_FEATURE_PACKAGE`
|
||||||
|
- `SYS_AI_REVISION`
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- 一个功能包可以导出、导入、重复校验
|
||||||
|
- 每个通过 smoke 的里程碑都能追溯输入、输出、测试证据和回滚脚本
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- `POST /api/ai/tasks/{taskId}/change-sets/{changeSetId}/feature-package`
|
||||||
|
- `GET /api/ai/tasks/{taskId}/feature-packages`
|
||||||
|
- `POST /api/ai/tasks/{taskId}/feature-packages/{packageId}/revisions`
|
||||||
|
- `GET /api/ai/tasks/{taskId}/revisions`
|
||||||
|
- `eip4 ai feature-package`
|
||||||
|
- `eip4 ai revision`
|
||||||
|
- `sys_ai_feature_package`
|
||||||
|
- `sys_ai_revision`
|
||||||
|
|
||||||
|
未完成项:
|
||||||
|
|
||||||
|
- 功能包导出/导入文件格式
|
||||||
|
- revision 差异比较
|
||||||
|
- 回滚执行编排
|
||||||
|
|
||||||
|
### P3:发布、回滚和环境治理
|
||||||
|
|
||||||
|
状态:进行中。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- CLI 扩展为环境管理和发布编排入口。
|
||||||
|
- 建立本地、测试、生产环境的只读探测、部署前检查和人工批准边界。
|
||||||
|
|
||||||
|
建议命令:
|
||||||
|
|
||||||
|
- `eip4 env list/use/status`
|
||||||
|
- `eip4 release package`
|
||||||
|
- `eip4 release verify`
|
||||||
|
- `eip4 release apply --require-approval`
|
||||||
|
- `eip4 release rollback-plan --package-file FILE --output FILE`
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- 默认不能连接线上执行写操作
|
||||||
|
- 生产写操作必须有显式环境、审批标记和部署包
|
||||||
|
- 发布失败能用结构化 evidence 回到本地修复链路
|
||||||
|
|
||||||
|
源码级修订:
|
||||||
|
|
||||||
|
- 参考 NocoBase `env/status.ts` 和 `env-guard.ts`,`platform-cli` 新增本地 env registry/current env。
|
||||||
|
- 参考 NocoBase revision 创建前检查版本控制插件的思路,EIP4 后续 revision restore/diff 不能只依赖 JSON 快照,必须有发布系统能力检查。
|
||||||
|
- 新增 `eip4 release verify --package-file FILE`,先做离线发布前门禁,阻断未替换占位符和缺失本地 evidence 的功能包。
|
||||||
|
- 新增 `eip4 release export/import-preview`,形成 `.eip4pkg.json` 文件格式和 checksum 门禁;导入预览不写环境、不启用功能。
|
||||||
|
- 新增 `eip4 release diff/rollback-plan`,先落地离线差异检查和计划型回滚;回滚计划不执行生产 SQL。
|
||||||
|
- 详细源码对照见 `docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md`。
|
||||||
|
|
||||||
|
### P4:Typed Page Schema 和组件注册表
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- 借鉴 NocoBase FlowEngine 的“可配置模型”思想,把页面 block、field、action、linkage 抽象为 typed schema。
|
||||||
|
- 让 AI 和人工设计器操作同一份 schema。
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- 页面 schema 有版本、类型、组件能力表和校验器
|
||||||
|
- AI 只能选择注册过的组件和动作
|
||||||
|
- 设计器变更和 AI 变更能互相接续
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- `GET /api/page/schema/components` 下发组件能力表。
|
||||||
|
- `POST /api/page/schema/validate` 做 typed page schema 离线校验。
|
||||||
|
- `PUT /api/page/schema/{templateId}/overlay` 保存 overlay 前强制校验组件和 actionType。
|
||||||
|
- 当前仍是第一版 registry;后续要继续补 linkage/event/resource 和组件属性级 schema。
|
||||||
|
|
||||||
|
### P5:多 Agent 协作和 AI 员工
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- 在平台内提供面向业务用户的 AI 助手能力,而不只是在开发侧使用 Agent。
|
||||||
|
|
||||||
|
建议方向:
|
||||||
|
|
||||||
|
- 数据分析 Agent
|
||||||
|
- 表单配置 Agent
|
||||||
|
- 服务流诊断 Agent
|
||||||
|
- 权限风险审查 Agent
|
||||||
|
- 发布审计 Agent
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- 每个 Agent 有独立权限、审计、工具白名单
|
||||||
|
- 业务侧操作和开发侧操作共用平台审计模型
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- `GET /api/ai/tools` 下发工具注册表和 scope 要求。
|
||||||
|
- `GET /api/ai/employees` 下发 AI employee 定义。
|
||||||
|
- `POST /api/ai/tools/access-check` 统一检查 employee/tool/scope/targetEnv/productionWrite。
|
||||||
|
- 生产写默认阻断;当前只开放本地开发、校验、smoke、功能包和发布准备工具。
|
||||||
|
|
||||||
|
## 四、不照搬的部分
|
||||||
|
|
||||||
|
NocoBase 是 TypeScript/Yarn workspace/插件包体系。EIP4 是 Java/Spring/Maven,并且必须兼容 EIP3 的实体、服务流和 XML 模板迁移路径。直接照搬 NocoBase 插件运行时会引入过高迁移成本。
|
||||||
|
|
||||||
|
EIP4 应该借鉴的是边界和流程:
|
||||||
|
|
||||||
|
1. 稳定核心能力。
|
||||||
|
2. 业务功能包化。
|
||||||
|
3. Agent 通过 CLI/API 操作。
|
||||||
|
4. 人审控制生产变更。
|
||||||
|
5. 每一步有 evidence、版本和回滚。
|
||||||
|
|
||||||
|
## 五、当前推进状态
|
||||||
|
|
||||||
|
| 阶段 | 状态 | 说明 |
|
||||||
|
|---|---|---|
|
||||||
|
| P0 | 完成 | `platform-ai` 主链路已提交 |
|
||||||
|
| P1 | 第一版完成 | 已新增 `platform-cli` 和 Skills 规范骨架 |
|
||||||
|
| P2 | 第一版完成 | 已新增功能包快照、里程碑 revision、CLI 命令和持久化表 |
|
||||||
|
| P3 | 进行中 | 已完成 env registry/current env/cross-env guard/release verify/export/import-preview/diff/rollback-plan 第一版 |
|
||||||
|
| P4 | 第一版完成 | 已新增组件 registry、typed schema validator、校验 API 和 overlay 保存前门禁 |
|
||||||
|
| P5 | 第一版完成 | 已新增 AI tool registry、AI employee registry 和 access-check 门禁 |
|
||||||
152
docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md
Normal file
152
docs/AI_AGENT_Nocobase_INTEGRATION_GAP_AND_PLAN.md
Normal file
@@ -0,0 +1,152 @@
|
|||||||
|
# EIP4 对照 NocoBase 的 AI Agent 接入差距与补齐计划
|
||||||
|
|
||||||
|
日期:2026-06-22
|
||||||
|
|
||||||
|
本文回答一个具体问题:**外部 coding agent(Claude Code / Codex / Cursor / OpenCode)接入平台做开发这件事,EIP4 和 NocoBase 现在差在哪、要补什么。**
|
||||||
|
|
||||||
|
口径限定:只谈「外部 agent 驱动确定性开发」这条线(EIP4 称 ①面)。平台内置生成式 LLM(②面)受对外承诺红线约束,单列在「四、不做的部分」,本文不展开。
|
||||||
|
|
||||||
|
前序文档:
|
||||||
|
- `AI_AGENT_Nocobase_ADOPTION_PLAN.md`(2026-06-17 借鉴路线,P0–P5)
|
||||||
|
- `AI_AGENT_Nocobase_SOURCE_REVIEW.md`(2026-06-17 源码级对照)
|
||||||
|
- 本文是上述两份在「接入体验」维度的增量,已对齐 NocoBase 2026 现状(AI employees 加 Skills、新增 MCP server plugin)。
|
||||||
|
|
||||||
|
NocoBase 参考:
|
||||||
|
- AI Builder:https://docs.nocobase.com/ai-builder/
|
||||||
|
- Skills 仓库:https://github.com/nocobase/skills
|
||||||
|
- AI Employees / MCP:https://docs.nocobase.com/ai-employees/ ,https://docs.nocobase.com/ai-employees/features/mcp
|
||||||
|
- LLM Service:https://v2.docs.nocobase.com/ai-employees/features/llm-service
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 一、一句话结论
|
||||||
|
|
||||||
|
EIP4 和 NocoBase 的**核心判断一致**:AI 不从零生成代码,而是在已过生产验证的 no-code 底座上操作元数据/页面/流程,人审控制生产变更。EIP4 ①面 v1 已交付、骨架完整;**差距全在「接入体验」而非「架构方向」**:NocoBase 把接入做成了一键安装 + 标准 MCP 协议,EIP4 还停在「手动喂 md + agent 死记 CLI」。补齐这层,EIP4 的外部 agent 接入即可达到 NocoBase 同等顺滑度。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 二、现状对照(带证据)
|
||||||
|
|
||||||
|
### EIP4 已有的接入资产(基线)
|
||||||
|
|
||||||
|
| 资产 | 证据 | 状态 |
|
||||||
|
|---|---|---|
|
||||||
|
| 确定性生成主链路 | `platform-ai/.../service/AiFeatureDraftGenerator.java`、`AiAgentService.java`、`AiLocalReleaseExecutor.java` | ✅ 已合 main |
|
||||||
|
| CLI(可运行 jar) | `platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar`;命令族 `env` / `ai` / `release` | ✅ |
|
||||||
|
| Skills 规程 | `docs/skills/`:`README.md` + `eip4-env-manage` + `eip4-ai-feature-development` + `eip4-release-manage` | ⚠️ 仅 4 个,且只是仓库文档 |
|
||||||
|
| REST API | `/api/ai/*`、`/api/design/*`、`/api/meta/*`、`/api/page/schema/{components,validate,overlay}` | ✅ |
|
||||||
|
| Typed schema 门禁 | `POST /api/page/schema/validate`、overlay 保存前强制校验 | ✅ |
|
||||||
|
| AI 工具/权限注册表 | `GET /api/ai/tools`、`/api/ai/employees`、`POST /api/ai/tools/access-check` | ✅(注册表层,非运行时调度)|
|
||||||
|
| 人审红线 | `AiDeploymentPackage.requiresHumanApproval=true`、状态恒 `READY_FOR_HUMAN_REVIEW` | ✅ |
|
||||||
|
| 版本/回滚 | `eip4 ai revision`、`eip4 release rollback-plan`(只生成计划不执行)| ✅ |
|
||||||
|
|
||||||
|
### EIP4 CLI 命令清单(核实自 `Eip4Cli.java`)
|
||||||
|
|
||||||
|
```
|
||||||
|
eip4 env add | list | use | current | status
|
||||||
|
eip4 ai auto-develop | feature-package | revision
|
||||||
|
eip4 release diff | export | import-preview | rollback-plan | verify
|
||||||
|
```
|
||||||
|
**注意:没有 `init`,也没有 `skills install/check/update`。** 这是和 NocoBase 的关键体验差。
|
||||||
|
|
||||||
|
### 逐项对照
|
||||||
|
|
||||||
|
| 维度 | NocoBase(2026 现状) | EIP4(现状) | 差距 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 核心理念:AI 在 no-code 底座工作、不从零生成 | ✅ | ✅ | 无(同源)|
|
||||||
|
| 外部 agent 接入门槛 | `nb init --ui` **自动安装 ~13 个 Skills**,`cd && claude` 直连 | 需人工把 `docs/skills/*.md` 复制/引用给 agent | **大** → G1 |
|
||||||
|
| Skills 覆盖面 | ~13:env / data-modeling / ui-builder / workflow / acl / plugin-manage / publish / revision / plugin-dev / data-analysis … | 4:env / ai-feature / release | **中** → G3 |
|
||||||
|
| Skills 安装与校验 | CLI 安装/检查/更新(`skills install`)| 无,纯仓库文档 | 中 → G3 |
|
||||||
|
| MCP server(外部 AI 用标准协议操作平台)| ✅ 已有 MCP server plugin(2026 新增)| ❌ 仅 `AiArtifactType.java:6` 一行注释 | **大** → G2 |
|
||||||
|
| CLI 命令族 | `nb` env/pm/revision/publish | `eip4` env/ai/release | 小(基本对齐)|
|
||||||
|
| 人审确认 | Skill Permission(Ask / Allow)| `READY_FOR_HUMAN_REVIEW` + `requiresHumanApproval` | 无(机制等价)|
|
||||||
|
| 版本/回滚 | `nb revision` | `eip4 ai revision` / `release rollback-plan` | 无 |
|
||||||
|
| 端口/连接配置一致性 | `nb init` 引导写入 | skills 文档写 `8084`,实际环境跑 `8093/8094` | **小但扎手** → G1 |
|
||||||
|
| 内置 LLM / AI employees(②面)| ✅ 接 OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama | ❌ 刻意不做(repair 钩子默认关)| 受红线约束 → 见「四」|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 三、补齐计划(按对外接入体验优先级)
|
||||||
|
|
||||||
|
### G1 — 一键接入体验(P0,最快见效)✅ 已完成(2026-06-22)
|
||||||
|
|
||||||
|
**问题**:接入要人工搬运 md + agent 不知道端口,第一步就劝退。
|
||||||
|
|
||||||
|
**做什么**:
|
||||||
|
1. 新增 `eip4 init`(或独立脚本 `scripts/install-skills.sh`),把 `docs/skills/*.md` 安装到各 agent 能自动读取的位置:
|
||||||
|
- Claude Code:`.claude/skills/`(或写入项目 `CLAUDE.md` 引用块)
|
||||||
|
- Codex:项目根 `AGENTS.md`
|
||||||
|
- OpenCode:其 agent 规则/上下文目录
|
||||||
|
2. 安装时把 skills 里的 `--base-url` 占位符**用当前 env registry 的 current env 渲染**(解决 `8084` vs `8093/8094` 不一致)。
|
||||||
|
3. 安装完打印「下一步:`cd <dir> && claude`」引导,对齐 NocoBase 体验。
|
||||||
|
|
||||||
|
**验收**:
|
||||||
|
- 一条命令后,新开 Claude Code 会话能识别 `eip4-ai-feature-development` skill,并据此跑通 `eip4 ai auto-develop` 产出 `READY_FOR_HUMAN_REVIEW` 包。
|
||||||
|
- skills 文档内端口与实际启动端口一致,agent 不再连错。
|
||||||
|
|
||||||
|
**成本**:小(1 个 CLI 子命令 + 文本渲染 + 端口统一)。
|
||||||
|
|
||||||
|
**落地(2026-06-22)**:`eip4 init` 已实现于 `platform-cli`(`Eip4Cli.runInit`),TDD 4 个新测试 + 原有共 19 单测全绿。配套:`docs/skills/*.md` 的 base URL 改为 `{{EIP4_BASE_URL}}` 占位符;新增 `platform-cli/src/main/resources/eip4-skills/manifest.json`(skill 清单 + name/description);`pom.xml` 用 maven-resources-plugin 把 `docs/skills` 打进 jar。真实 jar 端到端验证通过:`init` 产出 `.claude/skills/<name>/SKILL.md`(带 frontmatter)+ 根 `AGENTS.md`(`EIP4-SKILLS` 标记块,块外内容保留、可重复执行,且**内嵌每个 skill 渲染后全文**——Claude Code 用 `.claude/skills/` 原生 skill,Codex/OpenCode 读 `AGENTS.md` 即得完整规程,三工具全覆盖),base URL 按 `--base-url`/`--env`/current env 渲染,零占位符残留。skills 随 jar 打包,`init` 默认从 classpath 读取,无需仓库在场。
|
||||||
|
|
||||||
|
### G2 — MCP server(P1,接入面标准化)✅ 已完成(2026-06-22)
|
||||||
|
|
||||||
|
**问题**:现在 agent 要靠 skill 文档「死记」CLI/REST 用法;NocoBase 已用 MCP 把能力做成可发现、可调用的标准工具。
|
||||||
|
|
||||||
|
**做什么**:起一个 **EIP4 MCP server** 最小骨架,把已有端点包成 MCP tools(stdio + streamable HTTP 两种 transport,对齐 NocoBase):
|
||||||
|
- `eip4.auto_develop` → `POST /api/ai/features/auto-develop`
|
||||||
|
- `eip4.list_page_recipes` → `GET /api/ai/page-recipes`
|
||||||
|
- `eip4.validate_page_schema` → `POST /api/page/schema/validate`
|
||||||
|
- `eip4.list_components` → `GET /api/page/schema/components`
|
||||||
|
- `eip4.access_check` → `POST /api/ai/tools/access-check`
|
||||||
|
- (只读)`eip4.list_entities` / `eip4.entity_attributes` → `/api/meta/*`
|
||||||
|
|
||||||
|
红线沿用:所有写工具走本地 env;生产写默认阻断;产物恒 `READY_FOR_HUMAN_REVIEW`。MCP 工具粒度 1:1 复用现有 `AiToolRegistry` 的 scope 与 `access-check`,不新开权限面。
|
||||||
|
|
||||||
|
**验收**:
|
||||||
|
- Claude Code / Codex 通过 MCP 连上后 `list tools` 能看到上述 eip4 工具。
|
||||||
|
- 通过 MCP 调 `eip4.auto_develop` 能产出待人审部署包,证据与 CLI 路径一致。
|
||||||
|
|
||||||
|
**成本**:中(一个独立 server 进程;建议先 stdio + 复用 REST,不重写业务)。
|
||||||
|
|
||||||
|
**落地(2026-06-22)**:新增 `platform-mcp` 模块(stdio MCP server,MCP Java SDK 1.1.0 / jackson2 路线)。`McpServer.sync(StdioServerTransportProvider).tools(...).build()`,注册 7 个工具:`eip4_auto_develop / list_page_recipes / validate_page_schema / list_components / access_check / list_entities / entity_attributes`,忠实转发 EIP4 REST,复用人审红线、不另开权限面。工具逻辑 TDD(`Eip4McpTools` 9 单测,注入 mock REST client);真实 stdio JSON-RPC e2e 通过:`initialize` 协商 + `tools/list` 返回 7 工具(inputSchema 正确解析)+ `tools/call` 链路(死端口优雅 isError)。坑:父 pom 为 amis 校验钉死 `networknt:json-schema-validator:1.5.2`,与 MCP 需要的 `2.0.0`(含 `dialect.Dialects`)冲突 → 在 platform-mcp 显式覆盖 2.0.0(仅本模块)。接入:`claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url <env>`。
|
||||||
|
|
||||||
|
### G3 — Skills 覆盖面 + 安装/检查(P1)✅ 基本完成(2026-06-22,serviceflow 诊断暂缓)
|
||||||
|
|
||||||
|
**问题**:4 个 skill 覆盖不到「建模/选 recipe/权限/服务流诊断」等高频动作,agent 仍要猜。
|
||||||
|
|
||||||
|
**做什么**:
|
||||||
|
1. 补 skills(对标 NocoBase 但只覆盖 EIP4 真实能力,不照搬不存在的功能):
|
||||||
|
- `eip4-data-modeling`(建实体/字段/引用列,映射 `/api/meta/entity`)
|
||||||
|
- `eip4-page-recipe`(三种 recipe:maintenance-crud-v1 / tree-crud-v1 / master-detail-v1 的选用与字段约束)
|
||||||
|
- `eip4-acl-manage`(菜单授权/角色,映射 `/api/admin/*`)
|
||||||
|
- `eip4-serviceflow-diagnose`(默认流生成与排错)
|
||||||
|
2. 给 CLI 加 `eip4 skills list/check`,校验本地已安装 skill 版本与仓库是否一致。
|
||||||
|
|
||||||
|
**验收**:agent 不再询问「表怎么建 / recipe 怎么选 / 权限怎么配」即可独立完成一个新功能。
|
||||||
|
|
||||||
|
**成本**:中(主要是文档 + 一个 CLI 校验命令)。
|
||||||
|
|
||||||
|
**落地(2026-06-22)**:新增 3 个 skill(`eip4-data-modeling` / `eip4-page-recipe` / `eip4-acl-manage`,全部基于核实过的 `/api/meta/entity`、`/api/design/recipe/compile`、`/api/admin/*` 端点写就),manifest + jar 打包同步,`docs/skills` 现共 6 个。CLI 新增 `eip4 skills list`(列内置 skills)+ `eip4 skills check --dir`(检测目标项目已装/缺失,缺失退出非 0),TDD 2 新测试、platform-cli 共 22 单测全绿。真实验证:`skills list` 列 6 个、`init` 装 6 个、`skills check` 全 installed(exit 0)、新 skill 端口正确渲染零占位符残留。**`serviceflow-diagnose` 暂缓**:经源码核实平台没有「查看/诊断服务流定义」的 agent 可操作端点(仅能 `POST/GET /api/flow/{id}` 执行 + 看 FlowController 日志),需先补「查看流定义」端点才值得做,否则只能写出无法落地的规程。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 四、不做的部分(红线)
|
||||||
|
|
||||||
|
- **平台不内置生成式 LLM(②面)**:NocoBase 做了内置 AI employees + LLM Service(OpenAI/Claude/Gemini/DeepSeek/Qwen/Ollama)。EIP4 进程内唯一 LLM 是 `HttpAiLlmRepairClient`,`@ConditionalOnProperty(...repair.enabled,"true")` **默认关,且只修不生成**。是否立②面 = v1 之后的产品决策,本文不推进。
|
||||||
|
- **终点恒人审**:任何接入路径产物都停在 `READY_FOR_HUMAN_REVIEW`,生产写默认阻断。G1–G3 不得绕过该门禁。
|
||||||
|
- **对外口径**:限「AI 辅助、人工复核」;严禁承诺「AI 全自动开发 / 人力大幅下降」(决策会纪要商务条款③)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 五、建议执行顺序
|
||||||
|
|
||||||
|
1. **G1 一键接入**(P0,半天级):投入最小、最快让 claude code/codex 真正能用上 EIP4。
|
||||||
|
2. **G2 MCP server 最小骨架**(P1):把接入面标准化,去掉「agent 死记用法」。
|
||||||
|
3. **G3 Skills 补全**(P1,可与 G2 并行):提升 agent 自主完成度。
|
||||||
|
4. ②面(内置 LLM)维持观望,待产品对红线拍板。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 六、与既有路线图的关系
|
||||||
|
|
||||||
|
本文 G1–G3 落在 `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 的 P1(受控入口/Skills)与 P5(MCP 白名单)之间,是把当时「第一版完成」的接入层提升到 NocoBase 2026 的体验基线。`SOURCE_REVIEW.md` P5 未完成项明确列了「MCP 工具白名单」「Skills CLI check/update」——本文 G2/G3 即其落地化。进度以 `项目进度与路线-总览-2026-06-21.md` 为准,落地后回写该总览。
|
||||||
138
docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md
Normal file
138
docs/AI_AGENT_Nocobase_SOURCE_REVIEW.md
Normal file
@@ -0,0 +1,138 @@
|
|||||||
|
> 📌 **现状以总览为准(2026-06-21)**:本文系修订前快照,P3 等进度表述前后不一致(P3-1「进行中」vs P3-2/P4/P5「第一版完成」);AI 确定性五环生产线已合 main。以 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B2 + `AI_AGENT_Nocobase_ADOPTION_PLAN.md` 为准。
|
||||||
|
|
||||||
|
# NocoBase 源码级对照和 EIP4 修订
|
||||||
|
|
||||||
|
日期:2026-06-17
|
||||||
|
|
||||||
|
本文件补充 `docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md` 的源码级依据。结论:EIP4 不照搬 NocoBase 的 TypeScript 插件运行时,但 P3 之后必须参考它的 CLI/env/revision/skills/tool-registry 边界,否则容易只做出“HTTP wrapper”,做不到可持续的 Agent 开发体系。
|
||||||
|
|
||||||
|
## 一、已抽样源码
|
||||||
|
|
||||||
|
| 主题 | NocoBase 源码 | 对 EIP4 的影响 |
|
||||||
|
|---|---|---|
|
||||||
|
| CLI env status | `packages/core/cli/src/commands/env/status.ts` | CLI 要有 env registry/current env/status,不应只靠 `--base-url` |
|
||||||
|
| 跨 env 确认 | `packages/core/cli/src/lib/env-guard.ts` | 显式选择非当前 env 时需要确认边界 |
|
||||||
|
| API client | `packages/core/cli/src/lib/api-client.ts` | CLI 请求应带结构化 env/token/role/header,后续不能散落在命令里 |
|
||||||
|
| runtime command registry | `packages/core/cli/src/generated/command-registry.ts` | 可根据运行时 API 生成命令,EIP4 后续可用 OpenAPI 生成安全 CLI |
|
||||||
|
| generic resource command | `packages/core/cli/src/lib/resource-command.ts` | CRUD 类命令应统一处理 JSON body、分页、过滤、错误输出 |
|
||||||
|
| plugin import/enable | `packages/core/cli/src/commands/plugin/import.ts`, `packages/core/cli/src/commands/plugin/enable.ts` | EIP4 的 FeaturePackage 后续也要区分导入、启用、发布和重启/刷新 |
|
||||||
|
| revision create | `packages/core/cli/src/commands/revision/create.ts` | revision 不能只是保存 JSON,发布前要检查版本控制能力是否可用 |
|
||||||
|
| skills install | `packages/core/cli/src/commands/skills/install.ts` | Skills 应由 CLI 安装/检查/更新,而不是只放仓库文档 |
|
||||||
|
| AI plugin server | `packages/plugins/@nocobase/plugin-ai/src/server/plugin.ts` | AI 功能要注册 tools、skills、MCP、AI employees、ACL snippet |
|
||||||
|
| FlowEngine | `packages/core/flow-engine/src/flowEngine.ts`, `packages/core/flow-engine/src/models/flowModel.tsx` | 页面 schema 需要演进到 typed model/action/event/resource registry |
|
||||||
|
|
||||||
|
## 二、对当前实现的校正
|
||||||
|
|
||||||
|
### P0-P2 是否做实
|
||||||
|
|
||||||
|
已做实:
|
||||||
|
|
||||||
|
- `platform-ai` 主链路有 Java 实现、JDBC/内存 store、DDL、Web API 和测试。
|
||||||
|
- `platform-cli` 是可运行 jar,不是伪命令。
|
||||||
|
- `FeaturePackage` 和 `Revision` 已有最小持久化模型。
|
||||||
|
|
||||||
|
但它还不是 NocoBase 级完整度:
|
||||||
|
|
||||||
|
- CLI 之前缺少 env registry/current env。
|
||||||
|
- revision 只是功能包快照,不是完整版本控制。
|
||||||
|
- Skills 只是仓库文档,没有 CLI 安装/检查/更新。
|
||||||
|
- AI tools/permissions/MCP/AI employee 还没有平台级注册。
|
||||||
|
- 页面配置还没有 typed FlowModel registry。
|
||||||
|
|
||||||
|
### 已按源码对照修订的 P3 第一批
|
||||||
|
|
||||||
|
- `platform-cli` 新增本地 env registry,默认保存到 `~/.eip4/eip4-cli.json`。
|
||||||
|
- 新增 `eip4 env add/list/use/current/status`。
|
||||||
|
- AI 命令支持 `--env`。
|
||||||
|
- 显式选择非当前 env 时必须加 `--yes`,避免误操作共享环境。
|
||||||
|
- 新增 `eip4 release verify --package-file FILE`,离线检查功能包是否具备本地门禁 evidence、人审标记、SQL/rollback,并阻断 `${...}` 占位符。
|
||||||
|
- 新增 `eip4 release export --package-file FILE --output FILE`,将功能包封装为 `.eip4pkg.json`,包含格式版本和 SHA-256 checksum。
|
||||||
|
- 新增 `eip4 release import-preview --package-file FILE`,离线验证 `.eip4pkg.json` checksum 和发布门禁,不写任何环境。
|
||||||
|
- 新增 `eip4 release diff --left FILE --right FILE`,离线比较两个功能包或 `.eip4pkg.json` 的标识、SQL、rollback SQL 和 manifest 差异。
|
||||||
|
- 新增 `eip4 release rollback-plan --package-file FILE --output FILE`,只生成结构化回滚计划,不执行生产写入。
|
||||||
|
|
||||||
|
## 三、后续实现顺序
|
||||||
|
|
||||||
|
### P3-1:CLI env 和发布前治理
|
||||||
|
|
||||||
|
状态:进行中。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- env registry/current env
|
||||||
|
- `release verify`
|
||||||
|
- package/revision 差异检查
|
||||||
|
- 生产环境默认只读
|
||||||
|
|
||||||
|
### P3-2:FeaturePackage 导出/导入
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- `.eip4pkg.json` 文件格式
|
||||||
|
- checksum
|
||||||
|
- import preview
|
||||||
|
- import 后不自动启用
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- export: 普通 feature package JSON -> `.eip4pkg.json` 信封。
|
||||||
|
- import-preview: 校验 format/version/checksum/payload 和 release gate。
|
||||||
|
- import-preview 只读,不落库、不启用、不发布。
|
||||||
|
|
||||||
|
### P3-3:Revision diff/restore
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- revision diff
|
||||||
|
- rollback plan
|
||||||
|
- rollback 只生成计划和 SQL,不默认执行生产写入
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- diff: 比较两个普通 feature package JSON 或 `.eip4pkg.json`,支持 checksum 校验和 JSON 输出。
|
||||||
|
- rollback-plan: 生成 `EIP4_ROLLBACK_PLAN` JSON,包含 package/task/changeSet、rollback SQL、source evidence 和人审要求。
|
||||||
|
- rollback-plan 会阻断 rollback SQL 中的 `${...}` 占位符;命令不连接环境、不落库、不执行 SQL。
|
||||||
|
|
||||||
|
### P4:Typed UI Registry
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- typed page schema
|
||||||
|
- component/action/event registry
|
||||||
|
- AI 只能选择 registry 中允许的组件和动作
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- `PageComponentRegistry` 提供页面组件能力表,当前覆盖 page/crud/form/operation/button、常用 layout/display 和字段组件。
|
||||||
|
- `TypedPageSchemaValidator` 校验根节点、已注册组件和 actionType 能力。
|
||||||
|
- `GET /api/page/schema/components` 返回组件能力表。
|
||||||
|
- `POST /api/page/schema/validate` 离线校验页面 schema,不写库。
|
||||||
|
- `PUT /api/page/schema/{templateId}/overlay` 保存前会先跑 typed schema 校验,未注册组件或不支持 action 会被 400 阻断。
|
||||||
|
|
||||||
|
### P5:AI tools/skills/employee/ACL
|
||||||
|
|
||||||
|
状态:第一版完成。
|
||||||
|
|
||||||
|
目标:
|
||||||
|
|
||||||
|
- AI tool registry
|
||||||
|
- AI employee registry
|
||||||
|
- ACL/scope check
|
||||||
|
- 生产写默认阻断
|
||||||
|
|
||||||
|
第一版已落地:
|
||||||
|
|
||||||
|
- `AiToolRegistry` 注册工具、操作入口、所需 scope、本地限定和生产写边界。
|
||||||
|
- `GET /api/ai/tools` 返回 AI 工具注册表。
|
||||||
|
- `GET /api/ai/employees` 返回 AI employee 定义。
|
||||||
|
- `POST /api/ai/tools/access-check` 只做权限判定,不执行工具;`local.apply` 等本地工具在 prod target 会被阻断。
|
||||||
|
- 当前所有工具都不允许生产写;线上部署仍由人工拿发布包执行。
|
||||||
|
- Skills CLI check/update
|
||||||
|
- AI Agent 权限和审计
|
||||||
|
- MCP 工具白名单
|
||||||
129
docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md
Normal file
129
docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md
Normal file
@@ -0,0 +1,129 @@
|
|||||||
|
> 📌 **现状以总览为准(2026-06-21)**:正文若将 master-detail 列为「未来 TODO / 未覆盖」已过时——`master-detail-v1.yaml` recipe 已存在并交付(含派生/聚合/引用联动)。进度见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) §2。
|
||||||
|
|
||||||
|
# AI Agent Page Blueprint Contract
|
||||||
|
|
||||||
|
日期:2026-06-17
|
||||||
|
|
||||||
|
## 目标
|
||||||
|
|
||||||
|
EIP4 的 AI Agent 不直接自由生成 amis JSON。Agent 应先生成 EIP4 PageBlueprint,再由平台编译器输出 amis schema,并继续通过 typed page schema、amis schema 和真实浏览器 E2E。
|
||||||
|
|
||||||
|
这条路径借鉴 NocoBase 的做法:AI 操作受控配置模型,平台负责规范化、校验、模板复用和版本证据。
|
||||||
|
|
||||||
|
## 当前已落地对象
|
||||||
|
|
||||||
|
代码位置:
|
||||||
|
|
||||||
|
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprint.java`
|
||||||
|
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintField.java`
|
||||||
|
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageBlueprintCompiler.java`
|
||||||
|
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageRecipeRegistry.java`
|
||||||
|
- `platform-metadata/src/main/java/com/eip4/platform/metadata/schema/blueprint/PageRecipeValidator.java`
|
||||||
|
- `platform-ai/src/main/resources/ai/page-recipes/maintenance-crud-v1.yaml`
|
||||||
|
- `platform-ai/src/main/resources/ai/page-recipes/tree-crud-v1.yaml`
|
||||||
|
|
||||||
|
AI 可查询入口:
|
||||||
|
|
||||||
|
- `GET /api/ai/page-recipes`
|
||||||
|
- `GET /api/ai/page-recipes/{recipe}`
|
||||||
|
|
||||||
|
工具注册表中对应工具为 `page-recipe.read`,所需 scope 为 `ai:page-recipe:read`。Agent 生成
|
||||||
|
PageBlueprint 前应先读取 recipe 定义,再生成草稿。
|
||||||
|
|
||||||
|
AI 辅助开发链路中的 `PAGE_SCHEMA` 草稿仍然保存编译后的 amis schema,保持现有落库和前端渲染契约不变;草稿 metadata 额外保存:
|
||||||
|
|
||||||
|
- `pageRecipe`
|
||||||
|
- `pageBlueprintVersion`
|
||||||
|
- `pageBlueprint`
|
||||||
|
|
||||||
|
声明了 `pageRecipe` 的草稿必须通过 `page-recipe` 门禁。该门禁会重新解析 metadata 中的
|
||||||
|
`pageBlueprint`,用平台注册的 recipe/compiler 重新编译,并要求草稿 payload 与编译结果一致。
|
||||||
|
因此 Agent 不能一边声明使用标准 recipe,一边绕过 compiler 私改 amis JSON。没有声明 recipe 的
|
||||||
|
历史/手工 `PAGE_SCHEMA` 草稿暂按自由 schema 处理,只走 amis schema 和 typed page schema。
|
||||||
|
|
||||||
|
## Recipe: maintenance-crud-v1
|
||||||
|
|
||||||
|
适用范围:
|
||||||
|
|
||||||
|
- 普通实体维护页
|
||||||
|
- 单主表列表
|
||||||
|
- 新增、编辑、删除
|
||||||
|
- 本地 smoke 可覆盖列表、新增、服务流搜索
|
||||||
|
|
||||||
|
标准输出结构:
|
||||||
|
|
||||||
|
- 顶层 `type=page`
|
||||||
|
- `body` 为 `crud`
|
||||||
|
- `crud.name` 固定为 `{lowerCamel(tableName)}Crud`
|
||||||
|
- `crud.syncLocation=false`
|
||||||
|
- 列表 API 固定为 `/api/entity/{table}/list?page=${page}&perPage=${perPage}`
|
||||||
|
- 新增按钮位于 `headerToolbar[0]`
|
||||||
|
- 新增按钮使用 `level=primary`、`icon=fa fa-plus`、`actionType=dialog`
|
||||||
|
- 新增和编辑表单提交到 `post:/api/entity/{table}/save`
|
||||||
|
- 编辑按钮位于操作列第一位
|
||||||
|
- 删除按钮位于操作列第二位
|
||||||
|
- 删除按钮使用 `className=text-danger`、`actionType=ajax`、`confirmText`
|
||||||
|
- 删除 API 固定为 `/api/entity/{table}/delete`
|
||||||
|
- 页大小默认 `20`
|
||||||
|
- `footerToolbar` 固定包含 `statistics` 和 `pagination`
|
||||||
|
|
||||||
|
## Recipe: tree-crud-v1
|
||||||
|
|
||||||
|
适用范围:
|
||||||
|
|
||||||
|
- 自引用层级实体维护页
|
||||||
|
- 实体必须包含 `PARENTID` 字段
|
||||||
|
- 覆盖树形列表、新增顶级节点、加子节点、编辑、删除
|
||||||
|
|
||||||
|
标准输出结构:
|
||||||
|
|
||||||
|
- 顶层 `type=page`
|
||||||
|
- `body` 为 `crud`
|
||||||
|
- `crud.name` 固定为 `{lowerCamel(tableName)}TreeCrud`
|
||||||
|
- `crud.childrenColumnName=children`
|
||||||
|
- 列表 API 固定为 `/api/entity/{table}/tree?parentKey=PARENTID&idKey={primaryKey}&perPage=2000`
|
||||||
|
- 新增顶级按钮位于 `headerToolbar[0]`
|
||||||
|
- 新增顶级按钮使用 `level=primary`、`icon=fa fa-plus`、`actionType=dialog`
|
||||||
|
- 操作列按钮顺序固定为:加子项、编辑、删除
|
||||||
|
- 加子项表单必须隐藏写入 `PARENTID=${primaryKey}`
|
||||||
|
- 编辑表单必须保留隐藏主键和 `PARENTID`
|
||||||
|
- 删除按钮使用 `className=text-danger`、`actionType=ajax`、`confirmText`
|
||||||
|
- 树数据端点返回 `data.items` 层级数组,每个节点的子节点字段为 `children`
|
||||||
|
|
||||||
|
字段映射:
|
||||||
|
|
||||||
|
- `string` -> `input-text`
|
||||||
|
- `integer` / `number` -> `input-number`
|
||||||
|
- `date` -> `input-date`
|
||||||
|
- `datetime` -> `input-datetime`
|
||||||
|
- `boolean` -> `switch`
|
||||||
|
- 主键不出现在新增表单,编辑表单最后追加 `hidden`
|
||||||
|
|
||||||
|
## 当前边界
|
||||||
|
|
||||||
|
本阶段只解决“AI 生成维护类 CRUD 页时走受控 recipe”。还未覆盖:
|
||||||
|
|
||||||
|
- 主子表页面
|
||||||
|
- 审批办理页面
|
||||||
|
- 看板、日历、图表、报表页
|
||||||
|
- 复杂字段分组
|
||||||
|
- 条件联动
|
||||||
|
- 引用选择器策略
|
||||||
|
- 权限按钮策略
|
||||||
|
|
||||||
|
这些类型必须作为新的 recipe 增量加入,不能让 Agent 直接绕过 blueprint 生成最终 amis JSON。
|
||||||
|
|
||||||
|
## 已落地门禁
|
||||||
|
|
||||||
|
- `page-recipe`:校验 recipe 已注册、metadata 证据完整、payload 等于 blueprint 编译结果。
|
||||||
|
- `typed-page-schema`:校验组件和 actionType 来自 EIP4 注册表。
|
||||||
|
- `amis-schema`:校验最终 schema 符合 amis schema。
|
||||||
|
- `local-smoke`:本地发布后访问页面、实体、服务流和新增接口。
|
||||||
|
- `render-plan`:`TEST` 草稿必须提供 Playwright 可消费的 `renderTests`,包含 recipe、schemaUrl、previewUrl、预期根组件、CRUD 名、数据 API、列表列、页面动作和关键文本。
|
||||||
|
|
||||||
|
## 后续演进
|
||||||
|
|
||||||
|
1. 增加 `master-detail-v1`、`approval-task-v1` recipe。
|
||||||
|
2. 让设计器 overlay 保存也能记录对应 blueprint 或 template 来源。
|
||||||
|
3. 在功能包中导出 blueprint,线上部署包继续导出编译后的 amis schema。
|
||||||
|
4. Playwright E2E 消费 `renderTests`,执行真实浏览器渲染并回写运行证据。
|
||||||
155
docs/AI_AGENT_REPAIR_CONTRACT.md
Normal file
155
docs/AI_AGENT_REPAIR_CONTRACT.md
Normal file
@@ -0,0 +1,155 @@
|
|||||||
|
# AI Agent Repair LLM 接入契约
|
||||||
|
|
||||||
|
本文档定义 `platform-ai` 调用外部 LLM 修复服务的最小契约。该服务只负责根据失败证据生成安全草稿补丁,不直接写库、不发布线上、不访问生产环境。
|
||||||
|
|
||||||
|
## 启用配置
|
||||||
|
|
||||||
|
默认不启用外部 LLM 修复。需要显式配置:
|
||||||
|
|
||||||
|
```properties
|
||||||
|
eip4.ai.llm.repair.enabled=true
|
||||||
|
eip4.ai.llm.repair.endpoint=http://127.0.0.1:18081/ai-agent/repair
|
||||||
|
eip4.ai.llm.repair.api-key=${AI_REPAIR_API_KEY}
|
||||||
|
eip4.ai.llm.repair.model=${AI_REPAIR_MODEL}
|
||||||
|
```
|
||||||
|
|
||||||
|
`api-key` 为空时不发送 `Authorization` 头;非空时使用 `Authorization: Bearer <api-key>`。接口超时为 60 秒。服务返回非 2xx、响应格式非法或调用异常时,平台会忽略外部结果并回退到内置确定性修复规则。
|
||||||
|
|
||||||
|
## 请求格式
|
||||||
|
|
||||||
|
`HttpAiLlmRepairClient` 向配置的 endpoint 发送 `POST application/json`:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"model": "repair-model-name",
|
||||||
|
"taskId": "ait-1",
|
||||||
|
"changeSetId": "aics-1",
|
||||||
|
"repairPlan": {
|
||||||
|
"taskId": "ait-1",
|
||||||
|
"changeSetId": "aics-1",
|
||||||
|
"sourceRunId": "run-1",
|
||||||
|
"status": "READY",
|
||||||
|
"generatedAt": 1710000000000,
|
||||||
|
"actions": [],
|
||||||
|
"messages": []
|
||||||
|
},
|
||||||
|
"drafts": [],
|
||||||
|
"contract": {
|
||||||
|
"responseField": "draftPatches",
|
||||||
|
"patchShape": "artifactType,targetId,payload,metadata",
|
||||||
|
"rule": "Return only safe draft patches; do not execute production changes"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
字段说明:
|
||||||
|
|
||||||
|
- `repairPlan`: 平台根据最近失败的 `AUTO_DEVELOP` / `LOCAL_APPLY` / `SMOKE` 证据生成的修复计划。
|
||||||
|
- `drafts`: 当前任务的草稿快照,LLM 只能基于这些草稿生成替代草稿。
|
||||||
|
- `contract`: 平台要求的响应约束,外部服务必须遵守。
|
||||||
|
|
||||||
|
## 响应格式
|
||||||
|
|
||||||
|
外部服务必须返回 JSON 对象,且补丁数组放在 `draftPatches` 字段:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"draftPatches": [
|
||||||
|
{
|
||||||
|
"artifactType": "ENTITY",
|
||||||
|
"targetId": "CUSTOMER",
|
||||||
|
"payload": {
|
||||||
|
"publishTarget": "/api/meta/entity",
|
||||||
|
"tableName": "SYS_CUSTOMER",
|
||||||
|
"entityName": "Customer",
|
||||||
|
"fields": []
|
||||||
|
},
|
||||||
|
"metadata": {
|
||||||
|
"source": "llm-repair",
|
||||||
|
"reason": "补齐实体发布目标"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
`artifactType` 只允许:
|
||||||
|
|
||||||
|
- `ENTITY`
|
||||||
|
- `PAGE_SCHEMA`
|
||||||
|
- `SERVICEFLOW`
|
||||||
|
- `MENU`
|
||||||
|
- `TEST`
|
||||||
|
- `CODE`
|
||||||
|
|
||||||
|
平台当前主要自动修复 `ENTITY`、`PAGE_SCHEMA`、`SERVICEFLOW`、`MENU`、`TEST`。`CODE` 补丁即使返回,也仍然必须经过后续门禁、人审和部署包流程。
|
||||||
|
|
||||||
|
## 安全边界
|
||||||
|
|
||||||
|
外部 LLM 服务不得执行以下操作:
|
||||||
|
|
||||||
|
- 连接或修改线上数据库。
|
||||||
|
- 触发线上发布、重启、脚本执行或远程 shell。
|
||||||
|
- 绕过平台的草稿、变更包、本地 apply、smoke、部署包和人工审批流程。
|
||||||
|
- 返回除 `draftPatches` 之外需要平台立即执行的命令。
|
||||||
|
|
||||||
|
平台接收补丁后的流程是:
|
||||||
|
|
||||||
|
1. 将补丁写成新的 `AiDraft`,保留 `metadata.source` 和原因。
|
||||||
|
2. 基于同一 `artifactType + targetId` 取最新草稿重新生成 change set。
|
||||||
|
3. 执行本地 apply 和 smoke。
|
||||||
|
4. 生成线上人工部署包。
|
||||||
|
5. 线上部署仍由人工审批和发布系统执行。
|
||||||
|
|
||||||
|
## 示例:修复 TEST 契约
|
||||||
|
|
||||||
|
请求中的 `repairPlan.actions` 指出 smoke 期望状态码与实际接口不一致时,外部服务可以返回:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"draftPatches": [
|
||||||
|
{
|
||||||
|
"artifactType": "TEST",
|
||||||
|
"targetId": "customer-smoke",
|
||||||
|
"payload": {
|
||||||
|
"smokes": [
|
||||||
|
{
|
||||||
|
"name": "打开客户列表",
|
||||||
|
"method": "GET",
|
||||||
|
"path": "/api/customer/list",
|
||||||
|
"expectedStatus": 200
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"metadata": {
|
||||||
|
"source": "llm-repair",
|
||||||
|
"reason": "同步 smoke 期望状态码"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## 示例:修复 PAGE_SCHEMA
|
||||||
|
|
||||||
|
页面 schema 缺少 `type`、`title` 或 `body` 时,外部服务可以返回:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"draftPatches": [
|
||||||
|
{
|
||||||
|
"artifactType": "PAGE_SCHEMA",
|
||||||
|
"targetId": "customer-page",
|
||||||
|
"payload": {
|
||||||
|
"type": "page",
|
||||||
|
"title": "客户管理",
|
||||||
|
"body": []
|
||||||
|
},
|
||||||
|
"metadata": {
|
||||||
|
"source": "llm-repair",
|
||||||
|
"reason": "补齐 amis 页面必填结构"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
@@ -159,9 +159,9 @@ ls -la /opt/eip3/reports/ 2>/dev/null || echo "路径待确认"
|
|||||||
|---|------|------|---------|---------|---------|--------|
|
|---|------|------|---------|---------|---------|--------|
|
||||||
| C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | 后端架构(老员工)| ≥20 个代表性实体逐行一致率 100% | 🟢 **完成(客户库口径,2026-06-11)**:框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 **24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异**;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 | `eip4-platform/platform-parity/C1实测报告.md`(含客户库口径节+归因台账);`parity-reports/` | 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办 |
|
| C1 | **逐行对拍框架**:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff | 后端架构(老员工)| ≥20 个代表性实体逐行一致率 100% | 🟢 **完成(客户库口径,2026-06-11)**:框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 **24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异**;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 | `eip4-platform/platform-parity/C1实测报告.md`(含客户库口径节+归因台账);`parity-reports/` | 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办 |
|
||||||
| C2 | 数据权限最小真实现替换桩,纳入对拍样本 | 后端 | ≥3 个行级过滤实体对拍通过 | 🟢 **完成**:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 **9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝**,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 | `eip4-platform/platform-auth/C2实测报告.md`;`platform-parity/parity-reports/privilege-parity-*.{json,md}` | P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座) |
|
| C2 | 数据权限最小真实现替换桩,纳入对拍样本 | 后端 | ≥3 个行级过滤实体对拍通过 | 🟢 **完成**:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 **9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝**,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 | `eip4-platform/platform-auth/C2实测报告.md`;`platform-parity/parity-reports/privilege-parity-*.{json,md}` | P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座) |
|
||||||
| C3 | Top 10 高频实体基础压测 + 慢查询采样 | 后端 + 架构 | 输出 P95 延迟基线文档 | 🟢 **完成(双口径,2026-06-11)**:本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。**关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s)**,定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 | `eip4-platform/docs/C3压测基线.md`(双口径+归因);JSON 在 `eip4-platform/tools/loadtest/` | 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测 |
|
| C3 | Top 10 高频实体基础压测 + 慢查询采样 | 后端 + 架构 | 输出 P95 延迟基线文档 | 🟢 **完成(双口径,2026-06-11)**:本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。**关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s)**,定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 | `eip4-platform/docs/归档/C3压测基线.md`(双口径+归因);JSON 在 `eip4-platform/tools/loadtest/` | 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测 |
|
||||||
| C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | 后端 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 | 🟢 **完成(真实库口径,2026-06-11)**:全量 1,427 条实测,S3=612,自动化率 **81.2%(497/612)≥80% 预算线锁定**;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A | `eip4-platform/tools/s3_rewriter/C4实测报告.md`;`eval-real-20260611-final.json` | 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月) |
|
| C4 | S3 脚本正则改写器原型在真实脚本上实测自动化率 | 后端 | 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 | 🟢 **完成(真实库口径,2026-06-11)**:全量 1,427 条实测,S3=612,自动化率 **81.2%(497/612)≥80% 预算线锁定**;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A | `eip4-platform/tools/s3_rewriter/C4实测报告.md`;`eval-real-20260611-final.json` | 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月) |
|
||||||
| C5 | amis 6.13.0 fork 可行性预演(独立构建通过)| 前端 | 构建产物可替换 CDN 版本运行 | 🟢 **完成**:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;**止损 S2 不触发** | `eip4-platform/docs/C5构建预演报告.md`;产物 `static/sdk-local/` + `amis-local.html` | — |
|
| C5 | amis 6.13.0 fork 可行性预演(独立构建通过)| 前端 | 构建产物可替换 CDN 版本运行 | 🟢 **完成**:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;**止损 S2 不触发** | `eip4-platform/docs/归档/C5构建预演报告.md`;产物 `static/sdk-local/` + `amis-local.html` | — |
|
||||||
| — | **老员工知识转移**:PoC 坑位记录整编为《迁移手册》v1 | 老员工 + 架构 | 手册过评审,backup 人选确定 | 🟡 **进行中** | `eip4-platform/docs/迁移手册.md`(本批交付)| backup 人选待确定(项目负责人决策)|
|
| — | **老员工知识转移**:PoC 坑位记录整编为《迁移手册》v1 | 老员工 + 架构 | 手册过评审,backup 人选确定 | 🟡 **进行中** | `eip4-platform/docs/迁移手册.md`(本批交付)| backup 人选待确定(项目负责人决策)|
|
||||||
| — | **153 定制视图处置清单**(重写/降级/留旧三分)| 项目负责人 | 决策会开放项,2 周限期 | 🟡 **进行中** | `153定制视图处置清单v1.md`(本批交付,初判底稿)| 需客户库 SQL 拉取完整列表 + 老员工终判 |
|
| — | **153 定制视图处置清单**(重写/降级/留旧三分)| 项目负责人 | 决策会开放项,2 周限期 | 🟡 **进行中** | `153定制视图处置清单v1.md`(本批交付,初判底稿)| 需客户库 SQL 拉取完整列表 + 老员工终判 |
|
||||||
| — | **JOR 报表布局客户环境清点** | 交付团队 | 报表 C 类预算锁定 | 🔴 **未开始**(需客户环境访问)| — | 客户环境网络访问权限;执行方案见本文档第一节 |
|
| — | **JOR 报表布局客户环境清点** | 交付团队 | 报表 C 类预算锁定 | 🔴 **未开始**(需客户环境访问)| — | 客户环境网络访问权限;执行方案见本文档第一节 |
|
||||||
|
|||||||
159
docs/README.md
159
docs/README.md
@@ -1,58 +1,65 @@
|
|||||||
# EIP4 迁移项目 — 文档索引与状态总览
|
# EIP4 迁移项目 — 文档索引与状态总览
|
||||||
|
|
||||||
> 维护日期:2026-06-17 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
|
> 维护日期:2026-07-02 | **本文是 `docs/` 的唯一入口与状态权威。** 被取代的历史状态/审计快照已移入 `归档/`。
|
||||||
>
|
>
|
||||||
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → **engineclass Java delta**)产出了多份「framework 视图状态/parity」文档,结论互相冲突——尤其 `归档/framework系统管理视图-实现交付报告`(宣称「16 视图已交付」)是「以为做了很多」错觉的来源,实为 demo 级、未逐功能验收。**以本文 + 下方两份现行权威为准,其余归档勿再据以判断进度。**
|
> **进度权威看这份**:`项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 06-17→06-21 增量交付 + 下一步 + 待拍板决策)。本 README 只做「文档地图 + 模块完成度」,进度细节以总览为准。
|
||||||
|
>
|
||||||
|
> **为什么需要本文**:项目历史上随方法论演进(源码 parity → 宣称交付 → 数据驱动重审 → XML 审计 → engineclass Java delta → **人走五环低代码平台 / AI 确定性生产线**)产出了多份状态文档,结论可能互相冲突。**以本文 + 总览-2026-06-21 + 下方现行权威为准,归档/历史目录勿再据以判断进度。**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 0. 一句话现状
|
## 0. 一句话现状(2026-07-02)
|
||||||
|
|
||||||
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1;当前逐项执行队列见 `framework定制视图-TODO-2026-06-17.md`。
|
**横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制① / 元数据+写真相门禁);**A 兼容线**纵向「按模块做到 parity 验收」目前只有「用户管理」1 个完成,framework 其余约 38 视图待写、**业务 106 视图是最大未动块**;**B 新能力线本期破局**——「人走五环建新功能」低代码平台 v1 全链交付合 main、设计器选型(amis-editor)拍板 + DesignerPage 全闭环、AI 确定性五环生产线合 main。仍在 dev;**A10 MVP 骨架(Flyway + 容器化/nginx/compose)已合 main(06-25),切流未执行**。
|
||||||
|
|
||||||
> **本会话进展(2026-06-17 续)**:三个**全站通用**保真修复 + Wave A 两项已 push origin/main `1b69f8b..fb8a37d`;用户选择框最新回归标准 amis `picker`(`eip4-web b0537f8`、`eip4-platform 0d6fab4`)。详见 §1.3 横向能力(real-first 流解析 / 树编辑布局保真 / 搜索时间段过滤 / 标准 picker 接线)与 §1.1(功能模板下载 ✅、枚举组 ✅、日志组 🟡)。
|
> **06-17→06-21 增量**(详见总览 §2):人走五环后端全链 + 前端编排壳/建模器、DesignerPage 闭环(解除 P1 头号阻塞)、主子表四件套、AI 五环生产线合 main + 写路径对齐、附件双态、framework P2 移植一批。两仓 origin/main 已 push(platform `75f942b` / web `d1fd6ed`)。
|
||||||
|
|
||||||
|
> **06-22→06-26 增量**(详见总览 §10/§11 与 A2/A3 行):安全基线 P0 全收口(RCE/fail-open/asUser 越权/CI 孤儿 + 2 孪生 + Groovy 沙箱,platform `eba9ce1` / web `2a37251`);报表 A3 JOR 重宿主 + 安全/OOM 收口 🟢(总览 §11);审批闭环补齐(协办/转阅/BPMN 流程图/会签/会签进度,`c95eaee`);A10 W1-W4 骨架(Flyway `f7675c9` + deploy `97a0eb1`);稳定性三件套 + actuator + ArchUnit 6 条 + AiAgentService SRP 拆分;G1-G3 外部 agent 接入(`eip4 init`/platform-mcp/7 skills);在线流程 Modeler design 拍定 D1-D9(`d3ec758`)。06-26 后至 07-02 无代码增量(本次为文档对齐与归档)。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1. 模块完成度(诚实口径)
|
## 1. 模块完成度(诚实口径)
|
||||||
|
|
||||||
档位说明:✅ parity 完成(逐功能验收过) | 🟡 demo 级(有页/端点但未 parity 验收) | 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力(跨模块共用,非单模块)
|
档位:✅ parity 完成(逐功能验收过)| 🟡 demo 级(有页/端点未 parity 验收)| 🟠 通用页已产·engineclass delta 未移植 | ❌ bespoke 未起步 | 🔵 横向能力 | 🆕 本期新能力
|
||||||
|
|
||||||
### 1.1 纵向(系统模块 / framework 定制视图)
|
### 1.1 纵向(系统模块 / framework 定制视图)
|
||||||
|
|
||||||
| 模块组 | 代表视图 | 档位 | 备注 |
|
| 模块组 | 代表视图 | 档位 | 备注 |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| **用户管理** | 用户管理 629463ae | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收。剩:编辑页 org picker 查询条件、导出 Excel |
|
| **用户管理** | 用户管理 | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收(`bf7bb25/0d6fab4/17c449c`)。剩:编辑页 org picker 查询条件、导出 Excel |
|
||||||
| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | 2026-06-14 搭了 CRUD 端点 + amis 后台页,但 demo 级、未对照旧版逐功能验收 |
|
| RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | CRUD 端点 + amis 后台页已建,demo 级未对照旧版逐功能验收 |
|
||||||
| RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 |
|
| RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 |
|
||||||
| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 |
|
| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器重度 delta 未移植 |
|
||||||
| 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995`/`3276774`:去右表单「添加」按钮 + 标题「编辑模板附件」+ 布局保真;`ffd8c31`:补 `VIEW_TEMPLATEID` 门控,未关联模板节点不显示附件编辑/保存 |
|
| 元数据/平台工具 | 数据导入配置 / 定时任务「设置提醒人」 | 🟡 | `DataImportConfigController` / `ScheduleJobNotifyController` 已落(c9e4d35);调度运行时未起步 |
|
||||||
| 元数据/平台工具 | 实体分类-枚举组 b114351f | ✅ | 已核对:EIP4 树端点 PK 唯一+去重+全量建树,天然规避老 UUID 防重逻辑,无需移植 |
|
| 元数据/平台工具 | 脚本编辑器 / 工作日历 | 🟡 | framework P2 批次已移植(57c3412…d218c2b) |
|
||||||
| 流程/审批 | 待办/已办/我的发起任务 | 🟡 | 已办 `FinishTaskComponentNew` 两个模板已浏览器验收只读详情;待办 `TaskComponentNew` 两个模板已验列表/查看详细/处理抽屉/遮罩层级,未点最终同意/拒绝,处理后刷新仍待专门测试数据或用户确认。我的发起任务的查看/撤回未接。 |
|
| 元数据/平台工具 | 功能模板下载 / 实体分类-枚举组 | ✅ | 已核对验收 |
|
||||||
| 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 |
|
| 流程/审批 | 待办/已办/我发起的任务 | 🟡→✅ | 列表/查看/处理抽屉/审批历史抽屉已验收;列表入口接线已 live(228 页 openApprovalDrawer);协办/转阅/会签/会签进度/approve 默认「同意」意见 06-26 补齐。剩客户 BPMN 真实流转(外部前置①) |
|
||||||
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 |
|
| 流程/审批 | 查看审批/流程监控/流程定义/BPMN 图 | 🟡 | 监控(撤回/结束/高级)已 live;BPMN 流程图**查看**已做(ProcessDiagramController + bpmn-js,中文 id 净化);流程定义**编辑**=Modeler 另案(B3,design 已拍定 D1-D9);客户 BPMN 部署=前置① |
|
||||||
| 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 |
|
| 消息/邮件 | 收到/已发送消息、短消息 | 🟠→🟡 | 短消息发送 + 消息详情已移植(16393c1 等);已读联动未接 |
|
||||||
| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 用户选择框×4 最新已切回标准 amis `picker`(单选默认,`multiple: true` 为多选,数据源 `/api/picker/<dialogid>/list`;旧 schema 由 web 兼容过滤器兜底归一);流程选择框已接 `transfer-picker` + `ProcessSelectController`。均已页面烟测,仍待真实业务保存/权限差异验收。 |
|
| 消息/邮件 | 电子邮件全家桶(webmail) | ❌ | 独立子系统,另案立项(A5) |
|
||||||
| 日志/历史 | 系统日志/登录历史/登录操作 | 🟡 | `17c449c` 删除按钮组已接(机制①+LogController systemLogManager);列表经 real-first 修通(原 SYS_USERLOGIN_HISTORY_SEARCH 报 createtime 缺列);时间段过滤已通。剩:登录操作列表 VIEW_SYS_USERLOGINFO 此库缺视图 |
|
| picker 控件 | 用户选择框×4 / 流程选择框 | 🟡 | 已切回标准 amis `picker`(单/多选靠 `multiple`),数据源 `/api/picker/<dialogid>/list`;流程选择框接 `transfer-picker`。已烟测,待真实业务保存/权限验收 |
|
||||||
| 其它 bespoke | 个人设置/工作日历/报表 | ❌ | 无 XML,逐个从零 |
|
| 日志/历史 | 系统日志/登录历史 | 🟡 | 删除按钮组 + real-first 列表 + 时间段过滤已通;剩登录操作列表此库缺视图 |
|
||||||
|
| 其它 bespoke | 个人设置/工作日历/报表 | 🟠→🟢 | 工作日历已移植;**报表 A3 已完成**(JOR 重宿主 + 安全/OOM 收口,总览 §11);个人设置未起步 |
|
||||||
|
|
||||||
> framework 定制视图共 46 个,逐视图清单与移植项见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog)。
|
> framework 定制视图共 46 个,逐视图清单见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog),当前执行队列见 **`framework定制视图-TODO-2026-06-17.md`**(活清单·三态)。
|
||||||
|
|
||||||
### 1.2 业务模块(pm/hr/oa/dm 的 153 个定制视图)
|
### 1.2 业务模块(pm/hr/oa/dm 的 106 个定制视图)
|
||||||
|
|
||||||
另一条线,多数走 bespoke 重写或通用模板,绝大部分未做。处置口径见 `M0交付/153定制视图处置清单v1.md`(历史)。
|
另一条线,源码在 `EIP-3.0` 仓(3.1G),**基本未动 = A 兼容线最大块**。处置口径卡 S1 止损评审(见总览 §6 待拍板①)。
|
||||||
|
|
||||||
### 1.3 🔵 横向能力(已就绪,跨模块共用)
|
### 1.3 🆕 本期新能力(人走五环 / AI / 设计器)
|
||||||
|
|
||||||
- **转换器通用能力**:navigation 按钮、type=101 树形选择框、picker 引用列显名、filterscript 级联(组织→部门→岗位,已收口静态可达部分)、title 修正、colspan 栅格、A0 控件(密码/附件/日期)、EditGrid 子表递归。
|
- **人走五环建新功能 v1**:NocoBase 式建模器 + 实时设计器,五环(元数据→表→设计→实现→发布)+ AI①面入口 + 主子表四件套,全链交付合 main(platform `75f942b` / web `d1fd6ed`)。v1 限简单 CRUD/树 recipe + 只建新不改表。设计权威:`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`。
|
||||||
- **🆕 树编辑表单布局保真**(`3276774`):type=3 可编辑树 master-detail 现按 view_page `<layout>` 的 `<div location>` 槽位排版 + 隐藏未布局字段(VERSION/主键/引用 id 等绑提交但不显示)——与 EDITFORM 同口径 `buildFormBody`,修「树编辑泄露隐藏字段 + 裸列名标签」。影响 41 可编辑树页。
|
- **B1 设计器**:amis-editor 选型拍板(D1);DesignerPage 全闭环上线(`2278cbc` 等),原 P1 头号阻塞解除。
|
||||||
- **🆕 搜索时间段过滤**(`fb8a37d`,全站通用):amis `input-date(time)-range` 的 `"起,止"` 串在保真层读流路径(NAMED_READ/SYNTHESIZED)转 `DateTime[]`,接通引擎 GeneralPO 区间查询 `(col>=起 AND col<=止)`;认 unix 秒/毫秒/格式化;只碰 DATE/TIME 列(零回归)。修「操作日志等时间段查不动」。
|
- **B2 AI 模块**:确定性(非 LLM)五环增量生产线合 main,终点恒人审、平台不内置生成 LLM;契约见 `AI_AGENT_*.md` + `skills/`。
|
||||||
- **🆕 用户选择框全家接线(最新口径)**:旧 `UserSelectWindow` / `UserOrgSelectWindow` 四个 dialogid 已由转换器接到 amis 标准 `picker`,单选/多选只通过 `multiple` 区分;数据源走统一 `/api/picker/<dialogid>/list`,表格弹窗保留搜索、分页、显名与 checkbox 多选。`eip4-web` 兼容过滤器会把历史 `user-transfer-picker` schema 归一成同一标准 picker。已页面烟测查询单选与业务表单多选;真实业务保存、ALL 互斥、权限差异和考勤源仍按 TODO 逐页验收。
|
|
||||||
- **🆕 流程选择框接线**:旧 `ProcessSelectDialog` 已由转换器接到 amis 内建 `transfer-picker`,后端 `/api/process-select/options|search` 维持旧值口径(流程名即提交值),数据源优先 Flowable Model/ProcDef,本地 dev 无模型时回退历史流程名。`919477da` 流程代理授权页面已页面烟测,保存闭环待验。
|
### 1.4 🔵 横向能力(已就绪,跨模块共用)
|
||||||
- **🆕 real-first 流解析**(`abc32af`):`_SEARCH` 优先真实 serviceflow(忠实旧引擎,无运行时合成兜底覆盖),统一所有操作读存储流。修约 107 列表打不开(无 createtime)+ 157 排序错;A/B 新修 33。
|
|
||||||
- **机制①** `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表(REGISTRY)**+ 整页改写器(MUTATORS,`b5fe995`,覆盖非 crud 加按钮类 delta:移除/改写默认页元素)**。
|
- 转换器通用能力:navigation 按钮、type=101 树选、picker 显名、filterscript 级联、colspan 栅格、A0 控件、EditGrid 子表递归、树编辑 layout 保真、搜索时间段过滤、`_SEARCH` real-first 流解析。
|
||||||
- **审批基础设施**:后端 `ApprovalController`(approval-meta/business-data/action)+ `TodoController`(trace)+ BusinessRecordLoader/WfTemplateService/StatusWriteback;前端 `ApprovalDrawer.tsx`(业务表单+轨迹+动态按钮+提交)。**已建成,缺的是 amis 列表页的入口按钮接线。**
|
- 机制① `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表 + 整页改写器。
|
||||||
- **保真层/写路径**:JUEL(jakarta.el JSR-223)跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、PG 升级、Flowable 升级。
|
- 审批基础设施:`ApprovalController` / `TodoController` / `ApprovalDrawer.tsx` / WfTemplate 驱动审批(缺列表入口接线)。
|
||||||
|
- 保真层/写路径:JUEL 跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、`PageSchemaWriter` 单一写真相(M3a `d3b8846`)、PG/Flowable 升级。
|
||||||
|
- AI 门禁五件套:page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan(已接 putOverlay,只严格约束 AI 草稿)。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -60,48 +67,74 @@
|
|||||||
|
|
||||||
| 文档 | 用途 |
|
| 文档 | 用途 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| **`项目进度与路线-总览-2026-06-17.md`** | **全项目进度盘点 + 剩余工作路线**(A 兼容 / B 新功能 + 关键路径 + 待拍板决策) |
|
| **`项目进度与路线-总览-2026-06-21.md`** | **全项目进度权威**:A/B 矩阵 + 增量交付 + 下一步 + 待拍板决策 |
|
||||||
| **`framework定制视图-TODO-2026-06-17.md`** | **当前活 TODO**:已改/已提交/待验/下一批优先级;每次修完必须回写 commit 与验证。 |
|
| `新人上手.md` | 新成员第一天路径(环境→起服务→验证→必读序→高频坑→红线) |
|
||||||
| **`framework定制视图-engineclass移植backlog-2026-06-17.md`** | 46 个 framework 定制视图迁移**主 backlog**(verdict/移植项/优先级 P1-P3) |
|
| `../CONTRIBUTING.md` | 分支/合并/提交/质量门/文档纪律约定(两仓通用) |
|
||||||
| **`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`** | 方法论 + 机制① + 踩坑 + filterscript 级联收口(首个端到端案例 + 会话交接) |
|
| `架构设计.md` | 双层制架构 / 工程结构 / 选型 / 红线(架构基线) |
|
||||||
| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(已设计、未实现) |
|
| `迁移手册.md` | 双层制纪律 + 踩坑四栏制(知识转移手册) |
|
||||||
| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(非定制,~1363 个)覆盖与收口(与定制视图是两条线) |
|
| `plans/2026-06-19-EIP4开发平台-架构方向-design.md` | 开发平台方向级 design(锁定 D1-D7) |
|
||||||
|
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design.md` | 主特性「人走五环」设计定型 |
|
||||||
|
| `plans/2026-06-19-EIP4开发平台-落地执行路线图.md` | 活路线图(M0-M8,状态随里程碑回写) |
|
||||||
|
| `plans/2026-06-25-A10-生产上线工程化-design.md` | A10 生产化 design(D1-D6 待拍板;W1-W4 骨架已合 main) |
|
||||||
|
| `plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md` | 报表 A3 设计(Phase1-3 已完成 + 安全收口,总览 §11) |
|
||||||
|
| `plans/2026-06-25-审批闭环-实施计划.md` | 审批闭环 P0-P3(已实施合 main `c95eaee`,剩外部前置) |
|
||||||
|
| `plans/2026-06-26-在线流程Modeler-design.md` | B3 流程 Modeler 设计(D1-D9 拍定) |
|
||||||
|
| `plans/2026-07-02-在线流程Modeler-实施计划.md` | B3 实施计划(4 阶段 17 任务 **全完成合 main 2026-07-02**;含语料/代码勘探基线 + 计划级决策 + 每阶段 live 验收发现 + 双对抗评审处置) |
|
||||||
|
| `AI_AGENT_AUTO_DEVELOPMENT.md` + `AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md` / `AI_AGENT_REPAIR_CONTRACT.md` / `AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` | AI Agent 对外口径红线 + 编译/修复/采纳契约 + Skills 目录 |
|
||||||
|
| `framework定制视图-TODO-2026-06-17.md` | A 兼容线**活清单**(Done/In-Progress/待验三态),每次修完回写 |
|
||||||
|
| `framework定制视图-engineclass移植backlog-2026-06-17.md` | 46 framework 视图迁移**主 backlog**(verdict/移植项/优先级) |
|
||||||
|
| `用户管理-Delta移植-实现过程与踩坑-2026-06-17.md` | engineclass Delta 移植方法论 + 机制① + 踩坑(首个端到端案例 + 交接) |
|
||||||
|
| `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` | **通用模板**(~1363)覆盖与收口(与定制视图两条线) |
|
||||||
|
| `组件设计体系-design-2026-06-15.md` | 全站 UI/UE 组件设计体系(落地状态以总览 B4 为准) |
|
||||||
| `客户沟通清单v1.md` | 商务/客户侧依赖卡点 |
|
| `客户沟通清单v1.md` | 商务/客户侧依赖卡点 |
|
||||||
| `plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md` | 审批界面实现方案(对应基础设施 🔵 已建) |
|
| `决策与盘点/EIP3架构决策{报告,会纪要}.md` | 奠基性决策 + 对外口径红线来源 |
|
||||||
| `决策与盘点/` | 架构决策报告/会纪要/客户库盘点(历史参考,奠基性) |
|
| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook(生产切流执行依据) |
|
||||||
| `P0-PG升级/`、`P3-Flowable升级/` | PG / Flowable 升级 runbook |
|
|
||||||
| `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) |
|
| `研究/` | 服务流分派、通知保存老vs新机制 trace(专题研究) |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 3. 全文档索引(含归档)
|
## 3. 全文档索引(含状态分级)
|
||||||
|
|
||||||
| 文档 | 状态 | 取代它的 / 备注 |
|
状态:现行·权威 | 现行 | 活清单 | **已完成·归档候选**(一次性 plan/报告,已落地,可后续 `git mv` 入 `归档/`)| 已归档 | 历史
|
||||||
|
|
||||||
|
| 文档 | 状态 | 备注 |
|
||||||
|---|---|---|
|
|---|---|---|
|
||||||
| README.md(本文) | 现行 | 唯一状态入口 |
|
| `项目进度与路线-总览-2026-06-21` | 现行·权威 | 进度唯一入口 |
|
||||||
| framework定制视图-TODO-2026-06-17 | 现行·活清单 | 当前执行队列,记录已改提交、待验项、下一批 |
|
| `归档/项目进度与路线-总览-2026-06-17` | 已归档(07-02) | 被 06-21 总览取代 |
|
||||||
| framework定制视图-engineclass移植backlog-2026-06-17 | 现行·权威 | framework 视图主 backlog |
|
| `README.md`(本文) | 现行·权威 | 文档地图 + 模块完成度 |
|
||||||
| 用户管理-Delta移植-…-2026-06-17 | 现行·权威 | 方法论+交接 |
|
| `架构设计`、`迁移手册` | 现行·权威 | 架构基线 |
|
||||||
| 组件设计体系-design-2026-06-15 | 现行 | — |
|
| `plans/2026-06-19-EIP4开发平台-架构方向-design` | 现行·权威 | 方向 D1-D7 |
|
||||||
| 通用模板全类型可用性-…-2026-06-16 | 现行 | 通用模板线 |
|
| `plans/2026-06-20-人走五环建新功能-NocoBase式-design` | 现行·权威 | 主特性设计 |
|
||||||
| 客户沟通清单v1 | 现行 | 商务线 |
|
| `plans/2026-06-19-EIP4开发平台-落地执行路线图` | 现行·活路线图 | 里程碑状态已回写本期进展 |
|
||||||
| `归档/framework系统管理视图-功能点Parity对照与实现计划-2026-06-16`(84K) | 已归档 | 被 engineclass backlog 取代 |
|
| `归档/2026-06-20-人走五环建新功能-实施计划` | 已归档(07-02) | 24 TDD 任务全完成 + 合 main |
|
||||||
| `归档/framework系统管理视图-实现交付报告-2026-06-17` | 已归档 | ⚠️「16 视图已交付」=demo 级,被数据驱动重审纠正;勿据此判进度 |
|
| `AI_AGENT_AUTO_DEVELOPMENT` / `PAGE_BLUEPRINT_CONTRACT` / `REPAIR_CONTRACT` / `Nocobase_ADOPTION_PLAN` / `Nocobase_SOURCE_REVIEW` | 现行·权威 | AI 契约族;前 4 份正文个别过时点已加横幅 |
|
||||||
| `归档/framework系统管理视图-数据驱动Parity重审与修复队列-2026-06-17` | 已归档 | 被 engineclass backlog 取代 |
|
| `skills/`(7 份:ai-feature-development / data-modeling / page-recipe / acl-manage / amis-pitfalls / env-manage / release-manage) | 现行·权威 | AI Agent Skills 目录(`eip4 init` 渲染分发,G1/G3) |
|
||||||
| `归档/framework定制视图-转换页审计-2026-06-17` | 已归档 | XML 审计(自评不可靠),被 engineclass backlog 取代 |
|
| `framework定制视图-TODO-2026-06-17` | 现行·活清单 | 执行队列 |
|
||||||
| `归档/EIP4-架构与缺口现状-2026-06-13`(34K) | 已归档 | 06-13 快照,早于 engineclass 重定性 + 06-14~17 全部工作 |
|
| `framework定制视图-engineclass移植backlog-2026-06-17` | 现行·权威 | framework 主 backlog(开头有 agent 思考噪声待清) |
|
||||||
| `归档/转换器覆盖度审计-2026-06-13` | 已归档 | 06-13 缺口快照 |
|
| `用户管理-Delta移植-…-2026-06-17` | 现行·权威 | 方法论 + 交接 |
|
||||||
| `归档/F2-17-审计基线-2026-06-13-升级` | 已归档 | 自动审计快照(历史) |
|
| `组件设计体系-design-2026-06-15` | 现行(落地状态见总览 B4) | 顶部已加横幅 |
|
||||||
| `归档/F2-17-组件真实性审计-修复后复测`(06-12) | 已归档 | 自动审计快照(历史) |
|
| `通用模板全类型可用性-…-2026-06-16` | 现行 | 通用模板线(§七运行库现状需复核) |
|
||||||
| `归档/F2-17-组件真实性审计基线`(06-12) | 已归档 | 自动审计快照(历史) |
|
| `客户沟通清单v1` | 现行 | 商务线(部分卡点随本期交付已消解) |
|
||||||
| `归档/F2-12-UI走查清单`(06-11/12) | 已归档 | UI 走查(历史) |
|
| `决策与盘点/`(架构决策报告/会纪要/客户库盘点/源码预核查/报表迁移方案/EIP4前端实施计划) | 现行·权威 + 历史盘点混放 | 决策报告/会纪要 = 现行权威红线来源;06-10 一次性盘点报告(源码预核查/客户库盘点/报表迁移方案)= 历史 |
|
||||||
| `归档/未完成工作清单`(06-12) | 已归档 | 早期清单,已被多轮取代 |
|
| `plans/2026-06-24-生成式OS数据驾驶舱-design` | 指针存根 | 方案已迁独立仓 `genos-cockpit`(权威在彼仓 docs/design/) |
|
||||||
| M0交付/、P1/、PoC证据/ 子目录 | 历史 | 阶段交付/简报/证据(保留备查,不反映当前进度) |
|
| `归档/`(06-14 onEvent修复/提交审批桥接/新闻管理、06-15 菜单维护、06-16 WfTemplate方案、CRUD-QA-06-14、C3压测基线、C5构建预演) | 已归档(07-02) | 一次性 plan/报告,均已落地;引用处已同步改路径 |
|
||||||
|
| `归档/`(framework parity/交付报告/数据驱动重审/转换页审计/EIP4-架构与缺口现状-06-13/转换器覆盖度审计-06-13/F2-12/F2-17 三件套/未完成工作清单) | 已归档 | 历史快照,**勿据以判进度** |
|
||||||
|
| `M0交付/`(153 处置清单 v1 / 153 终判证据包 / M0 剩余项登记) | 历史 | M0 阶段交付,已被 engineclass backlog + 终判取代 |
|
||||||
|
| `P1/`(F1/F2-x/F3/F4/P1-P4 简报 共 ~22 份) | 历史 | 阶段交付简报(部分已被后续重做取代,如审批 UI/选择窗),保留备查 |
|
||||||
|
| `决策与盘点/EIP3工程化实施计划` / `EIP3路线A-PoC执行方案` | 历史 | 早期工程化/PoC 方案 |
|
||||||
|
|
||||||
|
> eip4-web 仓另有 `docs/F1-4扫描报告.md`、`docs/P4脚手架报告.md`(06-11 一次性早期快照,建议 web 仓建 `docs/归档/` 归入)。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4. 下一步指引
|
## 4. 下一步指引
|
||||||
|
|
||||||
- framework 定制视图优先级见 backlog §5:P1 = 岗位·主岗位·查看菜单按钮组 / 查看审批 / 任务按钮 / 消息查看 / 短消息;用户选择框全家、流程选择框已进入业务逐页验收队列。
|
> 完整优先级排序见 `项目进度与路线-总览-2026-06-21.md` §5;P0②/P1④/P1⑥/P1⑤ 已实施 + 对抗审查 + 全验证,**已合 main 并 push**(总览 §9);安全基线 P0(§10.1)、报表 A3(§11)、审批闭环(A2)、A10 骨架均已收口/落地。
|
||||||
- **主攻方向待拍板**(候选:RBAC/组织模块组做到 parity | 全模块完成度审计 | 广度优先铺基线 | 任务/审批簇接线)。
|
|
||||||
|
- **P0**:① 文档对齐 ✅;② AI 门禁余项 —— 引擎 ALTER 安全通道 ✅ / 安全门 enforced ✅ / overlay 审计端点 ✅;存量 overlay 白名单 strict 化推进 待续。
|
||||||
|
- **P1**:③ framework 业务 106 视图 —— **双重阻塞:卡 S1 止损评审 + EIP-3.0 源码本地未克隆,无法分析迁移**;④ 人走五环 v2 改表加列 ✅(recipe 扩面 M7 待续);⑤ 流程审批列表入口 e2e ✅(真实流转依赖客户 BPMN、BPMN 图另案);⑥ 运行时 DELETE ✅ + publish 菜单授权 ✅(部署包下沉统一待续,已查两生成器现逻辑等价无 bug)。
|
||||||
|
- **P2**:~~报表 A3 立项~~(✅ 已完成,总览 §11)/ 附件 A4 补完 / 生产上线 A10 落地执行(骨架已建,剩切流/性能/灰度 + Gitea act_runner 注册)/ 生产级 UI B4 补完。
|
||||||
|
- **进行中方向**:B3 流程 Modeler(design 已拍定,待 plan→实现);报表作者化 WEB 设计器 + Agent 设计报表(目标已立,待 brainstorm→design)。
|
||||||
|
- **待拍板**(总览 §6):153 终判三选一、②面 AI/内置 LLM 立项、type100/101 死页停转或留、onEvent 面板自动化率边界、对外口径统一、webmail 是否纳入本期。
|
||||||
|
|
||||||
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。
|
- 部署/重转/导入 recipe、踩坑见「用户管理-Delta移植」§4 与本仓 `scripts/run-dev.sh`。
|
||||||
|
|||||||
BIN
docs/assets/eip4-architecture-2026-06-26.png
Normal file
BIN
docs/assets/eip4-architecture-2026-06-26.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.4 MiB |
@@ -9,9 +9,9 @@
|
|||||||
| 口径 | 数量 | 说明 |
|
| 口径 | 数量 | 说明 |
|
||||||
|---|---:|---|
|
|---|---:|---|
|
||||||
| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 |
|
| framework 定制视图总数 | 46 | README 总览口径;backlog 表格当前可解析出 45 行,需后续校正缺的 1 行。 |
|
||||||
| 已逐功能验收 / 可算 Done | 约 8 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批、我的发起任务。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
|
| 已逐功能验收 / 可算 Done | 约 16 | 用户管理、功能模板下载、实体分类-枚举组、已办任务、消息查看/已读、短消息、查看审批、我的发起任务、流程监控、通用脚本/XML 编辑器第一批、treeGrid 主键列隐藏、treeGrid 查询字段提交、treeGrid 实体分类级联、服务页实体显名、服务/实体配置下拉与子表加载、设置定时任务提醒人。功能模板下载/已办/消息查看各覆盖 2 个 templateId,但按 engineclass 各计 1 组。 |
|
||||||
| 代码已提交但待最终副作用验收 | 约 12 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;审批表单删除已补查看/删除端点和按钮注入;流程监控已补处理明细查看、结束流程和「高级处理」Groovy 执行入口;通用脚本/XML 编辑器已接入第一批页面;设置定时任务提醒人、数据导入下载/执行入口、功能/视图设计器入口、报表宿主、工作日历已接线。上述项未覆盖所有真实业务保存、权限差异或页面副作用验收。 |
|
| 代码已提交但待最终副作用验收 | 约 9 | 待办任务:列表、查看详细、处理抽屉已验;未点同意/拒绝。用户选择框全家已切标准 amis picker,并已覆盖单选查询、单选表单、多选弹窗层级与多选展示烟测;流程选择框已接线/页面烟测;审批表单删除已补查看/删除端点和按钮注入;数据导入下载/执行入口、功能/视图设计器入口、报表宿主、工作日历已接线。上述项未覆盖所有真实业务保存、权限差异或页面副作用验收。 |
|
||||||
| 仍需修或逐功能验收 | 约 38 | 含上面的待验组;大多是通用页已产出,但 engineclass Java delta 未迁移。 |
|
| 仍需修或逐功能验收 | 约 33 | 含上面的待验组;大多是通用页已产出,但 engineclass Java delta 未迁移或仍需真实业务副作用验收。 |
|
||||||
| 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 |
|
| 剩余工程单元 | 约 28+ | 多视图可复用同一套组件/端点,如脚本编辑器、消息详情、工作流按钮。 |
|
||||||
|
|
||||||
## Done(已完成 / 已验收)
|
## Done(已完成 / 已验收)
|
||||||
@@ -32,6 +32,14 @@
|
|||||||
| 2026-06-18 | 短消息 `MessageManageView`:发送消息弹窗、标准用户多选 picker、写 `sys_message/sys_messageuser`、发送后刷新已发列表 | Done | `eip4-platform 723443e` | `NoticeControllerTest`; `TemplateToAmisConverterTest#engineclass_MessageSendView_注入查看按钮,#engineclass_MessageManageView_注入发送消息弹窗`; live 浏览器验收 `ae79a47b`:打开「发送消息」→ 接收人标准 amis 表格 picker(搜索/分页/checkbox)→ 发送成功 → 不点搜索即在已发列表第一行出现 `codex短消息live刷新-*` |
|
| 2026-06-18 | 短消息 `MessageManageView`:发送消息弹窗、标准用户多选 picker、写 `sys_message/sys_messageuser`、发送后刷新已发列表 | Done | `eip4-platform 723443e` | `NoticeControllerTest`; `TemplateToAmisConverterTest#engineclass_MessageSendView_注入查看按钮,#engineclass_MessageManageView_注入发送消息弹窗`; live 浏览器验收 `ae79a47b`:打开「发送消息」→ 接收人标准 amis 表格 picker(搜索/分页/checkbox)→ 发送成功 → 不点搜索即在已发列表第一行出现 `codex短消息live刷新-*` |
|
||||||
| 2026-06-18 | 查看审批 `WorkFlowHistoryDetailPanel`:通用审批业务列表「查看审批」从轨迹表弹窗升级为只读 `ApprovalDrawer`,支持 businessKey/processInstanceId 双路历史查看,展示业务单据 + 流程轨迹 | Done | `eip4-platform 21e3865`, `eip4-web d03c2ba` | `TemplateToAmisConverterTest#buildToolbar_审批列表补查看审批按钮`; `ApprovalControllerHistoryTest`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl platform-app -am package -DskipTests`; 全量重转 2757 项,导入更新 636 项;浏览器验收 `18fb15c9`:选中第一行 →「查看审批」打开“审批详情”抽屉,含“业务单据(总包合同评审)/流程轨迹”,无旧“审批记录”弹窗 |
|
| 2026-06-18 | 查看审批 `WorkFlowHistoryDetailPanel`:通用审批业务列表「查看审批」从轨迹表弹窗升级为只读 `ApprovalDrawer`,支持 businessKey/processInstanceId 双路历史查看,展示业务单据 + 流程轨迹 | Done | `eip4-platform 21e3865`, `eip4-web d03c2ba` | `TemplateToAmisConverterTest#buildToolbar_审批列表补查看审批按钮`; `ApprovalControllerHistoryTest`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl platform-app -am package -DskipTests`; 全量重转 2757 项,导入更新 636 项;浏览器验收 `18fb15c9`:选中第一行 →「查看审批」打开“审批详情”抽屉,含“业务单据(总包合同评审)/流程轨迹”,无旧“审批记录”弹窗 |
|
||||||
| 2026-06-18 | 我的发起任务 `MySendTaskComponent`:列表改走 Flowable startedBy 聚合端点;查看详细打开只读 ApprovalDrawer;撤回桥接 Flowable changeActivityState + 挂起实例;起流写入 authenticated user,保证 startedBy 有数据 | Done | `61f3152` | `FlowControllerTest`; `FlowableClientTest`; `TodoControllerAmisTest`; `TemplateToAmisConverterTest#engineclass_MySendTaskComponent_注入查看详细和撤回按钮`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl flowable-service,platform-app -am clean package -DskipTests`; 全量重转 2757 项、导入更新 641 项;接口 E2E:`20424028` 以 `ADMIN` 发起后 `/api/workflow/process/started-amis` 返回 `E2E-MYSEND-BROWSER-20260618-0250`;浏览器验收 `0db4af06`:列表出现测试行,选中后“查看详细/撤回”启用,“查看详细”打开业务单据+流程轨迹;撤回后实例 `suspended=true` |
|
| 2026-06-18 | 我的发起任务 `MySendTaskComponent`:列表改走 Flowable startedBy 聚合端点;查看详细打开只读 ApprovalDrawer;撤回桥接 Flowable changeActivityState + 挂起实例;起流写入 authenticated user,保证 startedBy 有数据 | Done | `61f3152` | `FlowControllerTest`; `FlowableClientTest`; `TodoControllerAmisTest`; `TemplateToAmisConverterTest#engineclass_MySendTaskComponent_注入查看详细和撤回按钮`; `registerApprovalAction.test.ts`; `npm run build`; `mvn -q -pl flowable-service,platform-app -am clean package -DskipTests`; 全量重转 2757 项、导入更新 641 项;接口 E2E:`20424028` 以 `ADMIN` 发起后 `/api/workflow/process/started-amis` 返回 `E2E-MYSEND-BROWSER-20260618-0250`;浏览器验收 `0db4af06`:列表出现测试行,选中后“查看详细/撤回”启用,“查看详细”打开业务单据+流程轨迹;撤回后实例 `suspended=true` |
|
||||||
|
| 2026-06-18 | 流程监控 `ProcessMonitorComponentNew`:列表改走 Flowable 全量实例聚合;「处理」打开只读审批详情;「结束流程」桥接 Flowable terminate 并回写 `SYS_DATASTATUS=6`;「高级处理」执行 Groovy 脚本 | Done | 本次提交 | `TodoControllerAmisTest`; `TemplateToAmisConverterTest#engineclass_ProcessMonitorComponentNew_注入处理高级处理和结束流程按钮`; 接口 E2E:`/api/workflow/process/monitor-amis` 返回运行中/已撤回数据和发起人显示名,`/terminate` 已结束流程 409、运行中流程 200 且状态回写作废,`/advanced-script` 成功/失败脚本均按预期返回;全量重转 2757 项、导入扫描 2685 项/更新 677 项;内置浏览器验收 `9f3b5a8b`:列表有数据,选中后「处理/高级处理/结束流程」启用,「处理」打开业务单据 + 流程轨迹 |
|
||||||
|
| 2026-06-18 | 通用脚本/XML 编辑器(P2 第一批):定时任务脚本、数据导入转换/保存脚本、功能/视图 XML 高级配置统一走 `/api/field-editor/load|save` | Done | 本次提交 | `FieldEditorControllerTest`; `TemplateToAmisConverterTest`; live 可逆保存:`RUNSCRIPT`、`CONVERTSCRIPT`、`SAVESCRIPT`、`VIEW_TEMPLATE.XML`、`VIEW_PAGE.XML` 均完成保存-回读-恢复;非法 XML 返回业务失败不再 500;内置浏览器验收:`d99b5760` 打开「编辑任务脚本」并加载脚本,`8b89fd29` 打开「高级配置」并加载 XML,`7821ef3b` 打开「编辑转换脚本」并加载脚本,弹窗层级 `z-index=1400` |
|
||||||
|
| 2026-06-18 | 引用式 treeGrid 右表主键列隐藏:`hidden=true` 或 `iskeycolumn=true` 的 display 列统一默认隐藏,修复功能/视图/定时任务等 treeGrid 列表露出 UUID 主键 | Done | 本次提交 | `TemplateToAmisConverterTest#tree_treeGrid右表引用模板主键列默认隐藏`; `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`; 全量重转 2757 项、导入扫描 2685 项/更新 800 项;HTTP schema 确认 `8b89fd29 VIEW_TEMPLATE_ID`、`d7e12a83 VIEW_PAGE_ID`、`d99b5760 SYS_SCHEDULEJOB_ID` 均为 `toggled=false`;内置浏览器刷新 `8b89fd29` 后表头只剩「功能名称/模板类型/可作为菜单/模板解析类」,行内不再显示 UUID |
|
||||||
|
| 2026-06-18 | 服务页 `76ff564a` 实体列显名:转换器按 `SYS_REFERENCE → SYS_ENTITY` 识别旧式引用标识,把 `SYS_SERVICEFLOW.ENTITYID` 列改绑 `ENTITYID_DISPLAY__` | Done | 本次提交 | `TemplateToAmisConverterTest#引用列绑定到displayField字段`; 全量重转 2757 项、导入扫描 2685 项/更新 613 项;HTTP schema 确认服务页「实体」列 name=`ENTITYID_DISPLAY__`;接口 `/api/template/treegrid?...gridTable=SYS_SERVICEFLOW&rcol=ENTITYID` 返回 `ENTITYID_DISPLAY__=项目报销申请表`;内置浏览器刷新服务页后行显示「项目报销申请表」而非 UUID |
|
||||||
|
| 2026-06-18 | 服务/实体配置下拉与子表加载:枚举 ComboBox 在查询和编辑表单内联 `options`,避免远程字典下拉加载时序问题;`FormEditGrid` 支持旧 XML 的 `formeditgridtemplate/display/field` 列解析,并按 `pageid` 子页面字段定义恢复子表单元格组件(ComboBox/SelectDialog/NumberField 等),修复实体配置编辑/查看弹窗子表列为空或全部退化为文本框;服务页左树按排序字段/fallback 排序 | Done | 本次提交 | `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest#form_formEditGrid从display解析子表列,TemplateToAmisConverterTest#form_formEditGrid按pageid子页面字段定义生成quickEdit控件,TemplateToAmisConverterTest#crud_search枚举下拉优先内联options,TemplateToAmisConverterTest#form_editform枚举下拉优先内联options test`; `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`; 全量重转 2757 项、导入扫描 2727 项/更新 815 项;本轮补充重转导入扫描 2685 项/更新 155 项;HTTP schema 确认实体编辑 `8de37a6d` 的 `ATTRIBUTES` 子表 13 列,`ISMANDATORY/ISREADONLY` 为 `select false/true`、`REFERENCEID` 为 `picker`、`FIELDLENGTH` 为 `input-number`;接口确认项目报销申请表 `ATTRIBUTES=29`;内置浏览器验收:服务配置查询/弹窗下拉可展开,服务新增内容为 XML editor,实体配置查询下拉可展开,实体编辑弹窗「实体属性」子表表头正常显示,子表 DOM 出现 `cxd-Select`、`cxd-Picker`、`cxd-NumberControl` |
|
||||||
|
| 2026-06-18 | TreeGrid 右表查询通用修复:转换器把 gridtemplate `<search>` 字段显式拼入 `/api/template/treegrid` CRUD api,修复 treegrid 页面点击搜索不提交查询字段;BOOLEAN 查询值按列元数据 coerce,编辑兜底表单 BOOLEAN 下拉 options 与 load 返回值统一为 `false/true` | Done | 本次提交 | `TemplateToAmisConverterTest#tree_treeGrid右表查询字段拼入api`; `TemplateToAmisConverterTest#crud_search布尔枚举下拉内联为booleanOptions`; `FlowInputCoercerTest#coerceSearchValuesByTableBoolean`; 全量重转 2757 项、导入扫描 2685 项/更新 638 项;HTTP schema 确认服务页 `76ff564a` 的 treegrid api 含 `SYS_SERVICEFLOW_ID/DISPLAYNAME/ISCONTROL/ISUPDATEABLE`;接口确认 `DISPLAYNAME=项目` 返回 642 条、`ISCONTROL=false/true` 分别返回 1946/3052 条;内置浏览器验收:服务页「服务流名称=签到」从 500 页缩为 10 行且项目报销行消失,「是否受权限控制=否」后剩余行该列全为“否” |
|
||||||
|
| 2026-06-18 | TreeGrid 实体分类级联:`/api/template/treegrid` 对伪 `rcol=ENTITYTYPE` 按关联表转换为右表主键 IN,恢复功能管理/视图管理/定义定时任务左树实体分类过滤右表 | Done | 本次提交 | `TemplateTreeControllerTest`; HTTP smoke:功能管理 `VIEW_TEMPLATE`、视图管理 `VIEW_PAGE`、定义定时任务 `SYS_SCHEDULEJOB` 分类过滤均 200;内置浏览器验收:`8b89fd29` 点击「数据字典/表单管理/用户组织管理」右表分别出现自动编号/视图管理/部门选择等模板;`d7e12a83-904d-42ed-ae05-39a83bee8c76` 点击同三类后右表分别出现自动编号添加页面/视图编辑页面/部门编辑页面;`d99b5760-ce63-4e15-aa5d-05430cc25d10` 默认有定时任务,点击「数据字典/表单管理/用户组织管理」变为暂无数据,点击有数据的「人员证书管理」出现「证书借用到期提醒/十大员证到期提醒」等任务 |
|
||||||
|
| 2026-06-18 | 设置定时任务 `70f85b21`:`ScheduleJobSettingComponent` 的「设置提醒人」按旧 `SYS_SCHEDULEJOB.SENDINFO` 结构化编辑,提醒对象收敛到单列 group,避免 input-table 列级 visibleOn 导致用户/部门/岗位 picker 不显示;维度下拉兼容无 `SEQ` 字段的 `SYS_DIMENSION` | Done | 本次提交 | `ScheduleJobNotifyControllerTest`; `TemplateToAmisConverterTest#engineclass_ScheduleJobSettingComponent_注入设置提醒人规则编辑器`; `mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest test`; 全量重转 2757 项且 onEvent 挂载 502 个模板,导入扫描 2727 项/更新 955 项;HTTP smoke:`/api/schedulejob/dimensions/options` 返回 status 0;接口闭环:对任务 `0b85a1ec-3a0b-4862-b2eb-05dd68d20481` 写入用户/部门/固定维度岗位类别/项目角色 4 类规则,DB JSON 与 GET 回显一致,验后恢复 `SENDINFO=NULL`;内置浏览器验收 `70f85b21`:选中 `test` 行打开「设置提醒人」,表头为「基于/提醒对象/短消息/邮件/手机/操作」,用户行显示标准 picker |
|
||||||
|
|
||||||
## In Progress / Needs Verification
|
## In Progress / Needs Verification
|
||||||
|
|
||||||
@@ -41,10 +49,6 @@
|
|||||||
| 用户选择框全家 | Implemented / Needs business verification | 最新口径:用户单选 `SelectDialog`、多选 `MultiSelectDialog` 均使用标准 amis `picker`(单选不加 `multiple`;多选 `multiple:true` + `overflowConfig.maxTagCount=1`;数据源 `/api/picker/<dialogid>/list`),`eip4-web` 兼容过滤器继续把存量 `user-transfer-picker` 归一成标准 picker。本轮补丁补齐运行时默认值契约:转换器给编辑/查看弹窗 load 服务追加 `?__egtpl=<editFormViewPageId>`,`FlowController` 按该编辑表单 XML 将 load 返回的 `SelectDialog/MultiSelectDialog` 裸 id 解析为 `{_id,_label}`(多选为对象数组),避免默认值显示 UUID 或撑开布局。部署:`BatchConvertCli` 全量重转 2757 项(view_page 编辑表单 1241 个产物),`SchemaImportCli` 扫描 2727 个产物、入库/更新 1054 个,8093 已重启。自动化:`mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest#read按钮接load服务_dialog用api加载本体数据,TemplateToAmisConverterTest#crud_用户单选框受控转标准Picker,TemplateToAmisConverterTest#crud_用户选择框组织与考勤模式接线,TemplateToAmisConverterTest#crud_multiSelectDialog转picker多选弹窗 test`、`mvn -q -pl platform-metadata -Dtest=FlowControllerTest#postLoadWithEditTemplateResolvesPickerDefaults test`、`npm test -- --run src/amis/registerUserTransferPicker.test.ts`。浏览器烟测:`5078945c`「用户组-分配用户」为标准多选 picker,默认值显示 `施继栋002[222222]`、无裸 UUID、控件 32px、二级弹窗含搜索/分页/checkbox;`919477da`「流程代理授权」代理人为标准单选 picker,控件与 label 对齐且二级弹窗实际 input 类型为 radio;短消息 `ae79a47b` 已覆盖多选 picker 选人并保存。 | 继续在设置定时任务、岗位设置等真实引用页验保存值、ALL 互斥、受控/全部权限差异和考勤排除挂靠 |
|
| 用户选择框全家 | Implemented / Needs business verification | 最新口径:用户单选 `SelectDialog`、多选 `MultiSelectDialog` 均使用标准 amis `picker`(单选不加 `multiple`;多选 `multiple:true` + `overflowConfig.maxTagCount=1`;数据源 `/api/picker/<dialogid>/list`),`eip4-web` 兼容过滤器继续把存量 `user-transfer-picker` 归一成标准 picker。本轮补丁补齐运行时默认值契约:转换器给编辑/查看弹窗 load 服务追加 `?__egtpl=<editFormViewPageId>`,`FlowController` 按该编辑表单 XML 将 load 返回的 `SelectDialog/MultiSelectDialog` 裸 id 解析为 `{_id,_label}`(多选为对象数组),避免默认值显示 UUID 或撑开布局。部署:`BatchConvertCli` 全量重转 2757 项(view_page 编辑表单 1241 个产物),`SchemaImportCli` 扫描 2727 个产物、入库/更新 1054 个,8093 已重启。自动化:`mvn -q -pl platform-converter -Dtest=TemplateToAmisConverterTest#read按钮接load服务_dialog用api加载本体数据,TemplateToAmisConverterTest#crud_用户单选框受控转标准Picker,TemplateToAmisConverterTest#crud_用户选择框组织与考勤模式接线,TemplateToAmisConverterTest#crud_multiSelectDialog转picker多选弹窗 test`、`mvn -q -pl platform-metadata -Dtest=FlowControllerTest#postLoadWithEditTemplateResolvesPickerDefaults test`、`npm test -- --run src/amis/registerUserTransferPicker.test.ts`。浏览器烟测:`5078945c`「用户组-分配用户」为标准多选 picker,默认值显示 `施继栋002[222222]`、无裸 UUID、控件 32px、二级弹窗含搜索/分页/checkbox;`919477da`「流程代理授权」代理人为标准单选 picker,控件与 label 对齐且二级弹窗实际 input 类型为 radio;短消息 `ae79a47b` 已覆盖多选 picker 选人并保存。 | 继续在设置定时任务、岗位设置等真实引用页验保存值、ALL 互斥、受控/全部权限差异和考勤排除挂靠 |
|
||||||
| 流程选择框 | Implemented / Needs business verification | `ProcessSelectController` 已提供 `/api/process-select/options|search`;转换器已把 `b3070157` 接到 amis `transfer-picker`;`919477da` 流程代理授权已重转重导并从 PARTIAL 转 SUCCESS;浏览器 smoke 可打开弹窗,显示「流程名称/已选流程」和流程名 | 继续验流程代理授权保存闭环:代理类型=指定流程时必填、保存后 `wf_agent_process` 写入/读取一致 |
|
| 流程选择框 | Implemented / Needs business verification | `ProcessSelectController` 已提供 `/api/process-select/options|search`;转换器已把 `b3070157` 接到 amis `transfer-picker`;`919477da` 流程代理授权已重转重导并从 PARTIAL 转 SUCCESS;浏览器 smoke 可打开弹窗,显示「流程名称/已选流程」和流程名 | 继续验流程代理授权保存闭环:代理类型=指定流程时必填、保存后 `wf_agent_process` 写入/读取一致 |
|
||||||
| 审批表单删除 `91ccbba3` | Implemented / Needs page verification | `eip4-platform 1d8a4fe` 已补 `flowable-service` 历史流程删除端点 `/api/flow/process/{processInstanceId}/delete-history`(运行中流程 409)、网关 AMIS 端点 `/api/workflow/process/{processInstanceId}/delete-history`、`ProcessFormRemoveComponent` 查看/删除按钮注入与 CRUD reload 锚点。自动化已过:`FlowControllerTest`、`TodoControllerAmisTest,FlowableClientTest`、`TemplateToAmisConverterTest#engineclass_ProcessFormRemoveComponent_注入查看和删除历史流程按钮`;打包已过:`mvn -q -pl flowable-service package -DskipTests`、`mvn -q -pl platform-app -am package -DskipTests`。 | 重转/导入 `91ccbba3` 后浏览器验收:列表选中已结束流程 → 查看打开只读 ApprovalDrawer;删除成功后列表刷新;运行中流程删除返回 409 且不误删 |
|
| 审批表单删除 `91ccbba3` | Implemented / Needs page verification | `eip4-platform 1d8a4fe` 已补 `flowable-service` 历史流程删除端点 `/api/flow/process/{processInstanceId}/delete-history`(运行中流程 409)、网关 AMIS 端点 `/api/workflow/process/{processInstanceId}/delete-history`、`ProcessFormRemoveComponent` 查看/删除按钮注入与 CRUD reload 锚点。自动化已过:`FlowControllerTest`、`TodoControllerAmisTest,FlowableClientTest`、`TemplateToAmisConverterTest#engineclass_ProcessFormRemoveComponent_注入查看和删除历史流程按钮`;打包已过:`mvn -q -pl flowable-service package -DskipTests`、`mvn -q -pl platform-app -am package -DskipTests`。 | 重转/导入 `91ccbba3` 后浏览器验收:列表选中已结束流程 → 查看打开只读 ApprovalDrawer;删除成功后列表刷新;运行中流程删除返回 409 且不误删 |
|
||||||
| 流程监控 `9f3b5a8b` | Implemented / Needs page verification | `eip4-platform a019af8` 已补 `flowable-service` 运行中流程结束端点 `/api/flow/process/{processInstanceId}/terminate`(已结束流程 409)、网关 AMIS 端点 `/api/workflow/process/{processInstanceId}/terminate` 并回写 `SYS_DATASTATUS=6(作废)`、`ProcessMonitorComponentNew` 注入「处理」和「结束流程」按钮与 CRUD reload 锚点;`eip4-platform 3523007` 已补「高级处理」按钮和 `/api/workflow/process/{processInstanceId}/advanced-script` Groovy 执行入口,绑定 `processid/businessKey/processInstanceId/tableName/currentUser*` 等上下文。「处理」当前复用只读 ApprovalDrawer 承载流程监控明细查看。自动化已过:`FlowControllerTest`、`TodoControllerAmisTest,FlowableClientTest`、`TemplateToAmisConverterTest#engineclass_ProcessMonitorComponentNew_注入处理和结束流程按钮`、`TodoControllerAmisTest` 高级脚本成功/失败、`TemplateToAmisConverterTest` 高级处理按钮;打包已过:`mvn -q -pl flowable-service package -DskipTests`、`mvn -q -pl platform-app -am package -DskipTests`。部署:全量重转 2757 项、导入扫描 2727 项/更新 647 项,HTTP schema 已确认含「高级处理」和 `/advanced-script`。 | 浏览器验收:选中运行中流程 → 处理打开审批详情;结束流程成功后列表刷新且状态回写作废;已结束流程返回 409;高级处理执行只读脚本/失败脚本并确认错误提示、权限与审计口径 |
|
|
||||||
| 通用脚本/XML 编辑器(第一批) | Implemented / Needs page verification | `eip4-platform 3523007` 新增 `/api/field-editor/load|save`,白名单限制 `RUNSCRIPT/CONVERTSCRIPT/SAVESCRIPT/XML/CONTENTXML/SENDINFO`;转换器已给 `d99b5760` 定义定时任务注入「编辑任务脚本」、`7821ef3b` 数据导入配置注入「编辑转换脚本/编辑保存脚本」、`8b89fd29/d7e12a83/117374e1/de403e76` 功能/视图管理和自定义列表注入 XML「高级配置」。自动化已过:`FieldEditorControllerTest`、`TemplateToAmisConverterTest` 定时任务嵌套 CRUD 和数据导入脚本按钮;打包已过:`mvn -q -pl platform-app -am package -DskipTests`。部署:全量重转 2757 项、导入扫描 2727 项/更新 647 项,HTTP schema 已确认 `d99b5760`、`7821ef3b`、`9f3b5a8b` 按钮与端点存在。本次 P2 又给功能/视图管理四个页面补了设计器入口,浏览器 smoke 已确认 `8b89fd29` 页面可见「编辑模板/高级配置」。 | 浏览器逐页验:打开脚本/XML 弹窗、加载已有值、保存后 DB 字段一致;确认弹窗层级、只读/必填、空值保存和异常提示 |
|
|
||||||
| TreeGrid 实体分类级联 | Implemented / Needs page verification | `eip4-platform 1ef3de1` 修复 `/api/template/treegrid` 对伪 `rcol=ENTITYTYPE` 的处理:老源码实际是 `ENTITYS -> ENTITYTYPE` 关联过滤,现对白名单 `VIEW_TEMPLATE/VIEW_PAGE/SYS_SCHEDULEJOB` 通过 `view_templateentity/view_pageentity/sys_schedulejobentity` 转成主键 IN,再交给原 `_SEARCH` 流。自动化已过:`TemplateTreeControllerTest`;打包已过:`mvn -q -pl platform-app -am package -DskipTests`;8093 已重启。HTTP smoke:功能管理 `VIEW_TEMPLATE` 节点返回 `total=77`,视图管理 `VIEW_PAGE` 节点返回 `total=75`,定义定时任务 `SYS_SCHEDULEJOB` 节点返回 `total=13`,均 200/status=0。 | 浏览器验收:`8b89fd29`、`d7e12a83`、`d99b5760` 左树点击后右表数据随实体分类变化;新增时默认实体分类/关联实体保存口径仍需页面闭环 |
|
|
||||||
| 设置定时任务 `70f85b21` | Implemented / Needs page verification | `eip4-platform c9e4d35` 新增 `/api/schedulejob/{id}/notify` GET/POST、`/api/schedulejob/dimensions/options`、`/api/schedulejob/project-role-options`,把旧 `SYS_SCHEDULEJOB.SENDINFO` 的 `{"items":[...]}` 拆成 input-table 结构化编辑并保存回旧 JSON;转换器给 `ScheduleJobSettingComponent` 注入「设置提醒人」,用户/部门/岗位/岗位类别使用标准 amis picker。自动化已过:`ScheduleJobNotifyControllerTest`、`TemplateToAmisConverterTest#engineclass_ScheduleJobSettingComponent_注入设置提醒人规则编辑器`;部署:全量重转 2757 项、导入扫描 2727 项/更新 794 项,8093 已重启;HTTP smoke:`/api/schedulejob/NO_SUCH/notify` 返回 200/业务失败,`70f85b21` schema 含「设置提醒人」和 `/api/schedulejob/`。 | 浏览器验收:打开提醒人弹窗、加载已有 `SENDINFO`、新增/修改用户/部门/岗位/维度/项目角色规则后保存,DB JSON 与页面回显一致 |
|
|
||||||
| 功能/视图管理设计入口 `8b89fd29/d7e12a83/117374e1/de403e76` | Implemented / Browser smoke verified | `eip4-platform 5636b37`:转换器给 `UserFunDesignComponent/UserPageDesignComponent` 注入「编辑模板/编辑页面」并打开现有 `/editor.html?templateId=${selectedItems[0].<pk>}`;给自定义列表 `UserFunDesignCustomComponent/UserPageDesignCustomComponent` 按底层 `TEMPLATEID/PAGEID` 打开设计器,避免用自定义行主键。自动化:`TemplateToAmisConverterTest#engineclass_功能和视图管理注入设计器入口`、`#engineclass_功能和视图自定义列表设计器入口使用底层模板和页面Id`。部署:全量重转 2757 项、导入扫描 2727 项/更新 644 项;HTTP schema 已确认四页入口均存在;内置浏览器 smoke:`8b89fd29` 可见「编辑模板/高级配置」。 | 页面副作用验收:选中真实功能/视图行后打开设计器,编辑保存后 overlay/schema 变化可回读;自定义列表确认打开的是底层 `TEMPLATEID/PAGEID` 对应设计器 |
|
| 功能/视图管理设计入口 `8b89fd29/d7e12a83/117374e1/de403e76` | Implemented / Browser smoke verified | `eip4-platform 5636b37`:转换器给 `UserFunDesignComponent/UserPageDesignComponent` 注入「编辑模板/编辑页面」并打开现有 `/editor.html?templateId=${selectedItems[0].<pk>}`;给自定义列表 `UserFunDesignCustomComponent/UserPageDesignCustomComponent` 按底层 `TEMPLATEID/PAGEID` 打开设计器,避免用自定义行主键。自动化:`TemplateToAmisConverterTest#engineclass_功能和视图管理注入设计器入口`、`#engineclass_功能和视图自定义列表设计器入口使用底层模板和页面Id`。部署:全量重转 2757 项、导入扫描 2727 项/更新 644 项;HTTP schema 已确认四页入口均存在;内置浏览器 smoke:`8b89fd29` 可见「编辑模板/高级配置」。 | 页面副作用验收:选中真实功能/视图行后打开设计器,编辑保存后 overlay/schema 变化可回读;自定义列表确认打开的是底层 `TEMPLATEID/PAGEID` 对应设计器 |
|
||||||
| 数据导入配置/文件管理 `7821ef3b/1d132d4a` | Implemented / Browser smoke verified | `eip4-platform c9e4d35` 新增 `/api/dataimport/template?configId=...` 和 `/api/dataimport/basedata`,用 SpreadsheetML 2003 输出 Excel/WPS 可打开的 `.xls`;`eip4-platform 5636b37` 新增 `DataImportExecuteController`、`DataImportExecutionService`、`DataImportExcelParser`、`DataImportScriptHelper`,支持 SpreadsheetML/Excel 解析、zip 内首个 Excel、旧 `CONVERTSCRIPT/SAVESCRIPT` Groovy、`findUser/findCompany/findDepart/findProject/findUnitProject/findProjectCompany/findUserOrg/findUserDepart/findUserPosition/savePo/saveDoc/saveWf/execSql`,`saveWf` 同步写旧 `wf_hi_*`、Flowable `act_hi_*` 和 `sys_datastatus`。转换器给 `DataImportConfigView` 注入「下载模板/下载基础数据」,给 `DataExcelImportView` 注入「执行」。自动化:`DataImportConfigControllerTest`、`DataImportExcelParserTest`、`DataImportExecuteControllerTest`、`TemplateToAmisConverterTest#engineclass_DataExcelImportView_注入执行按钮`;HTTP smoke:`7821ef3b` schema 含下载端点,`1d132d4a` schema 含「执行」和 `/api/dataimport/execute`,`POST /api/dataimport/execute?fileId=NO_SUCH_FILE` 返回业务 422;内置浏览器 smoke:`1d132d4a` 可见「执行」。 | 业务验收:选中配置后下载模板文件可打开且列符合实体;基础数据文件可打开且含公司/用户/部门/工程 sheet;准备一份非生产导入文件,点击「执行」后确认目标业务表、附件、流程历史与 `sys_datastatus` 写入一致 |
|
| 数据导入配置/文件管理 `7821ef3b/1d132d4a` | Implemented / Browser smoke verified | `eip4-platform c9e4d35` 新增 `/api/dataimport/template?configId=...` 和 `/api/dataimport/basedata`,用 SpreadsheetML 2003 输出 Excel/WPS 可打开的 `.xls`;`eip4-platform 5636b37` 新增 `DataImportExecuteController`、`DataImportExecutionService`、`DataImportExcelParser`、`DataImportScriptHelper`,支持 SpreadsheetML/Excel 解析、zip 内首个 Excel、旧 `CONVERTSCRIPT/SAVESCRIPT` Groovy、`findUser/findCompany/findDepart/findProject/findUnitProject/findProjectCompany/findUserOrg/findUserDepart/findUserPosition/savePo/saveDoc/saveWf/execSql`,`saveWf` 同步写旧 `wf_hi_*`、Flowable `act_hi_*` 和 `sys_datastatus`。转换器给 `DataImportConfigView` 注入「下载模板/下载基础数据」,给 `DataExcelImportView` 注入「执行」。自动化:`DataImportConfigControllerTest`、`DataImportExcelParserTest`、`DataImportExecuteControllerTest`、`TemplateToAmisConverterTest#engineclass_DataExcelImportView_注入执行按钮`;HTTP smoke:`7821ef3b` schema 含下载端点,`1d132d4a` schema 含「执行」和 `/api/dataimport/execute`,`POST /api/dataimport/execute?fileId=NO_SUCH_FILE` 返回业务 422;内置浏览器 smoke:`1d132d4a` 可见「执行」。 | 业务验收:选中配置后下载模板文件可打开且列符合实体;基础数据文件可打开且含公司/用户/部门/工程 sheet;准备一份非生产导入文件,点击「执行」后确认目标业务表、附件、流程历史与 `sys_datastatus` 写入一致 |
|
||||||
| 报表 `e81454af-0e0e-4c0d-add8-db434f198936` | Implemented / Browser smoke verified | `eip4-platform 5636b37` 新增 `ReportMenuController` `/api/report/menu-tree`,按旧 `ReportComponent` 的 DOCUMENT 菜单树口径从 `VIEW_SYS_MENU` 构建父菜单/类型/报表三级树,并只返回 `sys_page_schema` 已有的可路由叶子;`PageSchemaController` 对报表 templateId 提供内置宿主 schema,左侧树选择叶子后右侧用 `/api/page/schema/${reportTemplateId}?format=amis` 复用已转换页。自动化:`ReportMenuControllerTest`、`PageSchemaControllerTest#reportHostBuiltinSchemaFallback`;HTTP smoke:`/api/report/menu-tree` 返回 110 个叶子,宿主 schema 200 且含 `/api/report/menu-tree`、`report-schema-host`;内置浏览器 smoke:报表页显示 DOCUMENT 菜单树和「请选择左侧报表」。 | 页面副作用验收:逐类选择 3-5 个真实报表叶子,确认右侧报表页 schema 加载、查询条件、分页和导出/打印等报表专属动作是否需要继续迁移 |
|
| 报表 `e81454af-0e0e-4c0d-add8-db434f198936` | Implemented / Browser smoke verified | `eip4-platform 5636b37` 新增 `ReportMenuController` `/api/report/menu-tree`,按旧 `ReportComponent` 的 DOCUMENT 菜单树口径从 `VIEW_SYS_MENU` 构建父菜单/类型/报表三级树,并只返回 `sys_page_schema` 已有的可路由叶子;`PageSchemaController` 对报表 templateId 提供内置宿主 schema,左侧树选择叶子后右侧用 `/api/page/schema/${reportTemplateId}?format=amis` 复用已转换页。自动化:`ReportMenuControllerTest`、`PageSchemaControllerTest#reportHostBuiltinSchemaFallback`;HTTP smoke:`/api/report/menu-tree` 返回 110 个叶子,宿主 schema 200 且含 `/api/report/menu-tree`、`report-schema-host`;内置浏览器 smoke:报表页显示 DOCUMENT 菜单树和「请选择左侧报表」。 | 页面副作用验收:逐类选择 3-5 个真实报表叶子,确认右侧报表页 schema 加载、查询条件、分页和导出/打印等报表专属动作是否需要继续迁移 |
|
||||||
@@ -54,19 +58,16 @@
|
|||||||
|
|
||||||
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |
|
| 优先级 | 范围 | 视图 / engineclass | 要补什么 | 复用机制 |
|
||||||
|---|---|---|---|---|
|
|---|---|---|---|---|
|
||||||
| P1 | 流程监控(剩余) | `9f3b5a8b` | 已接线;待页面副作用验收见上方 Needs Verification | 通用 code-editor + Groovy 权限/审计端点 |
|
| P1 | - | - | 2026-06-18 已清零;流程监控已移入 Done | - |
|
||||||
|
|
||||||
## P2(中等 delta,可批量复用)
|
## P2(中等 delta,可批量复用)
|
||||||
|
|
||||||
> 2026-06-18:P2 缺实现项已清零;下表只保留仍需业务副作用验收的页面闭环。
|
> 2026-06-18:P2 实现项和代表性浏览器烟测已完成;下表只保留不阻塞 P2 完成的真实业务副作用/产品形态确认。
|
||||||
|
|
||||||
| 范围 | 视图 | 要补什么 | 复用点 |
|
| 范围 | 视图 | 要补什么 | 复用点 |
|
||||||
|---|---|---|---|
|
|---|---|---|---|
|
||||||
| 脚本/XML 编辑器 | 定义定时任务、数据导入配置、流程监控高级处理、功能/视图编辑列表-自定义 | 第一批已接线;按字段保存 `RUNSCRIPT` / `CONVERTSCRIPT` / `SAVESCRIPT` / XML;待页面保存副作用验收 | 一个组件多处接线 |
|
| 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 高级配置 XML、左树到右 grid 实体分类级联、编辑模板/可视化设计器入口均已接线;实体分类级联已逐页验收,仍需真实设计器 overlay 保存副作用验收 | 机制① mutator + 设计中心/overlay |
|
||||||
| 功能管理 / 视图管理 | `8b89fd29`, `d7e12a83` | 高级配置 XML、左树到右 grid 实体分类级联、编辑模板/可视化设计器入口均已接线;待页面保存副作用验收 | 机制① mutator + 设计中心/overlay |
|
| 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 高级配置 XML、按底层 `TEMPLATEID/PAGEID` 打开设计器均已接线;仍需真实设计器 overlay 保存副作用验收 | 同设计器/编辑器能力 |
|
||||||
| 功能编辑列表-自定义 / 视图编辑列表-自定义 | `117374e1`, `de403e76` | 高级配置 XML、按底层 `TEMPLATEID/PAGEID` 打开设计器均已接线;待页面保存副作用验收 | 同设计器/编辑器能力 |
|
|
||||||
| 定义定时任务 | `d99b5760` | 编辑任务脚本已接线;左树到右 grid 实体分类级联已恢复;仍缺页面保存副作用验收 | 级联 + code-editor |
|
|
||||||
| 设置定时任务 | `70f85b21` | 设置提醒人已接线;仍缺页面保存副作用验收 | 用户选择框 + UserTable 规则 |
|
|
||||||
| 数据导入配置/文件管理 | `7821ef3b`, `1d132d4a` | 编辑转换/保存脚本、下载模板、下载基础数据、执行导入端点和文件页「执行」按钮已接线;待真实文件导入和下载文件打开验收 | code-editor + 导入端点 |
|
| 数据导入配置/文件管理 | `7821ef3b`, `1d132d4a` | 编辑转换/保存脚本、下载模板、下载基础数据、执行导入端点和文件页「执行」按钮已接线;待真实文件导入和下载文件打开验收 | code-editor + 导入端点 |
|
||||||
| 工作日历 | `a13fa07f` | 已接线:例外日服务、年度列表、toggle、3 态状态;待用户确认是否必须复刻旧 3x4 月历网格 | 新 bespoke 页 + 旧表 `SYS_CALENDAREXCEPTDAY` |
|
| 工作日历 | `a13fa07f` | 已接线:例外日服务、年度列表、toggle、3 态状态;待用户确认是否必须复刻旧 3x4 月历网格 | 新 bespoke 页 + 旧表 `SYS_CALENDAREXCEPTDAY` |
|
||||||
| 报表 | `e81454af-0e0e-4c0d-add8-db434f198936` | DOCUMENT 菜单树和右区按 `VIEW_TEMPLATEID` 路由复用已转换页已接线;待真实报表叶子页面副作用验收 | 路由宿主 |
|
| 报表 | `e81454af-0e0e-4c0d-add8-db434f198936` | DOCUMENT 菜单树和右区按 `VIEW_TEMPLATEID` 路由复用已转换页已接线;待真实报表叶子页面副作用验收 | 路由宿主 |
|
||||||
|
|||||||
133
docs/plans/2026-06-19-EIP4开发平台-架构方向-design.md
Normal file
133
docs/plans/2026-06-19-EIP4开发平台-架构方向-design.md
Normal file
@@ -0,0 +1,133 @@
|
|||||||
|
# EIP4 开发平台 · 架构方向(与最初设计对齐版)
|
||||||
|
|
||||||
|
> 日期:2026-06-19 | 性质:方向级 design(brainstorm 收敛 + 最初设计考古 + 引擎代码核实 + 对抗审查产出)
|
||||||
|
> 配套权威:`项目进度与路线-总览-2026-06-21.md`(A 兼容 / B 新能力全景,取代 06-17 版)、`架构设计.md`(双层制/选型/红线)、`决策与盘点/EIP4前端与收尾实施计划.md`(F4 低代码工具链原始定义)
|
||||||
|
> 方法:9-agent workflow(7 路考古/代码核实 → 综合 → 对抗审查),逐行核实引擎实况。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. 一句话结论
|
||||||
|
|
||||||
|
**「153 收尾后做可视化开发平台」不是另起炉灶,是项目最初路线图里 F4「低代码工具链 L1→L3」的兑现。** 方向成立(对抗审查判决 `sound-with-fixes`),但最初设计逼出三根硬约束(一根是「触发重新决策」级),需带 6 条修正落地。
|
||||||
|
|
||||||
|
## 1. 背景与驱动(用户拍板)
|
||||||
|
|
||||||
|
- **先 B 提效、再 A 卖点**:先用新能力填「建页/建模/交付太慢太贵」的钱坑,再讲 AI/现代化差异化。
|
||||||
|
- **递进**:存量 153 定制视图用现有兼容方式(转换器 mutator)啃完(已完成几十个);真正重点是 153 后,面向「**未来功能维护 + 新功能开发**」要有一套现代可视化开发平台,覆盖【**元数据 → 表结构 → 设计 → 实现功能 → 发布**】五环。
|
||||||
|
- **AI 独立轨**:已在另一分支做,定位=给 AI coding 工具(Claude Code/Cursor)供 **MCP + CLI**,不是应用内 AI 生成 schema。
|
||||||
|
- **定位**:内部交付提效工具(**非**对客户售卖的低代码/自助配置平台——见 §5 红线)。
|
||||||
|
|
||||||
|
## 2. 与最初设计「一脉相承」的依据(5 处文档锚点)
|
||||||
|
|
||||||
|
| 本方向 | 最初设计原文锚点 |
|
||||||
|
|---|---|
|
||||||
|
| 五环【元数据→表→设计→实现→发布】 | 《EIP4前端与收尾实施计划》F4 总览:**「低代码工具链 L1→L3,门控:无(架构已拍板)」**;§七:L1 页面设计器=amis-editor 二开 / L2 实体建模器=可视化维护 SYS_ENTITY / L3 流程设计器=bpmn.js + Flowable。末环=§6.3 在线导入发布 |
|
||||||
|
| 现代层 authoring 长在引擎上 | 架构设计 §一「**保真层供奉、现代层生长**」+ ArchUnit 单向纪律(`com.eip4.*` 可调 `com.dsasp.*`,反向禁止) |
|
||||||
|
| 一个 schema 世界 | §6.2「SYS_PAGE_SCHEMA 标准层 + overlay 层,升级时标准层整体替换、overlay 保留提示 diff」 |
|
||||||
|
| AI 独立轨给 MCP+CLI | 最初 **P5「MCP/AI 工具层」** 逐字吻合 |
|
||||||
|
|
||||||
|
**引擎实况(已读码核实)**:四环里**三环引擎已在保真层活着**——`Entity.java`/`POInfo.java`/`POJOCRUDServiceImpl`(元数据 CRUD)、`Entity.createTableSql`→`DataDicServiceImpl`(动态建表)、`FlowExcuteServiceImpl`(534 行,含 `insertNodeAfter/removeNode` 图编辑原语 + `saveOrUpdate` 写回 `SYS_SERVICEFLOW`)、Groovy/JUEL 脚本引擎。
|
||||||
|
|
||||||
|
## 3. 最初设计强加的三根硬约束(对抗审查核实)
|
||||||
|
|
||||||
|
### ① 最大矛盾 · 焊死退路(go/no-go 级)—— 决策:**签字下注 amis**
|
||||||
|
最初把 amis-editor/自研设计器钉为「amis fork 失败时的防御性 **Plan B**」(止损 S2,换渲染器损失仅 1–2 人月)。架构决策报告 §四「触发重新决策条件#1」:*若决策层不接受永久 fork + 终身自维护前端渲染器的预算 → 须重评其他 Apache 渲染层*。把 amis-editor 升为战略主线 = 主动焊死退路 = 踩中该触发条件。
|
||||||
|
**已知天花板(写进立项)**:amis-fork 6.13.0 冻结于 2025-08、近 3 月零上游提交、bus factor≈1、需 **0.5–1 人/年自维护**。
|
||||||
|
**用户拍板**:✅ 签字下注 amis。**但附带关键现实**:**DesignerPage 当前还无法真正使用**(见 §7)——下注成立的前提是先把它弄到能用。
|
||||||
|
|
||||||
|
### ② 「补 UI 非造引擎」被系统性低估 —— 真实=「一环就位 + 两环要补引擎」
|
||||||
|
- **设计环**:✅ 就位,但**仅 edit-only on 存量页**(e2e 68/68 验的是 overlay 存取往返,**不等于设计器可用**)。
|
||||||
|
- **建模环**:🔴 引擎层**不能 ALTER**(`executeCreateSql` 只接受 CREATE,`DataDicServiceImpl:193-200`);`MetaController` 是克隆 SYS_USERGROUP、限 `EIP4AI_` 前缀的 **AI 雏形**,非面向人。新建实体后改字段**零迁移路径**。
|
||||||
|
- **编排环**:🔴 `FlowController` **只执行不编辑**,flow 仍是老 XML,EIP4 侧 **0 个 authoring REST**。
|
||||||
|
|
||||||
|
### ③ overlay 是 edit-only —— 「一个 schema 世界」附条件成立(一次性数据建模门)
|
||||||
|
`SYS_PAGE_SCHEMA_OVERLAY` 以 `template_id` 为主键、`base_etag` 挂靠**转换器产出的标准层**。「一个 schema 世界 + 可升级」的优雅**只在「先有标准底版、overlay 是其差量」时成立**。**从零新建的页没有标准底版**,其生命周期/升级/diff 在最初设计里是**空白**。「改存量页已上线」≠「新建页平台就绪」。
|
||||||
|
|
||||||
|
## 4. 逻辑编排器(唯一硬骨头)—— 决策:**b 主干 + 人工 20% + c 增量,否决 a**
|
||||||
|
|
||||||
|
- **否决 a(节点图编辑器)**:最初零根基;`Flow.java:422/454` 对非线性流主动抛「请用高级配置进行编辑」——证明**连老 EIP3 自己的可视化也只覆盖线性流**。节点图是最重前端投资、对冻结栈纯新增,ROI 最差。
|
||||||
|
- **b 主干**:80% 常规联动/线性服务流走声明式配置面(32 个 facade 动词 onEvent 面板,复用已有),不写代码即提效。
|
||||||
|
- **诚实修正(对抗审查)**:b 只覆盖**老系统已能可视化的线性流**;那 20% 复杂逻辑(非线性流/有副作用 Groovy/跨流条件=最初 S3 留下的 **115 份人工作业单**)**b 接不住**。
|
||||||
|
- **故**:那 20% **默认保留「人工作业单」兜底**(人写 Groovy/JUEL,复用 `field-editor`);**c(AI 生成)仅「加速人工 + 人工复核入库」增量**,platform-ai 空壳未落地前**不算进对外交付能力**。对外能力边界=「**b 声明式 80% + 人工 20%**」。
|
||||||
|
|
||||||
|
## 5. 落地形态(与最初设计对齐)
|
||||||
|
|
||||||
|
不立「新平台」为独立大项目,而是把 F4 三件套 + §6.2 overlay + §6.3 发布 + P5 MCP 正式化为一套「**现代层 authoring 模块集合**」,落在 `platform-metadata` 等现有模块内(不新进程),守三红线:
|
||||||
|
|
||||||
|
> **4 进程私有化单体 / 无新中间件 / 无多租户**;authoring 必须走既有引擎接口签名(POInfo/Entity/DataPrivilege/FlowExcuteService)**不旁路**。
|
||||||
|
|
||||||
|
- **存储层零新增**:authoring 全部读写 `SYS_ENTITY`/`SYS_ENTITYATTRIBUTE`(元数据真相)、`SYS_SERVICEFLOW.CONTENTXML`(服务流真相)、`SYS_PAGE_SCHEMA`+overlay(页面真相)。「元数据即白名单」运行期/开发期同源。
|
||||||
|
- **定位红线**:架构决策报告 §2.1a 已把「交付带动态建表的低代码平台能力给客户继续配置」定性为合同敏感地带(曾用于否决路线 B)。新平台守在**内部提效工具**,不对外做 SaaS/多租户配置平台。
|
||||||
|
|
||||||
|
## 6. 分期路线(每期标复用什么 / 补什么引擎欠账)
|
||||||
|
|
||||||
|
| 期 | 目标 | 关键交付 | 真实前置 / 复用 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **P0** | 立底座 + 门禁 | 组件设计体系 **L1 主题 token 做到生产级**(决策2「先 B 提效」的 UI 前提);为新 authoring 产物补**正确性门禁**(新建页无对拍基准!→ 元数据变更 CRUD 烟测 + 编排执行对拍 + overlay 版本可审计回滚 + schema 双闸复用);amis 战略取舍立项书签字 | **真实前置=组件 L1,非 153**;复用 overlay 双层、schema 双闸 |
|
||||||
|
| **P1** | 设计环正式化 + **先修 DesignerPage 可用性** | 诊断并修复 DesignerPage「无法使用」(见 §7);从「改存量」升级到能用;**补 net-new 页数据模型/生命周期**(闭合 §3③门);收敛独立设计中心(评估 `DesignCenterPage.tsx` 雏形);facade onEvent 声明式面板第一块 | 复用 DesignerPage/overlayApi、PageSchemaController、facade 动词表 |
|
||||||
|
| **P2** | 建模环 | **先补引擎安全 `alterTableSql`**(加法在线/改删走升级窗口,守 §6.3 红线)再做 L2 建模器 UI;MetaController 从 AI 雏形重写为面向人 | 复用 Entity.createTableSql + 缓存失效免重启 |
|
||||||
|
| **P3** | 编排环(硬骨头·打法 b) | 服务流 authoring REST 出口(暴露 `FlowServiceImpl.saveOrUpdate` + 图编辑原语)+ 声明式线性流配置面 + Groovy 代码编辑器兜底;BPMN 审批流走 L3 bpmn.js | 复用 FlowExcuteService + Flow 图编辑原语 + DefaultFlowHelper |
|
||||||
|
| **P4** | 发布环 + 链条贯通 | §6.3 元数据资产包另存/导入;「建实体→合成默认流→生成默认页→设计器微调→发布」串通 | 复用 §6.3 资产包 + 缓存失效 + DefaultFlowHelper |
|
||||||
|
| **P5** | AI 工具面(决策3 独立轨·c 兜底) | Meta/Flow 端点升级为正式 MCP,接通 platform-ai 空壳,消除两套 authoring 入口 | 复用已建端点 + schema 校验 |
|
||||||
|
|
||||||
|
> 启动次序:**与 153 收尾并行**(用户拍板)。解除「153 收尾后才做」硬前置——153 进度由商务 S1 拍板、不由技术,挂其后会被无限期阻塞。**但据实承认**:新平台真实前置是组件 L1,不是把「等 153」换成「等组件 L1」的隐藏依赖游戏。
|
||||||
|
|
||||||
|
## 7. DesignerPage 现状(状态标记,非当前动手任务)
|
||||||
|
|
||||||
|
> 定性:这是一个**已知状态**(用户实测不可用),作为 D1 amis 下注的前置验证项纳入 P1,**不在架构方向讨论里展开 debug**。诊断已查实环境层根因嫌疑(见下),最终复现/修复留到 P1 执行期。
|
||||||
|
|
||||||
|
**入口模型(D5 已定)**:单一「设计中心」菜单入口(运行态/设计态分离),废弃每页注入按钮。`DesignCenterPage.tsx`(fetchMenu→collectLeaves 列页 + 「设计」入口)是正确雏形方向,需补「新建页」与 net-new 生命周期(§3③)。
|
||||||
|
|
||||||
|
**「打开没有内容」环境层查实(curl/lsof 实测,2026-06-19)**:
|
||||||
|
- **8093 是纯 API 后端,完全不托管前端**(`/`、`/index.html`、`/assets/*`、`/editor.html` 全 404);
|
||||||
|
- 前端只活在 **4 个 stale 重复 vite dev server**(5174-5177);`.env` 有重复 `VITE_BACKEND_TARGET`(8084→8093)——**stale 实例代理到死端口 8084 → schema 拉不到 → 画布空** 是头号嫌疑;
|
||||||
|
- editor.html 入口页本身没坏(vite 上 200 + CSS 直链 200,dist 构建也正确);
|
||||||
|
- 这同时暴露 **A10:整个前端(设计器在内)没有被托管的家,只跑临时 dev 进程** —— 设计器「无法使用」一半是部署/托管缺失。
|
||||||
|
|
||||||
|
**旧线索(仍待 P1 复现确认)**:
|
||||||
|
- e2e 只验 overlay 存取往返,**未验设计器作为 authoring 工具可用**;
|
||||||
|
- 报告自承「**facade onEvent 可视化面板未做**」——能拖布局、配不了行为;
|
||||||
|
- `editor.html` CSS 走 `/node_modules/...` 直链(dev-only hack),**生产构建可能裂**;
|
||||||
|
- **edit-only on 存量页**,不能新建/绑新实体(§3③门);
|
||||||
|
- `DesignerPage.handleRestore` 注释自承:amis-editor 整体替换 value 会「白屏」,故还原后整页 reload(提示 amis-editor 二开的脆性)。
|
||||||
|
|
||||||
|
**下一步**:钉准「无法使用」的真实症状(开不了 / 白屏 / 只能改存量 / 能改但太糙/配不了逻辑 / 生产构建裂),再定 P1 第一锤。
|
||||||
|
|
||||||
|
## 8. 6 条必须吞下的修正(对抗审查 fixes)
|
||||||
|
|
||||||
|
1. 「放弃渲染层可换退路」升为立项**硬 go/no-go**,立项书签字接受 amis-fork 冻结天花板。(✅ 用户已签)
|
||||||
|
2. 为 net-new 页补数据模型与生命周期,再谈「一个 schema 世界」;闭合前不把「设计中心」当「新平台就绪」对外宣称。
|
||||||
|
3. 拆 b/c 真空:20% 复杂逻辑默认「人工作业单」兜底,c 仅「加速人工 + 人工复核」,platform-ai 落地前不算进交付。
|
||||||
|
4. 引擎层**先补安全 `alterTableSql` 并冻结边界**再做 L2 UI;MetaController 重写为面向人,别在 AI 雏形上长 UI。
|
||||||
|
5. 解除「153 后才做」硬前置,但 P0 据实命名「L1 底座 + authoring 门禁」,不用隐藏前置替换显式前置。
|
||||||
|
6. 为新 authoring 产物新设正确性门禁(新建页无对拍基准)——提为 **P0 交付物**,是绕过最初数据事故控制机制的唯一补偿。
|
||||||
|
|
||||||
|
## 9. 顶层风险
|
||||||
|
|
||||||
|
- 逻辑编排环是最初真空地带、无对拍基准、最高不确定(S3 自动化率 <80% 即触发工期重估)。
|
||||||
|
- amis-fork 冻结天花板被加码(押更多二开在 bus factor≈1 的栈上)。
|
||||||
|
- 建表 ALTER 缺口 × §6.3「DDL 只允许加法在线」红线夹击——「改表」体验天然受限,不能做成自由在线 DDL。
|
||||||
|
- 「元数据即白名单」在线 authoring 下可能反转为约束:白名单变活动目标,并发 authoring 的一致性/缓存时序是新攻击面。
|
||||||
|
- 组件体系未达生产级即做设计中心=重蹈「功能对但观感差」覆辙。
|
||||||
|
|
||||||
|
## 10. 决策记录(本次锁定)
|
||||||
|
|
||||||
|
| # | 决策 | 选择 |
|
||||||
|
|---|---|---|
|
||||||
|
| D1 | amis-editor 战略下注 | ✅ 签字下注(接受冻结天花板);前提=先修 DesignerPage 可用性 |
|
||||||
|
| D2 | 新平台启动次序 | ✅ 与 153 并行(真实前置=组件 L1) |
|
||||||
|
| D3 | 逻辑编排打法 | ✅ b 主干 + 人工 20% + c 增量,否决 a |
|
||||||
|
| D4 | 对外定位 | 内部提效工具(守 §5 合同红线)|
|
||||||
|
| D5 | **设计入口模型** | ✅ **单一「设计中心」菜单入口**(运行态/设计态分离);**废弃每页注入的设计按钮**(转换器 `EngineclassDelta:898` + PageRenderPage「设计」按钮,用户已移除)。开发/设计是独立工作区,不混进业务页工具栏 |
|
||||||
|
| D6 | **AI 轨形态** | ✅ AI = **独立 NocoBase 式 CLI 编程轨**(`feature-package` 为单元的 scaffold→dev→verify→release 生命周期,供 Claude Code/Cursor 等 AI coding 工具操作),**不并入设计中心**。EIP4 的「插件」等价物 = 元数据 feature-package(非代码插件) |
|
||||||
|
| D7 | **设计中心定位** | ✅ 设计中心 = **给实施人员的纯人工 no-code**(b 轨),不挂 AI 入口;AI 走 D6 独立 CLI 轨 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. 落地状态(2026-06-19 续)
|
||||||
|
|
||||||
|
- **AI agent 分支已合入 main(`9aea6c1`)**:交付了五环+横向的后端地基一大半(schema 门禁/三真相 authoring 端点/recipe-blueprint/元数据建实体/CLI 种子),并由 3 个收口提交保障合 main 安全(分流 `bac69d8` / admin 门 `c379f5b` / 对外口径 `9aea6c1`)。逐项对账 + 有序里程碑见 **`2026-06-19-EIP4开发平台-落地执行路线图.md`**(活计划)。
|
||||||
|
- **仍为 P0 锁定前置且未起步**:组件设计体系 **L1 主题 token 生产级**(D2)——路线图 M0。
|
||||||
|
- 本方向级 design 为权威决策记录;可执行里程碑/状态以路线图为准。
|
||||||
|
|
||||||
|
*本文为方向级 design;细化实施计划见配套《落地执行路线图》。*
|
||||||
80
docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md
Normal file
80
docs/plans/2026-06-19-EIP4开发平台-落地执行路线图.md
Normal file
@@ -0,0 +1,80 @@
|
|||||||
|
> 🔄 **里程碑状态回写(2026-06-21)**:正文部分表述已被本期进展推进,以此处与 [总览-2026-06-21](../项目进度与路线-总览-2026-06-21.md) 为准。
|
||||||
|
> - ✅ **M0**(L1 主题 token)已上线;✅ **M-Gate**(渲染冒烟 `4b564c6`)已做;✅ **M3a**(单一写真相 `PageSchemaWriter` `d3b8846`)已做;✅ **DesignerPage 全闭环**(`2278cbc` 等,原 §1/§2「DesignerPage 打不开」已解除);✅ **人走五环 v1** 全链交付合 main;✅ **两仓已 push origin/main**(`75f942b`/`d1fd6ed`,§5「push = 用户决策」已完成);🟡 **M7** recipe 扩面部分(master-detail-v1 已做,余待 v2)。
|
||||||
|
> - 🔴 仍未起步:**M4**(引擎 ALTER 安全通道)、**M5**(onEvent 声明式面板)、**M8**(CLI NocoBase 化 + 安全 Part2)、**M1 生产单源托管**(dev 反代已通,生产托管 = A10)。
|
||||||
|
|
||||||
|
# EIP4 开发平台 · 落地执行路线图
|
||||||
|
|
||||||
|
> 日期 2026-06-19 | 活计划,配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向+锁定决策 D1-D7)。本文是该 design doc 承诺的「另立 plan 文档」。每里程碑落地后回写状态。
|
||||||
|
> **经对抗审查修订**:补回 D2 锁定的 P0 前置(组件 L1);把正确性门禁(渲染冒烟)置于真库 dogfood 之前;net-new 旁路先收口为单一写真相再立新端点;区分「build 完成 vs env 终验」。
|
||||||
|
|
||||||
|
## 0. 修订要点(为什么不照搬初稿)
|
||||||
|
|
||||||
|
- design §6 的 P0 = **组件 L1 主题 token 生产级**,是 D2 锁定的「真实前置」;初稿漏了,本版补为 **M0**,且设计中心-facing 里程碑(M3b 新建入口 / M5 面板)必须 gated 在 M0 之后(否则重蹈 design §9「功能对观感差」覆辙)。
|
||||||
|
- design fix#6:新 authoring 产物无对拍基准,**渲染冒烟闸是绕过原数据事故控制的唯一补偿**——必须先于任何真库 dogfood。
|
||||||
|
- net-new 标准层现由 `AiLocalReleaseExecutor:158` 裸 JDBC 旁路直写;新端点必须**先把旁路收口为单一写函数**,否则两套写法并存(语义/审计/etag 漂移)。
|
||||||
|
|
||||||
|
## 1. AI 合并交付对账(设计五环+横向 → 已交付 → 状态 → 剩余)
|
||||||
|
|
||||||
|
> 图例:🟢=主体已交付且无 P0 级剩余 | 🟡=部分交付/有 P0 级剩余(见右列)| 🔴=未起步。main 现位于 `9aea6c1`(fast-forward 纳入 AI 合并 `bd4c642` + 3 收口 `bac69d8`/`c379f5b`/`9aea6c1`,全 reactor 10 模块绿)。
|
||||||
|
|
||||||
|
| 环/横向 | 已交付 | 状态 | 剩余(含 P0 标注) |
|
||||||
|
|---|---|---|---|
|
||||||
|
| 横向·正确性门禁 | TypedPageSchemaValidator + recipe 逐字节对拍 + 官方 draft-07,已接 putOverlay(分流后只对 AI 草稿严格) | 🟡 | **[P0] 渲染冒烟闸未做**(`AiSmokeRunner` 仅 HTTP 探针,playwright-render 无执行代码)= design fix#6 唯一补偿控制 |
|
||||||
|
| ①元数据 | `MetaController.createEntity` + 动态 CREATE + 缓存失效 | 🟡 | 引擎不能 ALTER;L2 建模器 UI 无;仍克隆 `SYS_USERGROUP` 做载体 |
|
||||||
|
| ②表结构 | `createTableDdl`(控制器内联) | 🟡 | ALTER 缺口;DDL 类型映射双份真相(与引擎漂移险) |
|
||||||
|
| ③设计 | recipe/blueprint 编译器(2 recipe)生成 amis 页;DesignerPage 改存量(分流后存量页可存 overlay) | 🟡 | DesignerPage 打不开(serving/env);net-new 正规写端点缺(走 AI 旁路);onEvent 声明式面板未做;recipe 仅 2 |
|
||||||
|
| ④实现功能 | `AiFeatureDraftGenerator` 用保真层 `DefaultFlowHelper` 生成默认 5 服务流 | 🟡 | 无人工编排 UI;只默认流;无服务流语义级 gate |
|
||||||
|
| ⑤发布 | deployment-package + CLI release ops + feature-package/revision 快照 | 🟡 | online apply 断档(人工跑 SQL);菜单注册未串端到端;**净新标准行无删除/回滚路径** |
|
||||||
|
| 横向·CLI | `Eip4Cli`(env/ai/release ops) | 🟡 | feature-package 为单元的 scaffold→dev→verify→release 生命周期未成型 |
|
||||||
|
| 横向·安全 | admin 门 + localhost 门 | 🟡 | `check()` 身份/scope 未织入写路径(等 CLI 身份模型) |
|
||||||
|
| 横向·UI 底座(组件 L1) | — | 🔴 | **[P0] L1 主题 token 未起步**(design §6 P0 锁定前置,D2);repo 无 token 资产 |
|
||||||
|
|
||||||
|
## 2. 有序里程碑
|
||||||
|
|
||||||
|
### 前置地基(design 锁定 P0,先于一切设计中心-facing 工作)
|
||||||
|
- **M0 组件设计体系 L1 主题 token 生产级**[自主 build / 需 env 终验观感]:落 `组件设计体系-design` L1 主题层。D2 锁定前置 + 设计中心/设计器观感底座。**M3b/M5 必须在 M0 后**。
|
||||||
|
- **M-Gate 正确性门禁第二闸(渲染冒烟)**[harness 自主 / 需 headless 终验]:Playwright/headless 对 previewUrl 真渲染断言(可视 + 无控制台报错),替 `AiSmokeRunner` HTTP 探针。design fix#6 唯一补偿控制——**必须先于任何真库 dogfood(M2)**。
|
||||||
|
|
||||||
|
### 先宽度(让 2 recipe + 设计器对存量 真端到端可用)
|
||||||
|
- **M1 Serving 解锁(A10)**[配置部分自主 / 终验需 env]:(a) 修 stale vite 代理死端口 8084 + `safeLocalBase` 默认(可自主改配置);(b) 前端(含设计器)被真正托管 → DesignerPage 能打开(终验需 env)。先消 design §7 已定位的环境性根因。
|
||||||
|
- **M3a net-new 写路径收口(单一写真相)**[自主 + TDD]:把 `AiLocalReleaseExecutor:158` 裸 `INSERT sys_page_schema` 改为调用**唯一共享写函数**(复用 typed 校验/审计/etag);`PageSchemaController` 加标准层写端点复用同一函数。**验收 = sys_page_schema 写入只剩一个函数,无旁路裸 INSERT**。**收口先于新建入口**。
|
||||||
|
- **M2 真库 dogfood(沙箱 schema)**[需 env + admin creds]:AI 产 EIP4AI_净新 CRUD → 过三闸(**含 M-Gate 渲染冒烟**)→ **写一次性/沙箱 schema(非共享生产 PG)** → 浏览器打开可用;附净新行清理/回滚脚本。**前置 = M-Gate + M3a**。
|
||||||
|
- **M3b 设计中心「新建功能」入口**[前端,gated by M0 + M3a]:`DesignCenterPage` 加新建入口,走 M3a 共享写函数;设计角色细分(复用 RBAC)。
|
||||||
|
- → **宽度闭环**「建实体→生成默认页→设计器微调→发布」可演示(前置 M0/M-Gate/M1/M3a 全绿)。
|
||||||
|
|
||||||
|
### 再深度
|
||||||
|
- **M4 引擎 ALTER 安全通道 + DDL 单源**[自主 build / 需 env 终验]:保真层白名单化 `alterTableSql`(只加列/扩长/改可空,改删走升级窗口)+ `MetaController` alter 端点 + 独立安全门;顺带把 `createTableDdl` 的第二份 DDL 类型映射收敛回引擎单源(消漂移)。
|
||||||
|
- **M5 onEvent 声明式面板(逻辑 b 主干第一块·design P3 硬骨头)**[前端,gated by M0]:32 facade 动词配置面板。**风险储备**:design 标的最高不确定环(S3 自动化率 <80% 触发工期重估);**20% 复杂逻辑保留「人工作业单」兜底**(design fix#3),不进面板。
|
||||||
|
- **M7 recipe 扩面**[自主 + TDD]:主子表/EditGrid/审批/组合 tabs recipe + 字段控件补 select/picker/input-tree/引用列(每种自带逐字节对拍基准)。
|
||||||
|
- **M8 CLI NocoBase 化 + 安全 Part2**[design + code 自主]:feature-package 为单元 scaffold→dev→verify→release 生命周期(D6);「认证用户→AI employee→scope」映射 + `check()` 织入写路径。
|
||||||
|
|
||||||
|
## 3. 自主 vs 需环境(build 完成 ≠ 集成已证)
|
||||||
|
|
||||||
|
| 里程碑 | 可自主 build + unit-test | 需 env/creds 终验 |
|
||||||
|
|---|---|---|
|
||||||
|
| M0 L1 token | 定义 token 层 | 生产级观感(浏览器) |
|
||||||
|
| M-Gate 渲染冒烟 | Playwright harness 代码 | 真渲染断言(headless) |
|
||||||
|
| M1 serving | 改 vite/8084 配置 | 托管 + 打开终验 |
|
||||||
|
| M3a 收口 | 共享写函数 + 端点 + TDD | —(纯写路径,集成在 M2 证) |
|
||||||
|
| M2 dogfood | — | 端到端(沙箱 PG + admin) |
|
||||||
|
| M3b 新建入口 | 端点接线 | 浏览器新建终验 |
|
||||||
|
| M4 ALTER | alterSql + 端点 + TDD | 真 PG 在线加列证 |
|
||||||
|
| M5 面板 | 面板代码 | 浏览器联动证 |
|
||||||
|
| M7 recipe | 编译器 + 对拍 TDD | 渲染证 |
|
||||||
|
| M8 CLI/Part2 | 命令 + 身份映射 + TDD | 端到端证 |
|
||||||
|
|
||||||
|
> **纪律**:M3a/M4/M7 的「完成」= **code-complete, integration-pending**;集成声明等 env 终验,不在绿单测上宣称端到端 done。
|
||||||
|
|
||||||
|
## 4. 下一步(已定,honest)
|
||||||
|
|
||||||
|
**M3a — net-new 写路径收口为单一写真相**(自主 + TDD,不依赖 env,不碰 L1-gated UI,收口 critic 点名的三真相旁路纪律)。其「完成」严格限 **code-complete**;端到端宽度价值待 M0/M-Gate/M1/M2 解锁后证。
|
||||||
|
**M0(L1)与 M1(serving 配置)可并行起**(L1 是 D2 锁定前置);M2/M3b/M5 的浏览器/真库终验等用户给登录方式。
|
||||||
|
|
||||||
|
## 5. Housekeeping
|
||||||
|
- 本文 + design doc(补 D6/D7)commit 进 main。
|
||||||
|
- main 现领先 origin/main 20 提交(AI 合并 + 3 收口),**push = 用户决策**(两仓需先 add remote 到私有托管,见 memory `eip3-git-remotes-latentchat`)。
|
||||||
|
- worktree `eip4-platform-ai-agent` 已与 main 同 commit,可清理。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*本文为活的执行计划;状态随里程碑落地回写。方向/决策权威见配套 design doc。*
|
||||||
99
docs/plans/2026-06-20-人走五环建新功能-NocoBase式-design.md
Normal file
99
docs/plans/2026-06-20-人走五环建新功能-NocoBase式-design.md
Normal file
@@ -0,0 +1,99 @@
|
|||||||
|
# 人走五环建新功能 · NocoBase 式(建模器 + 实时设计器)· 设计
|
||||||
|
|
||||||
|
> 日期 2026-06-20 | brainstorm 产物 | 配套《2026-06-19-EIP4开发平台-架构方向-design.md》(方向 D1-D7)+《2026-06-19-EIP4开发平台-落地执行路线图.md》(里程碑 M0-M8)。
|
||||||
|
> 决策来源:memory `eip4-human-five-ring-wizard`(宽度 vs 深度 → 选 B:人走五环建新功能,AI 退回加速器)。
|
||||||
|
> 本文是该特性的设计定型,供新会话直接跑 `superpowers:writing-plans` 出实施计划。
|
||||||
|
|
||||||
|
## 0. 一句话
|
||||||
|
|
||||||
|
给老引擎本来就有的「元数据驱动低代码核」配一套 **NocoBase 式的现代 UI(建模器 + 实时设计器),不做线性问卷向导**;让人能走完整五环(元数据→设计→实现→发布)建新功能,AI 作为加速器、不是唯一通道。
|
||||||
|
|
||||||
|
## 1. 锁定的决策(带依据)
|
||||||
|
|
||||||
|
- **D-A 形态 = 建模器 + 实时设计器,不做线性 wizard。** 依据:用户指定参考 NocoBase,NocoBase 用「实时所见即所得区块设计器 + 一键切使用/配置模式」,明确**不用向导**;且我们今天刚把 DesignerPage(amis-editor)修到全闭环,与之天然契合。
|
||||||
|
- **D-B v1 只「建新功能」,不「改已有表」。** 依据:CREATE 建表后端已 live 验证(见 §3);唯一缺口是 ALTER(改已有表的列)= 路线图 M4,留给 v2。
|
||||||
|
- **D-C 建完实体走「recipe 自动产默认页 → 进设计器微调」,不走「空白页现拖组件绑实体」。** 依据:`PageBlueprintCompiler.compile()` 吃 blueprint 直接产出**已接好 `/api/flow/{TABLE}_SEARCH` 的页**(`PageBlueprintCompiler.java:50`);DesignerPage 现为 **edit-only**(只改存量页),recipe 预接好页正好落在它能干的范围内,**设计器无需长「从零绑实体」的新能力**。
|
||||||
|
- **D-D「AI 帮我」走 ①面(外部 agent + Skills + CLI 驱动确定性工具),不在平台内置生成 LLM。** 依据:见 §3——平台主路径零 LLM,NocoBase 的「建功能 AI」本身就是外部 coding-agent CLI + Skills;EIP4 已建好这套底座(`docs/skills/` + `platform-cli` + `AiToolRegistry` + `AiEmployee`)。②面(in-app AI employees,平台内置 LLM)= v1 之后单独立项。
|
||||||
|
- **D-E 元数据单一真相 = `SYS_ENTITY` + `SYS_ENTITYATTRIBUTE`(老系统保真层),新旧共用。** 见 §3。
|
||||||
|
|
||||||
|
## 2. 整体形态 + 建功能流程
|
||||||
|
|
||||||
|
**两个界面(落在设计中心):**
|
||||||
|
1. **建模器**(新建的唯一无对应 UI 的环)— 建/浏览实体 + 字段,包 `POST /api/meta/entity`。
|
||||||
|
2. **实时设计器**(DesignerPage / amis-editor,已有,edit-only)— 微调页面。
|
||||||
|
|
||||||
|
**建一个新功能的流:**
|
||||||
|
|
||||||
|
```
|
||||||
|
①建模器建实体+字段
|
||||||
|
→ POST /api/meta/entity(写 SYS_ENTITY/SYS_ENTITYATTRIBUTE + 真 CREATE 物理表)
|
||||||
|
②选 recipe(维护CRUD / 树CRUD)
|
||||||
|
→ PageBlueprintCompiler 自动产出已接 /api/flow 的默认页 → 落 sys_page_schema(标准层)
|
||||||
|
③默认页进 DesignerPage 微调(拖列/调布局)
|
||||||
|
④选菜单位置 + 发布(PageSchemaWriter 单一写真相 + 菜单注册)
|
||||||
|
(五流 _ADD/_UPDATE/_SEARCH/_DELETE/_LOAD 由 DefaultFlowHelper 默认生成,可见可确认,多数不用人管)
|
||||||
|
```
|
||||||
|
|
||||||
|
**设计中心两入口(人/AI 共用同一套后端 + 同一份 schema):**
|
||||||
|
- **`[+ 新建功能]`**(人):自己在建模器 + 设计器里走五环。
|
||||||
|
- **`[⚡ AI 建功能]`**(AI ①面):触发外部 agent + 现有 skills/CLI 链(`POST /api/ai/features/auto-develop`),产 `READY_FOR_HUMAN_REVIEW` 草稿,人回设计器审/改/发。
|
||||||
|
|
||||||
|
## 3. 关键架构事实(brainstorm 核实,几条反直觉的)
|
||||||
|
|
||||||
|
1. **元数据单一真相、新旧共用。** `MetaController.createEntity` 把实体行写进 **`SYS_ENTITY`**(`:89`,克隆 SYS_USERGROUP 的实体描述行做模板载体)、字段行写进 **`SYS_ENTITYATTRIBUTE`**(`:246`)。这两张表 + 引擎在 `platform-legacy-core`,包名 `com.dsasp.server.common.dataDic.service`——**老系统保真层原物**。eip3 老系统本身就是元数据驱动低代码平台;「转换」只动页面层(XML/engineclass → amis `sys_page_schema`),元数据一行没转。
|
||||||
|
2. **CREATE 建表后端已 live。** `createEntity` 走 `createTableDdl()` 拼真 DDL → `dataDicService.executeCreateSql(ddl)` 真执行(`MetaController.java:130-131`),补索引、失效缓存。AI agent 建新表就走这条。**唯一缺口是 ALTER**(改已有表)= M4。
|
||||||
|
3. **平台主路径零 LLM。** `AiFeatureRequest` 完全结构化(`featureName/tableName/entityName/List<AiFeatureField> fields/pageRecipe`),连 `auto-develop` 吃的都是它,不是自然语言。`AiFeatureDraftGenerator` 按规则确定性编译。**平台内唯一 LLM = `HttpAiLlmRepairClient`,`@ConditionalOnProperty(...repair.enabled,"true")` 默认关,且只做修复不做生成。** NL→结构化 spec 的魔法在平台外(外部 coding-agent 经 CLI)。
|
||||||
|
4. **NocoBase 的「建功能 AI」= 外部 agent CLI + Skills。** NocoBase Skills 官方定义 =「给 AI Agent CLI(Claude Code、Codex、Cursor 等)用的可复用领域知识包」,外部加载、非服务端组件,agent 经 CLI/API 在权限+审计下驱动 no-code 操作。EIP4 已有对应底座。NocoBase 另有 in-platform「AI Employees」(业务用户在 App 内对话,内置 LLM)= 我们的 ②面,v1 不做。
|
||||||
|
5. **recipe 编译器吃 blueprint 产已接 API 的页。** `PageBlueprintCompiler.compile()` 设 `crud.api=/api/flow/{TABLE}_SEARCH`、列、增删改按钮(`:45-72`);`AiFeatureDraftGenerator` 已串了这条(`:47-52`)。
|
||||||
|
|
||||||
|
## 4. 真正要新建 vs 复用(端点均已核实)
|
||||||
|
|
||||||
|
**复用(端点/能力都已 live):**
|
||||||
|
|
||||||
|
| 环 | 复用 |
|
||||||
|
|---|---|
|
||||||
|
| 建实体+建表 | `POST /api/meta/entity` |
|
||||||
|
| 标准层页写 | `PUT /api/page/schema/{templateId}/standard`(M3a 单一真相)|
|
||||||
|
| 设计器存改+门禁 | `/api/page/schema/{templateId}/overlay` + `/validate` + `/components` |
|
||||||
|
| recipe 列表 | `GET /api/ai/page-recipes` |
|
||||||
|
| 菜单注册 | `POST /api/admin/menus/create` |
|
||||||
|
| 微调页面 | DesignerPage(amis-editor) |
|
||||||
|
| AI 建功能链(①面) | `POST /api/ai/features/auto-develop`(基址 `/api/ai`)|
|
||||||
|
| CRUD/flow 自动伺服 | 保真层引擎 |
|
||||||
|
|
||||||
|
**真正要新建(4 件):**
|
||||||
|
1. **建模器 UI(前端,最大块)**:列已有实体 / 建新实体(名/表)+ 字段表(列/类型/显示名/长度/必填/引用其它实体)。包 `POST /api/meta/entity`。最复杂控件 = **引用列(referenceid,外键选其它实体)**。
|
||||||
|
2. **「recipe→默认页→落标准层」单步端点(后端,小)**:把 `PageBlueprintCompiler.compile` + `/standard` 写串成人可单步调的端点(现在只埋在 `auto-develop` 里)。属路线图「把 AI pipeline 拆成可单步调」收口的第一块。
|
||||||
|
3. **「+ 新建功能」编排薄壳(前端)**:建模器→选 recipe→落页→跳设计器→发布(菜单注册)串起来。
|
||||||
|
4. **「⚡ AI 建功能」入口接线(前端 + 少量后端)**:网页触发 `auto-develop`,把 `READY_FOR_HUMAN_REVIEW` 草稿回流到设计器供人审/改/发。
|
||||||
|
|
||||||
|
## 5. v1 边界(YAGNI)
|
||||||
|
|
||||||
|
- 只建新,**不改已有表**(ALTER/M4 = v2)。
|
||||||
|
- recipe 限现有 2 种(维护 CRUD / 树 CRUD)→ **v1 只覆盖简单 CRUD/树类功能**;主子表/审批/组合 = 路线图 M7 扩面后。
|
||||||
|
- 设计器 **edit-only** 够用(recipe 预接好页)。
|
||||||
|
- **②面 in-app AI employees 不做**(平台内置 LLM = 独立大特性 + 红线扩面,v1 之后立项)。
|
||||||
|
|
||||||
|
## 6. 守红线(与架构 D3 + memory `eip4-ai-agent-merge-mapping` 一致)
|
||||||
|
|
||||||
|
- 发布**恒人审**。
|
||||||
|
- AI 入口产物状态**恒 `READY_FOR_HUMAN_REVIEW`**。
|
||||||
|
- 标准层写**恒走 `PageSchemaWriter` 单一真相**(M3a 已收口,不得旁路裸 INSERT)。
|
||||||
|
- 平台进程内**不内置生成 LLM**(仅 repair 钩子,默认关)。
|
||||||
|
|
||||||
|
## 7. 要在 plan 里钉死的 3 个未知
|
||||||
|
|
||||||
|
1. **建模器引用列(外键)UI**:怎么选其它实体?下拉已有实体列表 + 选目标显示列?这是建模器最复杂的控件,需先定交互。
|
||||||
|
2. **recipe 仅 2 种 = v1 能建的功能类型窄**:这是 v1 定位,需跟产品对齐——v1 明确只支持简单 CRUD/树类新功能,复杂功能引导走老路或等 M7。
|
||||||
|
3. **发布 online apply 断档**(路线图:线上仍人工跑 SQL):v1「发布」到哪一步算完?**真上线** vs **出部署包人工执行**?决定 ④环的终点与是否需要 env/creds 终验。
|
||||||
|
|
||||||
|
## 8. 不做 / 推迟
|
||||||
|
|
||||||
|
- ALTER/改已有表(M4,v2)
|
||||||
|
- recipe 扩面:主子表/EditGrid/审批/组合 tabs(M7)
|
||||||
|
- ②面 in-app AI employees / 平台内置 LLM 生成端点
|
||||||
|
- 纯 NocoBase「空白页拖组件现绑实体」(需给 amis-editor 造绑定能力,v1 用 recipe 预接好规避)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*本文为 brainstorm 定型设计。下一步:新会话跑 `superpowers:writing-plans` 出带文件路径/代码示例/验证步骤的实施计划,§7 三未知在 plan 阶段钉死。*
|
||||||
9
docs/plans/2026-06-24-生成式OS数据驾驶舱-design.md
Normal file
9
docs/plans/2026-06-24-生成式OS数据驾驶舱-design.md
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
# 生成式 OS 数据驾驶舱(GenOS Cockpit)— 已迁出本仓
|
||||||
|
|
||||||
|
> 2026-06-24:本方案定为**独立产品**(不属于 Java 后端仓),已迁至独立仓 `genos-cockpit`。
|
||||||
|
|
||||||
|
- 项目:**GenOS Cockpit / 生成式 OS 数据驾驶舱**(独立可单独部署的伴随模块,EIP4 为首个集成)
|
||||||
|
- 权威文档位置:`/Users/zhengwr/workspace/genos-cockpit/docs/design/2026-06-24-生成式OS数据驾驶舱-design.md`
|
||||||
|
- 原型简报:`/Users/zhengwr/workspace/genos-cockpit/docs/design/genos-cockpit-claude-design-brief.md`
|
||||||
|
|
||||||
|
一句话:用自然语言表达意图 → daemon 驱动用户本机 CLI agent(平台不内置 LLM)→ 经 **EIP4 platform-mcp** 取数(自动继承 RBAC)→ OpenUI Lang 流式自组装成驾驶舱。与 EIP4 **只通过 MCP/REST 松耦合**,不替换 amis、不进确定性五环主路径。最大前置门 = S1 拍板是否引入运行态 LLM。
|
||||||
114
docs/plans/2026-06-25-A10-生产上线工程化-design.md
Normal file
114
docs/plans/2026-06-25-A10-生产上线工程化-design.md
Normal file
@@ -0,0 +1,114 @@
|
|||||||
|
# A10 生产上线工程化 · design(2026-06-25)
|
||||||
|
|
||||||
|
> 目标读者:拍板人 + 执行者。本文是**待拍板设计**,不是已实现记录。对应进度总览 §3 A10(🔴 未起步)、§5 P2#9、§10.2「生产交付能力缺口」。
|
||||||
|
> 定位:把「dev 能跑」推进到「客户环境可交付、可回滚、可观测」。**纯设计产出,不依赖运行环境**;落地需用户环境(真 DB / 容器宿主 / Gitea runner)。
|
||||||
|
|
||||||
|
> **🛠️ 实施进度(2026-06-25,本地 PG+Docker 真验)**:**W1 Flyway 已实现 + 真验**——`platform-app` 加 flyway-core + flyway-database-postgresql(10.10.0),`db/migration/V1-V3`(sys_page_schema/sys_datastatus/sys_ai_*,DDL 从既有幂等 bootstrap 迁入),`application.yml` 启 Flyway(baseline-on-migrate + baseline-version=0),dev/local 的 spring.sql.init 收敛移除(app 运行态 provisioning 单一走 Flyway)。`FlywayMigrationLocalIT` 对真实 PostgreSQL 15.18 验两场景全绿:① 全新 schema→V1-V3 建全表+幂等;② 既有非空 schema(已有 sys_page_schema+数据)→baseline V0→V1-V3 幂等应用、既有行不破坏(=客户库接管场景)。**docker build 两镜像真验通过**(daemon 已起:platform-app 727MB/flowable 641MB)。**残留(收敛 follow-up)**:platform-ai/metadata/flow-gateway 的 bootstrap-*.sql 仍在(ci.sh/AiAgentDdlTest/parity fixture 用),与 db/migration 形成文档级重复——全收敛(删 bootstrap、ci.sh/测试改指 db/migration)待后续;app 运行态已单源。
|
||||||
|
>
|
||||||
|
> **W2+W3+W4 MVP 骨架已落地**(按推荐默认 D1 nginx 单源 / D3 compose+systemd 双轨 / D4 env / D6 客户 PG)——`platform-app/Dockerfile`、`flowable-service/Dockerfile`、`deploy/{nginx.conf,docker-compose.yml,.env.example,README.md,systemd/*.service}`。验证:`docker compose config` 通过(4 服务 + 变量插值);**`docker build` 待有 daemon 的 dev/CI 真验**(本机 daemon 未起)。验证过程揪出并修:flowable-service 双数据源(FLOWABLE_JDBC_*/BIZ_JDBC_*)env 漏传已补。**W1 Flyway 未做(下一批次)→ 当前 compose 假定 DB 已置备,尚不能从零自举平台表**。W5/W6 需准生产。
|
||||||
|
|
||||||
|
## 0. 一句话
|
||||||
|
|
||||||
|
EIP4 当前只有 **dev 形态**(手工 `run-dev.sh` 起两个 fat jar + 前端 vite proxy)。生产化缺四块成体系交付物:**① Flyway 平台表迁移 ② 容器化/编排(compose+Dockerfile+nginx)③ 单源托管与切流回滚 ④ 数据迁移 runbook 执行 + 性能/灰度基线**。可观测性(actuator+logback)与安全基线(prod profile/JWT/CI)本月已补,是 A10 的前置已就位。
|
||||||
|
|
||||||
|
## 1. 现状底数(2026-06-25 实测)
|
||||||
|
|
||||||
|
**运行进程(2 个 Spring Boot fat jar + 外部依赖)**
|
||||||
|
| 进程 | 端口(dev/base) | 角色 |
|
||||||
|
|---|---|---|
|
||||||
|
| `platform-app` | 8093 / 8084 | 主应用:保真层引擎 + 现代层 REST + 前端 schema 服务 |
|
||||||
|
| `flowable-service` | 8089 | 工作流引擎(Flowable)独立进程 |
|
||||||
|
| PostgreSQL | 5435(共享测试库) | 数据(客户库 eip3 schema + EIP4 平台表) |
|
||||||
|
| 前端 | vite 5173 dev proxy→8093 | amis SPA,prod 需静态托管 |
|
||||||
|
|
||||||
|
**已就位前置**:prod profile(`application-prod.yml`,JWT/DB 强制 env、fail-safe 安全链)、actuator `/actuator/health`(liveness/readiness)、logback 滚动日志、CI(`.gitea/workflows/ci.yml` + parity-nightly,待 runner 激活)。
|
||||||
|
|
||||||
|
**缺口(实测)**
|
||||||
|
- **Flyway 零落地**:平台表 DDL/数据散落 —— `docs/sql/*.sql`(7) + 各模块 `src/main/resources/bootstrap/*.sql`(`bootstrap-page-schema`/`bootstrap-datastatus`/`bootstrap-ai-agent`),且 **`bootstrap-ai-agent.sql` 在 platform-ai 与 platform-app 各一份**(易漂移)。无版本化、无执行顺序保证、无幂等台账。
|
||||||
|
- **无 `Dockerfile` / `docker-compose` / `nginx.conf`**:四服务编排、切流/回滚仅停在文档。
|
||||||
|
- **前端无生产托管**:dev 靠 vite proxy;prod 无 nginx/伴服方案。
|
||||||
|
- **数据迁移 runbook 备而未执行**:`docs/P0-PG升级/PG升级Runbook-v1.md`、`docs/P3-Flowable升级/Flowable升级Runbook-v1.md` 写好未跑。
|
||||||
|
- **无性能/并发基线、无灰度机制**。
|
||||||
|
|
||||||
|
> **关键边界(务必先共识)**:保真层跑在**客户既有 eip3 库**之上,EIP4 只**新增**平台表(`SYS_PAGE_SCHEMA`/`SYS_*_AI`/datastatus 等),**不迁移/不改客户业务表 schema**。故 Flyway 只管「EIP4 新增表」,客户库 schema 由保真层原样消费。这条决定 Flyway 范围与切流模型。
|
||||||
|
|
||||||
|
## 2. 目标生产拓扑
|
||||||
|
|
||||||
|
```
|
||||||
|
┌──────────── nginx (单源) ────────────┐
|
||||||
|
client → │ / → web dist (静态 SPA) │
|
||||||
|
│ /api/** → platform-app:8084 │
|
||||||
|
│ /flowable/** → flowable-service:8089 (按需)
|
||||||
|
└───────────────────────────────────────┘
|
||||||
|
│ │
|
||||||
|
platform-app flowable-service
|
||||||
|
(prod profile) (prod profile)
|
||||||
|
└────────┬───────────┘
|
||||||
|
PostgreSQL(客户库 eip3 schema + EIP4 平台表)
|
||||||
|
```
|
||||||
|
四容器:`nginx` / `platform-app` / `flowable-service` / `postgres`(生产 PG 多为客户既有实例,compose 里的 pg 仅自测/演示用)。
|
||||||
|
|
||||||
|
## 3. 工作分解(建议顺序 + 体量)
|
||||||
|
|
||||||
|
| ID | 工作 | 体量 | 依赖 | 产出 |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| **W1** | **Flyway 收敛平台表** | M | — | 引入 flyway-core;把散落 EIP4 平台表 DDL/种子整理为 `db/migration/V{n}__*.sql`(仅 EIP4 新增表,排除 parity 测试种子 + 客户库);去重 `bootstrap-ai-agent`;platform-app 启动跑 migrate(`flyway.baseline-on-migrate=true` 接管既有库)。**幂等 + 版本台账 + 执行顺序确定**。 |
|
||||||
|
| **W2** | **容器化** | M | W1 | 两个多阶段 `Dockerfile`(temurin-jre-21 运行层 + 非 root + actuator HEALTHCHECK);前端 `npm run build` → 静态产物;`.dockerignore`。 |
|
||||||
|
| **W3** | **单源托管 + 反代** | S-M | W2 | `deploy/nginx.conf`:serve web dist + `/api`→platform-app、`/flowable`→flowable-service;gzip/缓存/SPA history fallback。**消除 dev 的 vite proxy 依赖**。 |
|
||||||
|
| **W4** | **compose 编排 + 配置** | M | W2,W3 | `deploy/docker-compose.yml`(4 服务 + healthcheck + depends_on + 网络);`.env.example`(`EIP4_AUTH_JWT_SECRET`/`EIP4_DB_*`/`SERVER_PORT` 等,prod profile 已强制无默认);`SPRING_PROFILES_ACTIVE=prod`。 |
|
||||||
|
| **W5** | **数据迁移 runbook 执行** | M-L | W1 | 把 PG升级 / Flowable升级 两 runbook 在准生产真跑一遍并补「执行记录 + 回退验证」;产「客户环境部署 checklist」。**需真 DB/环境**。 |
|
||||||
|
| **W6** | **性能/并发基线 + 灰度** | L | W4,W5 | 关键只读路径压测基线(连接池/statement_timeout 已配,需实测);切流灰度=nginx upstream 权重(老 eip3 Vaadin ↔ 新 eip4 只读双跑),对接已有切流文档;回滚演练。 |
|
||||||
|
|
||||||
|
**最小可交付(MVP 切片)**:W1+W2+W3+W4 = 「一条 `docker compose up` 起全栈、Flyway 自动建平台表、nginx 单源访问」。W5/W6 需准生产环境,独立排期。
|
||||||
|
|
||||||
|
## 3.1 W1 Flyway 详细执行规格(ready-to-run,2026-06-25 勘探后细化)
|
||||||
|
|
||||||
|
> **状态(2026-06-25 更新)**:✅ **已实现 + 对本地真实 PG 验证通过 + 整栈 docker compose 真起 + 残留全收敛**。
|
||||||
|
> - 真验:`FlywayMigrationLocalIT`(库级两场景)+ 整栈 `docker compose up` 内置空 PG:platform-app 在 prod profile 启动时 Flyway 自建 eip3 schema 落 9 张 sys_* 表、readiness UP、nginx 单源反代生效(见 `deploy/README.md` 验证状态)。
|
||||||
|
> - 残留收敛(已完成):删 3 份与 db/migration 重复的 bootstrap(page-schema/datastatus/ai-agent);`ci.sh` 改指 `db/migration/V1`;`AiAgentDdlTest` 迁入 platform-app 改守 V3;新增 `SchemaImportCli.CREATE_DDL`↔V1 防漂移 guard(`PlatformMigrationDdlGuardTest`)。db/migration 现为平台表 DDL 唯一真相(SchemaImportCli 内联 DDL 为独立 CLI 兜底,经 guard 钉死不漂移)。
|
||||||
|
> **已做前置(2026-06-25)**:`bootstrap-ai-agent.sql` 两份去重——删 platform-app 副本,单一真相归 `platform-ai/src/main/resources/bootstrap/bootstrap-ai-agent.sql`(platform-app 经依赖传递消费;原同 classpath 路径双副本=解析歧义,已消除)。
|
||||||
|
|
||||||
|
**为何需 PG 才能安全做**:迁移 SQL 是 PG 专有(`::jsonb`/`::xml`/`ON CONFLICT`),H2 跑不了;本机 Docker daemon 未起→testcontainers 也用不了。盲发自动 migrate 进客户库启动路径=高爆炸半径,必须先在 dev PG 验过 `flyway migrate` + 回退。
|
||||||
|
|
||||||
|
**迁移清单(EIP4 新增平台表,从既有【幂等】bootstrap 原样迁入)**
|
||||||
|
| 迁移 | 源(现状) | 表 |
|
||||||
|
|---|---|---|
|
||||||
|
| `V1__sys_page_schema.sql` | `platform-metadata/.../bootstrap/bootstrap-page-schema.sql` | sys_page_schema |
|
||||||
|
| `V2__sys_datastatus.sql` | `platform-flow-gateway/.../bootstrap/bootstrap-datastatus.sql` | sys_datastatus(+种子) |
|
||||||
|
| `V3__sys_ai_agent.sql` | `platform-ai/.../bootstrap/bootstrap-ai-agent.sql` | sys_ai_task/draft/change_set/run/feature_package/revision/audit_log |
|
||||||
|
| (排除) | `platform-parity/.../bootstrap/*`(对拍测试种子) / `docs/sql/*`(admin 页数据 upsert,评估后单列) / 客户 eip3 schema | — |
|
||||||
|
|
||||||
|
**配置(baseline 策略)**:`flyway-core` 加 platform-app;`spring.flyway`:`baseline-on-migrate=true`、`baseline-version=0`(客户库非空→baseline 于 V0=不动既有,再跑 V1+;迁移幂等→既有平台表也安全)、`locations=classpath:db/migration`。**先 gated**:`enabled: ${EIP4_FLYWAY_ENABLED:false}`,dev 验过再开,prod 经 env 显式启用。
|
||||||
|
|
||||||
|
**跨模块处理(ai-agent)**:sys_ai_* DDL 由 platform-ai 拥有并被 `AiAgentDdlTest` 测试。`V3` 迁移在 platform-app/db/migration,内容与 platform-ai 副本须一致——A10 W1 落地时二选一:① V3 引用/复制 platform-ai 副本并加防漂移测试;② 用 Flyway `locations` 叠加 `classpath:bootstrap`(但 bootstrap 非 V__ 命名,需重命名)。建议①。
|
||||||
|
|
||||||
|
**收敛 spring.sql.init**:W1 验过后,dev/local 的 `spring.sql.init.schema-locations` 改指 `classpath:db/migration/*.sql`(与 Flyway 同源),并删散落 bootstrap → 真单一真相。**收敛前 dev 行为不变**(spring.sql.init 仍跑现有 bootstrap,Flyway gated off,零回归)。
|
||||||
|
|
||||||
|
**验证门(接 PG 后)**:dev PG 跑 `flyway migrate`→`info`/`validate` 全绿 → 既有库 baseline 不破坏既有数据 → 回退演练 → 再 prod 开 `EIP4_FLYWAY_ENABLED=true`(W5 准生产)。
|
||||||
|
|
||||||
|
## 4. 待拍板决策点
|
||||||
|
|
||||||
|
| # | 决策 | 选项 | 建议 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **D1** | 单源托管形态 | (a) 独立 nginx 容器 serve dist+反代 / (b) platform-app Spring 伴服 dist+/api(少一进程) | **(a) nginx**:标准、解耦、支持灰度 upstream 权重(W6 需要);伴服把前端耦进 Java 发布节奏,不利切流。 |
|
||||||
|
| **D2** | Flyway 范围 | (a) 仅 EIP4 新增平台表 / (b) 含客户库 schema | **(a)**:客户库是既有 eip3 schema,保真层原样消费,EIP4 无权也无需迁移;`baseline-on-migrate` 接管既有库。 |
|
||||||
|
| **D3** | 是否容器化 | (a) Docker/compose / (b) systemd + 裸 jar(部分私有化客户禁 Docker) | **(a) 为主 + 文档化 (b) 兜底**:compose 标准化交付,同时给「裸 jar + systemd unit」附录供禁 Docker 客户。**需确认客户环境是否允许 Docker**。 |
|
||||||
|
| **D4** | 密钥/配置管理 | (a) 环境变量/.env / (b) Vault/KMS | **(a) v1**:prod profile 已强制 env 注入、缺失即 fail-fast;Vault 待客户安全要求再上。 |
|
||||||
|
| **D5** | 灰度/切流机制 | (a) nginx upstream 权重双跑(eip3↔eip4 只读)/ (b) 全量切换 | **(a)**:契合「只读先切流」既定路线 + 已有切流 runbook;可逐页/逐比例放量、秒级回滚。 |
|
||||||
|
| **D6** | 生产 PG | (a) 复用客户既有 PG / (b) compose 内置 PG | **(a) 生产 / (b) 仅自测演示**:生产 PG 是客户资产,compose 的 pg 仅 demo。 |
|
||||||
|
|
||||||
|
## 5. 风险
|
||||||
|
|
||||||
|
- **保真层与客户库耦合**:W1 `baseline-on-migrate` 必须在客户库真跑验证,错配会污染客户既有表(W5 准生产演练前置)。
|
||||||
|
- **冻结的 amis-fork / 端口契约漂移**(8084/8093/8094):nginx 反代须钉死 prod 端口(8084),与 dev(8093)/fivering(8094) 区隔,写进 .env。
|
||||||
|
- **Flowable 独立进程的事务/状态一致性**:切流灰度下 eip3/eip4 双写工作流状态需隔离(只读切流期 flowable 仅新系统写)。
|
||||||
|
- **CI 激活依赖 Gitea runner**:W 完成后的回归靠 CI,但 runner 未注册前不自动跑(基建前置)。
|
||||||
|
|
||||||
|
## 6. 建议下一步
|
||||||
|
|
||||||
|
1. **先拍 D1-D6**(尤其 D3 需问客户环境是否允许 Docker)。
|
||||||
|
2. 拍板后按 **W1→W2→W3→W4(MVP)** 执行——纯代码/配置,**不卡环境,可 headless 做完 + 单测/compose lint 验证**。
|
||||||
|
3. **W5/W6** 排进准生产窗口(需真 DB + 客户环境)。
|
||||||
|
|
||||||
|
---
|
||||||
|
*本文为待拍板设计;现状底数见进度总览 §3 A10 / §10.2,切流细节见 `docs/P0-PG升级`、`docs/P3-Flowable升级` runbook。*
|
||||||
209
docs/plans/2026-06-25-审批闭环-实施计划.md
Normal file
209
docs/plans/2026-06-25-审批闭环-实施计划.md
Normal file
@@ -0,0 +1,209 @@
|
|||||||
|
# 审批闭环 — 完整实施计划(2026-06-25)
|
||||||
|
|
||||||
|
> 目标:把 EIP4 审批从「单人串行主链路已 live」推进到「动作类型齐全 + 流程可视化 + 流程监控 + 端到端真实流转」的生产可用闭环。
|
||||||
|
>
|
||||||
|
> 现状权威依据:`ApprovalController.java`(gateway)/ `FlowController.java`、`CandidateController.java`(flowable-service)/ `FlowableClient.java`(gateway client)/ `ApprovalDrawer.tsx`、`TodoPage.tsx`(web)实读核实;进度矩阵见 `docs/项目进度与路线-总览-2026-06-21.md` §A2/B3/B4。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. 现状基线(核实于 2026-06-25)
|
||||||
|
|
||||||
|
### ✅ 已实现并 live(WfTemplate 数据驱动审批主链路)
|
||||||
|
- 动作:`approve`(complete + 回写 SYS_DATASTATUS 3/2)、`reject`(终止 + 回写 4)、`reback`(退回发起 + 回写 5)、`agent`(委托)。
|
||||||
|
- 界面:`ApprovalDrawer`(只读业务表单 + 流程轨迹时间线 + 动态按钮 + 审批意见);业务表单走统一 sys_page_schema editform 解析;load 脚本保真层执行(4s 超时守护);action servicename 服务器侧按 buttonId 重解析后执行。
|
||||||
|
- 入口:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮接线(mock e2e 1/1)。
|
||||||
|
- 提交审批桥:`ProcessCoreServiceBridge`(startWorkflow)已实证起真实 flowable 实例。
|
||||||
|
|
||||||
|
### 🟡 引擎/Client 层已具备、仅缺 gateway 动作接线 + UI 按钮(关键发现:比想象中近)
|
||||||
|
> 这些**不需要动引擎**,引擎与 `FlowableClient` 方法都已存在并测过:
|
||||||
|
- `FlowableClient.withdraw(pi, comment)` ← flowable-service `POST /api/flow/process/{pi}/withdraw`(发起人撤回)
|
||||||
|
- `FlowableClient.terminateProcessInstance(pi, comment)` ← `POST /process/{pi}/terminate`(强制结束)
|
||||||
|
- flowable-service `POST /process/{pi}/suspend` / `/activate`(挂起/激活,client 侧尚无封装方法)
|
||||||
|
- `FlowableClient.started(...)` ← `GET /process/started`(我发起的流程列表)
|
||||||
|
- `FlowableClient.deleteHistoricProcessInstance(pi)` ← `POST /process/{pi}/delete-history`
|
||||||
|
- `trace` / `traceByBusiness`(轨迹)已用于 ApprovalDrawer。
|
||||||
|
|
||||||
|
### ❌ 完全缺失
|
||||||
|
1. 动作类型:**协办/加签 `assist`**、**转阅/抄送 `circulated`** —— `ApprovalController.java:227` 直接 `badRequest`。**会签**(多实例并行 + 结果聚合)无任何处理。
|
||||||
|
2. **BPMN 流程图查看** —— 现仅文本轨迹,无图形化高亮当前节点。
|
||||||
|
3. **流程定义 Modeler(B3)** —— 完全未起步。
|
||||||
|
4. **「我发起的流程」页 / 流程监控页** —— web 无对应 page(仅 `TodoPage`);撤回/结束按钮无 UI。
|
||||||
|
5. **审批待办组件 B4** —— UI/UE 组件骨架未补完。
|
||||||
|
|
||||||
|
### 🔒 外部阻塞(非代码能力问题)
|
||||||
|
- 客户真实 BPMN 部署:新提交走通用流 `EIP4_DEFAULT_APPROVAL`,无 `form_key` → 降级默认按钮。全数据驱动 + 候选人计算需客户部署真实 BPMN(`form_key` 指 WfTemplate)。dev act 流程库不可达。
|
||||||
|
- `reject`/`reback`/action-servicename 写流:仅 wired + 单测,未对真实迁移数据跑 mutation(数据安全自限)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 范围分层与优先级
|
||||||
|
|
||||||
|
| 层 | 内容 | 外部依赖 | 工作量 | 价值 |
|
||||||
|
|----|------|---------|--------|------|
|
||||||
|
| **P0**(立即可做) | 协办/加签 `assist`、转阅/抄送 `circulated` 动作落地 | 无 | 中 | 高(补齐审批语义完整性) |
|
||||||
|
| **P1**(接线打磨) | 流程监控按钮(撤回/结束/挂起)接线 + 「我发起的流程」页 | 无 | 小-中 | 高(引擎已就绪,最后一公里) |
|
||||||
|
| **P1**(可视化) | BPMN 流程图查看(bpmn-js 高亮当前节点) | 无(用已部署 bpmn) | 中 | 高(审批可视化刚需) |
|
||||||
|
| **P2**(验证闭环) | 真实流转 / 候选人计算 / 写流对真实记录的端到端验收 | **客户 BPMN** | 中 | 高(但卡外部) |
|
||||||
|
| **P3**(大工程) | 会签(多实例聚合)+ 流程定义 Modeler(B3) | 部分卡 S1 | 大 | 中(按客户诉求排期) |
|
||||||
|
|
||||||
|
> 建议交付顺序:**P0 → P1 监控接线 → P1 BPMN 图 → P2(客户 BPMN 到位后)→ P3**。P0/P1 共约 4 个可独立交付的增量,互不阻塞,均不依赖外部。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 分阶段任务
|
||||||
|
|
||||||
|
### 阶段 A — 协办/加签 `assist`(P0)
|
||||||
|
|
||||||
|
**语义对账(先做,不可跳过)**:核对老系统 `TaskProcessServiceImpl` 中 assist 的真实行为。预期两种之一:
|
||||||
|
- (a) **加签**:当前任务保留,给目标人新增一个并行/串行待办(`addCandidateUser` 或动态加 task),目标人办完回到原审批人;
|
||||||
|
- (b) **协办**:把当前任务的 candidate 增加目标人,任一人可办。
|
||||||
|
> WfTemplate 数据里 assist 仅 2 例 —— **务必先 SQL 取这 2 例的 xml + servicename,确认是 (a) 还是 (b)**,不要凭猜实现。
|
||||||
|
|
||||||
|
**改动**:
|
||||||
|
- flowable-service `FlowController`:新增 `POST /api/flow/tasks/{taskId}/assist`(入参 targetUserId、comment)。用 `TaskService.addCandidateUser` 或 `runtimeService` 动态加签,按语义对账结果实现。CHAR(36) 补白对齐既有 `TrimmingCandidateUsersHandler` 口径。
|
||||||
|
- `FlowableClient`:加 `assist(taskId, targetUserId, comment)`。
|
||||||
|
- `ApprovalController.action`:`case "assist"` → 新 `assist(taskId, req)` 方法(替换当前 400)。
|
||||||
|
- 单测:FlowController assist 1 + ApprovalController dispatch 1。
|
||||||
|
|
||||||
|
**验收**:真实/构造任务加签后,目标人 todo 出现该任务;办理后流程状态正确。
|
||||||
|
**风险**:加签的「办完回到谁」依赖 BPMN 结构;若客户 BPMN 不可达,先用 dev 构造流程验证机制,标注真实流待客户库。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 阶段 B — 转阅/抄送 `circulated`(P0)
|
||||||
|
|
||||||
|
**语义对账**:circulated 仅 2 例。老系统转阅通常是**只读知会**(不阻塞流程):给目标人发一条「抄送待阅」记录,目标人可见单据但无审批动作。核实是否落 `act_ru_identitylink`(type=participant)或独立抄送表。
|
||||||
|
|
||||||
|
**改动**:
|
||||||
|
- flowable-service `FlowController`:`POST /api/flow/tasks/{taskId}/circulate`(targetUserIds[]、comment)。实现 = 加 participant identityLink + 写抄送记录(若老系统有抄送表,迁移对齐;否则用 identityLink + 历史评论)。
|
||||||
|
- `FlowableClient`:`circulate(taskId, targetUserIds, comment)`。
|
||||||
|
- `ApprovalController.action`:`case "circulated"` → `circulate(...)`。
|
||||||
|
- 「抄送给我的」列表:复用 `TodoController` 加 `GET /api/tasks/circulated?user=`(查 participant identityLink)。**前端可暂缓**,先保证动作不报 400。
|
||||||
|
- 单测:circulate 1 + dispatch 1。
|
||||||
|
|
||||||
|
**验收**:转阅后目标人能在「抄送给我」看到只读单据;原审批流不受影响继续。
|
||||||
|
**风险**:抄送列表入口是新页面,P0 只交付动作 + 后端列表端点,前端页面归 B4。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 阶段 C — 流程监控按钮接线(P1)✅ 实施时核实:已完成(无需重做)
|
||||||
|
|
||||||
|
> **2026-06-25 实施勘探更正**:本阶段在 06-21 矩阵里被标为「缺监控按钮」,实测**后端 + amis 页全部已存在**(进度文档 framework P2 那批 `57c3412…d218c2b` 已交付,当时计划按旧矩阵误判):
|
||||||
|
> - `GET /api/workflow/process/started-amis`(我的发起)+ `monitor-amis`(流程监控)列表端点 —— 各被 1 个 `sys_page_schema` 页引用。
|
||||||
|
> - 我的发起页(`0db4af06…`)含**撤回**按钮 → `POST /api/workflow/process/{pi}/withdraw`(回写 SYS_DATASTATUS=5)。
|
||||||
|
> - 流程监控页(`9f3b5a8b…`)含**强制结束**按钮 → `/terminate`(回写=6 作废)+ **高级处理脚本** `/advanced-script`(带 RCE 守卫,仅非生产 profile)+ `/delete-history`。
|
||||||
|
> - 语义正确:发起人撤回自己的、管理员监控结束别人的。
|
||||||
|
>
|
||||||
|
> **结论**:阶段 C 无需实现。残留仅 suspend/activate(挂起/激活)未在 gateway 暴露——价值低,暂不做;监控页缺「流程图/轨迹」按钮归入阶段 D。
|
||||||
|
>
|
||||||
|
> ~~原计划(引擎 + client 已全有,只缺 gateway 动作端点 + UI)~~ —— 实际 gateway 端点也已就绪。
|
||||||
|
|
||||||
|
**改动**:
|
||||||
|
- `FlowableClient`:补 `suspend(pi)` / `activate(pi)`(其余 withdraw/terminate/started 已有)。
|
||||||
|
- gateway 新 `ProcessMonitorController`(或并入 ApprovalController):
|
||||||
|
- `POST /api/process/{pi}/withdraw`(发起人撤回,回写 SYS_DATASTATUS)
|
||||||
|
- `POST /api/process/{pi}/terminate`(强制结束,超管/管理员权限校验,回写状态)
|
||||||
|
- `POST /api/process/{pi}/suspend` / `/activate`
|
||||||
|
- 权限:撤回限发起人本人;结束/挂起限管理员角色(复用 JWT 角色)。
|
||||||
|
- web 新 `StartedProcessPage.tsx`(「我发起的流程」):列表走 `started`,行内「撤回」按钮 + 流程轨迹抽屉(复用 ApprovalDrawer 只读模式 + historyMeta 端点,已存在)。
|
||||||
|
- 单测:ProcessMonitorController 4(每动作 1)+ 权限拒绝 1;前端 vitest 列表渲染 1。
|
||||||
|
|
||||||
|
**验收**:发起人撤回未审任务 → 状态回写 + todo 消失;管理员强制结束运行流程 → 实例 ended。
|
||||||
|
**风险**:撤回/结束对真实客户数据是破坏性操作,**只对 dev 构造流程跑实际 mutation**,真实库标注待客户授权。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 阶段 D — BPMN 流程图查看(P1)
|
||||||
|
|
||||||
|
**方案**:bpmn-js 前端渲染 + 后端给 XML & 当前活动节点(业界标准,比服务端出图灵活,可高亮 + 缩放)。
|
||||||
|
|
||||||
|
**改动**:
|
||||||
|
- flowable-service:`GET /api/flow/process/{pi}/bpmn-xml` → 用 `RepositoryService.getProcessModel(procDefId)` 返 BPMN XML 字符串;`GET /api/flow/process/{pi}/active-activities` → `runtimeService.getActiveActivityIds(pi)`(高亮用,已有 RuntimeService)。历史流程取 `HistoricActivityInstance` 标记走过的节点。
|
||||||
|
- `FlowableClient`:`bpmnXml(pi)` / `activeActivities(pi)`。
|
||||||
|
- gateway:`GET /api/process/{pi}/diagram`(聚合 xml + active + history 节点)。
|
||||||
|
- web:引入 `bpmn-js`(NavigatedViewer),新 `ProcessDiagram.tsx`,在 ApprovalDrawer 加「流程图」Tab;高亮当前节点(绿)、走过节点(灰)。
|
||||||
|
- 单测:diagram 端点 2;前端组件渲染 smoke 1。
|
||||||
|
|
||||||
|
**验收**:打开任一运行中流程,流程图正确渲染并高亮当前停留节点。
|
||||||
|
**风险**:迁移的是 activiti5 流程定义,bpmn-js 需 BPMN 2.0 XML;若部分老流程是 activiti5 私有格式,需确认 `getProcessModel` 返的是标准 BPMN 2.0(flowable 部署后通常是)。先用一条已部署流程验证格式兼容性。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 阶段 E — 端到端真实流转验收(P2,卡客户 BPMN)
|
||||||
|
|
||||||
|
**前置①(外部)**:客户提供并部署真实 BPMN(form_key 指 WfTemplate)。到位后:
|
||||||
|
- 真实流转:提交 → 候选人计算(`CandidateController` + `OrgDirectory` 已就绪)→ 多级审批 → approve/reject/reback 实际推进。
|
||||||
|
- 写流:对**测试租户/沙箱记录**(非生产迁移数据)跑 reject/reback/action-servicename 实际 mutation,验证回写与服务流副作用。
|
||||||
|
- 候选人对账:用 `CandidateController` 对真实组织库批量核对解析结果(P3 报告口径)。
|
||||||
|
|
||||||
|
**验收**:一条客户真实审批流从提交到归档全程在 EIP4 走通,状态/候选人/表单全部正确。
|
||||||
|
**阻塞**:无客户 BPMN 则只能 dev 构造流程验机制,标注「机制已验,真实流待客户库」。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 阶段 F — 会签 + 流程定义 Modeler(P3,大工程,按客户诉求排期)
|
||||||
|
|
||||||
|
- **会签**:BPMN 多实例(multi-instance)任务,多人并行/串行审批,按比例/全票聚合结果。需引擎多实例支持 + 聚合变量 + UI 显示「3/5 已审批」。**先确认客户是否真有会签节点**(WfTemplate action type 分布里无独立会签 type,可能藏在 BPMN 结构,需核实)。
|
||||||
|
- **流程定义 Modeler(B3)**:bpmn-js + bpmn-js-properties-panel 在线编辑 BPMN,存 flowable 部署。**卡 S1 拍板**(是否自研 vs 用 flowable-modeler 嵌入)。工作量最大,建议独立 design。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 红线与约束(贯穿全程)
|
||||||
|
1. **不碰 view_template.xml / 153 bespoke**;审批是框架级通用能力。
|
||||||
|
2. **破坏性引擎动作(撤回/结束/加签/写流)只对 dev 构造数据跑实际 mutation**,真实迁移数据需用户显式授权。
|
||||||
|
3. **servicename 服务器侧按 buttonId 重解析,不信前端直传**(沿用 `ApprovalController.runActionServiceIfAny` 既有口径,防注入)。
|
||||||
|
4. **CHAR(36) 补白 / 候选人补白对齐既有 handler**(`TrimmingCandidateUsersHandler`、`EngineContextBinder` 归一化),避免身份不匹配。
|
||||||
|
5. **不自我批准**:实现后走 `code-reviewer` + 真库/dev e2e 验证,作者与评审分离。
|
||||||
|
6. e2e 端口坑:五环 jar = 8094(`playwright.fivering.config.ts`),标准 dev = 8093;psql 查业务表设 `PGOPTIONS='-c search_path=eip3'`。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 外部依赖与待拍板
|
||||||
|
- **【外部】客户真实 BPMN 部署** → 阻塞阶段 E 全部、阶段 A/B 的真实流验证。
|
||||||
|
- **【S1 拍板】流程定义 Modeler 自研 vs 嵌入 flowable-modeler**(阶段 F)。
|
||||||
|
- **【待核实】会签是否为客户真实诉求**(数据里无独立 type,先核实再排期)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 执行进度(2026-06-25/26 本会话,按 P0→P3 顺序)
|
||||||
|
|
||||||
|
### 波1 ✅ 已实现 + 对抗审查收口 + 单测绿 + **live 验证通过**:阶段 A(assist 协办)+ 阶段 B(circulated 转阅)
|
||||||
|
- 语义对账(红线)已做:SQL 取 view_wftemplate 那 2+2 例(全空 servicename)+ 读老 `ProcessCoreServiceImpl.createSubTask/createNewTask` 坐实语义(协办=建独立子任务、转阅=建只读知会任务)。
|
||||||
|
- 后端 flowable-service `POST /tasks/{id}/assist`+`/circulate`;gateway `FlowableClient.assist/circulate` + `ApprovalController` 分派把 400 改真实;前端 `ApprovalDrawer` 多选人弹窗 `MultiUserForm`。
|
||||||
|
- **对抗代码审查(code-reviewer)揪出 1 HIGH + 3 MEDIUM,已修**:
|
||||||
|
- 【HIGH 已修+live证】协办/转阅是独立任务(无 processInstanceId/formKey),审批渲染原取不到 businessKey/formKey → 协办人/转阅人看不到业务单据。修法=`approvalContext` 对独立任务**沿 parentTaskId 回溯父任务**取 businessKey+formKey(兼防 `processInstanceId(null)` 崩 500);circulate/assist 子任务 `setFormKey(父formKey)`。
|
||||||
|
- 【MEDIUM 已修】assist 补父任务 404 守卫(与 circulate 对称);派发 `MAX_FANOUT=50` 上限;assist/circulate 加 `@Transactional` 整批原子。
|
||||||
|
- 【LOW】转阅改 `setFormKey` 而非 description(FormKeyResolver 直接命中);javadoc 与实现对齐。
|
||||||
|
- 单测:flowable-service FlowControllerTest 21 + ProcessDiagramControllerTest 3 全绿;gateway ApprovalControllerActionTest 5 全绿;前端 tsc 干净 + vitest 83/83。
|
||||||
|
- **live e2e(8089+8093 新 jar,真引擎)**:① POST assist/circulated 各返 `count:1`(不再 400);② 子任务 approval-context **回溯出父流程 businessKey=probe-bk-1 + processInstanceId**(HIGH 修复实证);③ 子任务**进目标用户待办**(assignee 匹配无补白问题,reviewer Open Question 实证排除);④ 测试产物已清理。
|
||||||
|
|
||||||
|
### 波2 ✅ 核实即完成:阶段 C(流程监控)
|
||||||
|
后端 + amis 页早已存在(见上文阶段 C 更正),无需重做。
|
||||||
|
|
||||||
|
### 波3 ✅ 已实现 + 单测绿 + **live 验证通过**:阶段 D(BPMN 流程图)
|
||||||
|
- 后端 flowable-service 新 `ProcessDiagramController` `GET /process/{pi}/diagram`(返 bpmnXml + activeActivityIds + finishedActivityIds,只读,运行/历史双路取 procDefId);gateway `FlowableClient.diagram` + `TodoController GET /api/workflow/process/{pi}/diagram` 转发。
|
||||||
|
- 前端新 `src/api/diagram.ts` + `src/components/ProcessDiagram.tsx`(bpmn-js NavigatedViewer,中文节点走浏览器字体,当前节点绿/已走过灰高亮);`ApprovalDrawer` 加「查看流程图」按需展开段。bpmn-js 依赖已装,build ✓(5104 模块)。
|
||||||
|
- 单测 ProcessDiagramControllerTest 3 绿。**live e2e**:真实带 DI 的迁移实例(PI=511732)返 `bpmnXml=7586 chars / 含 BPMNDiagram 布局 / 当前节点 sid-… / 已走过 4 节点` → bpmn-js 可渲染。
|
||||||
|
|
||||||
|
### 阶段 E(P2)⏸ 外部阻塞
|
||||||
|
真实流转/候选人/写流端到端 —— 需客户 BPMN(dev `EIP4_DEFAULT_APPROVAL` 通用流无 form_key)。注:`eip4flow` 库有 1512 流程定义/9441 实例可读,故**只读类**(流程图/轨迹)已能 live;写类真实流转仍待客户 BPMN。
|
||||||
|
|
||||||
|
### 阶段 F(P3)— 会签 ✅ 已实现+live;Modeler ⏸ 待 S1
|
||||||
|
**会签更正(2026-06-26,用户确认是客户真实诉求)**:先前「阻塞/待核实」判断**错误**——会签不是 WfTemplate 的按钮 type,而是 **BPMN 多实例(multiInstance)节点结构**,故按钮 type 分布看不出。核实结果:
|
||||||
|
- 迁移库 28/1512 流程定义含 `multiInstanceLoopCharacteristics`;其中 **4 个真实业务流程**:安全技术交底(集合 type=`user`)、总包合同交底/招投标工程评审流程/施工技术交底(集合 type=`scriptUser`)。
|
||||||
|
- **引擎机制本就全在**:flowable 原生多实例(并行任务+`completionCondition` 聚合) + `multiInstanceUsersHandler` bean 已移植并在 `FlowableEngineConfig` 注册 + 每个会签人走现有 `approve`。故 `user` 类型会签早已能跑。**会签从不是外部阻塞**。
|
||||||
|
- **真正缺口**:`CandidateUsersHandler` 的 **`scriptUser`(JUEL 脚本)候选人解析分支当初故意没移植**("精简边界" WARN 降级,26 处)。3/4 真实会签流程用 scriptUser(`${APPLYUSERS}`) → 办理人解析返空 → 会签节点被跳过(日志实锤 WARN)。
|
||||||
|
- **已修复**:`CandidateUsersHandler` 实现 scriptUser 分支 = 单变量 `${VAR}` 直读流程变量、复杂表达式回退 flowable 表达式管理器对 execution 求值、结果按 List/数组/逗号分号串/单值归一为去重 userId 列表。单测 8(`CandidateUsersScriptUserTest`);flowable-service 全量 56 绿无回归。
|
||||||
|
- **live e2e**:起「招投标工程评审流程」(APPLYUSERS=3人) → 会签节点**生成 3 条并行任务**(修复前 0 条被跳过);完成 **1/3 不推进**(剩 2)、完成 **3/3 聚合推进**到下一节点(完成条件 `nrOfCompletedInstances/nrOfInstances==1` 全票);测试实例已清理。
|
||||||
|
|
||||||
|
**剩 Modeler ⏸**:流程定义 BPMN 在线 Modeler(B3,自研 vs 嵌入 flowable-modeler)仍卡 S1 拍板。
|
||||||
|
|
||||||
|
**会签残留(跟踪项,非阻断)**:① 会签进度显示("已会签 N/M 人")未做,可从多实例执行的 `nrOfInstances/nrOfCompletedInstances` 取,属 UX 增强;② scriptUser 复杂表达式回退依赖命令上下文,已 try/catch 安全降级;③ 真实 APPLYUSERS 由业务表单/前序步骤设置,本次用 start 变量模拟。
|
||||||
|
|
||||||
|
### 残留(非阻断,跟踪项)
|
||||||
|
- 协办/转阅目标用户用文本输入(与现有「转办」DelegateForm 同款),无真实用户存在性校验 → 错填 userId 会建不可见任务。**与现有转办行为一致**,建议后续统一接用户 picker(同时惠及转办)。
|
||||||
|
- 协办/转阅按钮在 WfTemplate 均无 servicename(已核实),故 `runActionServiceIfAny` 对其为 no-op,安全。
|
||||||
|
|
||||||
|
**改动文件**(全部在 flowable-service + platform-flow-gateway + eip4-web,未触及其他模块;platform-report/legacy-core 的失败测试是它处 WIP/JDK 环境问题,与本次无关):
|
||||||
|
- 后端:`FlowController.java`、`Requests.java`、`ProcessDiagramController.java`(新)、`FlowableClient.java`、`ApprovalController.java`、`GatewayRequests.java`、`TodoController.java` + 3 测试
|
||||||
|
- 前端:`approval.ts`、`ApprovalDrawer.tsx`、`diagram.ts`(新)、`ProcessDiagram.tsx`(新)、`package.json`(bpmn-js)
|
||||||
62
docs/plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md
Normal file
62
docs/plans/2026-06-25-报表迁移-JOR引擎重宿主-design.md
Normal file
@@ -0,0 +1,62 @@
|
|||||||
|
# 报表迁移:JOR(jatools)引擎重宿主到 EIP4 — design + 实施
|
||||||
|
|
||||||
|
> 2026-06-25。回答「EIP3 的真报表(JOR 套打)能否迁移」=**能**,PoC 已证(headless 渲染 + 连真库 + 跑报表 SQL,见 `/tmp/eip4-report-poc.html` 与浏览器截图 `在建工程项目收付款信息表`)。本文为把 PoC 变成可用功能的设计与实施。
|
||||||
|
|
||||||
|
## 0. 关键结论(PoC 已验)
|
||||||
|
- EIP3 报表 = `jatools` JOR **套打模板**(633 个 `.xml`,合并单元格/边框/公式列/分组小计/分页/签字栏),引擎是**纯 Java 服务端**,导出 HTML/PDF/XLS/RTF,浏览器显示(H5;旧 ActiveX `.cab` 仅 IE 已死)。
|
||||||
|
- **不用移植 900 个源文件**:整套**预编译成品**在 `/Users/zhengwr/workspace/eip3/framework/com.dsasp.client.report/lib/`:
|
||||||
|
`jatools.jar`(引擎) + `bsh2.0.jar`(改造版 BeanShell,含 8 个自定义类) + 全部依赖(`itext.jar`/`jxl.jar`/`jsqlparser.jar`/`jfreechart-1.0.13.jar`+`jcommon`+`chart.jar`/`barcode4j.jar`+`zxing2.1.core.jar`/`commons-*`/`log4j-1.2.8`/`jaxen`/`xercesImpl`/`postgresql.jar`)。授权许可:`jatools.dat`(912B ASCII),预编译 jar 在 server 模式直接跑通(无物理 dongle);生产需确认授权(客户 EIP3 本就在用)。
|
||||||
|
- **渲染 recipe(已验)**:`ReportDocument.load(xml)` → 设参数 → `jatools.engine.ReportJob.printAsDHTML(imp, writer)`(HTML)/`printAsPDF(os)`/`printAsXLS(ba)`。headless:`-Djava.awt.headless=true`,`java.desktop@21` 在。
|
||||||
|
|
||||||
|
## 1. 参数绑定(查询条件,需求①)
|
||||||
|
EIP3 `ReportExporter` 的真实通道(`jor/jatools/server/ReportExporter.java`):
|
||||||
|
- 每个请求参数 `job.setParameter(name, value)`;
|
||||||
|
- `declareExternalVariables(doc, script, params)`:把 params 注入 script,并遍历 `doc.getVariableContext().variables(VariableContext.PARAMETER)`,按 `Parameter.castValue` 类型转换后 `script.set(p.getName(), value)`;
|
||||||
|
- 报表 SQL 里的 `${PARAM}` 即由这些已声明变量替换(`SqlReader` 检 `sql.indexOf("${")`)。
|
||||||
|
- 注:`LocalReportJob` 路径**不做** declareExternalVariables(故 PoC 里用 params 传 DBJdbcUrl 无效);**必须走 `ReportJob` 路径**。
|
||||||
|
- DB 连接:模板 `<Connection>` 用 `${property("DBJdbcUrl")/DBUser/DBPassword}`,`property()=System2.getProperty()=jatools.properties`。EIP4 须在启动时把 `DBJdbcUrl/DBUser/DBPassword` 注入 System2(指向客户库)。
|
||||||
|
|
||||||
|
## 2. 目标架构
|
||||||
|
- **platform-report 模块**:依赖上述预编译 jar。打包进 fat jar 的可靠做法 = `mvn install:install-file` 各 jar 进**项目内本地仓** `platform-report/local-repo/`(随码提交,坐标如 `com.dsasp.thirdparty:jatools:eip3`),pom 加 `<repository>file://.../local-repo</repository>` 正常依赖。**勿用 system scope**(不进 fat jar)。
|
||||||
|
- **ReportService**(复刻 ReportExporter 核心,去掉 com.dsasp 应用胶水):`render(templateXml, Map<String,String> params, format) → bytes/String`。`ReportJob` + `FileResourceOutputFactory(tmpDir)` + `printAsDHTML/PDF/XLS`。
|
||||||
|
- **ReportController**:`GET /api/report/{templateId}?format=html|pdf|xls&<查询参数>` → 加载 JOR 模板 → ReportService → `text/html` / `application/pdf` / xls。
|
||||||
|
- **模板来源**:633 个 `.xml`。v1:配置一个模板根目录(EIP3 report 目录)+ `templateId→xml` 映射;后续:导入 `sys_report_template` 表(随 sys_* 平台表,Flyway 管)。
|
||||||
|
- **System2 连接注入**:启动时用 EIP4 `spring.datasource` 配置写入 jatools 的 DBJdbcUrl/DBUser/DBPassword(经 System2 的 setProperty 或可解析的 jatools.properties)。
|
||||||
|
|
||||||
|
## 3. 前端集成(菜单页,需求②:不是独立 tab)
|
||||||
|
- type=200 报表页**已是** sys_page_schema 里的菜单功能页(转换器已生成,含查询条件表单——见 `项目安全费用投入明细` 的 amis filter)。
|
||||||
|
- 改造该页 body:把 amis CRUD 表换成**报表查看器**(amis `iframe`/`html` 组件)指向 `/api/report/{templateId}?{查询表单参数}`;查询表单 onSubmit 刷新 viewer。
|
||||||
|
- 仍是原菜单页(满足需求②);查询条件表单字段名 = 报表 VariableContext PARAMETER 名(PROJECTID/日期段/…)。
|
||||||
|
|
||||||
|
## 4. 分期
|
||||||
|
- **Phase 1(后端,本批次)**:platform-report 模块 + ReportService + `/api/report` 端点,headless 渲染一张带查询参数的 JOR 模板→HTML/PDF,接进 platform-app,curl 验证返回报表 HTML。
|
||||||
|
- **Phase 2(前端集成)**:报表页 body 换查看器 + 查询表单喂参数 + 菜单可达,端到端一张报表(对完整客户库出数据)。
|
||||||
|
- **Phase 3(铺量)**:633 模板导入 `sys_report_template`;type=200 页批量改造;字体保真;PDF/Excel 下载;图表(B 类,jfreechart 已在 lib)。
|
||||||
|
|
||||||
|
## 5. 风险
|
||||||
|
- headless 中文字体保真(版式已通,需装字体)。
|
||||||
|
- jatools 授权(生产确认;客户已持有)。
|
||||||
|
- System2 连接为进程级全局(单客户部署 OK;多租户需改造)。
|
||||||
|
- 模板里 `<Url>reportviewer.jsp?...`(钻取链接)需改写为 EIP4 路由(Phase 3)。
|
||||||
|
- eip4dev 是**部分** dev 库,缺部分报表源表/视图;数据验收须对**完整客户库**。
|
||||||
|
|
||||||
|
## 6. Phase 2/3 实现纪要(2026-06-25,已完成+live验收)
|
||||||
|
|
||||||
|
报表页**不再手搭**——由转换器对 type=200 统一生成,且查询条件落在 amis `crud.filter`(实测唯一能让 picker 正常加载选项的上下文;独立 form 里 picker 弹窗恒空)。
|
||||||
|
|
||||||
|
- **后端** `GET /api/report/frame/{templateId}`(`ReportController`):回显 amis CRUD 单行信封 `{status:0,data:{items:[{__url}],total:1}}`,`__url`=`/api/report/render/{id}?format=html&<查询参数>`(templateId 路径段 + 参数键值全 UTF-8 URL 编码,防注入)。crud 的 html 列把 `__url` 渲成 `<iframe>`,JOR HTML 独立加载、CSS 隔离保真。
|
||||||
|
- **转换器** `TemplateToAmisConverter.convertReport` 分流:含 `<reportfile>`(JOR 套打,328/339)→ `convertReportViewer` 产 `page→crud{api:/api/report/frame/{id}, filter:buildSearchFilter(查询条件), columns:[单 html 列 iframe], initFetch:false(有查询条件时等用户「查询」再加载)}`;无 reportfile(9/339,纯数据)→ 保留原数据表降级;2/339 为空 XML 孤儿模板(测试动态报表等),无产物属正常。
|
||||||
|
- **认证根因修(关键)** `EngineContextBinder`:工程 picker「选不到」的真因**不是**转换器/页面结构,而是**认证 admin 的引擎身份没被识别成超管**——JWT 注入 `CURRENTUSER="ADMIN"`(5 字符),引擎跳过行级数据过滤的判定是 exact `ctx.get(CURRENTUSER).equals(LoggedInUser.ADMIN)`,而该常量是 CHAR(36) 补白的 `"ADMIN"+31 空格`,5 字符 ≠ 36 字符 → admin 被当普通用户走数据权限 → `PM_PROJECT` 无规则 → `PrivilegeException` →「暂无该数据源的查询权限」(无 token 的 curl 走 ADMIN 默认上下文,故误以为后端正常)。修=`bind()` 把系统管理员(userId trim=ADMIN,或 account 精确小写='admin',与全站 `requireAdmin` 同口径,不放宽大小写防变体账号提权)的 CURRENTUSER 归一为引擎规范 36 字符 `LoggedInUser.ADMIN`,引擎识别超管→跳过过滤。各 `requireAdmin` 门控均 `trim().equalsIgnoreCase`,对补白形式同样判真,不破鉴权门。
|
||||||
|
- **live 验收**(8093 新 jar + 真库 + Playwright):工程 picker 列出全部 1672 工程→选中值落定→「搜索」→ crud 携 `PROJECTID` 调 frame→iframe `src=…?format=html&PROJECTID=…`→渲出 JOR 套打「在建项目收付款信息表」(单位/中标价/合同价/序号/工程名称/累计收款付款…);菜单 tab 内非独立页。339 报表页已批量重转重导 eip3.sys_page_schema(328 viewer 更新 + 9 表格不变)。
|
||||||
|
- **评审**:独立 code-reviewer + security-reviewer;按建议收口 templateId 路径编码、`/render` 端点 page/perPage 行为保持不变(分流到 frame)、account 判定与 requireAdmin 对齐大小写敏感(防变体账号提权)。
|
||||||
|
- **已收尾**:headless 中文字体保真(生产镜像装 `fontconfig+fonts-wqy-zenhei+fonts-dejavu-core`,docker 真镜像渲染验证零豆腐块,字体嵌入子集可移植);PDF/Excel 下载入口(查看器 `filter.actions`/`headerToolbar` 加导出按钮 → `/api/report/render?format=pdf|xls`,端点回 `Content-Disposition: attachment`+RFC5987 中文文件名,浏览器+curl 真验下载保真)。
|
||||||
|
|
||||||
|
## 7. B 类图表报表 backlog(2026-06-25 验证暂缓,独立小特性)
|
||||||
|
|
||||||
|
**验证结论(暂缓,非 jfreechart)**:`ischart=true` 报表仅 **4 张**(项目考勤图表-前十/单个、未签合同率前十、供应商价格分析土建),且**全部 `<reportfile>` 为空** —— EIP3 图表**不是 JOR/jfreechart 套打**(lib 的 jfreechart 只服务于内嵌在 JOR 版式里的图,这 4 张都没有),而是**老客户端从图表数据流画的 ECharts**。
|
||||||
|
- 图表数据流(如 `GB_ATTENDANCEINFO_PRJCHART`)被分类为**写服务流、GET 被拒**;POST 返结构化图数据 `{PRJNAMELIST:[类目], NOWLIST/COUNTLIST/ALLLIST:[系列], …标量}`(dev 库无源数据 → 全空)。
|
||||||
|
- 当前转换器把这 4 张走「图表→数据表」降级,crud 指向 `/api/flow/..._PRJCHART` 的 **GET**(被拒)→ 实为一张加载不出数据的破表。
|
||||||
|
- **faithful 迁移所需(独立特性)**:①能 POST 取数的图表端点;②把流结果映射成 amis `chart`(ECharts option)——但**图表类型/系列映射在老客户端代码里**(模板 XML 只有 `ischart`+`selectservice`+display,无图表定义),且**每张形状不同**,难用一套通用启发式覆盖;③出图保真还须**完整客户库**(dev 缺源数据)。仅 4 张、低优先,需产品定夺图表口径后再做。
|
||||||
|
|
||||||
|
- **钻取链接改 EIP4 路由已做**(2026-06-25):JOR 模板 `<Hyperlink><Url>reportviewer.jsp?xmluuid=<目标报表ID>&PARAM=${PARAM}…</Url>` 经 jatools `HtmlExport` 渲成 `<a href='reportviewer.jsp?xmluuid=…' target='_blank'>`(jar 内已确认 `<a href='` 发射);老 jsp 已失效。`ReportService.rewriteDrillLinks`(HTML 输出后处理,仅 HTML 通道)正则 `reportviewer\.jsp\?xmluuid=([^&'"\s<>]+)` → `/api/report/render/$1?format=html`(其余查询参原样保留,目标报表新标签渲出;目标自身钻取链接亦被同一步递归改写)。短路(无 `reportviewer.jsp` 子串原样返回,302/339 报表跳过正则);`replaceAll(Function)` 字面量拼接防 `$/\` 注入。**全 37 张 drill 报表 xmluuid 恒为首参**(评审实证全语料)。坑:钻取行落在报表明细行,eip4dev 缺源数据 → dev 渲不出 drill 链接,**点击直通须完整客户库验**;改写经 6 单测(真发射格式/裸&/多处/短路/null)+ jar 发射证实 + live 正常报表 round-trip 无损。
|
||||||
|
- **仍剩余**:完整客户库数据对账(eip4dev 部分库,源表/视图缺→渲布局但空数据,非引擎问题)、B 类图表(§7)。
|
||||||
134
docs/plans/2026-06-26-在线流程Modeler-design.md
Normal file
134
docs/plans/2026-06-26-在线流程Modeler-design.md
Normal file
@@ -0,0 +1,134 @@
|
|||||||
|
# 在线流程定义 Modeler — 设计(2026-06-26)
|
||||||
|
|
||||||
|
> 在 EIP4 已有 bpmn-js 流程图查看器之上,扩成**可编辑的 BPMN 流程设计器**:老审批流程能在线编辑修改、新审批流程能在线创建,flowable 流程相关特性全支持,叠加 EIP4 专有语义(办理人/会签/表单绑定)。
|
||||||
|
>
|
||||||
|
> 经 brainstorming 逐项拍定(本文末「决策记录」)。承接审批闭环:[[2026-06-25-审批闭环-实施计划]]、流程图查看(main `0ee919b`)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. 目标与成功标准(用户拍定)
|
||||||
|
1. **老流程能正常编辑修改**(改造 eip4flow 里 1512 个真实迁移流程)。
|
||||||
|
2. **新功能流程能正常创建**(从空白/模板新建并部署)。
|
||||||
|
3. **功能不缺失**:全 BPMN/flowable 元素可编可配(各类任务/网关/事件/子流程/边界事件/定时器/信号/错误/补偿…)。
|
||||||
|
4. **支持 flowable 流程特性**:监听器/超时/异步/网关条件/多实例/事件定义等 flowable 扩展属性可编辑。
|
||||||
|
|
||||||
|
**v1 边界(不含)**:DMN(决策表)、CMMN(案例管理)、flowable 自带表单设计器(EIP4 表单走 WfTemplate/amis,不需要)。这三者是 flowable 里平级但独立的编辑器,若客户需要 DMN(复杂规则表)属未来另立评估。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 现状基线(已具备,~70% 基础设施)
|
||||||
|
| 件 | 状态 |
|
||||||
|
|----|------|
|
||||||
|
| 部署端点 `POST /api/flow/deploy`(bpmnXml → `createDeployment().addString().deploy()`) | ✅ 已有 |
|
||||||
|
| 读流程 BPMN `GET /api/flow/process/{pi}/diagram`(含中文 id 净化) | ✅ 已有 |
|
||||||
|
| `bpmn-js/lib/Modeler`(可编辑版) | ✅ 已在 eip4-web 依赖 |
|
||||||
|
| 引擎模型表 `act_re_model`(草稿存储) | ✅ 已有 143 行 |
|
||||||
|
| `bpmn-js-properties-panel` + `@bpmn-io/properties-panel` | ❌ 需 npm 加 |
|
||||||
|
| activiti/flowable moddle 描述符 | ❌ 需加(保真地基) |
|
||||||
|
| 无 `ACT_DE_*`(flowable-modeler 设计态表) | — 不依赖;不嵌 flowable-modeler(Angular 栈,off-stack;其底层本就是 bpmn-js) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 架构与组件
|
||||||
|
|
||||||
|
**前端**(eip4-web,新 `ProcessModelerPage` + 路由 `/process-modeler/:modelId?`):
|
||||||
|
- 用 `bpmn-js/lib/Modeler`(替查看用的 `NavigatedViewer`)+ 完整元素 palette + `bpmn-js-properties-panel`。
|
||||||
|
- 布局:左画布 / 右属性面板 / 顶栏(保存草稿·发布上线·校验·返回)。
|
||||||
|
|
||||||
|
**后端**(flowable-service,新 `ProcessModelController`,复用既有 `RepositoryService`):
|
||||||
|
- `GET /api/flow/models` 列草稿
|
||||||
|
- `GET /api/flow/models/{id}` 取草稿 XML(`getModelEditorSource`)
|
||||||
|
- `POST /api/flow/models` 建草稿(`newModel`+`saveModel`+`addModelEditorSource`)
|
||||||
|
- `PUT /api/flow/models/{id}` 存草稿
|
||||||
|
- `POST /api/flow/models/{id}/deploy` 发布(草稿 XML → 复用既有 /deploy 逻辑)
|
||||||
|
- `GET /api/flow/process/{procDefId}/source` 载入存量流程为新草稿(复用 /diagram 的中文 id 净化)
|
||||||
|
- gateway(platform-flow-gateway)转发对应 `/api/workflow/models/**`,套 JWT 权限。
|
||||||
|
|
||||||
|
**存储**:草稿 = `act_re_model`(flowable 原生);发布 = `act_re_deployment`/`act_re_procdef`(引擎原生版本机制)。
|
||||||
|
|
||||||
|
**版本与运行实例**:发布 = 引擎出**新版本**;**运行中实例留在旧版本不受影响**(flowable 原生版本隔离)。v1 **不做实例迁移**(YAGNI;迁移属高级特性,另案)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. 数据流
|
||||||
|
1. **新建**:空白/模板 → 编辑 → 存草稿(act_re_model)。
|
||||||
|
2. **改存量**:打开 procDef → `/source` 灌成草稿 → 编辑 → 存草稿。
|
||||||
|
3. **发布**:草稿 XML → 同人确认弹窗(影响摘要)→ 校验门 → `/deploy` → 新版本。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 属性面板:标准全套 + EIP4 定制叠加
|
||||||
|
|
||||||
|
**标准面板**(bpmn-js-properties-panel):出全部 flowable 流程属性——节点名/文档、网关条件、多实例、监听器、超时、异步、事件定义等 → 满足「功能不缺失 / flowable 特性」。
|
||||||
|
|
||||||
|
**EIP4 定制控件**(叠加的自定义分组):
|
||||||
|
1. **办理人**:读节点 `activiti:candidateUsers="${candidateUsersHandler.getCandidateUsers(execution,'<JSON>')}"` → 解析内嵌 JSON → 友好编辑(角色/部门/前序处理人/scriptUser 多项,对齐已移植的 `UserProperty` 结构)→ 回写表达式。**前后端同源复用 CandidateUsersHandler 配置格式**。
|
||||||
|
2. **会签**:开关 → `multiInstanceLoopCharacteristics`(并行/顺序)+ collection=`${multiInstanceUsersHandler.getUsers(execution,'<JSON>')}` + 完成规则(全票 `nrOfCompletedInstances/nrOfInstances==1` / 过半 / 指定数)。人员来源复用办理人控件。
|
||||||
|
3. **formKey**:选择器列 `view_wftemplate` → 设 `formKey=view_wftemplate_id`,绑 EIP4 业务表单。
|
||||||
|
|
||||||
|
**原生 assignee/candidateUsers 字段不压**(用户拍定):保留显示供调试/高级,加灰字提示「EIP4 引擎以下方办理人控件为准」缓解误填。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. moddle 扩展(保真地基)
|
||||||
|
迁移 BPMN 用 `xmlns:activiti="http://activiti.org/bpmn"` 存扩展。bpmn-js 默认不认 → 重新导出**会丢扩展**(致命)。**提供完整 activiti moddle 描述符**(JSON,声明整个 activiti 命名空间的元素/属性,非最小集),让编辑器读写原样保留 → 既保真零丢失,又使「flowable 扩展全属性可编辑」。activiti 命名空间予以保留(不归一为 flowable,避免引擎侧读取依赖断裂)。
|
||||||
|
|
||||||
|
**铁律测试**:载入真实流程 BPMN → 不改 → 导出 → XML 语义 diff **零丢失**(覆盖 activiti 扩展 / 会签 / 办理人表达式)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 🔴 关键保真细节:id 可逆净化(保流程 key)
|
||||||
|
`/diagram` 把中文 process id(如「招投标工程评审流程」)净化为 `nXXX` 是给 bpmn-js 渲染用的。若拿净化版去部署,**流程 key 会变成 nXXX,断了与存量实例/引用的连续性**。
|
||||||
|
|
||||||
|
**对策**:载入改存量时**记下 id 映射**(原中文 ↔ 安全 ASCII),编辑器用净化版;**发布时逆向还原原始中文 key**(新加节点的 ASCII id 保留)。这样存量流程 key 不变、版本连续。映射随草稿一并存。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 红线 / 权限 / 审计(套「草稿 + 同人确认部署」)
|
||||||
|
- **部署门限超管**:`POST /models/{id}/deploy` JWT role 校验(控制器层拦),非超管 403。
|
||||||
|
- **同人确认**:前端发布弹窗显**影响摘要**(流程 key、当前版本号、运行中实例数、改了哪些节点的办理人/会签)→ 确认才部署。
|
||||||
|
- **校验门**:部署前服务端跑 flowable 部署校验 + EIP4 校验(办理人表达式可解析 / formKey 命中 view_wftemplate / 会签完成条件合法)→ 不过不部署。
|
||||||
|
- **审计**:每次部署记一条(谁 / 何时 / model→deploymentId / 新版本号)。
|
||||||
|
- 不分离作者/审批(v1 取舍;作者-审批分离属 v2 增强)。
|
||||||
|
|
||||||
|
**错误处理**:草稿损坏/解析失败 → 422 不部署;校验失败 → 返回具体节点错误;权限不足 → 403。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 测试策略
|
||||||
|
1. **moddle 保真**:载真实流程 → 不改 → 导出 → XML 语义 diff 零丢失(activiti 扩展/会签/办理人表达式)。
|
||||||
|
2. **控件双向**:办理人 JSON ↔ 表达式、会签完成条件生成、formKey picker。
|
||||||
|
3. **id 可逆净化**:净化→还原回原 key、新节点 ASCII id 保留、映射稳定。
|
||||||
|
4. **后端**:model CRUD + deploy(校验门/权限门/审计)单测。
|
||||||
|
5. **live e2e**:载存量会签流 → 改办理人 → 存草稿 → 发布 → 起实例验新办理人生效;Playwright 走查编辑器渲染(含中文节点名、palette、属性面板)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. 分阶段交付
|
||||||
|
- **阶段 1**:完整 activiti moddle 保真 + 只读载入存量(编辑器能开真实流程、palette/标准属性可见、不丢扩展)+ 保真零丢失测试。
|
||||||
|
- **阶段 2**:三 EIP4 定制控件(办理人/会签/formKey)+ 存草稿(act_re_model)+ 控件双向测试。
|
||||||
|
- **阶段 3**:发布门(校验+超管权限+同人确认+审计)+ id 可逆净化 + 后端 deploy 门测试。
|
||||||
|
- **阶段 4**:新建流程(空白/模板)+ live e2e(载存量改办理人→发布→起实例验生效)+ Playwright 走查。
|
||||||
|
|
||||||
|
每阶段独立可验、可合 main。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 决策记录(brainstorming 2026-06-26)
|
||||||
|
| # | 决策 | 取定 |
|
||||||
|
|---|------|------|
|
||||||
|
| D1 | v1 范围 | **改存量 + 新建**(两者都要) |
|
||||||
|
| D2 | 部署门 | **草稿 + 同人确认部署**(限超管 + 校验 + 审计;不分离作者/审批) |
|
||||||
|
| D3 | 草稿存储 | **复用 flowable `act_re_model`**(model→deployment 一条龙) |
|
||||||
|
| D4 | 属性面板 | **标准全套 + EIP4 定制控件(办理人/会签/formKey)**;原生字段不压(加提示) |
|
||||||
|
| D5 | 编辑器能力 | **全功能 bpmn-js Modeler + flowable 流程全属性**(功能不缺失、新特性支持) |
|
||||||
|
| D6 | moddle | **完整 activiti 描述符**(保真零丢失 + 全属性可编辑),保留 activiti 命名空间 |
|
||||||
|
| D7 | id 处理 | **可逆净化**,发布还原原始中文流程 key |
|
||||||
|
| D8 | 版本/运行实例 | flowable 原生版本隔离,发新版本,运行中实例留旧版,v1 不做实例迁移 |
|
||||||
|
| D9 | v1 边界 | **BPMN 流程编辑器**,不含 DMN/CMMN/flowable 表单设计器 |
|
||||||
|
|
||||||
|
## 待 plan 阶段细化
|
||||||
|
- moddle 描述符来源:社区 flowable/activiti moddle vs 自建最小完整描述符(需核 activiti 命名空间实际用到的元素/属性全集)。
|
||||||
|
- 影响摘要里「改了哪些节点」的 diff 算法(节点级语义 diff)。
|
||||||
|
- 模板库(新建流程的起步模板:单人审批/多级审批/会签)放哪、几个。
|
||||||
|
- 草稿权限模型(谁能看/改别人的草稿)。
|
||||||
392
docs/plans/2026-07-02-在线流程Modeler-实施计划.md
Normal file
392
docs/plans/2026-07-02-在线流程Modeler-实施计划.md
Normal file
@@ -0,0 +1,392 @@
|
|||||||
|
# 在线流程 Modeler(B3)实施计划
|
||||||
|
|
||||||
|
> **✅ B3 全 17 任务完成并合 main(2026-07-02)**:platform origin/main 阶段1-4 全合、web origin/main 全合;每任务 TDD+对抗评审+修复轮,每阶段出口 live 验收(挡下 3 个单测/评审都没抓到的真 bug:options语义/面板ref/**bpmn-js PascalCase断部署**),末尾双对抗评审(安全+发布链)判定可宣告完成、唯一 Critical(nginx骨架洞)已修。**Modeler 端到端可用**:打开中文key存量流程→改办理人/会签保真读回→存草稿eip4IdMap保全→同人确认发布→部署新版本中文key保住+审计+起实例真userTask+旧实例不动+非admin403。
|
||||||
|
>
|
||||||
|
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
||||||
|
>
|
||||||
|
> 设计权威:`2026-06-26-在线流程Modeler-design.md`(D1-D9 已拍定)。本计划把 design 落成 TDD 任务,
|
||||||
|
> 每阶段独立可验、可 `--no-ff` 合 main。执行分支:platform `feat/process-modeler` / web `feat/process-modeler`。
|
||||||
|
|
||||||
|
**Goal:** 在既有 bpmn-js 流程图查看器之上交付可编辑 BPMN 流程设计器——1512 个存量真实流程可在线改(key 不变),新流程可从空白/模板建并部署,activiti 扩展零丢失。
|
||||||
|
|
||||||
|
**Architecture:** 前端 eip4-web 新 `/process-modeler` 页(bpmn-js `lib/Modeler` + 标准属性面板 + EIP4 React 侧栏控件);后端 flowable-service 新 `ProcessModelController`(flowable 原生 Model API 存草稿 act_re_model,id 净化映射存 metaInfo,发布时逆向还原);platform-flow-gateway 转发 `/api/workflow/models/**` 并承担超管门/EIP4 语义校验/部署审计。
|
||||||
|
|
||||||
|
**Tech Stack:** bpmn-js 17.11(已装)+ `bpmn-js-properties-panel`/`@bpmn-io/properties-panel`(新增)+ 自建 vendored activiti moddle 描述符;Flowable 6.8.1 RepositoryService Model API;React 18 + 自研 ui/Dialog;vitest + Mockito/MockMvc + Playwright。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## §0 事实基线(2026-07-02 勘探,全部核实过)
|
||||||
|
|
||||||
|
**语料(本地 eip4 库,5433,search_path=eip3)**:1512 真实 BPMN(act_ge_bytearray)/1503 部署/143 act_re_model。
|
||||||
|
扩展面实测:**11 个扩展属性**(activiti:formKey 1476docs / candidateUsers 1465 / exclusive 1311 / assignee 27 / collection 28 / elementVariable 24 / candidateGroups 3 / autoStoreVariables 4 / initiator 3 / dueDate 1 + flowable:assignee 3docs)、**5 个扩展元素**(taskListener 159docs / formProperty 6 / value / field / string);命名空间 activiti=1509docs、flowable=3docs。BPMN 特性:userTask 1505 / conditionExpression 297 / exclusiveGateway 276 / parallelGateway 52 / **multiInstance 28(8 个 distinct key,如「总包合同交底」——key 就是中文,D7 id 可逆净化是硬需求;且 moddle-xml 拒绝中文 id=进 moddle 前必须已净化,T1.1 实证)**。activiti:formKey 值=裸 UUID(view_wftemplate_id 本身,无前缀) / boundary·timer·subProcess·error 个位数 / signal·callActivity·serviceTask 零。
|
||||||
|
|
||||||
|
**后端**(file:line 均已核实):
|
||||||
|
- 部署端点已有:`FlowController.deploy` @ flowable-service `api/FlowController.java:81-105`,body=`{name?,bpmnXml}`,`createDeployment().name().addString().deploy()`,**无鉴权无审计**;网关 FlowableClient **未封装 deploy**。
|
||||||
|
- `ProcessDiagramController.java`:`sanitizeBpmnIds` @ :120 **单向丢映射**(:125 建 map :130 `"n"+hex(hash)`,方法返回即弃);`readProcessModel(procDefId)` @ :172 是 private(`repositoryService.getProcessModel`);**无 public 按 procDefId 取 XML 端点**。ID 重写正则 `ID_ATTR` @ :113-114 覆盖 `id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default`。
|
||||||
|
- Flowable 6.8.1 裸引擎(flowable-service/pom.xml:26,非 starter;flowable5-compatibility 已引)。`RepositoryService` bean @ `config/FlowableEngineConfig.java:73-76`;`databaseSchemaUpdate=false`(:55,红线)。**Model API(newModel/saveModel/addModelEditorSource/getModelEditorSource/createModelQuery)全仓零使用**——本计划首次启用,act_re_model 表已存在(143 行),无需 DDL。
|
||||||
|
- 网关模式:`FlowableClient`(client/FlowableClient.java,RestClient,baseUrl 默认 :8089,`execute()` @ :299 连接类失败重试→503、4xx/5xx 透传不重试);控制器方法参数注入 `AuthPrincipal`;**超管判定现成**:`EngineContextBinder.isSystemAdmin(AuthPrincipal)` @ platform-auth `security/EngineContextBinder.java:68-76`(userId trim equalsIgnoreCase "ADMIN" 或 account=="admin")。
|
||||||
|
- flowable-service **无 Spring Security 无 @Profile**,裸 8089 靠网关保护 → 超管门必须落在网关层。
|
||||||
|
- 审计现状:部署/审批动作无审计表(只有 taskService.addComment + logger);唯一显式审计模型先例=platform-ai `AiAuditEntry`。Flyway 机制已有(platform-app `db/migration/V1-V3`),本计划加 V4。
|
||||||
|
- 办理人 JSON(`BasePropertiesConverter.java`):`{"items":[{type,content,isCandidate,isSendMail,isSendPhone(,isSendMessage)}]}`;**BPMN 里花括号写全角 `【】`**,handler 运行时 replace 回 `{}`;前缀常量 `CANDIDATESERVICE="${candidateUsersHandler.getCandidateUsers(execution,'"` @ :34、`MULTIINSTANCESERVICE="${multiInstanceUsersHandler.getUsers(execution,'"` @ :35。type 取值:user/depart/position/formSpecifiedDimension/initiator/sameToTask/beforeTaskLeader/beforeTaskDepartManager/scriptUser/projectRoleType。引擎注册 bean 名(FlowableEngineConfig:62-68):`candidateUsersHandler`(TrimmingCandidateUsersHandler)/`multiInstanceUsersHandler`。
|
||||||
|
- 起实例(e2e 用):`POST /api/flow/process/start` @ FlowController:246(processDefinitionKey→startProcessInstanceByKey)。
|
||||||
|
- WfTemplate 全量列表端点**不存在**(WfTemplateService 只按单 id 查)→ 需新建 picker 数据源。
|
||||||
|
- 测试范本:`ProcessDiagramControllerTest`(@Mock RepositoryService + MockMvc standalone + getProcessModel stub 返 ByteArrayInputStream)、`FlowableClientTest`(MockRestServiceServer)、`CandidateUsersHandlerTest`。
|
||||||
|
|
||||||
|
**前端**:
|
||||||
|
- bpmn-js 17.11.1 已装、`lib/Modeler` 可直接 import、CSS 裸路径可行(ProcessDiagram.tsx:4-6 已验证);**需新增 `bpmn-js-properties-panel` + `@bpmn-io/properties-panel`**;Modeler 需补 `bpmn-js/dist/assets/bpmn-font/css/bpmn.css`(palette 图标)。
|
||||||
|
- 现有 `/modeler` = 实体建模器(占用)→ 新页用 **`/process-modeler`**。
|
||||||
|
- admin 门=页面组件内 `isAdminProfile(getProfile())` 自查降级(ModelerPage.tsx:21-22 范式);路由注册 App.tsx:41-52;入口挂 DesignCenterPage.tsx:76-91 按钮区 + Topbar.tsx:71-80 admin 图标。
|
||||||
|
- 弹窗/确认:自研 `ui/Dialog`(Dialog/Drawer)+ `toast()`;选人表单范本 ApprovalDrawer.tsx `MultiUserForm`(:199-261)。
|
||||||
|
- api 惯例:`src/api/http.ts` axios 单例;流程域走裸 JSON 派(diagram.ts 防御性默认);网关前缀 `/api/workflow/`。
|
||||||
|
- 测试:vitest(token 用 importOriginal 只 mock getProfile);Playwright 新配一个 config(照 `playwright.fivering.config.ts`:后端 8094、vite 5174、`apiJson`/`adminToken` 辅助复用 five-ring.spec.ts 写法)。
|
||||||
|
- 生命周期范本 ProcessDiagram.tsx:29-67(alive flag + destroy try/catch);编辑器页布局范本 editor/DesignerPage.tsx。
|
||||||
|
|
||||||
|
## §0.5 计划级决策(design「待 plan 细化」四项 + 实现取舍,执行前已定)
|
||||||
|
|
||||||
|
| # | 决策 | 取定与理由 |
|
||||||
|
|---|------|-----------|
|
||||||
|
| P1 | moddle 描述符来源 | **自建 vendored** `eip4-web/src/modeler/moddle/activiti.json`(完整 activiti 命名空间描述符,以社区 activiti-bpmn-moddle 内容为种子手工审校收录,不引 npm 依赖——供应链可控 + 可扩展 flowable 别名)。**验收=双门**:①语料覆盖测试(§0 的 11 属性+5 元素全部声明)②moddle 层 round-trip 零丢失测试 |
|
||||||
|
| P2 | 影响摘要 diff | 前端 DOMParser 节点级 diff:按 userTask id 对齐,比较 candidateUsers/assignee/formKey/multiInstance 四类属性变化,列「节点名:改了什么」。不做通用图 diff(YAGNI) |
|
||||||
|
| P3 | 新建模板库 | 3 个:单人审批/两级审批/会签,静态 BPMN 字符串放 `src/modeler/templates/`。**以真实流程为骨架改造**(从「总包合同交底」等抽形),保证与引擎兼容 |
|
||||||
|
| P4 | 草稿权限 | v1 整页 admin 门(页面+网关双层),草稿全体 admin 共见,无 per-user 属主(YAGNI,v2 再说) |
|
||||||
|
| P5 | EIP4 定制控件宿主 | **不写 preact 属性面板分组**,改为**同右栏叠放的 React 侧板**(selection.changed 驱动),放标准面板上方。理由:preact entries 与 React+RTL 测试栈割裂、集成风险高;React 侧板同样满足 D4「标准全套+定制叠加」,且原生字段照旧显示+灰字提示。含通用「activiti 扩展属性」键值编辑器兜底长尾属性(D5 全属性可编辑)+ taskListener 简单编辑(event+class/delegateExpression) |
|
||||||
|
| P6 | 语料保真扫描 | 全量 1512 流 round-trip 扫描做成**工具脚本**(连库跑,如 parity 模式),不进 CI 硬门;单测用**合成 fixture**(复刻 §0 全扩展面+中文 id+全角【】),不把客户 BPMN 提交进仓 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 阶段 1:moddle 保真 + 只读载入存量(可独立合 main)
|
||||||
|
|
||||||
|
### Task 1.1 前端依赖 + moddle 描述符 + 保真单测 ✅(8fdfe68,2026-07-02)
|
||||||
|
|
||||||
|
> 完成实证:panel 5.60.0/3.47.0;12/12+全量 101/101 绿;**三发现已回写本计划**(双包冲突→T1.5 只载 activiti / 嵌套全角【】→T2.3 / formKey=裸 UUID)。遗留:bpmn-moddle 无类型声明(TS7016 编辑器诊断,tsc -b 不受影响)→ T1.5 顺带补 `.d.ts`。
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `eip4-web/package.json`(+`bpmn-js-properties-panel@^5.23.0` +`@bpmn-io/properties-panel@^3.23.0`;装完看 npm 实际解析版本,只需兼容 bpmn-js 17)
|
||||||
|
- Create: `eip4-web/src/modeler/moddle/activiti.json`(完整 activiti 描述符:name=Activiti, uri=`http://activiti.org/bpmn`, prefix=activiti;types 覆盖 §0 全部 11 属性(挂 bpmn:UserTask/Process/SequenceFlow 等宿主的 extension attributes)+ taskListener/formProperty/field/string/value 元素;另加 flowable 别名描述符 `flowable.json`(uri=`http://flowable.org/bpmn`,覆盖 flowable:assignee 等 3docs 用到的属性))
|
||||||
|
- Create: `eip4-web/src/modeler/moddle/fidelity.test.ts`
|
||||||
|
- Create: `eip4-web/src/modeler/moddle/fixtures/synthetic-full-surface.bpmn.ts`(合成 fixture:中文 process id/name + userTask 带 candidateUsers 全角【】JSON + formKey + exclusive + 多实例(collection/elementVariable/completionCondition) + taskListener(class+field/string/value) + formProperty + boundaryEvent/timer + conditionExpression + BPMNDiagram DI)
|
||||||
|
|
||||||
|
**Step 1** 写失败测试(fidelity.test.ts,moddle 层 round-trip):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import BpmnModdle from 'bpmn-moddle';
|
||||||
|
import activiti from './activiti.json';
|
||||||
|
import flowable from './flowable.json';
|
||||||
|
import { SYNTHETIC_BPMN } from './fixtures/synthetic-full-surface.bpmn';
|
||||||
|
|
||||||
|
const CORPUS_ATTRS = ['formKey','candidateUsers','exclusive','assignee','collection',
|
||||||
|
'elementVariable','candidateGroups','autoStoreVariables','initiator','dueDate'];
|
||||||
|
const CORPUS_ELEMENTS = ['taskListener','formProperty','value','field','string'];
|
||||||
|
|
||||||
|
it('语料覆盖:全部实测 activiti 属性/元素在描述符中有声明', () => {
|
||||||
|
const declared = JSON.stringify(activiti);
|
||||||
|
[...CORPUS_ATTRS, ...CORPUS_ELEMENTS].forEach(n =>
|
||||||
|
expect(declared, `activiti:${n} 未声明`).toContain(`"${n}"`));
|
||||||
|
});
|
||||||
|
|
||||||
|
it('round-trip 零丢失:import→export 后全部 activiti 扩展原样保留', async () => {
|
||||||
|
const moddle = new BpmnModdle({ activiti, flowable });
|
||||||
|
const { rootElement } = await moddle.fromXML(SYNTHETIC_BPMN);
|
||||||
|
const { xml } = await moddle.toXML(rootElement, { format: false });
|
||||||
|
// 关键断言:每个扩展属性值逐字保留(含全角【】JSON、中文 id)
|
||||||
|
for (const frag of ['activiti:formKey="view_wftemplate_'
|
||||||
|
, "candidateUsersHandler.getCandidateUsers(execution,'【"
|
||||||
|
, 'activiti:taskListener', 'activiti:elementVariable="assignee"'
|
||||||
|
, 'multiInstanceUsersHandler.getUsers']) {
|
||||||
|
expect(xml).toContain(frag);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2** `cd eip4-web && npm install bpmn-js-properties-panel@^5.23.0 @bpmn-io/properties-panel@^3.23.0 && npx vitest run src/modeler` → 期望 FAIL(描述符/fixture 不存在)。
|
||||||
|
**Step 3** 写 activiti.json/flowable.json 描述符 + 合成 fixture(fixture 的多实例/办理人形态先 `psql` 抽「总包合同交底」BPMN 对照,形态照抄)。
|
||||||
|
**Step 4** `npx vitest run src/modeler` → PASS;`npx tsc -b` 干净。
|
||||||
|
**Step 5** commit:`feat(modeler): activiti/flowable moddle 描述符 + 语料覆盖/round-trip 保真测试`
|
||||||
|
|
||||||
|
### Task 1.2 全量语料保真扫描脚本(工具,不进 CI)
|
||||||
|
|
||||||
|
**Files:** Create: `eip4-web/tools/modeler-fidelity-sweep.mjs`
|
||||||
|
|
||||||
|
node 脚本:`pg` 不引依赖——用 `psql` 子进程拉 `translate(encode(bytes_,'base64'),E'\n','')`(同勘探法),逐条 bpmn-moddle round-trip,对比「activiti:*/flowable:* 属性与元素多重集」前后一致(归一化后 diff),输出 `匹配 N/1512 + 差异清单`。跑:`node tools/modeler-fidelity-sweep.mjs`(连 5433/eip4)。
|
||||||
|
**验收:1512/1512 零丢失**(有差异=描述符缺口,回补 Task 1.1 描述符后重跑)。结果记进 commit message。
|
||||||
|
commit:`feat(modeler): 全量 1512 真实流程 moddle round-trip 保真扫描工具(实测零丢失)`
|
||||||
|
|
||||||
|
### Task 1.3 后端:id 净化抽成可逆 `BpmnIdSanitizer`
|
||||||
|
|
||||||
|
> ⚠️ **T1.2 实证预警——hash 碰撞**:现行 `"n"+hex(hashCode&0x7fffffff)` **有碰撞可能**(1445/1512 文档 process id 为中文;同文档内两个原 id 撞哈希→引用错乱)。查看器容忍,但**可逆 restore 要求双射**:`sanitize` 必须检测碰撞并消解(碰撞时追加 `-2`/`-3` 序号),并补「同文档撞哈希仍双射可逆」单测(构造碰撞对或可注入 hash 的测试缝)。
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java`
|
||||||
|
- Modify: `flowable-service/src/main/java/com/eip4/flowservice/api/ProcessDiagramController.java`(sanitizeBpmnIds 委托新类,行为不变)
|
||||||
|
- Create: `flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java`
|
||||||
|
|
||||||
|
**Step 1** 失败测试(核心断言:可逆):
|
||||||
|
|
||||||
|
```java
|
||||||
|
@Test void 净化后还原_逐字节等于原文() {
|
||||||
|
String xml = 读fixture(中文id流程含processRef/sourceRef引用);
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
assertThat(r.xml()).doesNotContain("总包合同交底");
|
||||||
|
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
@Test void 还原只回写映射内id_新增ASCII节点id保留() { ... }
|
||||||
|
@Test void 合法NCName_id不改写_映射为空() { ... }
|
||||||
|
```
|
||||||
|
|
||||||
|
**Step 2** `mvn -pl flowable-service -am test -Dtest=BpmnIdSanitizerTest` → FAIL。
|
||||||
|
**Step 3** 实现:搬 ProcessDiagramController :113-150 的 `ID_ATTR` 正则与净化逻辑进 `sanitize`(返回 `record Result(String xml, Map<String,String> idMap)`,idMap=原→净化);`restore(xml, idMap)` 用同一 `ID_ATTR` 正则反向替换(净化→原,仅命中 map 值者)。ProcessDiagramController 原 static 方法改为委托(保持包级可见签名,原单测不动)。
|
||||||
|
**Step 4** `mvn -pl flowable-service -am test`(含既有 ProcessDiagramControllerTest 回归)→ 全绿。
|
||||||
|
**Step 5** commit:`refactor(flow): id 净化抽 BpmnIdSanitizer,补可逆 restore(D7 地基)`
|
||||||
|
|
||||||
|
### Task 1.4 后端:按 procDefId 取源 XML 端点
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `flowable-service/.../api/ProcessDiagramController.java`(新增端点,readProcessModel 已在此类)
|
||||||
|
- Modify: `flowable-service/src/test/java/com/eip4/flowservice/api/ProcessDiagramControllerTest.java`
|
||||||
|
|
||||||
|
**Step 1** 失败测试:`GET /api/flow/process-definitions/{procDefId}/source` → `{found:true, bpmnXml:<净化后>, idMap:{原:净}, procDefKey, version}`;procDefId 不存在 → `{found:false}`(200,防御性——网关照 diagram 惯例)。
|
||||||
|
**Step 3** 实现:`repositoryService.getProcessModel` + `createProcessDefinitionQuery().processDefinitionId(id).singleResult()`(取 key/version)+ `BpmnIdSanitizer.sanitize`,返回 xml 与 idMap。
|
||||||
|
**Step 4** `mvn -pl flowable-service -am test` 绿。**Step 5** commit:`feat(flow): 按 procDefId 取净化源 XML 端点(含 idMap)`
|
||||||
|
|
||||||
|
### Task 1.5 前端:ProcessModelerPage 骨架 + 只读载入存量
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `eip4-web/src/pages/ProcessModelerPage.tsx`、`src/api/processModeler.ts`、`src/pages/ProcessModelerPage.test.tsx`
|
||||||
|
- Modify: `src/App.tsx`(+route `/process-modeler`)、`src/pages/DesignCenterPage.tsx`(+入口按钮 `dc-process-modeler`「流程设计」)、`src/shell/Topbar.tsx`(admin 图标可选,跟设计中心并排)
|
||||||
|
|
||||||
|
**Step 1** 失败测试(照 ModelerPage.test.tsx 范式:importOriginal 保留 isAdminProfile、mock getProfile + api):admin 可见容器 `data-testid="process-modeler-canvas"` 与属性面板容器;非 admin 显示「仅管理员可用」;`?procDefId=` 时调 `fetchProcDefSource` 并 importXML(mock api 返合成 fixture)。
|
||||||
|
**Step 3** 实现:照 ProcessDiagram.tsx 生命周期(alive flag/destroy)挂 `bpmn-js/lib/Modeler`:
|
||||||
|
|
||||||
|
```ts
|
||||||
|
import Modeler from 'bpmn-js/lib/Modeler';
|
||||||
|
import { BpmnPropertiesPanelModule, BpmnPropertiesProviderModule } from 'bpmn-js-properties-panel';
|
||||||
|
import 'bpmn-js/dist/assets/diagram-js.css';
|
||||||
|
import 'bpmn-js/dist/assets/bpmn-js.css';
|
||||||
|
import 'bpmn-js/dist/assets/bpmn-font/css/bpmn.css';
|
||||||
|
import '@bpmn-io/properties-panel/dist/assets/properties-panel.css';
|
||||||
|
import activitiModdle from '../modeler/moddle/activiti.json';
|
||||||
|
// (app 代码首次 import json:本 task 顺带在 tsconfig.app.json 开 "resolveJsonModule": true)
|
||||||
|
|
||||||
|
const modeler = new Modeler({
|
||||||
|
container: canvasRef.current,
|
||||||
|
propertiesPanel: { parent: panelRef.current },
|
||||||
|
additionalModules: [BpmnPropertiesPanelModule, BpmnPropertiesProviderModule],
|
||||||
|
// ⚠️ 只载 activiti!T1.1 实证:activiti+flowable 双包同载会因 bpmn:UserTask 同名 extends
|
||||||
|
// 属性冲突(not allowed without redefines)静默丢弃 userTask。语料 1509/3 两命名空间不混用;
|
||||||
|
// 单载 activiti 时 flowable 文档经 moddle lax $attrs 零丢失往返。flowable.json 只做隔离单测。
|
||||||
|
// ⚠️ 同理:只 import 标准 BpmnPropertiesProviderModule,严禁引 Camunda provider——
|
||||||
|
// 它会把 camunda 描述符注进 moddle,即双包冲突的变体(T1.1 评审 M-3)。
|
||||||
|
moddleExtensions: { activiti: activitiModdle },
|
||||||
|
});
|
||||||
|
```
|
||||||
|
布局参照 DesignerPage:顶栏(名称/保存草稿·发布·返回,本阶段按钮 disabled 占位)+ 左画布 + 右栏(上=EIP4 侧板占位,下=标准面板)。存量入口:设计中心按钮 → 新页内「打开存量流程」下拉(数据源复用 `GET /api/process-select/options`)。
|
||||||
|
**Step 4** `npx vitest run` + `npx tsc -b` + `npm run build` 全绿。
|
||||||
|
**Step 5** commit:`feat(modeler): /process-modeler 页骨架(Modeler+标准属性面板+存量只读载入)`
|
||||||
|
|
||||||
|
### Task 1.6 网关:source 转发 + 阶段 1 live 验收
|
||||||
|
|
||||||
|
> 🔴 **阶段1 live 验收实证(2026-07-02)——options 语义缺口已修**:`/api/process-select/options` 在合并库返回的 143 选项**全部 source='model',option.id=act_re_model 的 id 非 procDefId**(计划原假设错),打开器按 procDefId 载入恒 found:false。修法=新增 **by-key 取最新版**端点(`GET /api/flow/process-definitions/by-key/{key}/source` + 网关同门转发),前端打开器按 option.source 双参分派(model→?procKey=key / processDefinition→?procDefId=id)。
|
||||||
|
>
|
||||||
|
> ⚠️ **T1.4 评审 M-2——中文 procDefId 编码**:真实 procDefId 形如 `总包合同交底:3:<uuid>`(中文+冒号进 path segment)。网关 FlowableClient 转发**必须用 UriComponentsBuilder/uriVariables 正确编码**(禁字符串拼 URL),且测试必须含一个**中文 procDefId 用例**(MockRestServiceServer 断言转发 URL 编码正确);live 验收也必须用中文 key 流程点穿 HTTP 全链。
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `platform-flow-gateway/.../client/FlowableClient.java`(+`procDefSource(procDefId)`)
|
||||||
|
- Create: `platform-flow-gateway/.../web/ProcessModelerController.java`(`GET /api/workflow/process-definitions/{id}/source`,**超管门**:`AuthPrincipal` 校验 `EngineContextBinder.isSystemAdmin`,非超管 403——若该方法非 public static,本 task 顺带提升可见性并补一个判定单测)
|
||||||
|
- Create: `platform-flow-gateway/src/test/.../ProcessModelerControllerTest.java`(admin 200 转发 / 非 admin 403 / flowable 不可达 503——照 FlowableClientTest 的 MockRestServiceServer 模式)
|
||||||
|
|
||||||
|
**live 验收(阶段 1 出口)**:`mvn -pl platform-app,flowable-service -am package -DskipTests` → `run-dev.sh both` → 浏览器 admin 登录 → 设计中心「流程设计」→ 打开「总包合同交底」→ palette/标准属性面板可见、中文节点名正常渲染、点 userTask 属性面板出 BPMN 标准属性。截图留档。
|
||||||
|
commit + `--no-ff` 合 main:`feat(modeler): 阶段1 存量流程只读载入(moddle保真+可逆净化+页面骨架)`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 阶段 2:EIP4 三控件 + 草稿(act_re_model)
|
||||||
|
|
||||||
|
### Task 2.1 后端:ProcessModelController(草稿 CRUD + from-procdef)
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `flowable-service/.../api/ProcessModelController.java`(`@RequestMapping("/api/flow")`)
|
||||||
|
- Create: `flowable-service/src/test/.../ProcessModelControllerTest.java`(@Mock RepositoryService + Model + ModelQuery,MockMvc standalone,照 ProcessDiagramControllerTest)
|
||||||
|
|
||||||
|
端点(全裸 JSON,防御性风格同 diagram):
|
||||||
|
- `GET /models` → `createModelQuery().orderByLastUpdateTime().desc().list()` → `[{id,name,key,lastUpdateTime}]`
|
||||||
|
- `GET /models/{id}` → model + `new String(getModelEditorSource(id), UTF_8)` → `{found,id,name,key,bpmnXml,metaInfo}`
|
||||||
|
- `POST /models` body `{name,key,bpmnXml,metaInfo?}` → `newModel()`+`saveModel`+`addModelEditorSource`(XML 先过 BpmnXMLConverter 解析守卫,坏 XML→422)
|
||||||
|
- `PUT /models/{id}` → 更新 name/editorSource/metaInfo(不存在→404)
|
||||||
|
- `POST /models/from-procdef` body `{procDefId}` → 读源 XML → `BpmnIdSanitizer.sanitize` → 建 model,**metaInfo=`{"eip4IdMap":{...},"sourceProcDefId":"...","originalKey":"总包合同交底"}`**(jackson 序列化)→ `{modelId}`
|
||||||
|
|
||||||
|
TDD 循环同前;测试含:from-procdef 的 metaInfo 落 idMap、坏 XML 422、404。
|
||||||
|
commit:`feat(flow): 流程草稿 ProcessModelController(act_re_model,Model API 首次启用)`
|
||||||
|
|
||||||
|
### Task 2.2 网关:models 全套转发 + wftemplate picker 数据源
|
||||||
|
|
||||||
|
> 📌 **T1.6 评审 M-3**:本 task 给 ProcessModelerController 加第二个及以后端点时,先抽 `requireSuperAdmin()` 私有方法(返回 403 ResponseEntity 或 null),所有端点统一过门防漏。
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Modify: `FlowableClient.java`(+models list/get/create/update/fromProcDef 五方法)
|
||||||
|
- Modify: `ProcessModelerController.java`(+`/api/workflow/models/**` 五端点,全部过超管门)
|
||||||
|
- Modify: `platform-flow-gateway/.../web/`(新 `GET /api/workflow/wftemplates`:JdbcTemplate `SELECT view_wftemplate_id, ... FROM view_wftemplate`——**实现前先 psql `\d view_wftemplate` 核实名称列**(name 或 xml 内 title,照 WfTemplateService.parse 的取名逻辑),返 `[{id,name}]`)
|
||||||
|
- Tests:转发/403/wftemplates 列表(mock JdbcTemplate)
|
||||||
|
|
||||||
|
commit:`feat(gateway): 流程草稿转发(超管门)+wftemplate picker 数据源`
|
||||||
|
|
||||||
|
### Task 2.3 前端:办理人表达式编解码器(纯函数,TDD 核心件)
|
||||||
|
|
||||||
|
**Files:** Create: `eip4-web/src/modeler/candidateExpression.ts` + `candidateExpression.test.ts`
|
||||||
|
|
||||||
|
**Step 1** 失败测试(真实形态往返):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
// T1.1 psql 实证真实形态:外层对象与 items 内每个对象的花括号**全部**是全角【】,
|
||||||
|
// 方括号[]半角,XML 属性内引号转义为 ",content 可带 CHAR 尾部补白空格(不可 trim)。
|
||||||
|
const REAL = `\${candidateUsersHandler.getCandidateUsers(execution,'【"items":[【"type":"user","content":"u1,u2","isCandidate":true,"isSendMail":false,"isSendPhone":false】]】')}`;
|
||||||
|
it('解析真实表达式(全角【】)', () => {
|
||||||
|
const r = parseCandidateExpression(REAL);
|
||||||
|
expect(r!.items[0]).toMatchObject({ type: 'user', content: 'u1,u2', isCandidate: true });
|
||||||
|
});
|
||||||
|
it('构建=引擎口径(全角【】+前缀后缀逐字)', () => {
|
||||||
|
expect(buildCandidateExpression(r.items)).toBe(REAL);
|
||||||
|
});
|
||||||
|
it('scriptUser/depart/beforeTaskLeader 各 type 往返不丢字段', ...);
|
||||||
|
it('multiInstance 前缀变体 multiInstanceUsersHandler.getUsers 同套解析', ...);
|
||||||
|
it('非法/空表达式返回 null 不抛', ...);
|
||||||
|
```
|
||||||
|
> ⚠️ 全角【】的准确包裹形态(`【"items":...】` 还是 `{"items":...}` 外层才转)**以「总包合同交底」真实 BPMN 逐字为准**——写实现前先 psql 抽原文对照,测试 fixture 逐字复制真实片段。
|
||||||
|
|
||||||
|
**Step 3** 实现 `parse/build`(前后缀常量逐字对齐 BasePropertiesConverter :34-35;build 输出全角,parse 兼容全角/半角)。
|
||||||
|
commit:`feat(modeler): 办理人/会签表达式编解码器(与 BasePropertiesConverter 逐字对齐)`
|
||||||
|
|
||||||
|
### Task 2.4 前端:EIP4 侧板(办理人/会签/formKey/扩展属性/监听器)
|
||||||
|
|
||||||
|
> 🔴 **T2.3 实证——meta 透传是正确性硬要求**:真实表达式外层对象除 items 外还有 5 个业务 meta 字段(messageTemplate/taskSuccessService/isSkipInitiator/isNoUserSkip/isSkipBeforeTask;taskSuccessService 是真实任务后置服务钩子如 PM_CONTRACTUALREGISTER_UPDATEPROJECTSTATUS)。codec 的 parse 已返 `{items,variant,meta}`、build 收 meta 可选参——**侧板写回办理人/会签时必须把 parse 出的 meta 原样传回 build**,否则发布会打掉已部署流程的业务字段。测试必须含「改 items 后 meta 逐字保留」用例。
|
||||||
|
>
|
||||||
|
> 📌 **随本 task 顺带收 T1.5 评审遗留**:红线回归测试——ProcessModelerPage 测试断言 `ModelerCtor.mock.calls[0][0].moddleExtensions` 键恰为 `['activiti']` 且 `additionalModules` 长度为 2(防「顺手」加 provider 静默回归)。(canvas ref null 分支已随 dffd1f3 修复,勿重复。)
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `src/modeler/Eip4Panel.tsx`(+`Eip4Panel.test.tsx`)、`src/modeler/useSelectedElement.ts`(订阅 `selection.changed`)
|
||||||
|
- Modify: `ProcessModelerPage.tsx`(右栏上方挂 Eip4Panel)
|
||||||
|
|
||||||
|
控件(全部经 bpmn-js `modeling.updateProperties(element, {...})` 写回,undo/redo 天然生效):
|
||||||
|
1. **办理人**(userTask 选中时):解析 `activiti:candidateUsers` → items 表格编辑(type 下拉=§0 的 10 种 + content 文本 + isCandidate/三个通知开关)→ build 回写。原生字段照旧显示于标准面板,控件顶部灰字:「EIP4 引擎以本控件为准,下方原生字段仅供高级调试」。
|
||||||
|
2. **会签**:开关=读写 `loopCharacteristics`(`moddle.create('bpmn:MultiInstanceLoopCharacteristics', {isSequential, collection: MI表达式, elementVariable:'assignee'})` + completionCondition 三预设:全票 `${nrOfCompletedInstances/nrOfInstances==1}`/过半 `>0.5`/指定数 `>=N`;**结构逐字对照真实会签流**);人员来源复用办理人 items 编辑器。
|
||||||
|
3. **formKey**:下拉(数据源 `GET /api/workflow/wftemplates`)写 `activiti:formKey`。
|
||||||
|
4. **扩展属性**(兜底 D5):列出 `element.businessObject.$attrs` 里 activiti:/flowable: 长尾键值可增删改。
|
||||||
|
5. **任务监听器**:读写 `extensionElements` 里 `activiti:taskListener`(event 下拉 create/assignment/complete/all + class/delegateExpression 文本;v1 不做 fields 编辑,原样保留)。
|
||||||
|
|
||||||
|
测试:RTL 渲染 + 假 element/modeling(vi.fn 断言 updateProperties 载荷);办理人/会签/formKey 三控件各 set/clear 用例。
|
||||||
|
commit:`feat(modeler): EIP4 侧板三控件+扩展属性/监听器编辑`
|
||||||
|
|
||||||
|
### Task 2.5 前端:存草稿 + 草稿列表打开
|
||||||
|
|
||||||
|
> 📌 **T2.2 评审遗留——草稿删除端点**:五端点无 DELETE,POST 重试窗口产生的重复草稿无 API 可清、草稿列表 UX 也需要删除。**本 task 或 T4.1 补**:flowable-service `DELETE /api/flow/models/{id}`(deleteModel)+ 网关同门转发 + 前端草稿列表删除按钮(confirm)。
|
||||||
|
>
|
||||||
|
> 📌 **T2.2 实证——wftemplates 名称现实**:view_wftemplate **无名称列**(计划原假设错),网关已按 entityid→sys_entity.name 解析——1016 活动模板仅 339 有中文名,其余下拉显 uuid。**formKey 下拉须加过滤输入框**(1016 项不可裸滚动),无名项显示「<uuid 前 8 位>…(未命名)」。此项归本 task 或 T2.4 收口轮顺带。
|
||||||
|
|
||||||
|
**Files:** Modify `processModeler.ts`(saveDraft/createDraft/listModels/getModel/fromProcDef)、`ProcessModelerPage.tsx`(顶栏「保存草稿」`saveXML({format:true})`→PUT;打开器加「草稿」tab);tests。
|
||||||
|
|
||||||
|
**阶段 2 live 验收**:打开「总包合同交底」→ from-procdef 建草稿 → 改办理人(加一个 user)→ 保存 → psql 查 `act_re_model` 新行 + `act_ge_bytearray` 编辑源含改动 + metaInfo 含 eip4IdMap → 重开草稿回显正确。
|
||||||
|
commit + 合 main:`feat(modeler): 阶段2 EIP4 控件+草稿闭环`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 阶段 3:发布门(校验 + 超管 + 同人确认 + 审计 + id 还原)
|
||||||
|
|
||||||
|
### Task 3.1 后端:deploy-from-model(id 还原 + 引擎校验门)
|
||||||
|
|
||||||
|
> 🔴 **阶段2 live 实证——bpmn-js 输出被严格 XSD 校验拒(已修,且警示 T3.1)**:flowable `convertToBpmnModel(src, validateSchema=true, ...)` 的严格 Xerces XSD 校验**拒绝 bpmn-js saveXML 的默认命名空间输出**(`cvc-complex-type.2.4.a: Invalid content ... {MODEL}Process`),原始带前缀 source 能过。草稿保存已改 validateSchema=false(草稿是半成品,XSD 不适用)+ 字节级 DOCTYPE 守卫保 XXE。**本 task deploy 必须验证同问题**:`createDeployment().addString().deploy()` 也解析 bpmn-js 输出,若 Flowable 部署校验拒默认命名空间/activiti 扩展,需在部署前把 bpmn-js XML 规范化(或确认 deploy 路径不走严格 XSD)——阶段 3 live 必须用「编辑器改过并 saveXML 的真实流程」部署,不能只用原始 source。
|
||||||
|
|
||||||
|
> ⚠️ **T1.3 评审 I-2 预警——文本引用**:bpmn-js `saveXML` 会给流节点补 `<bpmn:incoming>/<bpmn:outgoing>` **元素文本**引用(存量 1512 文档 0 命中,但编辑器导出会有),`BpmnIdSanitizer.restore` 只还原**属性位** → 直接部署会落库「属性=中文原 id、文本引用=净化 id」的脏 XML(Flowable 不解析 incoming/outgoing 故功能无害,但再次 from-procdef 重编辑时碰撞序号换位可能指错节点)。**本 task 必须**:restore 前剥除 incoming/outgoing 元素(Flowable 自行从 sequenceFlow 推导)或把文本引用位纳入 restore,二选一并加测试(含「编辑器导出态 XML → 部署 XML 无净化 id 残留」断言)。
|
||||||
|
|
||||||
|
**Files:** Modify `ProcessModelController.java` + test。
|
||||||
|
|
||||||
|
`POST /models/{id}/deploy`:
|
||||||
|
1. 读 editorSource + metaInfo.eip4IdMap → `BpmnIdSanitizer.restore`(**存量 key 还原为中文原 key**;无 idMap=新建流程,跳过)。
|
||||||
|
2. **引擎校验门**:`BpmnXMLConverter.convertToBpmnModel` + `new ProcessValidatorFactory().createDefaultProcessValidator().validate(model)` → 有 error 返回 422 `{errors:[{activityId,problem}]}` 不部署。
|
||||||
|
3. `createDeployment().name(model.getName()).addString(key+".bpmn20.xml", restoredXml).deploy()` → 查新 procdef → `{deploymentId, processKey, newVersion}`。
|
||||||
|
4. `GET /models/{id}/impact`:还原后解析 key → `{processKey, currentVersion(latest procdef), runningInstances(runtimeService.createProcessInstanceQuery().processDefinitionKey(key).count())}`。
|
||||||
|
|
||||||
|
测试:还原后部署 XML 含原中文 key(捕获 addString 参数断言)、校验失败 422 不调 deploy、impact 计数。
|
||||||
|
commit:`feat(flow): 草稿发布(id还原+ProcessValidator校验门)+影响摘要端点`
|
||||||
|
|
||||||
|
### Task 3.2 网关:EIP4 语义校验 + 部署审计(Flyway V4)
|
||||||
|
|
||||||
|
> 📌 **T2.4 评审补充**:语义校验白名单须加两条——①办理人/会签表达式的 `items` **非空**(`items:[]` 的 MI collection 运行期会炸,仅 JSON 可解析+type 白名单不够);②completionCondition 允许「三预设 或 保留的自定义 body」(T2.4 已实现自定义保留态,校验别把存量自定义条件拒了,白名单改为预设正则 ∪ 非空任意表达式加告警)。
|
||||||
|
|
||||||
|
**Files:**
|
||||||
|
- Create: `platform-flow-gateway/.../aggregate/ModelSemanticValidator.java` + test:解析 XML(**照 WfTemplateService.newJdkDbf :116-135 钉 JDK 解析器**,防 xerces 击穿)→ ①每个 `activiti:candidateUsers`/multiInstance collection 的内嵌 JSON 可解析且 items[].type ∈ 白名单 ②`activiti:formKey` 存在于 view_wftemplate(JdbcTemplate exists)③completionCondition 匹配预设白名单正则。返回 `List<String> errors`。
|
||||||
|
- Create: `platform-app/src/main/resources/db/migration/V4__flow_deploy_audit.sql`(照 V3 风格):`sys_flow_deploy_audit(id bigserial pk, model_id, deployment_id, process_key, new_version int, operator varchar(64), deployed_at timestamp default now())`
|
||||||
|
- Modify: `ProcessModelerController.java`:deploy 端点=超管门 → ModelSemanticValidator(fail→422 带明细)→ FlowableClient.deployModel → 成功后 JdbcTemplate INSERT 审计行(operator=principal.userId())。
|
||||||
|
- Tests:语义校验三类各 fail 用例 / 非 admin 403 / 审计行落库断言(mock JdbcTemplate 捕获参数)。
|
||||||
|
|
||||||
|
commit:`feat(gateway): 发布语义校验门+sys_flow_deploy_audit 审计(V4)`
|
||||||
|
|
||||||
|
> 🔴🔴 **阶段3 live 揪出 CRITICAL——activiti.json 描述符致 bpmn-js Modeler 输出 PascalCase 元素名(部署链断)**:bpmn-js Modeler.saveXML 对 activiti.json `extends` 的 bpmn 类型(Process/UserTask/StartEvent)序列化成大写 `<Process>/<UserTask>/<StartEvent>`(未扩展的 sequenceFlow/endEvent 仍小写)。Flowable 大小写敏感→`<Process>` 不识别→ProcessValidator 报 flowable-process-definition-not-executable,**部署完全断**。「isExecutable 丢失」是此 bug 症状非独立问题。**T1.1/T1.2 moddle round-trip 测试抓不到**(直接 fromXML→toXML 读写同形),只有真 Modeler saveXML+真部署暴露(live 铁证)。修=重构 activiti.json 扩展类型定义让 Modeler 序列化保持小写 BPMN 元素名(moddle extends 惯用法),验收硬门=saveXML 输出小写 userTask/process + 真部署 200 + 起实例生成 userTask。已挂 T3.3 修复轮 + 需前端保真测试升级到「过 bpmn-js Modeler.saveXML 非仅 bpmn-moddle」。
|
||||||
|
|
||||||
|
### Task 3.3 前端:同人确认弹窗(影响摘要)+ 发布流
|
||||||
|
|
||||||
|
**Files:** Create `src/modeler/PublishConfirm.tsx`(+test)、`src/modeler/diffSummary.ts`(+test,P2 节点级 diff);Modify `ProcessModelerPage.tsx`。
|
||||||
|
|
||||||
|
发布点击 → 并发取 impact + 本地 diffSummary(打开时的源 XML vs 当前 saveXML)→ `ui/Dialog`:流程 key/当前版本→新版本/运行中实例数(灰字:留在旧版本不受影响)/「办理人或会签变更节点」清单 → 确认 → deploy → `toast('已发布 vN','ok')`;422 校验失败按节点渲染错误清单。
|
||||||
|
commit:`feat(modeler): 同人确认发布(影响摘要+节点级diff+校验错误展示)`
|
||||||
|
|
||||||
|
**阶段 3 live 验收**:改「总包合同交底」办理人 → 发布 → psql 验 act_re_procdef 新版本 **key_ 仍=总包合同交底**、sys_flow_deploy_audit 有行、旧版本运行实例不受影响;非 admin 用户 curl deploy=403。合 main。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 阶段 4:新建流程 + live e2e + 收尾
|
||||||
|
|
||||||
|
### Task 4.1 模板库 + 新建流
|
||||||
|
|
||||||
|
**Files:** Create `src/modeler/templates/{blank,single-approval,two-level,cosign}.bpmn.ts` + `NewProcessDialog.tsx`(名称/key/模板选择;key 允许中文——引擎既有事实)+ tests。模板以真实流程结构为骨架(psql 抽形改造),三模板全部先过 Task 1.1 round-trip 测试 + 后端 ProcessValidator 校验。
|
||||||
|
commit:`feat(modeler): 空白/单人/两级/会签模板新建流程`
|
||||||
|
|
||||||
|
### Task 4.2 Playwright live e2e(8094 惯例)
|
||||||
|
|
||||||
|
**Files:** Create `eip4-web/playwright.process-modeler.config.ts`(照 fivering:VITE_BACKEND_TARGET=8094、vite 5174、testMatch process-modeler)+ `e2e/process-modeler.spec.ts`。
|
||||||
|
|
||||||
|
场景(复用 five-ring 的 apiJson/adminToken/登录块):
|
||||||
|
1. **改存量全链**:登录 admin → 流程设计 → 打开「总包合同交底」→ 改办理人 content 加用户 → 保存草稿 → 发布(确认弹窗断言含 key/版本/实例数)→ `apiJson POST /api/flow/process/start {processDefinitionKey:'总包合同交底'}` → 取新实例任务 approval-context 断言新办理人生效。
|
||||||
|
2. **新建全链**:会签模板新建 → formKey 选一个 → 发布 → start → 任务出现。
|
||||||
|
3. **走查**:中文节点名渲染 / palette 元素齐 / 标准面板 + EIP4 侧板同屏 / 非 admin 页面降级。
|
||||||
|
|
||||||
|
跑法(spec 头注释):`java -jar platform-app/target/*.jar --server.port=8094` + flowable 8089 → `npx playwright test -c playwright.process-modeler.config.ts`。
|
||||||
|
commit:`test(modeler): 流程Modeler live e2e(改存量/新建/走查 3 场景)`
|
||||||
|
|
||||||
|
### Task 4.3 收尾:文档回写 + 对抗评审
|
||||||
|
|
||||||
|
- 总览 B3 行 🔴→🟢(证据哈希)、A2 行「仅剩」措辞更新、README/设计中心导航登记;本计划顶部加完成横幅。
|
||||||
|
- **对抗评审**(house 惯例,不可跳):code-reviewer + security-reviewer 双 agent 过 diff(重点:网关超管门绕过面 / restore 正则替换的边界(id 是另一 id 前缀)/ deploy XML 注入面 / 审计字段),揪修后全量 `mvn clean install` + `npm test` + e2e 重跑。
|
||||||
|
- 合 main + push。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## B3 最终发布链对抗评审处置(2026-07-02)
|
||||||
|
判定「可宣告完成,无 Critical 无阻断」。id 保真闭环三来源自洽+发布错误契约双形状透传扎实。跟进项处置:
|
||||||
|
- **I-1 formKey 门误拒改存量——语料 dry-run 证伪(无需修)**:全库 803 个 distinct activiti:formKey **全部命中 view_wftemplate(miss=0)**,formKey 门不会误拒任何存量流程。评审担心的静默回归在真实库不成立。
|
||||||
|
- **I-2 空 content 语义缺口**:已作已知限制记录(见下),v2 精化(content 可能是变量表达式,硬要求非空会误拒,需按 type 分白名单)。
|
||||||
|
- **M-1**(下游 422 顶层文案 handler 用 message、前端读 msg,per-node 错误仍渲染)/ M-2(by-id 写删侧无 category 守卫,超管门+UI 已兜)/ M-3(writeCosign 重建只保 4 属性,真实会签仅用 handler-collection 模式暴露低)= 低优先清理 backlog。
|
||||||
|
|
||||||
|
## B3 最终安全对抗评审(2026-07-02 阶段4)——1 Critical 已修 + A10 生产加固 backlog
|
||||||
|
|
||||||
|
- **✅ Critical#1 已修**:`deploy/nginx.conf` 的 `/flowable/` 裸 proxy 到无鉴权 8089 对公网暴露→绕过网关超管门匿名部署/覆盖生产 BPMN。改 `return 404`(前端只走 `/api/workflow/` 网关,不需要直达)。**注:此洞在 A10 部署骨架里、生产未切流,非 B3 运行时可达**;网关侧超管门本身实现严密无绕过面(评审确认)。
|
||||||
|
- **A10 生产加固 backlog(非 B3 dev 阻塞,超管信任模型内可接受,随 A10 生产化做)**:High#2 部署 BPMN 可含 serviceTask/JUEL 表达式/监听器=引擎内表达式求值面(超管信任内可接受;修 #1 后降为加固项,v2 可加可执行元素白名单);Medium#3 网关→flowable-service 无凭据纯靠网络隔离(加 X-Internal-Auth 共享密钥纵深);Medium#4 审计只覆盖网关 deploy 路径+写失败静默(下沉审计到 flowable-service 实际部署点或加失败告警)。Low#5(无细粒度流程授权=v1有意)/#6(伪造metaInfo不提权=超管本可写任意key)/#7(impact 缺 DOCTYPE 兜底=enableSafeBpmnXml 已挡)/#8(disableSchemaValidation 只跳 XSD 不开 DTD) 均已缓解/可接受。
|
||||||
|
|
||||||
|
## 已知限制 / v2 精化点(2026-07-02 阶段4 e2e 发现)
|
||||||
|
|
||||||
|
- **会签办理人 content 为空的语义缺口**:ModelSemanticValidator 校验 `items 非空`(数组长度)但不校验 candidate item 的 `content 非空`。会签模板出厂 items=[{type:user,content:""}] 过语义门,但运行期 multiInstanceUsersHandler 解析空 content → MI 跳过 → 流程无任务直接结束。**不硬修**(content 常是 `${APPLYUSERS}` 变量表达式,硬要求非空会误拒合法流程);v2 可考虑「content 空且非变量表达式 → WARNING」。用户新建会签流程须填办理人,否则部署出空转流程。
|
||||||
|
- **live e2e 非幂等**:发布无运行时下架端点,每跑场景A「总包合同交底」版本 +1(live 验收固有,非 CI 硬门)。
|
||||||
|
- **非超管 403 e2e 降级**:dev 库无非超管账号,场景C④用无 token(principal==null 走同一 requireSuperAdmin 分支)+admin 对照证门有效;真非超管 token 断言待 dev 库补账号。
|
||||||
|
|
||||||
|
## 验收清单(全项打勾才算 B3 完成)
|
||||||
|
|
||||||
|
- [ ] 1512 流 moddle round-trip 扫描零丢失(Task 1.2 工具实测)
|
||||||
|
- [ ] 打开存量中文 key 流程→编辑→发布,act_re_procdef 新版本 key 不变(D7)
|
||||||
|
- [ ] 办理人/会签/formKey 三控件双向往返与 BasePropertiesConverter 逐字兼容(D4)
|
||||||
|
- [ ] 发布门:非超管 403 / ProcessValidator+语义校验 422 / 审计行落库(D2)
|
||||||
|
- [ ] 运行中实例留旧版本(D8,e2e 断言)
|
||||||
|
- [ ] 新建(空白+3 模板)可部署可起实例(D1)
|
||||||
|
- [ ] Playwright 3 场景 + 全量单测 + `mvn clean install` + `tsc -b`/`npm run build` 全绿
|
||||||
|
- [ ] 对抗评审收口,文档回写
|
||||||
|
|
||||||
|
## 红线提醒(执行中不可越)
|
||||||
|
|
||||||
|
**每阶段合 main 前必须全 reactor `mvn clean install` 真绿**(模块级 `mvn -pl` 跑不到 platform-app 的 ArchitectureRulesTest,阶段2 wftemplates 给 @RestController 注 JdbcTemplate 触棘轮就是模块级漏过、全 reactor 才 catch;且判绿看 `BUILD SUCCESS` 字样,勿信 `| tail` 后的 `$?`=tail 退出码);控制器新增 SQL 一律收口 Service(ArchUnit 棘轮禁 @RestController 直用 JdbcTemplate);**生产 8089 不对外**(T1.6 评审:门在网关的前提=flowable-service 网络隔离,阶段 3 部署门验收清单显式检查,deploy/nginx/compose 不得暴露 8089);flowable `databaseSchemaUpdate=false` 不动(act_re_model 已存在无需 DDL;审计表走 Flyway V4 是平台表非引擎表);保真层 `com.dsasp.*` 不改(BasePropertiesConverter 只读对齐,不重构);XML 解析一律钉 JDK 解析器(xerces 击穿前科);JDK 21;部署门只落网关(flowable-service 裸 8089 无安全栈);每 task TDD、每阶段对抗自查后才合 main。
|
||||||
66
docs/skills/README.md
Normal file
66
docs/skills/README.md
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
# EIP4 Agent Skills
|
||||||
|
|
||||||
|
本目录是 EIP4 给 AI Agent 使用的领域操作规程。目标是让 Codex、Claude Code、Cursor、OpenCode 等 Agent 都按同一套规则操作 EIP4,而不是临时猜接口、猜表结构或直连线上库。
|
||||||
|
|
||||||
|
## Skills
|
||||||
|
|
||||||
|
| Skill | 用途 |
|
||||||
|
|---|---|
|
||||||
|
| `eip4-env-manage` | 环境探测、启动检查、端口和 profile 边界 |
|
||||||
|
| `eip4-ai-feature-development` | 从自然语言需求生成实体、服务流、页面、菜单和本地 smoke |
|
||||||
|
| `eip4-release-manage` | 部署包、人审、发布前校验和回滚边界 |
|
||||||
|
| `eip4-data-modeling` | 建实体/加字段/引用列/主子表(/api/meta/entity) |
|
||||||
|
| `eip4-page-recipe` | 用 recipe 生成默认页:维护/树/主子表(/api/design/recipe/compile) |
|
||||||
|
| `eip4-acl-manage` | 菜单/角色/用户组授权(/api/admin/*) |
|
||||||
|
|
||||||
|
## 快速接入(一键安装)
|
||||||
|
|
||||||
|
用 `eip4 init` 把这些 skills 安装到目标项目,供 Claude Code / Codex / OpenCode 直接读取。skill 示例里的 base URL 会按当前环境自动渲染(不再硬编码 8084/8093):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 可选:先登记环境地址(init 会用 current env 渲染示例端口)
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
|
||||||
|
--name local --base-url http://localhost:8094 --use
|
||||||
|
|
||||||
|
# 一键安装 skills + 生成 AGENTS.md
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar init --base-url http://localhost:8094
|
||||||
|
|
||||||
|
# 然后在该目录启动你的 agent
|
||||||
|
cd <project> && claude
|
||||||
|
```
|
||||||
|
|
||||||
|
产出:
|
||||||
|
|
||||||
|
- `.claude/skills/<name>/SKILL.md`:Claude Code 原生 skill(自带 frontmatter)。
|
||||||
|
- `AGENTS.md`:Codex / OpenCode 共用入口,内容受 `EIP4-SKILLS` 标记块管理(块外内容不动,可重复执行)。块内**内嵌每个 skill 的完整正文**,因此 Codex / OpenCode 只读 `AGENTS.md` 即可拿到全部规程,不依赖 `.claude/skills/`。
|
||||||
|
|
||||||
|
参数:`--dir` 目标项目根(默认当前目录)、`--base-url` 或 `--env` 指定渲染地址、`--skills-dir` 用本地目录覆盖内置 skills。skills 已随 `platform-cli` jar 一起打包,`init` 默认从 jar 内读取,无需仓库在场。
|
||||||
|
|
||||||
|
查看与校验已安装的 skills:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills list
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar skills check --dir <project>
|
||||||
|
```
|
||||||
|
|
||||||
|
`skills check` 在目标项目缺少任一内置 skill 时退出码非 0,便于在 CI/接入脚本里把关。
|
||||||
|
|
||||||
|
## MCP 接入(标准协议)
|
||||||
|
|
||||||
|
除 skills + CLI 外,EIP4 还提供 MCP server(`platform-mcp`,stdio),把 `eip4_auto_develop / eip4_list_page_recipes / eip4_validate_page_schema / eip4_list_components / eip4_access_check / eip4_list_entities / eip4_entity_attributes` 暴露为 MCP 工具,让 Agent 用标准协议调用,而不必死记 CLI/REST 用法:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mvn -pl platform-mcp package
|
||||||
|
claude mcp add eip4 -- java -jar platform-mcp/target/platform-mcp-0.1.0-SNAPSHOT.jar --base-url http://localhost:8094
|
||||||
|
# 或设环境变量 EIP4_BASE_URL;默认 http://localhost:8084
|
||||||
|
```
|
||||||
|
|
||||||
|
工具忠实转发到平台 REST,复用人审红线(产物恒 `READY_FOR_HUMAN_REVIEW`)与 `access-check`;MCP server 应只配本地/开发 baseUrl,不另开权限面。
|
||||||
|
|
||||||
|
## 通用原则
|
||||||
|
|
||||||
|
1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。
|
||||||
|
2. 默认只允许本地开发和测试环境自动执行写操作。
|
||||||
|
3. 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。
|
||||||
|
4. 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。
|
||||||
|
5. 任何失败先回到本地复现和修复,再重新生成部署包。
|
||||||
32
docs/skills/eip4-acl-manage.md
Normal file
32
docs/skills/eip4-acl-manage.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
# Skill: eip4-acl-manage
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 给角色授菜单、管理用户组 / 角色成员、查看菜单树。
|
||||||
|
|
||||||
|
> 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer <token>`,取 token 见 `eip4-env-manage`。
|
||||||
|
|
||||||
|
## 菜单
|
||||||
|
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/admin/menu-all` — 管理视角全量菜单树(`roots[]` 两级,含 `templateId`)。
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/menu` — 当前用户可见菜单树。
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/admin/user/{userId}/menu` — 指定用户可见菜单。
|
||||||
|
- 菜单写:`POST {{EIP4_BASE_URL}}/api/admin/menus/create`、`/api/admin/menus/{id}/update`、`/api/admin/menus/{id}/delete`。
|
||||||
|
|
||||||
|
## 角色授权
|
||||||
|
|
||||||
|
- `POST {{EIP4_BASE_URL}}/api/admin/roles/{id}/set-menus`,body `{"menuIds": ["..."]}`(整存差量,空数组=清空)。
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/admin/roles/{roleId}/users` — 角色成员。
|
||||||
|
|
||||||
|
## 用户 / 用户组
|
||||||
|
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/admin/users?page=1&perPage=20&keyword=` — 用户分页(密码列不下发)。
|
||||||
|
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/create`,body `{"name","description"}`。
|
||||||
|
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/update | /delete`。
|
||||||
|
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-user | /remove-user`(幂等)。
|
||||||
|
- `POST {{EIP4_BASE_URL}}/api/admin/usergroups/{id}/add-role | /remove-role`。
|
||||||
|
|
||||||
|
## 红线
|
||||||
|
|
||||||
|
- 写操作仅管理员,事务性。
|
||||||
|
- 授权走「用户组 → 角色 → 菜单」链(`sys_usergrouprole` / `sys_usergroupuser`),不直接给单用户授菜单。
|
||||||
113
docs/skills/eip4-ai-feature-development.md
Normal file
113
docs/skills/eip4-ai-feature-development.md
Normal file
@@ -0,0 +1,113 @@
|
|||||||
|
# Skill: eip4-ai-feature-development
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 用户描述一个新功能,希望 AI 自动生成。
|
||||||
|
- 用户要求从 EIP3 模板、实体、服务流或页面定义生成 EIP4 功能。
|
||||||
|
- 用户要求本地自动开发、自动修复和 smoke。
|
||||||
|
|
||||||
|
## 输入要求
|
||||||
|
|
||||||
|
最小需求应包含:
|
||||||
|
|
||||||
|
- 功能目标
|
||||||
|
- 功能名称
|
||||||
|
- 业务表名
|
||||||
|
- 实体名称
|
||||||
|
- 页面 templateId
|
||||||
|
- 菜单名称
|
||||||
|
- 字段列表
|
||||||
|
- 页面配方,可省略。默认 `maintenance-crud-v1`;树形维护页使用 `tree-crud-v1`
|
||||||
|
|
||||||
|
字段格式:
|
||||||
|
|
||||||
|
```text
|
||||||
|
column:label:type[:length][:required]
|
||||||
|
```
|
||||||
|
|
||||||
|
示例:
|
||||||
|
|
||||||
|
```text
|
||||||
|
NAME:名称:string:100:true
|
||||||
|
CODE:编码:string:64:true
|
||||||
|
ENABLED:启用:boolean::false
|
||||||
|
```
|
||||||
|
|
||||||
|
## 推荐命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||||
|
--base-url {{EIP4_BASE_URL}} \
|
||||||
|
--objective "新增客户等级维护功能" \
|
||||||
|
--feature-name "客户等级维护" \
|
||||||
|
--table-name EIP4AI_CUSTOMER_LEVEL \
|
||||||
|
--entity-name "客户等级" \
|
||||||
|
--template-id eip4ai-customer-level \
|
||||||
|
--menu-name "客户等级维护" \
|
||||||
|
--field NAME:名称:string:100:true \
|
||||||
|
--field CODE:编码:string:64:true \
|
||||||
|
--field ENABLED:启用:boolean::false \
|
||||||
|
--page-recipe maintenance-crud-v1 \
|
||||||
|
--max-repair-attempts 2 \
|
||||||
|
--output target/ai-runs/customer-level.json
|
||||||
|
```
|
||||||
|
|
||||||
|
树形维护页示例:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \
|
||||||
|
--base-url {{EIP4_BASE_URL}} \
|
||||||
|
--objective "新增组织分类树形维护功能" \
|
||||||
|
--feature-name "组织分类维护" \
|
||||||
|
--table-name EIP4AI_ORG_CATEGORY \
|
||||||
|
--entity-name "组织分类" \
|
||||||
|
--template-id eip4ai-org-category \
|
||||||
|
--menu-name "组织分类维护" \
|
||||||
|
--field NAME:名称:string:100:true \
|
||||||
|
--field CODE:编码:string:64:true \
|
||||||
|
--page-recipe tree-crud-v1 \
|
||||||
|
--max-repair-attempts 2 \
|
||||||
|
--output target/ai-runs/org-category-tree.json
|
||||||
|
```
|
||||||
|
|
||||||
|
## 通过标准
|
||||||
|
|
||||||
|
- `applyStatus` 为 `PASSED`。
|
||||||
|
- `smokeStatus` 为 `PASSED`。
|
||||||
|
- 最终状态为 `READY_FOR_HUMAN_REVIEW`。
|
||||||
|
- 部署包存在且 `requiresHumanApproval=true`。
|
||||||
|
- 页面 schema 只能使用组件能力表中注册的组件和动作。
|
||||||
|
- `PAGE_SCHEMA` 草稿必须声明并通过 `page-recipe` 门禁;普通维护页为 `maintenance-crud-v1`,树形维护页为 `tree-crud-v1`。
|
||||||
|
- `TEST` 草稿必须通过 `smoke-plan` 和 `render-plan`;`renderTests` 是后续 Playwright 渲染验收的输入,需包含 previewUrl、预期组件、列、动作、数据 API 和关键文本。
|
||||||
|
|
||||||
|
## 页面 schema 校验
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl {{EIP4_BASE_URL}}/api/page/schema/components
|
||||||
|
|
||||||
|
curl -X POST {{EIP4_BASE_URL}}/api/page/schema/validate \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
--data-binary @target/ai-runs/page-schema.json
|
||||||
|
```
|
||||||
|
|
||||||
|
设计器保存 overlay 时也会执行同一套 typed schema 校验;未注册组件或不支持的 `actionType` 会被拒绝。
|
||||||
|
|
||||||
|
## AI 工具权限检查
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl {{EIP4_BASE_URL}}/api/ai/tools
|
||||||
|
curl {{EIP4_BASE_URL}}/api/ai/employees
|
||||||
|
|
||||||
|
curl -X POST {{EIP4_BASE_URL}}/api/ai/tools/access-check \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"employeeId":"agent-developer","toolName":"local.apply","grantedScopes":["ai:local:apply"],"targetEnv":"local","productionWrite":false}'
|
||||||
|
```
|
||||||
|
|
||||||
|
本地 apply、smoke 等工具只允许本地目标;生产写默认被阻断,线上部署仍走人工发布。
|
||||||
|
|
||||||
|
## 失败处理
|
||||||
|
|
||||||
|
1. 查看输出 JSON 中的 apply/smoke/repair evidence。
|
||||||
|
2. 如果自动修复已尝试但失败,基于 evidence 修改本地代码或元数据生成逻辑。
|
||||||
|
3. 重新运行本地 auto-develop。
|
||||||
|
4. 不直接连接线上库修复。
|
||||||
59
docs/skills/eip4-amis-pitfalls.md
Normal file
59
docs/skills/eip4-amis-pitfalls.md
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
# Skill: eip4-amis-pitfalls
|
||||||
|
|
||||||
|
EIP4 前端用 amis(JSON schema 配置 UI)。本 skill 汇集「写 / 改 amis schema 时会撞、且不真渲染就发现不了」的实战坑。**绝大多数页面由转换器 / recipe 编译器生成**,所以多数修复落在生成逻辑(Java),但症状表现为 amis 行为——下面按 amis 概念分组。
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 生成或手改 amis 页面后:联动失效、选不中、显 id、空列表报错、行内编辑异常。
|
||||||
|
- 在 DesignerPage overlay 或 recipe 模板里调字段 / 事件 / 列。
|
||||||
|
- 排查「功能通了但 UI/UE 不对」。
|
||||||
|
|
||||||
|
## 铁律(先读这条)
|
||||||
|
|
||||||
|
1. **必真渲染实测**:任何 amis 改动都要 vite 反代 + Playwright / 浏览器逐屏看。功能点 e2e(落库 / status)**≠** 视觉 / UE 走查——很多坑只在渲染时暴露。
|
||||||
|
2. **线上 sdk.js 与 amis-fork 源码已漂移**:以实际加载的 sdk 行为为准,别照搬某版源码 API;直接改 sdk 有全站回归险。
|
||||||
|
3. **属性别凭记忆**:amis 属性多且迭代快,查官方文档(context7 / amis.io),别幻觉出不存在的属性或事件名。
|
||||||
|
4. **行为不确定先隔离钉死**:建隔离 `amis.embed` 手写最小 schema 跑真事件,确认机制后再写后端 / 转换器。
|
||||||
|
5. **校验工具**:`POST {{EIP4_BASE_URL}}/api/page/schema/validate`(不写库);`GET {{EIP4_BASE_URL}}/api/page/schema/components` 查注册组件 / 动作(未注册会被 typed 校验拒)。
|
||||||
|
|
||||||
|
## 引用列 / picker / select 联动
|
||||||
|
|
||||||
|
- **picker 显名**:用 form `initApi`(**不要** service 包裹,service 破坏 fetch 时序)+ 引用字段返 `{_id, _label}` 对象(自带 label 不依赖二次拉取)。**禁全局递归 schema filter**(崩过)。
|
||||||
|
- **单选 select 取联动源**:`event.data.selectedItems` 是 **Option 对象,不是数组** → 写 `selectedItems.FIELD`,**别加 `[0]`**(只有多选才是数组)。引用联动 fill 失败,十有八九是这。
|
||||||
|
- 联动 / 校验动作要锚定 `onEvent.actions[]`。
|
||||||
|
- CHAR(36) 外键值常带尾空格 → 匹配不上,要 **trim**。
|
||||||
|
|
||||||
|
## 树(tree / tree-select / treeGrid)
|
||||||
|
|
||||||
|
- **选不中**:>100 节点触发 amis 虚拟列表,`valueSet.has` 走对象身份判断 → 选中 / 高亮失效。设 `virtualThreshold` 关虚拟,或避免一次性渲染大树。
|
||||||
|
- **点一次发两请求**:别同时写 `onEvent.change` 里 reload **和** `api: node=${tree}` 自动重拉,二者叠加双触发;去掉显式 reload。
|
||||||
|
- 加节点用弹窗表单(含多必填列),顶级节点省略 parentid;「加子节点」预填父名要 `canAccessSuperData:false` + 显式传 data。
|
||||||
|
- 树形维护对应实体 type=101 → 用 tree-select + onlyLeaf。
|
||||||
|
|
||||||
|
## CRUD 列表 / 空数据
|
||||||
|
|
||||||
|
- 列表 data 必须是**数组**;后端空结果 `{result:{}}` 要兜底成 `items:[]`,否则 amis 报红横幅 `data.items 必须是数组`。
|
||||||
|
- **别直接绑外键 id 当显示列**(会显裸 id):用计算 / columnsql 显示列,或按列名映射目标表取名(如 DEPARTID→SYS_DEPART、ORGID→SYS_ORG)。
|
||||||
|
- 点整行选中:`checkOnItemClick: true`。
|
||||||
|
|
||||||
|
## 行内编辑 / 主子表
|
||||||
|
|
||||||
|
- `quickEdit.needConfirm` 必须**显式 `false`**——amis 默认会强注一个 confirm 步骤,不写就每格都要点确认。
|
||||||
|
- 派生列公式里的 `|` 会破坏表达式切分;深嵌套表达式可能 StackOverflowError,求值要兜底。
|
||||||
|
- 多行子表用 `${index}` 按行隔离,防字段串台。
|
||||||
|
|
||||||
|
## 对话框 / 表单 / 附件
|
||||||
|
|
||||||
|
- 🔑 **行级按钮打开的 dialog 表单,会按字段 name 自动回填该行同名字段**:命名冲突会意外带入行数据,起名时留意。
|
||||||
|
- 附件双态:只读 / 编辑都用 `input-file` + `staticOn: ${__readonly}`(**别**用 each / service 拼),契约字段 `{id, name, value, url, sizeKb}`;保真层大写 `DOCUMENT` 要归一为 amis 小写。
|
||||||
|
|
||||||
|
## onEvent 事件挂载
|
||||||
|
|
||||||
|
- 要挂事件的工具栏 / 按钮**必须有 id**,否则联动挂不上。
|
||||||
|
- 区分事件类型(`inited` vs `change`),别一把抓全挂。
|
||||||
|
- 联动脚本要覆盖**所有**按钮模式(不只 FULL_AUTO,NO_S3 等也要)。
|
||||||
|
|
||||||
|
## 红线
|
||||||
|
|
||||||
|
- 改 amis 行为前先想清楚改的是「生成逻辑(转换器 / recipe)」还是「单页 overlay」——前者影响全站,必跑回归。
|
||||||
|
- schema 只能用注册过的组件 / 动作;改动后 `validate` + 真渲染**双验证**再收工。
|
||||||
55
docs/skills/eip4-data-modeling.md
Normal file
55
docs/skills/eip4-data-modeling.md
Normal file
@@ -0,0 +1,55 @@
|
|||||||
|
# Skill: eip4-data-modeling
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 用户要新建业务实体(表)、给已有表加字段。
|
||||||
|
- 需要引用列(外键)、主子表结构。
|
||||||
|
|
||||||
|
> 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer <token>`,取 token 见 `eip4-env-manage`。
|
||||||
|
|
||||||
|
## 端点
|
||||||
|
|
||||||
|
建实体:`POST {{EIP4_BASE_URL}}/api/meta/entity`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"tablename": "EIP4AI_DEMO",
|
||||||
|
"name": "演示实体",
|
||||||
|
"attributes": [
|
||||||
|
{"column": "TITLE", "display": "标题", "type": "string", "length": 200, "mandatory": true},
|
||||||
|
{"column": "OWNER", "display": "负责人", "type": "reference", "referenceTable": "SYS_USER"}
|
||||||
|
],
|
||||||
|
"tabletype": 0,
|
||||||
|
"masterTable": "PARENT_TABLE"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- `tablename` 必须 EIP4 前缀,大写,匹配 `[A-Z][A-Z0-9_]{2,40}`。
|
||||||
|
- `type`:`string | integer | number | date | datetime | boolean | reference`。
|
||||||
|
- `reference` 必带 `referenceTable`,自动生成 CHAR(36) 外键列指向目标表。
|
||||||
|
- `tabletype`:`0`=主表 `1`=子表 `2`=中间表;子表用 `masterTable` 指定主表,自动加 `MASTERID` 回链列。
|
||||||
|
- 标准列(主键/版本/审计时间/操作人)由引擎自动补齐,**不要手传**。
|
||||||
|
|
||||||
|
加字段:`POST {{EIP4_BASE_URL}}/api/meta/entity/{table}/attributes`,body 为 `{"attributes":[...]}`。
|
||||||
|
- ALTER ADD COLUMN 恒可空(有数据的表加 NOT NULL 会失败)。
|
||||||
|
|
||||||
|
查询:
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/meta/entities` — 实体目录(引用列目标表选择)。
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/meta/entity/{table}` — 单实体属性(columns + displayColumn)。
|
||||||
|
- `GET {{EIP4_BASE_URL}}/api/meta/entity-types` — 实体分类。
|
||||||
|
|
||||||
|
删除:`DELETE {{EIP4_BASE_URL}}/api/meta/entity/{table}`(仅 EIP4 前缀表)。
|
||||||
|
|
||||||
|
## 命令示例
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -X POST {{EIP4_BASE_URL}}/api/meta/entity \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
--data-binary @entity.json
|
||||||
|
```
|
||||||
|
|
||||||
|
## 红线
|
||||||
|
|
||||||
|
- 表名必须 EIP4 前缀,DDL 经 CreateTableSqlGuard / AlterTableSqlGuard / DropTableSqlGuard 强制校验。
|
||||||
|
- 建表/加列/删表只对 EIP4 前缀表;生产表禁碰。
|
||||||
|
- 不手传标准审计列。
|
||||||
64
docs/skills/eip4-env-manage.md
Normal file
64
docs/skills/eip4-env-manage.md
Normal file
@@ -0,0 +1,64 @@
|
|||||||
|
# Skill: eip4-env-manage
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 用户要求启动、检查或切换 EIP4 环境。
|
||||||
|
- 用户要求 Agent 在本地验证功能。
|
||||||
|
- 用户要求确认当前服务是否可被 AI 自动开发链路使用。
|
||||||
|
|
||||||
|
## 操作规则
|
||||||
|
|
||||||
|
1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。
|
||||||
|
2. 使用 JDK 21,不能使用 JDK 26。
|
||||||
|
3. 默认本地 base URL 由 `eip4 init` 渲染,当前环境为 `{{EIP4_BASE_URL}}`;多套环境用 `eip4 env add/use` 管理。
|
||||||
|
4. 使用 CLI 探测环境:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env add \
|
||||||
|
--name local \
|
||||||
|
--base-url {{EIP4_BASE_URL}} \
|
||||||
|
--kind local \
|
||||||
|
--use
|
||||||
|
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status
|
||||||
|
```
|
||||||
|
|
||||||
|
5. 如果服务未启动,优先使用重新打包后的 jar:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests
|
||||||
|
/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local
|
||||||
|
```
|
||||||
|
|
||||||
|
## 鉴权 / Token
|
||||||
|
|
||||||
|
- 非 prod profile(default / local / ci)放行 `/api/**`;本地 `eip4 init` 默认渲染 local,故本地 curl / CLI **无需 token**。
|
||||||
|
- prod 或开启 JWT 的环境:`/api/**` 需请求头 `Authorization: Bearer <token>`(`/api/auth/**` 例外,登录本身免令牌)。
|
||||||
|
- 取 token(登录响应顶层字段 `token`=JWT、`expireSeconds`=过期秒数;失败 401 仅含 `success:false` + `msg`):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
TOKEN=$(curl -s -X POST {{EIP4_BASE_URL}}/api/auth/login \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"account":"admin","password":"111111"}' \
|
||||||
|
| python3 -c 'import sys,json;print(json.load(sys.stdin)["token"])')
|
||||||
|
|
||||||
|
curl {{EIP4_BASE_URL}}/api/meta/entities -H "Authorization: Bearer $TOKEN"
|
||||||
|
```
|
||||||
|
|
||||||
|
> `admin/111111` 为本地 dev 种子账号;按环境替换。
|
||||||
|
|
||||||
|
## 禁止事项
|
||||||
|
|
||||||
|
- 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。
|
||||||
|
- 不把线上环境设置为默认写入目标。
|
||||||
|
- 不跳过 JDK 版本检查。
|
||||||
|
- 显式选择非当前 env 执行 AI 或发布类命令时,必须要求 `--yes` 或等效人工确认。
|
||||||
|
|
||||||
|
## 常用命令
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env list
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env current
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env use --name local
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --all
|
||||||
|
```
|
||||||
48
docs/skills/eip4-page-recipe.md
Normal file
48
docs/skills/eip4-page-recipe.md
Normal file
@@ -0,0 +1,48 @@
|
|||||||
|
# Skill: eip4-page-recipe
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 用户要为某实体生成默认页面(维护 / 树 / 主子表)。
|
||||||
|
- 需要派生列、父级汇总。
|
||||||
|
|
||||||
|
> 调用方式:经 REST(无对应 CLI 子命令),或经 `platform-mcp`(MCP)。非 local 环境需带 `Authorization: Bearer <token>`,取 token 见 `eip4-env-manage`。
|
||||||
|
|
||||||
|
## recipe 类型
|
||||||
|
|
||||||
|
权威列表以 `GET {{EIP4_BASE_URL}}/api/ai/page-recipes` 为准;当前三种(id 带 `-v1`,须逐字传,端点精确匹配,不接受省略 `-v1` 的别名):
|
||||||
|
|
||||||
|
- `maintenance-crud-v1` — 普通维护 CRUD(列表 + 表单)。
|
||||||
|
- `tree-crud-v1` — 树形维护(有 parentid 的层级表)。
|
||||||
|
- `master-detail-v1` — 主子表(主表 + 子表行内编辑)。
|
||||||
|
|
||||||
|
## 端点
|
||||||
|
|
||||||
|
编译生成默认页:`POST {{EIP4_BASE_URL}}/api/design/recipe/compile`
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"tableName": "EIP4_DEMO",
|
||||||
|
"title": "演示页面",
|
||||||
|
"recipe": "maintenance-crud-v1",
|
||||||
|
"pageSize": 20,
|
||||||
|
"displayField": "NAME",
|
||||||
|
"childTable": "DEMO_DETAIL",
|
||||||
|
"linkColumn": "MASTERID",
|
||||||
|
"childDerived": [{"column": "AMOUNT", "formula": "QTY*PRICE"}],
|
||||||
|
"childRollup": [{"masterColumn": "TOTAL", "childColumn": "AMOUNT", "agg": "SUM"}]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
- `childTable` / `linkColumn` 仅 `master-detail-v1` 需要;`childDerived` / `childRollup` 可选。
|
||||||
|
- 生成流程:读实体属性 → 装配编译 → typed schema 严格校验(不过则 400)→ 落标准层(页面唯一真相)。
|
||||||
|
- 返回 `data.templateId`。
|
||||||
|
|
||||||
|
查可用 recipe(经 AI 链路):`GET {{EIP4_BASE_URL}}/api/ai/page-recipes`。
|
||||||
|
|
||||||
|
校验页面 schema(不写库):`POST {{EIP4_BASE_URL}}/api/page/schema/validate`。
|
||||||
|
组件能力表:`GET {{EIP4_BASE_URL}}/api/page/schema/components`。
|
||||||
|
|
||||||
|
## 红线
|
||||||
|
|
||||||
|
- schema 只能使用注册过的组件 / 动作;typed 校验会拒未注册组件或不支持的 actionType。
|
||||||
|
- 生成 = 落标准层;设计器 overlay 在其上叠加,二者共用同一份 typed schema 校验。
|
||||||
96
docs/skills/eip4-release-manage.md
Normal file
96
docs/skills/eip4-release-manage.md
Normal file
@@ -0,0 +1,96 @@
|
|||||||
|
# Skill: eip4-release-manage
|
||||||
|
|
||||||
|
## 触发场景
|
||||||
|
|
||||||
|
- 用户要求生成部署包。
|
||||||
|
- 用户要求发布 AI 生成的功能。
|
||||||
|
- 用户要求线上 bug 修复或回滚。
|
||||||
|
|
||||||
|
## 当前边界
|
||||||
|
|
||||||
|
当前 `platform-ai` 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。
|
||||||
|
|
||||||
|
## 发布前检查
|
||||||
|
|
||||||
|
1. 确认本地 auto-develop 已通过。
|
||||||
|
2. 使用 CLI 生成 AI 功能包快照:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai feature-package \
|
||||||
|
--base-url {{EIP4_BASE_URL}} \
|
||||||
|
--task-id ait-xxx \
|
||||||
|
--change-set-id aics-xxx \
|
||||||
|
--output target/ai-runs/feature-package.json
|
||||||
|
```
|
||||||
|
|
||||||
|
3. 保存里程碑 revision:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai revision \
|
||||||
|
--base-url {{EIP4_BASE_URL}} \
|
||||||
|
--task-id ait-xxx \
|
||||||
|
--package-id aipkg-xxx \
|
||||||
|
--note "本地门禁通过,待人工部署" \
|
||||||
|
--output target/ai-runs/revision.json
|
||||||
|
```
|
||||||
|
|
||||||
|
4. 运行离线发布校验:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release verify \
|
||||||
|
--package-file target/ai-runs/feature-package.json
|
||||||
|
```
|
||||||
|
|
||||||
|
5. 导出 `.eip4pkg.json` 并做导入预览:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release export \
|
||||||
|
--package-file target/ai-runs/feature-package.json \
|
||||||
|
--output target/ai-runs/feature-package.eip4pkg.json
|
||||||
|
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release import-preview \
|
||||||
|
--package-file target/ai-runs/feature-package.eip4pkg.json
|
||||||
|
```
|
||||||
|
|
||||||
|
6. 如存在上一版功能包,先做离线差异检查:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release diff \
|
||||||
|
--left target/ai-runs/feature-package-old.json \
|
||||||
|
--right target/ai-runs/feature-package.json
|
||||||
|
```
|
||||||
|
|
||||||
|
7. 需要回滚预案时,只生成回滚计划文件:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar release rollback-plan \
|
||||||
|
--package-file target/ai-runs/feature-package.eip4pkg.json \
|
||||||
|
--output target/ai-runs/rollback-plan.json
|
||||||
|
```
|
||||||
|
|
||||||
|
8. 确认部署包包含:
|
||||||
|
- manifest
|
||||||
|
- SQL 草案
|
||||||
|
- rollback SQL
|
||||||
|
- 本地 apply evidence
|
||||||
|
- smoke evidence
|
||||||
|
- repair evidence
|
||||||
|
9. 确认部署包需要人工审批。
|
||||||
|
10. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核;`release verify` 默认会阻断这类包。
|
||||||
|
|
||||||
|
## 线上 bug 修复路径
|
||||||
|
|
||||||
|
1. 收集线上错误日志、请求样本或人工复现步骤。
|
||||||
|
2. 在本地创建新的 AI 修复任务。
|
||||||
|
3. 本地执行 apply/smoke/repair。
|
||||||
|
4. 生成新的部署包。
|
||||||
|
5. 人工审核后走现有上线流程。
|
||||||
|
|
||||||
|
## 禁止事项
|
||||||
|
|
||||||
|
- 不让 Agent 默认直接写线上数据库。
|
||||||
|
- 不绕过部署包和人审。
|
||||||
|
- 不把 smoke 失败的变更包交给发布流程。
|
||||||
|
- 不发布 `release verify` 失败的功能包。
|
||||||
|
- 不把 `import-preview` 当成导入或启用;它只是离线检查。
|
||||||
|
- 不把 `rollback-plan` 当成回滚执行;它只生成计划和 SQL 清单。
|
||||||
129
docs/sql/SYS_AI_AGENT.sql
Normal file
129
docs/sql/SYS_AI_AGENT.sql
Normal file
@@ -0,0 +1,129 @@
|
|||||||
|
-- ============================================================================
|
||||||
|
-- 生产建表脚本:SYS_AI_AGENT(AI Agent 运行态平台表)
|
||||||
|
-- ----------------------------------------------------------------------------
|
||||||
|
-- 归属:platform-ai(P5 Agent 开发底座)。
|
||||||
|
-- 契约:/api/ai/tasks、/api/ai/tasks/{taskId}/drafts、change-sets、runs、audit。
|
||||||
|
--
|
||||||
|
-- 【Flyway 已落地(A10 W1,2026-06-25)】
|
||||||
|
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。
|
||||||
|
-- ✅ 已引入 Flyway。这些表【单一真相】= platform-app/src/main/resources/db/migration/V3__sys_ai_agent.sql
|
||||||
|
-- (运行态由 Flyway 启动时幂等 migrate;内容与本脚本一致)。本文件保留为人读的生产建表参考。
|
||||||
|
-- 原 bootstrap-ai-agent.sql 自举副本已删除(收敛入 V3)。
|
||||||
|
--
|
||||||
|
-- 边界:这些表只保存 AI 开发运行态和草稿。发布到 SYS_PAGE_SCHEMA / SYS_ENTITY /
|
||||||
|
-- 服务流等生产元数据必须经过独立人审门禁,不能由 Agent 接口直接落生产。
|
||||||
|
-- ============================================================================
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_task (
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
objective text NOT NULL,
|
||||||
|
status character varying(32) NOT NULL,
|
||||||
|
plan_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
updated_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_task PRIMARY KEY (task_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_draft (
|
||||||
|
draft_id character varying(64) NOT NULL,
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
artifact_type character varying(32) NOT NULL,
|
||||||
|
target_id character varying(128) NOT NULL,
|
||||||
|
payload_json jsonb NOT NULL,
|
||||||
|
gates_json jsonb NOT NULL,
|
||||||
|
metadata_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_draft PRIMARY KEY (draft_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_change_set (
|
||||||
|
change_set_id character varying(64) NOT NULL,
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
status character varying(32) NOT NULL,
|
||||||
|
draft_ids_json jsonb NOT NULL,
|
||||||
|
summary_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_change_set PRIMARY KEY (change_set_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_run (
|
||||||
|
run_id character varying(64) NOT NULL,
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
change_set_id character varying(64) NOT NULL,
|
||||||
|
run_type character varying(32) NOT NULL,
|
||||||
|
status character varying(32) NOT NULL,
|
||||||
|
payload_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_run PRIMARY KEY (run_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_feature_package (
|
||||||
|
package_id character varying(64) NOT NULL,
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
change_set_id character varying(64) NOT NULL,
|
||||||
|
status character varying(32) NOT NULL,
|
||||||
|
manifest_json jsonb NOT NULL,
|
||||||
|
deployment_package_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_feature_package PRIMARY KEY (package_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_revision (
|
||||||
|
revision_id character varying(64) NOT NULL,
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
package_id character varying(64) NOT NULL,
|
||||||
|
status character varying(32) NOT NULL,
|
||||||
|
note text NOT NULL,
|
||||||
|
snapshot_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_revision PRIMARY KEY (revision_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE TABLE IF NOT EXISTS sys_ai_audit_log (
|
||||||
|
audit_id character varying(64) NOT NULL,
|
||||||
|
task_id character varying(64) NOT NULL,
|
||||||
|
action character varying(96) NOT NULL,
|
||||||
|
actor character varying(64) NOT NULL,
|
||||||
|
details_json jsonb NOT NULL,
|
||||||
|
created_at bigint NOT NULL,
|
||||||
|
CONSTRAINT pk_sys_ai_audit_log PRIMARY KEY (audit_id)
|
||||||
|
);
|
||||||
|
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_draft_task ON sys_ai_draft (task_id, created_at);
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_change_set_task ON sys_ai_change_set (task_id, created_at);
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_run_task ON sys_ai_run (task_id, created_at);
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_run_change_set ON sys_ai_run (change_set_id, created_at);
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_feature_package_task ON sys_ai_feature_package (task_id, created_at);
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_revision_task ON sys_ai_revision (task_id, created_at);
|
||||||
|
CREATE INDEX IF NOT EXISTS idx_sys_ai_audit_log_task ON sys_ai_audit_log (task_id, created_at);
|
||||||
|
|
||||||
|
COMMENT ON TABLE sys_ai_task IS 'AI Agent 开发任务。只描述需求、状态和计划,不代表已发布功能';
|
||||||
|
COMMENT ON TABLE sys_ai_draft IS 'AI Agent 草稿产物。payload_json 保存实体/页面/服务流/代码等草稿';
|
||||||
|
COMMENT ON TABLE sys_ai_change_set IS 'AI Agent 待人审变更包。通过门禁后供人工确认和发布';
|
||||||
|
COMMENT ON TABLE sys_ai_run IS 'AI Agent 本地执行证据。保存 smoke/local-apply 的结构化结果';
|
||||||
|
COMMENT ON TABLE sys_ai_feature_package IS 'AI Agent 功能包快照。封装部署包、manifest 和本地证据,用于人审/导出/版本里程碑';
|
||||||
|
COMMENT ON TABLE sys_ai_revision IS 'AI Agent 里程碑版本。保存功能包快照,后续用于差异比较和回滚';
|
||||||
|
COMMENT ON TABLE sys_ai_audit_log IS 'AI Agent 操作审计日志';
|
||||||
|
|
||||||
|
COMMENT ON COLUMN sys_ai_task.task_id IS 'Agent 任务 id';
|
||||||
|
COMMENT ON COLUMN sys_ai_task.objective IS '用户目标或需求描述';
|
||||||
|
COMMENT ON COLUMN sys_ai_task.status IS '任务状态,例如 DRAFTING / READY_FOR_REVIEW';
|
||||||
|
COMMENT ON COLUMN sys_ai_task.plan_json IS 'Agent 计划步骤 JSON';
|
||||||
|
COMMENT ON COLUMN sys_ai_task.created_at IS '创建时间 epoch 毫秒';
|
||||||
|
COMMENT ON COLUMN sys_ai_task.updated_at IS '更新时间 epoch 毫秒';
|
||||||
|
|
||||||
|
COMMENT ON COLUMN sys_ai_draft.artifact_type IS '草稿类型:ENTITY / PAGE_SCHEMA / SERVICEFLOW / MENU / CODE / TEST';
|
||||||
|
COMMENT ON COLUMN sys_ai_draft.target_id IS '目标标识,例如实体编码、templateId、服务流 id 或文件路径';
|
||||||
|
COMMENT ON COLUMN sys_ai_draft.payload_json IS '草稿内容 JSON';
|
||||||
|
COMMENT ON COLUMN sys_ai_draft.gates_json IS '草稿门禁结果 JSON';
|
||||||
|
COMMENT ON COLUMN sys_ai_draft.metadata_json IS '来源、上下文、生成参数等附加信息';
|
||||||
|
|
||||||
|
COMMENT ON COLUMN sys_ai_change_set.draft_ids_json IS '纳入变更包的 draft_id 列表';
|
||||||
|
COMMENT ON COLUMN sys_ai_change_set.summary_json IS '变更摘要、风险、人审要求和回滚提示';
|
||||||
|
COMMENT ON COLUMN sys_ai_run.run_type IS '执行类型:SMOKE / LOCAL_APPLY / AUTO_DEVELOP / REPAIR_PLAN / REPAIR_EXECUTION';
|
||||||
|
COMMENT ON COLUMN sys_ai_run.status IS '执行状态:PASSED / FAILED / APPLY_FAILED / SMOKE_FAILED 等';
|
||||||
|
COMMENT ON COLUMN sys_ai_run.payload_json IS '执行结果 JSON,包含逐条 smoke 或 apply step 详情';
|
||||||
|
COMMENT ON COLUMN sys_ai_feature_package.manifest_json IS '功能包 manifest,包含包 id、变更包 id、证据数量和发布边界';
|
||||||
|
COMMENT ON COLUMN sys_ai_feature_package.deployment_package_json IS '部署包完整 JSON 快照';
|
||||||
|
COMMENT ON COLUMN sys_ai_revision.snapshot_json IS '里程碑快照 JSON,当前保存 AiFeaturePackage';
|
||||||
|
COMMENT ON COLUMN sys_ai_audit_log.details_json IS '操作详情 JSON';
|
||||||
@@ -4,12 +4,11 @@
|
|||||||
-- 归属:platform-metadata(页面 schema 服务化,P4-4)。
|
-- 归属:platform-metadata(页面 schema 服务化,P4-4)。
|
||||||
-- 契约:GET /api/page/schema/{templateId} 的下发数据源。
|
-- 契约:GET /api/page/schema/{templateId} 的下发数据源。
|
||||||
--
|
--
|
||||||
-- 【Flyway 待办(P5)】
|
-- 【Flyway 已落地(A10 W1,2026-06-25)】
|
||||||
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。
|
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。
|
||||||
-- 本工程当前未引入 Flyway。本脚本即「生产建表脚本」,P5 引入 Flyway 时
|
-- ✅ 已引入 Flyway。本表【单一真相】= platform-app/src/main/resources/db/migration/V1__sys_page_schema.sql
|
||||||
-- 原样改名为 V{n}__create_sys_page_schema.sql 纳入 src/main/resources/db/migration 即可
|
-- (运行态由 Flyway 启动时幂等 migrate;内容与本脚本一致)。本文件保留为人读的生产建表参考。
|
||||||
-- (内容无需改动,故此处保持 Flyway 友好:单条幂等 DDL,无数据)。
|
-- 原 bootstrap-page-schema.sql 自举副本已删除(收敛入 V1)。
|
||||||
-- 本地 / CI 自举副本见 platform-metadata/src/main/resources/bootstrap/bootstrap-page-schema.sql。
|
|
||||||
--
|
--
|
||||||
-- 初始数据导入(1489 个转换产物)由 SchemaImportCli 批量入库,不在本 DDL 内。
|
-- 初始数据导入(1489 个转换产物)由 SchemaImportCli 批量入库,不在本 DDL 内。
|
||||||
-- ============================================================================
|
-- ============================================================================
|
||||||
|
|||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ✅ **已完成·归档候选(2026-06-21)**:onEvent seq 映射已修复上线,计划执行完毕。可后续 `git mv` 入 `docs/归档/`。
|
||||||
|
|
||||||
# onEvent 脚本挂回修复(按钮联动 / 表单只读联动)Implementation Plan
|
# onEvent 脚本挂回修复(按钮联动 / 表单只读联动)Implementation Plan
|
||||||
|
|
||||||
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ✅ **已完成·归档候选(2026-06-21)**:processCoreService 桥接 bean 已端到端实证落地。可后续 `git mv` 入 `docs/归档/`。
|
||||||
|
|
||||||
# 提交审批端到端 — processCoreService 桥接 bean 设计(MVP)
|
# 提交审批端到端 — processCoreService 桥接 bean 设计(MVP)
|
||||||
|
|
||||||
> 日期:2026-06-14
|
> 日期:2026-06-14
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ✅ **已完成·归档候选(2026-06-21)**:新闻管理切片已修复上线 + live 验收。可后续 `git mv` 入 `docs/归档/`。
|
||||||
|
|
||||||
# 新闻管理 功能垂直切片 全 parity Implementation Plan
|
# 新闻管理 功能垂直切片 全 parity Implementation Plan
|
||||||
|
|
||||||
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans / superpowers:subagent-driven-development 逐任务实施。每条修复 TDD + 浏览器端到端对老系统验收,修完作为其余 ~150 功能的模板再泛化。
|
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans / superpowers:subagent-driven-development 逐任务实施。每条修复 TDD + 浏览器端到端对老系统验收,修完作为其余 ~150 功能的模板再泛化。
|
||||||
@@ -48,7 +50,7 @@
|
|||||||
|
|
||||||
## WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动)
|
## WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动)
|
||||||
|
|
||||||
> P0(rewritten-root 路径)已修并提交 `7b76dce`。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。**完整 TDD 细化见原稿** `docs/plans/2026-06-14-onEvent脚本挂回修复-plan.md`(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。
|
> P0(rewritten-root 路径)已修并提交 `7b76dce`。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。**完整 TDD 细化见原稿** `docs/归档/2026-06-14-onEvent脚本挂回修复-plan.md`(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。
|
||||||
|
|
||||||
**根因:** `TemplateToAmisConverter.attachScriptOnEvent`:1644 只挂 `full_auto_index.json` 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 `id` 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。
|
**根因:** `TemplateToAmisConverter.attachScriptOnEvent`:1644 只挂 `full_auto_index.json` 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 `id` 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。
|
||||||
|
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ✅ **已完成·归档候选(2026-06-21)**:菜单树模式 + 字段级树选择框已修复 live 验收。可后续 `git mv` 入 `docs/归档/`。
|
||||||
|
|
||||||
# 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划
|
# 菜单维护改老系统模式 + 字段级树选择框修复 — 实施计划
|
||||||
|
|
||||||
日期:2026-06-15
|
日期:2026-06-15
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ✅ **已完成·归档候选(2026-06-21)**:Phase 0-4 全部实现 + live 验收。仍可作 WfTemplate 驱动审批机制参考;可后续 `git mv` 入 `docs/归档/`。
|
||||||
|
|
||||||
# WfTemplate 驱动审批界面 — 完整实现方案
|
# WfTemplate 驱动审批界面 — 完整实现方案
|
||||||
|
|
||||||
日期:2026-06-16
|
日期:2026-06-16
|
||||||
5652
docs/归档/2026-06-20-人走五环建新功能-实施计划.md
Normal file
5652
docs/归档/2026-06-20-人走五环建新功能-实施计划.md
Normal file
File diff suppressed because it is too large
Load Diff
@@ -1,3 +1,5 @@
|
|||||||
|
> 📦 **归档候选(2026-06-21)**:M0 一次性本地压测基线(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。
|
||||||
|
|
||||||
# C3 压测基线 v1(M0 交付物)
|
# C3 压测基线 v1(M0 交付物)
|
||||||
|
|
||||||
> 版本 v1.0(2026-06-10)| 工具:`eip4-platform/tools/loadtest/load_p95.py`(零依赖,可复跑)
|
> 版本 v1.0(2026-06-10)| 工具:`eip4-platform/tools/loadtest/load_p95.py`(零依赖,可复跑)
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> 📦 **归档候选(2026-06-21)**:M0-C5 一次性 amis fork 构建预演(被 `M0交付/M0剩余项状态登记` 引用,物理归档前先改该引用)。
|
||||||
|
|
||||||
# C5 任务:amis 6.13.0 Fork 构建预演报告
|
# C5 任务:amis 6.13.0 Fork 构建预演报告
|
||||||
|
|
||||||
**任务编号**:EIP4 M0 – C5
|
**任务编号**:EIP4 M0 – C5
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ✅ **已完成·归档候选(2026-06-21)**:单次 CRUD QA dogfooding 清单,多数缺口已处理(对齐 `2ecda94`)。注:被 `通用模板全类型可用性…06-16` 引用,物理归档前先改该引用。
|
||||||
|
|
||||||
# CRUD 全面 QA 发现与剩余问题清单(2026-06-14)
|
# CRUD 全面 QA 发现与剩余问题清单(2026-06-14)
|
||||||
|
|
||||||
> 来源:本会话 dogfooding + 2 个并行只读巡检 agent(25 业务实体读 / 1241 编辑表单)+ 写流 QA(18 个 _ADD)+ playwright 浏览器抽验。
|
> 来源:本会话 dogfooding + 2 个并行只读巡检 agent(25 业务实体读 / 1241 编辑表单)+ 写流 QA(18 个 _ADD)+ playwright 浏览器抽验。
|
||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> ⚠️ **已被取代(2026-06-21)**:本文口径停在 06-17。最新进度权威见 [项目进度与路线-总览-2026-06-21.md](项目进度与路线-总览-2026-06-21.md)。本文保留作历史快照,勿据以判进度。
|
||||||
|
|
||||||
# EIP3 → EIP4 迁移:项目进度与路线总览
|
# EIP3 → EIP4 迁移:项目进度与路线总览
|
||||||
|
|
||||||
> 维护日期:2026-06-17 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新功能)。
|
> 维护日期:2026-06-17 | 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新功能)。
|
||||||
86
docs/新人上手.md
Normal file
86
docs/新人上手.md
Normal file
@@ -0,0 +1,86 @@
|
|||||||
|
# 新人上手 — 第一天路径
|
||||||
|
|
||||||
|
> 目标:半天内从零到「本地起全栈 + 登录看到真实页面 + 全量测试绿」。
|
||||||
|
> 遇到与本文不符的情况,以 `README.md`(仓根)+ `docs/架构设计.md` 为准并回改本文。
|
||||||
|
|
||||||
|
## 0. 前置软件
|
||||||
|
|
||||||
|
| 软件 | 版本 | 说明 |
|
||||||
|
|---|---|---|
|
||||||
|
| JDK | **21(硬性,严禁 26)** | `brew install openjdk@21`。保真层 Groovy 4.0.27 不认 JDK 26 字节码,服务流会批量 500(`scripts/run-dev.sh` 有守卫,详见仓根 README) |
|
||||||
|
| Node | 22+ | 前端 Vite + amis 本地 SDK |
|
||||||
|
| PostgreSQL | 15 | 本地 `localhost:5433`(惯例 `PGDATA=~/eip4-pgdata`,非 brew 默认);psql 查业务表先 `set search_path=eip3` |
|
||||||
|
| Maven | 3.9+ | 模块化构建注意:`mvn -pl <模块>` **必须加 `-am`** |
|
||||||
|
|
||||||
|
## 1. 取码
|
||||||
|
|
||||||
|
> ⚠️ **托管现状**:三仓目前在项目负责人的**私人 Git 托管**,**非团队基础设施**。
|
||||||
|
> 团队接手前需二选一:迁移到团队代码托管(届时本节地址与 CONTRIBUTING 的 CI 段随之更新),
|
||||||
|
> 或由仓主开通协作者账号。CI runner 也应部署在团队侧而非个人机器。
|
||||||
|
|
||||||
|
取码地址与账号**向项目负责人索取**(当前为私有 Gitea,SSH 走非标准端口,需在 `~/.ssh/config` 为该 Host 配 `Port`)。
|
||||||
|
clone 三个仓到同一父目录(前后端脚本按兄弟目录相互引用):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone <GIT_HOST>:<OWNER>/eip4-platform.git
|
||||||
|
git clone <GIT_HOST>:<OWNER>/eip4-web.git
|
||||||
|
git clone <GIT_HOST>:<OWNER>/amis-fork.git # 渲染 SDK 源,日常开发只读,可后取
|
||||||
|
```
|
||||||
|
|
||||||
|
## 2. 后端:构建 + 开发库 + 起服务
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd eip4-platform
|
||||||
|
mvn clean install # 全 reactor 构建+单测(首次较久);绿=环境 OK 第一证
|
||||||
|
bash tools/local-devdb/build_devdb.sh --drop-target
|
||||||
|
# 构建日常开发库 eip4dev(约 6 分钟,需内网可达客户库副本 192.168.20.68:5435)
|
||||||
|
mvn -pl platform-app,flowable-service -am package -DskipTests # 出可运行 jar
|
||||||
|
bash scripts/run-dev.sh both # platform :8093(dev profile) + flowable-service :8089
|
||||||
|
curl -s localhost:8093/v3/api-docs | head -c 80 # 健康判定用这个端点(返回 JSON 即活)
|
||||||
|
```
|
||||||
|
|
||||||
|
- 日志:`/tmp/eip4-platform.log`、`/tmp/eip4-flowable.log`。
|
||||||
|
- 不在内网/没有客户库副本:用 `deploy/` 的 compose 演示栈(见 `deploy/README.md`),或 local profile + `eip4m0` 极简自举集(CI/对拍口径,账号 alice/123456)。
|
||||||
|
- 三套 profile 的含义与端口:见仓根 `README.md`「三套 profile」表。
|
||||||
|
|
||||||
|
## 3. 前端:起 dev server
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd ../eip4-web
|
||||||
|
npm install
|
||||||
|
npm run dev # :5173,/api 反代 dev 后端 :8093(.env 已配)
|
||||||
|
```
|
||||||
|
|
||||||
|
浏览器 `http://localhost:5173/login`,**dev 库账号 `admin` / `111111`**。
|
||||||
|
登录后随便开几个菜单(如 新闻管理/用户管理),列表能出数据即全链路通。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npx vitest run && npm run build # 前端测试 + 生产构建绿=环境 OK 第二证
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. 必读文档(按序,约 1-2 小时)
|
||||||
|
|
||||||
|
1. 仓根 `README.md` — 模块地图、双层制纪律、三套 profile、JDK 红线
|
||||||
|
2. `docs/架构设计.md` — 双层制(保真层供奉/现代层生长)全部架构决策
|
||||||
|
3. `docs/迁移手册.md` — 引擎坑位台账(§5 引擎行为契约最常用)
|
||||||
|
4. `docs/README.md` — 全文档索引与状态分级(**历史/归档文档勿据以判断进度**)
|
||||||
|
5. `docs/项目进度与路线-总览-2026-06-21.md` — 进度权威(A/B 矩阵 + 待拍板)
|
||||||
|
6. 仓根 `CONTRIBUTING.md` — 分支/合并/提交/质量门约定
|
||||||
|
|
||||||
|
## 5. 高频坑(前人真踩过的)
|
||||||
|
|
||||||
|
- **fat jar 不重打**:改代码后 `mvn -pl platform-app -am package` 若行为没变,加 `clean` —— 增量打包可能没把改动打进 fat jar。
|
||||||
|
- **`mvn -pl` 忘 `-am`**:兄弟模块改动没被一起构建,报旧类错误。
|
||||||
|
- **前端页面卡死/转圈**:先杀孤儿 vite 进程(端口会漂 5173→5176…),再 `rm -rf node_modules/.vite` 清 pre-bundle 缓存重起。
|
||||||
|
- **psql 查不到表**:业务 schema 是 `eip3`,先 `set search_path=eip3`。
|
||||||
|
- **登录接口取 token**:`POST /api/auth/login` 的 token 在响应**顶层** `token` 字段;引擎主键 CHAR 补白,比对/传参前 `trim`。
|
||||||
|
- **改转换器不生效**:转换器产物落 `sys_page_schema`,改完须**重转重导**(BatchConvertCli + SchemaImportCli)运行库才变。
|
||||||
|
- **CRLF + tab 的老文件**:别用 sed 改,用 python 脚本改(保字节格式)。
|
||||||
|
|
||||||
|
## 6. 红线(越线=返工)
|
||||||
|
|
||||||
|
- 保真层 `com.dsasp.*` **只移植不重写**、不改包名(ArchUnit 强制现代层→保真层单向依赖)。
|
||||||
|
- 引擎 DDL 只走守卫单点(`AlterTableSqlGuard`/`CreateTableSqlGuard`/`DropTableSqlGuard`),禁裸 JDBC DDL。
|
||||||
|
- Flowable `databaseSchemaUpdate=false`,严禁引擎自动改表。
|
||||||
|
- AI 产物终点恒人审(`READY_FOR_HUMAN_REVIEW`),平台不内置生成 LLM;**对外严禁承诺「AI 全自动开发」**。
|
||||||
|
- amis 锁 6.13.0 本地 SDK,不依赖 CDN、不升版本。
|
||||||
@@ -4,6 +4,10 @@
|
|||||||
> 本文档固化了立项后关于工程结构、选型、中间件、保真层安全/性能的全部架构决策。
|
> 本文档固化了立项后关于工程结构、选型、中间件、保真层安全/性能的全部架构决策。
|
||||||
> **新会话/新成员开工 eip4-platform 前必读本文。**
|
> **新会话/新成员开工 eip4-platform 前必读本文。**
|
||||||
|
|
||||||
|
## 当前架构图(2026-06-26)
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 一、总原则:双层制——保真层供奉,现代层生长
|
## 一、总原则:双层制——保真层供奉,现代层生长
|
||||||
@@ -18,7 +22,8 @@ eip4-platform(Maven 多模块单体)
|
|||||||
├── platform-auth P2:组织/权限/数据权限真实现(替换 PoC 桩)
|
├── platform-auth P2:组织/权限/数据权限真实现(替换 PoC 桩)
|
||||||
├── platform-flow-gateway Flowable REST 客户端、待办聚合、3 个 handler bean
|
├── platform-flow-gateway Flowable REST 客户端、待办聚合、3 个 handler bean
|
||||||
├── platform-converter 模板转换器 + S3 脚本改写器(可独立 CLI 跑批)
|
├── platform-converter 模板转换器 + S3 脚本改写器(可独立 CLI 跑批)
|
||||||
├── platform-ai MCP Server、schema 双闸校验
|
├── platform-ai AI Agent 开发底座、schema 双闸校验、自动修复、本地门禁和人工部署包
|
||||||
|
├── platform-cli EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排
|
||||||
├── platform-parity C1 逐行对拍框架:录制/重放/逐行 diff(P1 一级交付物,可独立 CLI 跑批)
|
├── platform-parity C1 逐行对拍框架:录制/重放/逐行 diff(P1 一级交付物,可独立 CLI 跑批)
|
||||||
└── platform-app Spring Boot 启动器,组装上述模块
|
└── platform-app Spring Boot 启动器,组装上述模块
|
||||||
```
|
```
|
||||||
@@ -118,4 +123,4 @@ eip4-platform(Maven 多模块单体)
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**本文档维护**:随 P1 包结构落地校正;任何选型变更(尤其渲染层切换)回写第二、七节。
|
**本文档维护**:随 P1 包结构落地校正;任何选型变更(尤其渲染层切换)回写第二、七节。
|
||||||
|
|||||||
@@ -123,7 +123,7 @@ classpath:`mvn -pl platform-converter dependency:build-classpath -Dmdep.output
|
|||||||
|
|
||||||
**live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。
|
**live 验证(浏览器 dogfood,决定性证据)**:navigate `/page/71de2065...` 独立渲染表单 → 选组织「名城分公司」→ 网络实证 `GET /api/picker/SYS_DEPART/list?...&PARENTORGID=402881...0006` 自动重拉、部门下拉只显「名城分公司>经理室」→ 选该部门 → `GET .../SYS_POSITION/list?...&PARENTDEPARTID=402881...0063`、岗位下拉只显「经理室>科员/经理」。API 层亦验证(部门 48→28、岗位 75→6,匹配 DB)。「添加」按钮弹窗正常打开渲染该表单(无 bug;先前点击没弹是页面未就绪的时序问题,刷新后正常)。
|
||||||
|
|
||||||
**部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有远程 git.latent.chat)。
|
**部署**:转换器=schema 改动,重转 + 只导这 4 页(避免 24 噪声页 churn)即时生效;PickerController=后端改动,**已 `mvn -pl platform-app -am clean package` 重建 + 重启 8093**(新 jar 验含 `applyColumnFilters`)。备份 `/tmp/platform-app-NEW-filterscript.jar`、回滚 `/tmp/platform-app-BACKUP-running.jar`。converter 149 测试绿 + PickerControllerTest 26 绿。**改动未提交**(TemplateToAmisConverter/PickerController + 2 测试,叠加在上一轮 7 文件之上;eip4-platform 现有私有远程)。
|
||||||
|
|
||||||
**剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。
|
**剩余(P2/P3)**:P2 AUTOGENERATECODE 账号自动生成(USERORGID change 调取号端点 → bind ACCOUNT,需补后端取号端点)+ MASTERDEPART 改变设 MASTERPOSITION 必填(可 `requiredOn`);P3 非模式脚本走 `/api/script/execute-template-by-name` 运行时兜底。
|
||||||
|
|
||||||
|
|||||||
@@ -1,3 +1,5 @@
|
|||||||
|
> 📌 **落地状态以总览为准(2026-06-21)**:本文「未开始/未实现」等表述已过时——L1 主题(amis-theme.css §10-15 密度/按钮/弹窗)、L2 行选中、设计中心 DesignCenterPage 已上线。当前落地状态见 [总览-2026-06-21](项目进度与路线-总览-2026-06-21.md) B4。
|
||||||
|
|
||||||
# EIP4 组件设计体系 — 设计文档
|
# EIP4 组件设计体系 — 设计文档
|
||||||
|
|
||||||
> 日期:2026-06-15 状态:设计已成形(brainstorm 共识),具体数值/形态待真实数据校准
|
> 日期:2026-06-15 状态:设计已成形(brainstorm 共识),具体数值/形态待真实数据校准
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
日期:2026-06-16
|
日期:2026-06-16
|
||||||
触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。
|
触发:用户要求「停下来通盘考虑,保证**所有类型**的旧模板(不光 tree)**没有自定义模板**的功能都能正常使用——新架构(转换器+设计器);自定义的走 bespoke」。
|
||||||
方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。
|
方法:精读 `转换器覆盖度审计-2026-06-13` / `EIP4-架构与缺口现状-2026-06-13` / `归档/CRUD-QA-发现与剩余-2026-06-14` / `M0交付/153定制视图处置清单v1` + 全库 `view_template` 实测分布,合成一张通盘视图。
|
||||||
|
|
||||||
> **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。
|
> **状态校准(2026-06-16 晚)**:本计划 §三 的 **P0 三项(日历 type5 / 树 type3 接端点 / 组合 type6)转换器源码已全部实现并提交**(eip4-platform main `598f4f9`,连同审批 `33fda45` / 引用列显名 `cd133aa` / chore `bf56595`;提交前 `mvn test` 绿)。**但下文 §二 矩阵里 type3/5/6 的"未接/占位/语义错"描述的是 _运行库(883 页)现状_——在「全量重转重导 + 重启」之前仍成立**。即:源码已修 ✅,运行库待部署 ⏳。详见末尾「§七 收口落地与校准」。
|
||||||
|
|
||||||
|
|||||||
271
docs/项目进度与路线-总览-2026-06-21.md
Normal file
271
docs/项目进度与路线-总览-2026-06-21.md
Normal file
@@ -0,0 +1,271 @@
|
|||||||
|
# EIP3 → EIP4 项目进度与路线 · 总览(2026-06-21)
|
||||||
|
|
||||||
|
> 维护日期:2026-07-02(06-26 增量已并入;07-02 做过一轮文档-代码对抗核查对齐,见 §8 末)| 性质:全项目进度盘点 + 剩余工作路线(A 兼容 / B 新能力)+ 下一步。
|
||||||
|
> **本文取代 `归档/项目进度与路线-总览-2026-06-17.md`**(口径刷新至 06-21,新增「06-17→06-21 增量交付」一节;旧版已于 07-02 物理归档)。
|
||||||
|
> 配套权威:`README.md`(文档索引)、`架构设计.md`、`plans/2026-06-19-EIP4开发平台-架构方向-design.md`(方向 D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`(主特性设计)、`framework定制视图-engineclass移植backlog-2026-06-17.md` + `framework定制视图-TODO-2026-06-17.md`(A 兼容台账)。
|
||||||
|
>
|
||||||
|
> 编制方法:6 路并行盘点(两仓 git 真相 / 设计计划 / AI 契约 / 现有索引 / 全量文档分级)→ 综合 → 3 路对抗核对(过报 / 漏报 / 文档整理),核对修正已并入正文。所有 git 短哈希均对两仓 origin/main 核实存在。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 0. 一句话进度
|
||||||
|
|
||||||
|
EIP3(Vaadin / 老引擎)→ EIP4(amis 前端 + 保真层 + 转换器)迁移的**只读切流链路已闭合、写路径主线已端到端落库**。
|
||||||
|
|
||||||
|
- **A 兼容线**:通用模板 1363 基本可用;153 定制视图中 framework 推进过半、**业务 106 未动(最大块)**。
|
||||||
|
- **B 新能力线本期里程碑突破**:「人走五环建新功能」低代码平台 **v1 全链交付并合入 origin/main 两仓**;设计器选型(amis-editor)拍板且 **DesignerPage 全闭环上线**(解除历史 P1 头号阻塞);AI 确定性(非 LLM)五环生产线**已合 main**。
|
||||||
|
- **安全基线(§10.1 四项 P0 + 评审追加 2 孪生 + Groovy 沙箱)2026-06-25 全数收口并 push**(platform `eba9ce1` / web `2a37251`),可达 RCE/越权/fail-open 已闭。
|
||||||
|
- **报表保真层(套打 JOR)2026-06-25/26 重宿主 + 安全/OOM 收口全数完成并 push origin/main**(§11):SQLi 门 / IDOR 授权 / XXE / 并发·字节·超时·结果集封顶 / CVE 依赖替换 / 报表只读数据源;11 类 79 单测 + live e2e + 安全对抗复审,三批 merge `e6c73a4`/`dccca17`/`d697885`。
|
||||||
|
- **B3 在线流程 Modeler v1 全链交付并合 main(2026-07-02)**:可编辑存量/新建 BPMN→草稿→同人确认发布→部署 Flowable(中文 key 保真+EIP4 办理人/会签控件+发布门+审计),A2 审批线的「流程定义在线编辑」最后一块补齐。
|
||||||
|
- 项目仍在 **dev 环境**;生产上线工程化(A10)**MVP 骨架已合 main(2026-06-25)**:W1 Flyway(`db/migration/V1-V3`)+ W2-W4 容器化/nginx 单源/compose 编排(`deploy/` + 模块根 Dockerfile),切流执行 / 性能并发 / 灰度未做。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. 规模底数(2026-06-17 实测,仍有效)
|
||||||
|
|
||||||
|
| 项 | 数 |
|
||||||
|
|---|---|
|
||||||
|
| `view_template` 模板总量 | **1516** |
|
||||||
|
| ├ 通用(无 engineclass,走转换器) | **1363** |
|
||||||
|
| └ 定制(有 engineclass) | **153** = framework **47** + 业务 pm/hr/oa/dm **106** |
|
||||||
|
| `sys_page_schema` 已转换页(含 view_page 表单) | 2729 |
|
||||||
|
| 类型分布 | 列表 type1=858 / 报表 type200=339 / type100=121 / 编辑表单 type7=70 / 树 type3=50 / 树Grid type4=45 / 组合 type6=20 / 树选 type101=11 |
|
||||||
|
|
||||||
|
> 元数据单一真相:`SYS_ENTITY` + `SYS_ENTITYATTRIBUTE`(老系统保真层原物,新旧共用)。eip3 本身即元数据驱动低代码平台,「转换」只动页面层,元数据一行没转。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 06-17 → 06-21 增量交付(本期里程碑)
|
||||||
|
|
||||||
|
> 两仓 origin/main 终点 = merge commit(eip4-platform `75f942b` / eip4-web `d1fd6ed`),本地 main == origin/main(已 push,无需再决策)。AI 工作 20 提交(`a51f353 → 9aea6c1`)随 human-five-ring 推上 origin/main。
|
||||||
|
|
||||||
|
| 交付 | 仓 | git 证据 |
|
||||||
|
|---|---|---|
|
||||||
|
| **人走五环可视化新建特性 · 后端全链**(元数据建实体 / 引用列 → recipe 单步编译 → 默认流预览落库 → 发布产人审部署包 + 菜单注册) | platform | merge `75f942b`;`4400eab`(8094 真 DB 五环①②③④含引用列 OWNER→SYS_USER live e2e)、`303b4d0`(修 DesignFeatureController 多构造器漏 `@Autowired` 致 Spring 启动崩)。`/api/meta/{entities,attributes,entity,entity-types}` + `/api/design/{recipe/compile,flows,publish}`。418 单测 + live e2e |
|
||||||
|
| **人走五环 · 前端**(ModelerPage 建模器 + 引用列 picker + NewFeatureShell 编排壳(四步向导:建实体/建子表/生成页/发布) + AI①面 AiFeatureForm + admin-gated 路由) | web | merge `d1fd6ed`;`915443f/fef5e33/4e7a95c/2b261e3/4b9c933`(建模器 UI + meta/recipe/publish api 模块)、`8f94ba3/bfb076f/7153592/a6bd4b0`(编排壳 + 设计中心入口 + 五环 Playwright)、`4e0e974/4b564c6`(AI 入口恒 READY_FOR_HUMAN_REVIEW + M-Gate 渲染冒烟)。73 vitest + build |
|
||||||
|
| **DesignerPage 实时设计器闭环上线**(amis-editor 打通:去 StrictMode 修空白屏 / 画布高度约束可滚 / 滚动条可见 / 设计中心独立 tab / `editor.html` CSS import 进 bundle 修生产构建 404)——**解除历史 P1 头号阻塞「DesignerPage 实测不可用」** | web | `2278cbc`(去 StrictMode 修空白屏)、`8603d0f`(滚动条可见)、`3abeefe`(画布可滚)、`f39661a`(设计中心独立 tab)、`ae0155e`(editor.html CSS 进 bundle 修生产构建 404)、`690f4c7`(dev 反代默认 8093 开箱即通) |
|
||||||
|
| **主子表四件套**(建模 / 派生字段 金额=数量×单价 / 父级聚合 总额 SUM / 引用驱动联动 选物料带出单价规格) | platform + web | platform `b0daaaa/d71ad6f/ce544fa/ba8177e/63e6522/3e4264d`(含排除标准审计列让生成页真正可用);web `934c646/c735f24/df0ac72/4a107f3/b578d8d`(向导映射 UI + 真事件 e2e;单选 select 经 `selectedItems.<源>` 取值) |
|
||||||
|
| **AI 确定性(非 LLM)五环增量生产线合 main + 写路径对齐 + 三道硬门收口** | platform | platform-ai + platform-cli 两 Maven 模块;`e550725…6c60383`(blueprint 编译器 + recipe 闸 + 渲染计划闸)、`d3b8846`(**M3a:net-new 标准写收敛到单一 `PageSchemaWriter`** = 单一写真相基石)、`1ff0d33/5f32050/6c60383`(AI-recipe 增改删对齐保真层服务流 `_ADD/_UPDATE/_DELETE`,含 tree-crud 写口径,非自创 `/api/entity` save)、`bac69d8`(typed-recipe 闸只作用 AI 草稿不误伤设计器 overlay)、`c379f5b`(AI 端点要求 admin)、`9aea6c1`(对外措辞收敛为 AI 辅助 + 人审)。`POST /api/ai/features/auto-develop` 终态恒 READY_FOR_HUMAN_REVIEW |
|
||||||
|
| **附件双态组件**(查看只读可下载 / 编辑可增删;读路径大写 DOCUMENT 归一 + 写路径对账落库) | platform | `22211b2`(转换器 buildAttachmentField 收敛单个 input-file + `staticOn ${__readonly}`;FlowController.resolveAttachmentFields 修空白图标 + normalizeAttachmentFieldsForWrite 交保真层落库) |
|
||||||
|
| **framework 视图移植 P2**(审批历史抽屉 / 我发起的流程 / 流程监控 / 数据导入 / 脚本编辑器 / 工作日历 / treegrid 过滤搜索 / 用户+流程 picker 对齐 / 短消息 + 消息详情;定时任务「设置提醒人」) | platform + web | platform `57c3412…d218c2b` 一批(机制① delta 注入 + 整页改写器 + filterscript 级联 + `_SEARCH` real-first + 搜索时间段 + 树编辑 layout)、`c9e4d35`(**DataImportConfigController** 315 行 + **ScheduleJobNotifyController** 397 行,均含单测);web `bf7bb25`(picker parity + 消息详情)、`0d6fab4`(用户选择框 → amis picker)、`d03c2ba`(审批历史抽屉)等 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. A:EIP3 兼容矩阵(老模板可用性)→ 刷新至 06-21
|
||||||
|
|
||||||
|
档位:🟢 基本可用 | 🟡 demo/部分(有页/端点未逐功能验收)| 🟠 通用页已产·engineclass delta 未移植 | 🔴 未起步
|
||||||
|
|
||||||
|
| ID | 工作块 | 档位 | 说明 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **A0** | 通用模板 1363(转换器) | 🟢 | 基本可用。P0 三项(日历 type5 / 树 type3 / 组合 type6)源码 `598f4f9` 已实现,后续多轮全量重转重导已执行,运行库大概率已生效(**需复核**);残 P1 = 19 页缺 EDITFORM 映射 + onselected/filter/enableButton 脚本挂回 |
|
||||||
|
| **A1** | 153 定制视图(framework 47 + 业务 106) | 🟠 | framework 除用户管理(parity,`bf7bb25/0d6fab4/17c449c`)外多项已移植(审批历史 / 我发起 / 脚本编辑器 / 工作日历 / treegrid),按 Java 类去重约 38 待写单元;**业务 106 基本没动 = 最大块**(源码已核实在本地 `../EIP-3.0/`,pm/hr/oa/dm 3.1G,2026-07-02);终判 158.75 人日卡 S1 止损评审 |
|
||||||
|
| **A2** | 流程审批优化 | 🟢 | ApprovalDrawer / WfTemplate 驱动审批 / 审批历史抽屉 / 监控按钮(撤回/结束/高级,早已 live)+ **2026-06-26 审批闭环批补齐**:协办(assist)/转阅(circulated)动作、BPMN 流程图查看(bpmn-js)、会签(BPMN 多实例,scriptUser 候选人解析移植)、会签进度「已会签 N/M」、**xerces 击穿修复**(report 古董 xerces 击穿全部 WfTemplate 解析,已钉 JDK 解析器)。均单测+live。仅剩**客户 BPMN 真实流转(前置①外部)**与**流程定义 Modeler(=B3)**。详见 `docs/plans/2026-06-25-审批闭环-实施计划.md`(main `c95eaee`) |
|
||||||
|
| **A3** | 报表系统(339) | 🟢 | **套打 JOR 重宿主已完成**(复用客户预编译引擎 headless 渲染,328/339 type=200 为报表查看器 crud,`/api/report/render` 三格式 HTML/PDF/XLS + iframe 保真,push `53f3c25`)+ **保真层安全/OOM 收口已完成**(见 §11,三批 merge)。残:中文字体保真细化 / 钻取链接 / 完整客户库逐张对账;图表 ECharts、报表设计器 B6 仍未起步 |
|
||||||
|
| **A4** | 附件系统 | 🟠 | 双态组件已上线;缺图片预览、老附件物理文件迁移(下载 403)、DOCUMENT 全生命周期 |
|
||||||
|
| **A5** | 消息 & 邮件 | 🟠 | 短消息发送 + 消息详情已移植;webmail(IMAP/SMTP)独立子系统未起步;已读联动未接 |
|
||||||
|
| **A6** | 数据导入/导出 | 🔴 | 数据导入配置端点 `DataImportConfigController` 已落(c9e4d35);整体 FTP+Excel 导入管线 / Excel 导出未成体系 |
|
||||||
|
| **A7** | 定时任务/调度 | 🔴 | 调度运行时未起步;但「定时任务·设置提醒人」保真端点 `ScheduleJobNotifyController` 已交付(c9e4d35,拆 SENDINFO JSON 为 amis input-table 可编辑回写) |
|
||||||
|
| **A8** | RBAC/数据权限 parity | 🟡 | 菜单/用户/角色/部门/数据权限 5 块管理后台已建(CRUD + amis 页);用户管理达 parity,其余仍 demo 级未逐功能对照验收 |
|
||||||
|
| **A9** | 个人设置/工作日历 | 🟠 | 工作日历视图已移植;个人设置(改密/年历)未起步 |
|
||||||
|
| **A10** | 部署上线工程化 | 🟡(MVP 骨架已合 main,切流未执行) | 仍 dev(web 5173 + 后端 8093)。**2026-06-25 已落地 MVP 骨架**:design(`plans/2026-06-25-A10-生产上线工程化-design.md`,D1-D6 待拍板)+ **W1 Flyway 平台表迁移**(`platform-app/src/main/resources/db/migration/V1-V3`,本地 PG 真验,merge `f7675c9`)+ **W2-W4 容器化/nginx 单源/compose 编排**(`deploy/` compose+nginx.conf+.env.example+systemd、`platform-app`/`flowable-service` 模块根 Dockerfile,merge `97a0eb1`;后续 `fa3c92b` bootstrap 单一真相 / `2db44a6` 演示库自洽起栈)。**未做**:生产切流执行 / 数据迁移 runbook 实跑 / 性能并发 / 灰度(PG/Flowable Runbook 已备未执行) |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. B:EIP4 新能力矩阵 → 本期重大刷新
|
||||||
|
|
||||||
|
| ID | 工作块 | 档位 | 说明 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **人走五环** | NocoBase 式建模器 + 实时设计器 v1 | 🟢 | **v1 全链交付 + live 验收 + 合 main 两仓**(platform 418 单测 / web 73 vitest)。五环①②③④(含引用列)+ AI①面恒 READY_FOR_HUMAN_REVIEW + production 人审部署包(requiresHumanApproval=true)+ 主子表四件套全完,红线全守。**v1 限简单 CRUD/树 recipe + 只建新不改表** |
|
||||||
|
| **B1** | 新设计器(低代码可视化) | 🟢 | **选型已拍板**:D1 签字下注 amis-editor(接受 amis-fork 6.13.0 冻结天花板 / bus factor≈1 自维护);形态 = NocoBase 式建模器 + 实时设计器,不做线性 wizard。**DesignerPage 已修到全闭环**(`2278cbc` 等 6 提交),原 P1 头号阻塞已解除 |
|
||||||
|
| **B2** | AI 模块 | 🟢 | **确定性(非 LLM)五环增量生产线已合 main**(超 PoC)。platform-ai + platform-cli 落地;终点恒人审、平台不内置生成 LLM(唯 LLM 修复 `HttpAiLlmRepairClient` 默认关、只修不生成)。落地 P0/P1/P2/P4/P5 第一版完成,P3 进行中 |
|
||||||
|
| **B3** | 流程建模器 BPMN Modeler | 🟢 | **v1 全链交付并合 main(2026-07-02,platform+web)**。bpmn-js Modeler 可编辑存量/新建 BPMN 流程→存草稿(act_re_model)→同人确认发布→部署到 Flowable。含:可逆 id 净化(中文流程 key 保真 D7)、EIP4 侧板五控件(办理人/会签保真读回/formKey/扩展属性/监听器)、办理人表达式 codec(逐字对齐引擎)、activiti moddle 完整描述符(1512/1512 保真零丢失)、发布门(ProcessValidator+网关语义校验+超管门+审计 V4)、4 新建模板、Playwright e2e 三场景。17 任务 TDD+对抗评审+每阶段 live 验收(挡 3 真 bug 含 bpmn-js PascalCase 断部署)。设计+实施计划见 `plans/2026-07-02-在线流程Modeler-实施计划.md`。残:A10 生产加固 backlog(nginx 洞已修/引擎表达式白名单/网关内部鉴权)、空 content 语义校验、细粒度流程授权(v2)。BPMN 只读查看(A2 流程图)仍在 |
|
||||||
|
| **B4** | 生产级 UI/UE 组件体系 | 🟡 | L1 主题(amis-theme.css §10-15 密度/按钮/弹窗/字号)+ L2 行选中 `checkOnItemClick` + 设计中心 DesignCenterPage 已上线;剩选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办 未完整(`组件设计体系-design-2026-06-15` 落地状态需对齐本矩阵) |
|
||||||
|
| **B5** | 移动端 / 响应式 | 🔴 | 未起步 |
|
||||||
|
| **B6** | 报表设计器(自助报表) | 🔴 | 未起步(与 A3 同根待立项) |
|
||||||
|
| **B7** | 平台底座 | 🟡 | 元数据单一真相 + `PageSchemaWriter` 单一写真相(`d3b8846`)+ 五重门禁(page-recipe / typed-page-schema / amis-schema / local-smoke / render-plan)已建 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. 下一步工作(优先级排序)
|
||||||
|
|
||||||
|
> 来源:综合 6 路盘点 + 对抗核对;size:S=小 / M=中 / L=大。
|
||||||
|
|
||||||
|
### P0(先做,本期)
|
||||||
|
|
||||||
|
1. **【S,本文即产出】刷新主进度文档到 06-21**:本总览已建;下一步把 `README.md` 索引刷到 06-21、补登 plans/06-19/06-20 三份新 design 与 AI 契约导航、标注已完成的一次性 plan/简报为「归档候选」。*理由:文档时间线断层(最新交付 06-21,文档停 06-17),接手者会被误导。*
|
||||||
|
2. **【M】AI 门禁余项收口**:存量 overlay 组件 vs 白名单清零、引擎 ALTER 安全通道(`executeCreateSql` 现只接受 CREATE,net-new 仍有裸 JDBC 旁路风险)、安全门 advisory → enforced。*理由:合 main 硬门已清,但这批非红线清理是安全门转强制的前提。依赖:AI 分支已合 main(75f942b)。*
|
||||||
|
|
||||||
|
### P1(紧接其后)
|
||||||
|
|
||||||
|
3. **【L】framework 业务 106 视图(pm/hr/oa/dm)engineclass delta 移植启动**:A1 真实大头。机制① `EngineclassDelta` 注册表 + 用户管理 Delta 移植方法论已就位可复用。*依赖:S1 止损评审定处置方式(见 §6)。*
|
||||||
|
4. **【L】人走五环 v2**:ALTER 改已有表(引擎现零迁移路径)+ 主子表/审批/组合 tabs recipe 扩面(路线图 M7)。*须作为新 recipe 增量加入 blueprint,不得绕过门禁。依赖:v1(75f942b/d1fd6ed)+ 引擎 ALTER 安全通道(#2)。*
|
||||||
|
5. **【✅ 大部完成 2026-06-26】流程审批闭环**:协办/转阅/BPMN流程图/会签/会签进度/监控按钮/xerces修复 全部已做并合 main(`c95eaee`)。**仅剩**:客户 BPMN 真实流转(外部依赖)+ 流程定义 Modeler(=B3,S1 拍板)。*amis 列表入口按钮接线此前已 live(228 页 openApprovalDrawer)。*
|
||||||
|
6. **【M】AI 链与人工链部署包统一**:`DeploymentPackageBuilder` 下沉(platform-metadata 与 platform-ai 各一份)+ 净新标准页运行时 DELETE/回滚端点 + publish 写角色菜单授权(现仅 INSERT sys_menu,非超管不可见)。*影响人走五环 v1 完整可用。*
|
||||||
|
|
||||||
|
### P2(立项 / 排期)
|
||||||
|
|
||||||
|
7. **【L】报表系统 A3 立项**:套打 JOR(45) + 图表 ECharts + 打印 + 报表菜单树路由(与 B6 报表设计器同根,体量大独立立项)。
|
||||||
|
8. **【M】附件 A4 补完**:图片预览 + 老附件物理文件迁移(修下载 403)+ DOCUMENT 全生命周期。
|
||||||
|
9. **【L】生产上线工程化 A10**:生产构建 / 单源托管(Nginx 或 Spring 伴服 dist + /api)/ 数据迁移 runbook 执行 / 性能并发 / 灰度。*客户最终交付硬门,越早打通越好。*
|
||||||
|
10. **【M】生产级 UI/UE 组件体系 B4 补完**:选择框统一 / 主子表宿主 / 树编辑 Drawer / 审批待办(L1/L2/设计中心已上线,补 P1-P4 模式骨架)。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. 待拍板决策(决定后续排期)
|
||||||
|
|
||||||
|
1. **153 定制视图终判三选一**(分期交付 / 引第三方甘特组件 / 扩预算):158.75 人日 ≈ 7.56 人月,超 3 人月止损线,卡 S1 止损评审会。framework 47 已大幅推进,但业务 106 是主体,处置方式直接决定工期。
|
||||||
|
2. **②面 in-app AI employees / 平台内置生成 LLM 是否立项及时点**:v1 红线 = 平台进程内不内置生成 LLM(AI 走①面外部 agent + Skills + CLI)。②面何时启动、是否触碰对外口径红线待产品决策。
|
||||||
|
3. **type100(116) / type101(10) 列表选择框死页**:运行时由 `/api/picker/{dialogid}/list` 承接、不读这些 schema;是彻底停转还是留待低代码处理。
|
||||||
|
4. **onEvent 声明式面板(M5)自动化率目标与人工兜底边界**:逻辑编排 = b 声明式 80% 主干 + 人工 20% 兜底 + c AI 增量(D3),架构标最高不确定环;S3 自动化率 <80% 触发工期重估。
|
||||||
|
5. **对外口径统一**:人走五环 + AI①面已交付,客户演示/报价如何呈现「AI 辅助」而不越「严禁承诺 AI 全自动开发」红线。
|
||||||
|
6. **邮件全家桶(webmail IMAP/SMTP)是否纳入本期 parity 必交范围**:独立子系统、体量大。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. 现行权威文档导航
|
||||||
|
|
||||||
|
| 类别 | 文档 |
|
||||||
|
|---|---|
|
||||||
|
| 进度权威(本文) | `项目进度与路线-总览-2026-06-21.md`(A/B 矩阵 + 下一步 + 待拍板) |
|
||||||
|
| 架构基线 | `架构设计.md`、`迁移手册.md` |
|
||||||
|
| 方向 / 特性 design | `plans/2026-06-19-EIP4开发平台-架构方向-design.md`(D1-D7)、`plans/2026-06-20-人走五环建新功能-NocoBase式-design.md`、`plans/2026-06-25-A10-生产上线工程化-design.md`(待拍板 D1-D6 + W1-W6) |
|
||||||
|
| 活路线图 | `plans/2026-06-19-EIP4开发平台-落地执行路线图.md`(M0-M8,状态随里程碑回写) |
|
||||||
|
| AI 契约 | `AI_AGENT_AUTO_DEVELOPMENT.md`(对外口径红线)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`、`AI_AGENT_REPAIR_CONTRACT.md`、`AI_AGENT_Nocobase_ADOPTION_PLAN.md` + `skills/` |
|
||||||
|
| 决策红线来源 | `决策与盘点/EIP3架构决策会纪要.md`(对外口径红线:严禁承诺 AI 全自动开发)、`决策与盘点/EIP3架构决策报告.md` |
|
||||||
|
| 运维 runbook | `P0-PG升级/PG升级Runbook-v1.md`、`P3-Flowable升级/Flowable升级Runbook-v1.md` |
|
||||||
|
| A 兼容台账 | `framework定制视图-engineclass移植backlog-2026-06-17.md`(主 backlog)、`framework定制视图-TODO-2026-06-17.md`(活清单·Done/In-Progress/待验三态)、`用户管理-Delta移植-实现过程与踩坑-2026-06-17.md`(方法论/交接) |
|
||||||
|
| 通用模板线 | `通用模板全类型可用性-通盘盘点与收口计划-2026-06-16.md` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 8. 文档整理动作记录(2026-06-21 本次)
|
||||||
|
|
||||||
|
- **新建本文**为进度权威;`项目进度与路线-总览-2026-06-17.md` 顶部加「已被取代」横幅。
|
||||||
|
- **README.md** 刷新到 06-21(索引 + 模块完成度 + 导航 + 下一步)。
|
||||||
|
- **`plans/2026-06-20-人走五环建新功能-实施计划.md`** 加「24 任务全部完成 + 合 main」横幅;**`plans/2026-06-19-EIP4开发平台-落地执行路线图.md`** 回写里程碑状态。
|
||||||
|
- 以下**已完成的一次性 plan/报告标为「归档候选」**(本次未物理移动,避免破坏现行文档中的相对引用;可后续批量 `git mv` 入 `归档/`):`plans/2026-06-14-onEvent脚本挂回修复-plan.md`、`plans/2026-06-14-提交审批桥接-design.md`、`plans/2026-06-14-新闻管理垂直切片-plan.md`、`plans/2026-06-15-菜单维护树模式重建与树选择框修复-plan.md`、`plans/2026-06-16-WfTemplate驱动审批界面-完整实现方案.md`、`CRUD-QA-发现与剩余-2026-06-14.md`、`C3压测基线.md`、`C5构建预演报告.md`。
|
||||||
|
- 以下 design/契约文档**正文有过时点**,顶部加「现状以 06-21 总览为准」横幅并指明过时处:`组件设计体系-design-2026-06-15.md`(「未开始」已过时)、`AI_AGENT_AUTO_DEVELOPMENT.md`(「只覆盖最简单 CRUD recipe」已过时,实有 tree-crud + master-detail)、`AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md`(master-detail 列为未来 TODO,实已有 `master-detail-v1.yaml`)、`AI_AGENT_Nocobase_SOURCE_REVIEW.md`(P3 进度前后自相矛盾)。
|
||||||
|
|
||||||
|
**2026-07-02 文档-代码对抗核查对齐**(5 路并行核对本文 §9/§10/§11 + A/B 矩阵全部声明 vs 两仓代码,48 条声明 46 条完全一致、无虚报):
|
||||||
|
- 修正本文与代码不一致处:A10 行 🔴→🟡(W1-W4 骨架 06-25 已合 main,本文此前低报);§9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)已改;§10.2 render-plan 行号迁移至 `AiDraftGateValidator.java:246`;§11 报表单测 73→79;§2「五步编排壳」实为四步向导。
|
||||||
|
- 代码侧同步修正:`CandidateUsersHandler` 类级 javadoc(scriptUser 已于 06-26 接入,注释仍写「WARN 降级未接入」)。
|
||||||
|
- **归档候选物理归档执行**:上方列出的 8 份一次性 plan/报告 + `项目进度与路线-总览-2026-06-17.md`(已被取代)+ `plans/2026-06-20-人走五环建新功能-实施计划.md`(24 任务全完成)共 10 份 `git mv` 入 `归档/`,引用处(README 索引、M0剩余项登记、通用模板收口计划、架构方向-design)已同步改路径。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 9. P0/P1 实施记录(2026-06-21 续·已落地 + E2E 验证)
|
||||||
|
|
||||||
|
> 本节记录文档对齐之后启动的 P0/P1 实施。代码**已提交两仓特性分支 `feat/p0p1-impl`(未 push)**:eip4-platform 4 提交(docs / P0② / P0②b+P1⑥ / 对抗审查修复)、eip4-web 1 提交(P1④+P1⑤)。后端改动 `mvn -pl platform-app -am package` 重建 jar + 重启 8094 验证(已执行)。验收脚本:`scripts/p0-alter-acceptance.sh`、`scripts/p1-6-acceptance.sh`。
|
||||||
|
|
||||||
|
| 项 | 状态 | 交付 + 证据 |
|
||||||
|
|---|---|---|
|
||||||
|
| **P0② AI 门禁 + 引擎 ALTER 安全通道** | ✅ 完成·已验证 | (a) `AlterTableSqlGuard`(legacy-core,只允许 加列/改可空——同族扩长即 ALTER COLUMN TYPE 已经下方对抗审查①移除,拒 DROP/RENAME/SET NOT NULL/TYPE 变更/多语句/小写绕过)+ `DataDicService.executeAlterSql` 通道 + `MetaController POST /api/meta/entity/{table}/attributes` 加列端点(saveAttr 元数据 + 受控 ALTER 物理表 + evictByTable + 补索引);(b) `PageSchemaController` `?strict` 分流 + `GET /api/page/schema/overlay/audit` 白名单对账端点;(c) `AiAgentService.applyLocalRelease` 织入 `AiToolRegistry.check`(安全门 advisory→**enforced**,非本机/越权写路径 403)。**单测**:Guard 15/0、alter DDL 2/0、安全门 22/0(含新 FORBIDDEN 测试,112 基线无回归)、strict+审计 28/0。**真库 e2e**:建实体→加 4 列(数值/整型/字符串/引用)→元数据齐 + psql 物理列全生效 + 负控(重复列/不存在表/DROP 形态拒)全绿。 |
|
||||||
|
| **P1④ 人走五环 v2 · 改表加列** | ✅ 完成·浏览器 E2E | 前端 `meta.ts alterEntity` + `ModelerPage` 行内「加字段」Dialog(复用 FieldTable);打破「v1 只建新不改表」。**build 绿**(tsc 无错)+ **vitest 73/73**。**浏览器 E2E**:`five-ring.spec.ts` 新增「改已有表加列(建模器加字段→元数据落库)」,与五环/主子表共 **5/5 绿**。recipe 扩面(M7 新页型)暂缓。 |
|
||||||
|
| **P1⑥ 运行时 DELETE + 菜单授权** | ✅ 完成·真库 e2e | `PageSchemaWriter.deleteStandard` + `DELETE /api/page/schema/{tpl}/standard`(@Transactional 对称撤销:删 schema+overlay+软删菜单+清 sys_role_menu);`MenuRegistrar.grantToRoles` + `PublishOrchestrator.grantMenuRoles` + `DesignFeatureController.publish` 透传 roleIds(缺省 warning)。**单测**:PageSchemaWriter 6/0、MenuRegistrar 4/0、PageSchemaController 28/0、DeploymentPackageBuilder 1/0(无回归)。**真库 e2e**:发布带 roleIds→授权写 sys_role_menu ✓、无 roleIds→warning 负控 ✓、DELETE 对称撤销(计数全对)+ GET→404 + psql 核对授权落库/清除 ✓。部署包下沉(builder unify)暂缓(纯重构、回归风险高、可见价值低)。 |
|
||||||
|
| **P1⑤ 审批列表入口** | 🟡 接线完成·e2e 验证(运行时阻塞) | 列表入口接线**已 live**:228 个 sys_page_schema 含 `openApprovalDrawer` 按钮(psql 实证名实一致)+ 既有单测(registerApprovalAction 5/converter)。**浏览器 E2E**:新增 `approval-list-entry.spec.ts`(纯 mock)验证生产主路径「转换列表页按钮→选中行→openApprovalDrawer→AppShell→ApprovalDrawer 抽屉打开」1/1 绿。**外部阻塞**:点同意后真实流程流转/候选人计算需客户 BPMN(act 库 dev 不可达);BPMN 流程图编辑器=B3 级另案。 |
|
||||||
|
| **P1③ framework 业务 106 视图** | 🔴 未启动·待拍板 | 卡 S1 止损评审(§6 待拍板①:分期/第三方/扩预算),需客户决策方向。源码已在本地 `../EIP-3.0/`(2026-07-02 核实),仅剩决策一重阻塞。 |
|
||||||
|
|
||||||
|
**对抗审查收口(2026-06-21)**:实施完成后用 3-lens workflow 对自己的 P0②/P1⑥ 代码做对抗审查,揪出并修复 **4 major + 多 minor 真 bug**——①Guard 移除 ALTER COLUMN TYPE(静态守卫拿不到旧尺寸,缩短 `varchar(1)`/`numeric(1,0)` 会截断/溢出存量数据);②`addAttributes` 校验-写分离 + `@Transactional` + ALTER 失败抛异常(防孤儿元数据,PG 事务性 DDL 一起回滚);③`createEntity` 检查 `executeCreateSql` 返回值 + `@Transactional`(引擎拒建表不再静默成功);④`AiToolRegistry.isLocalEnv/isProductionEnv` 改 URI host 精确解析(防 `http://127.0.0.1.evil.com` 伪本地前缀绕过安全门);⑤`grantToRoles` 改 `INSERT...WHERE NOT EXISTS`(**实证 `sys_role_menu` 无唯一约束→`ON CONFLICT DO NOTHING` 不去重→重复发布插重复行**)+ `deleteStandard` trim/isactive 过滤 + `publish` roleIds 只接 String + `columnSqlType` 空 refTable 抛错。修复后全单测 + 双真库验收(含幂等 [2b])+ 浏览器 e2e 6/6 全绿。overlay 审计端点实跑:dev 库仅 1 overlay 用 `dialog`/`submit`(白名单偏窄,非存量页问题)。
|
||||||
|
|
||||||
|
**红线遵守**:引擎 ALTER 经 `AlterTableSqlGuard` 白名单(defense-in-depth:控制层 + 保真层双校验),只加列/恒可空、移除 TYPE 变更,杜绝破坏性 DDL;DDL 仍收口保真层单点;net-new 标准层删除收口 `PageSchemaWriter`,不裸 JDBC 旁路。
|
||||||
|
|
||||||
|
**仍待(按优先级)**:P0②余项(存量 overlay 白名单 strict 化推进,审计端点已提供对账数据)/ P1④ recipe 扩面 M7 / P1⑥ 部署包下沉统一(已查:两生成器**当前逻辑等价无 bug**,统一是防未来漂移的纯重构,需改 AI 黄金测试,低优先)/ P1⑤ 真实流转(依赖客户 BPMN)/ **P1③ framework 业务 106 视图(阻塞=待 S1 拍板;EIP-3.0 源码已核实在本地 `../EIP-3.0/`,2026-07-02)**。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 10. 架构改进待办(2026-06-24 核实并并入)
|
||||||
|
|
||||||
|
> 来源:① 一轮 8 维度架构评审(模块边界 / 巨型类 / 安全 / 性能 / 前端 / AI 五环 / 测试 / 运维),② 对另一份《EIP4 架构分析与改进建议》(其他 agent 产出)逐条对照**真实代码**核实(确认 / 夸大 / 已缓解 / 有意取舍)。**本节合并其可采纳内容,原文档已删除**(无外部引用)。
|
||||||
|
> **定级第一原则=可达性**(无需前提即可触达 > 需管理员/DBA 前提的二阶面),而非「是否存在字符串拼接」。下列项**独立于 §5/§9**:§9 收口的是 AI 写路径安全门,本节是评审新发现的、AI 链之外的可达攻陷面与工程缺口。
|
||||||
|
|
||||||
|
### 10.1 P0 — 安全/工程止血(可达攻陷面 + 零回归防护)✅ 全数收口(2026-06-25)
|
||||||
|
|
||||||
|
> 三条安全项强耦合(都靠「非 prod permitAll / prod 仅 authenticated」放大),建议作为一个「**安全基线**」批次一起做。
|
||||||
|
|
||||||
|
**✅ 全数收口(2026-06-25·安全基线批次)**:本节 4 项 P0 + 独立 security-reviewer 对抗评审追加的 2 个同类孪生漏洞 + Groovy 沙箱硬化,已全部 TDD + 全 reactor `mvn clean install` 绿 + 原子提交 --no-ff 合 main 并 push origin(**eip4-platform origin/main=`eba9ce1`、eip4-web origin/main=`2a37251`**)。逐项落地:
|
||||||
|
> - **①RCE/任意 DROP**:拆 `ScriptExecuteController`——任意请求体 Groovy 的 `/api/script/execute` + `/api/script/execute-template-by-name` 移入 `@Profile(SecurityProfiles.BYPASS=dev|local|ci|parity)`,生产仅保留**只重放脚本库内已审产物**的新 `ScriptReplayController`(`/api/script/execute-template`);`RewrittenScriptStore.load` 加 templateId 路径穿越守卫(resolve+normalize+startsWith root,+NUL 字节兜底);三个 `Poc*Controller`(含裸拼 DROP)全 `@Profile(BYPASS)`。(`980d83e`)
|
||||||
|
> - **②安全默认 fail-open**:宽松 permitAll 链由 `@Profile("!prod")` **反转为显式 opt-in** `@Profile("dev|local|ci|parity")`,严格认证链覆盖默认(含裸 `java -jar` 未设 profile)与 prod;新增 `SecurityProfiles`(旁路名单唯一真相)、`JwtSecretSafetyCheck`(严格 profile 用 dev 默认密钥即启动 fail-fast)、`application-prod.yml`(JWT/DB 无默认值、强制环境变量)。(`24160db`)
|
||||||
|
> - **③asUser/roles 越权**:`EntityController.buildCtx` 调换优先级 → JWT 绑定身份**恒权威**,客户端 asUser/roles 仅在无 JWT 身份时(非生产旁路)生效。(`1f2365f`)
|
||||||
|
> - **④CI 孤儿**:`.github/workflows/ci.yml` → `.gitea/workflows/ci.yml`(JDK 改 21);`ci.sh` 起服务加 `--spring.profiles.active=ci`(配合 fail-safe,否则健康检查 401/对拍免令牌失效);新增 eip4-web `.gitea/workflows/ci.yml`(tsc+build+vitest)。(`1a0985f` / web `63d46af`)。**前置条件**:Gitea 需启用 Actions 且注册 `ubuntu-latest` 标签 act_runner 才真跑。
|
||||||
|
> - **🔴 评审追加(原 §10.1 漏列的同类孪生,已一并修)**:(a) **CRITICAL** `TodoController.runProcessAdvancedScript`(`/api/workflow/process/{id}/advanced-script`)执行请求体 Groovy、无 `@Profile`/无角色门 = 任意认证用户 prod RCE → 注入 `Environment` + `SecurityProfiles.isBypassActive` 守卫,严格 profile 直接 amisFail 不执行(`bc9ae8c`);(b) **HIGH** `PickerController.buildCtx` 与 EntityController 同款 asUser-first IDOR(prod 可达)→ 同改 JWT 权威(`1f2365f`)。
|
||||||
|
> - **Groovy 沙箱硬化(评审 MEDIUM)**:强化 `MethodCallExpressionChecker`(原仅挡 `System.exit`)→ 编译期拦反射/进程执行/元编程/动态求值(Runtime/ProcessBuilder/`'cmd'.execute()`/Class.forName/反射/GroovyShell/metaClass/危险 System 方法…),覆盖 MethodCall/StaticMethodCall/ConstructorCall/Property 四类表达式;一处收口两条运行时 Groovy 路径(服务流 + onEvent/editgrid 重放,均经 `SecureGroovyScriptEngineFactory`)。先勘探 1428 改写脚本语料确认零使用再 TDD(8/8)+ 全语料编译零加固回归。(merge `eba9ce1`)
|
||||||
|
> - **生产上线 checklist(运维必知,fail-safe 行为变更)**:prod 必须 `-Dspring.profiles.active=prod` 且设 `EIP4_AUTH_JWT_SECRET`/`EIP4_DB_*`,否则按设计启动失败;`run-dev.sh`(dev)/`ci.sh`(ci) 已自带旁路 profile,本地/对拍不受影响。
|
||||||
|
> - **未做(更小,DEFER)**:`@EnableMethodSecurity` + 方法级 IMPERSONATE 角色(现以 profile-gate + JWT 权威已闭可达面);`EditGridScriptController` view_page id 白名单(脚本=DB 内已审 + 沙箱已硬化,残余风险低);`SecureASTCustomizer.setIndirectImportCheckEnabled(true)`(服务流脚本不在勘探语料、风险更高);新增「禁生产源码出现 `Poc*` 的 @RestController」ArchUnit 规则(现 3 个 Poc 已 @Profile 隔离)。
|
||||||
|
|
||||||
|
| 项 | 严重度 | 证据(file:line) | 建议 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| **RCE — `/api/script/execute` + `/api/poc/write-test`** | ✅ 已修(06-25) | `ScriptExecuteController.java:65→:193-198` 真执行请求体 Groovy(不受 facade 绑定约束=任意 Java/RCE),无 `@Profile`、无鉴权;`PocWriteTestController.java:181` `jdbcTemplate.execute("DROP TABLE IF EXISTS "+target)` 裸拼旁路 `DropTableSqlGuard`,无 `@Profile`。三个 `Poc*Controller` + 散落 `/api/poc/*` 随生产 jar 装配;全平台 `@PreAuthorize` 0 命中且无 `@EnableMethodSecurity` | 生产构建移除 / `@Profile("!prod")` 隔离全部 `Poc*`/`ScriptExecute` 端点;保留者加平台管理员级鉴权(开 `@EnableMethodSecurity`);新增 ArchUnit 规则禁生产源码出现 `Poc*` 的 `@RestController` |
|
||||||
|
| **安全默认 fail-open** | ✅ 已修(06-25) | `SecurityConfig.java:68-71` `@Profile("!prod")`→`anyRequest().permitAll()`(default/local/ci/dev 全放行);prod 严格链(`:50-61`)存在但仅 `@Profile("prod")`,且**仓内无 `application-prod.yml`**=prod 必须显式激活否则默认洞开;`JwtService.java:44-55` 仅校验长度,`application.yml:29` dev 默认密钥能静默签发可伪造令牌 | 补 `application-prod.yml`(JWT secret 强制环境变量、缺省启动失败);**反转 fail-safe**:未知/无 profile 默认走严格链,`permitAll` 收窄到仅 `local\|ci\|test`;prod 若 JWT secret 仍为 dev 默认值则 fail-fast |
|
||||||
|
| **`asUser/roles` 越权(prod 同样生效)** | ✅ 已修(06-25) | `EntityController.java:222-241` 客户端 `asUser/roles`(无 `@Profile` 的 `@RequestParam`)**优先于** `:247` JWT 绑定的 `UserSession.get()`,直驱 `DataPrivilegeServiceImpl` 行级数据权限,不校验是否等于 JWT 主体 | `asUser/roles` 测试通道 `@Profile("!prod")` 硬隔离;prod 引擎身份只能来自 JWT;确需 impersonation 须校验调用者持 `IMPERSONATE` 角色 |
|
||||||
|
| **CI 孤儿=自动回归实质为零** | ✅ 已修(06-25) | `eip4-platform/.github/workflows/ci.yml` 是 GitHub Actions 语法但 origin=私有 Gitea(不执行 GHA);`java-version "17"` 写死(项目 JDK21,即便能跑也编译失败=从未真跑过);`eip4-web` 无任何 CI | 把 `scripts/ci.sh` 迁成 `.gitea/workflows/ci.yml`(JDK 改 21)或公司 Jenkins;前端加最小 CI(vitest + `tsc -b`);Gitea 配 branch protection。**理由:P0 安全项修完后没有门禁防再退化。** |
|
||||||
|
|
||||||
|
### 10.2 P1 — 稳定性 / 交付能力 / 验证体系 / 可维护性
|
||||||
|
|
||||||
|
**【稳定性】**
|
||||||
|
- **✅【已完成 2026-06-24·稳定性三件套】稳定性配置真空 · high**:原状=HikariCP `maximum-pool-size:5` + `statement_timeout` 全仓零命中 + perPage 无封顶 + `queryForRowSet` 全量物化,四者叠加=一个大/恶意查询(`perPage=999999`)即耗尽连接 + OOM。**已做**:① perPage 硬封顶——新增 `Pagination.clampPerPage`(上限 5000,护栏非产品限),接入 `FlowController.applyPaging` 与 `PickerController.list` 两处 REST 入口(`page` 不封,深翻页合法);② `statement_timeout`——base `application.yml` 加 `hikari.connection-init-sql: SET statement_timeout='${EIP4_DB_STATEMENT_TIMEOUT:120s}'`(dev/local 继承、prod 无 profile 亦继承 base,可环境变量放宽/设 0 关闭);③ 连接池 `maximum-pool-size` 5→20(prod 继承 base 受益)。**验证**:`PaginationTest` 3/3 + `FlowControllerTest`(含新「perPage 超大封顶」集成测试,经真实 `executeGet` 路径) + `PickerControllerTest` 无回归=68/68 绿;`SET statement_timeout='120s'` 经真实 PG(localhost:5433)执行 `SHOW`=2min 确认语法/取值正确;`application.yml` YAML 解析校验通过。**残留(独立较大项,未做)**:`SqlRowSet` 全量物化 → 导出走流式 `RowCallbackHandler`(属性能 P2,见 §10.3)。
|
||||||
|
|
||||||
|
**【生产交付能力 — 意图与实现最大成体系缺口,对应 A10】**
|
||||||
|
- **✅【已完成 2026-06-25·A10 W1】Flyway 平台表迁移**:`platform-app/src/main/resources/db/migration/V1__sys_page_schema.sql`/`V2__sys_datastatus.sql`/`V3__sys_ai_agent.sql` 单一真相,本地 PG 真验(merge `f7675c9`);`bootstrap-ai-agent.sql` 重复已去(`11e668a`/`fa3c92b` 收敛 bootstrap 单一真相)。
|
||||||
|
- **✅【已完成 2026-06-25·A10 W2-W4】compose/Dockerfile/Nginx 骨架**:`deploy/`(docker-compose.yml + nginx.conf + .env.example + systemd/ + postgres-init/)+ `platform-app/Dockerfile`、`flowable-service/Dockerfile`(merge `97a0eb1`,`2db44a6` 内置演示库自洽起栈)。**残留**:生产切流/灰度未执行(见 A10 行)。
|
||||||
|
- **✅【已完成 2026-06-24】可观测性近零**:原状=无 actuator/无健康端点/无 logback 配置/base 日志 DEBUG(prod 继承会刷屏)。**已做**:① platform-app 加 `spring-boot-starter-actuator`,`management` 只暴露 `health`(`probes.enabled` 开 liveness/readiness,`show-details/components: when-authorized` 匿名不泄露 db 等组件细节)——不上 Prometheus 全家桶,守中间件最小化;② `SecurityConfig.PUBLIC_PATHS` 加 `/actuator/health(/**)`,prod 链探针免认证可达;③ 新增 `logback-spring.xml`(控制台 + 50MB×14 天滚动文件,文件 appender 仅 dev/local/prod 启用、不污染单测);④ base `application.yml` 的 `com.dsasp`/`jdbc.core` 日志 DEBUG→INFO(prod 继承 INFO,dev 仍 DEBUG)。**验证**:真启动 dev profile(1.7s 起)curl `/actuator/health`=`200 {"status":"UP","groups":["liveness","readiness"]}`、`/health/readiness`=200 UP、`/health/liveness`=200 UP;SecurityProfileTest 3/3 + ArchitectureRulesTest 6/6 无回归。**残留**:prod JSON 结构化日志需 Spring Boot 3.4 内建或 logstash-encoder 依赖,留作后续(避免现在加依赖)。
|
||||||
|
|
||||||
|
**【验证体系】**
|
||||||
|
- **🟡【夜间 job 已接 2026-06-25,实跑待 runner+DB】逐行对拍框架已冻结**:原状=`parity-reports/` 全是 `20260611` 时间戳,11 天引擎/转换器改动从未重拍;push CI 只在有提交时跑对拍。**核实**:`ParityCli` 本就「直连 JDBC 基线 vs 引擎 REST 被测逐行 diff,任一不一致退出码 2」=「非 0 即阻断」是内建的(基线=实时 JDBC,非冻结文件);RowDiffTest 30/30 框架健康。**已做**:新增 `.gitea/workflows/parity-nightly.yml`(cron 每日 02:00 CST + 手动 dispatch,跑 `scripts/ci.sh` 全量 seed+all+privilege 对拍、归档报告)——无提交的日子也能捕获隐性漂移。**仍待(环境/基建门,非代码)**:① 真正重拍刷新基线需在 dev/CI 起引擎+真 DB 实跑(`bash scripts/ci.sh` 或 `ParityCli --seed --all`,DB 依赖,本会话 headless 跑不了);② 工作流激活需 Gitea 注册 act_runner(同 ci.yml);③ `--discover`/`--realprivilege` 更广范围退出语义偏探索性,纳入硬门前需真跑核实。
|
||||||
|
- **保真层引擎核心无单测 + 集成测试静默跳过 · high · L**:`FlowExcuteServiceImpl`(534 行服务流主干)无单测;`FlowExecuteLocalIT.java:60` `assumeTrue(false,"本地不可达,跳过")`=无 DB 的 CI 永远绿但什么都没测(反模式:把「未运行」伪装成「通过」)。→ CI 必须起 testcontainers,DB 不可达应**红**而非跳过。
|
||||||
|
- **测试金字塔倒置 · high · L**:根目录 71 png + 前端 121 png 人工 dogfooding 是主回归手段;前端 vitest 仅 17 个;3 套 e2e config 故意不配 webServer(复用已跑环境)无法干净 CI 跑起。→ 关键闭环固化成自启动可进 CI 的稳定 e2e;扩 vitest 把「翻译正确但运行时哑火」下沉到单测。
|
||||||
|
|
||||||
|
**【可维护性核心】**
|
||||||
|
- **🟡【已完成安全半步 2026-06-24】【采纳自原文档 A5】AiLocalReleaseExecutor 裸写 sys_serviceflow/sys_menu**:**已做**——把执行器里所有裸 JDBC(sys_serviceflow UPSERT + sys_menu INSERT/UPDATE + ensureAiMenuParent + tableExists + 实体复用查询)下沉到新类 `platform-ai/.../service/AiReleaseWriter`,执行器只剩编排不再直接碰库;SQL 逐字保留(纯搬迁零行为变更)。**顺带补缺口**:新增 `AiReleaseWriterTest`(4 值断言:serviceflow 审计/`?::xml`/bool→int、菜单 INSERT 全列值、UPDATE 全字段、自动建「AI Agent」目录)——补上原 `AiLocalReleaseExecutorTest` 只查「SQL 含表名」的宽松缺口。**验证**:platform-ai 30/30 绿(黄金测试经搬迁仍绿=行为未变)。**未做(推迟为专项)**:与人走五环 `MenuRegistrar` 统一成单一写器——调查发现两者已实质分叉(本类 UPDATE 全字段 + operator 字面量 'AI_AGENT' + 顶级目录「AI Agent」vs MenuRegistrar 窄 UPDATE + `?` operator + 「新功能」),且各有钉死测试,真统一需重写两路测试 + 重验两条红线邻近路径(建议 live e2e),风险/工作量超「快速增量」,留作 A5 完整版专项。
|
||||||
|
- **✅【已完成 2026-06-24】【采纳自原文档 A4】ArchUnit 规则扩充**:`ArchitectureRulesTest.java` 从 1 条扩到 **6 条**——3 条强制(保真层禁依赖现代层 / 库模块[converter·parity]不得依赖应用编排层 / 模块切片 `beFreeOfCycles` 无环)+ 3 条**棘轮**(控制器不得新增直用 `JdbcTemplate` / 不得新增 Controller→Controller 互注入 / 不得新增 `Poc*` 调试控制器)。棘轮以「已知债务清单」基线化存量(JdbcTemplate 26 个 / 互注入 4 个 / Poc 3 个),只挡新增、清单即待偿台账。**验证**:`mvn -pl platform-app test -Dtest=ArchitectureRulesTest` 6/6 绿;并以临时探针走完整 RED→GREEN(探针触发恰好 3 条棘轮失败、强制规则不受影响,证明非空绿)。**一处刻意偏离原文档**:未加「禁控制器调 `POJOCRUDService`/引擎」——因 `com.eip4.*→com.dsasp.*` 是双层制明确允许(现代层=保真层薄门面),真正的坏味道是控制器直拼原始 SQL(已由 JdbcTemplate 棘轮覆盖)。**后续**:随 A1/A3 把控制器 SQL 收口到 Service 后,从清单删项,清空即把棘轮升为强制规则。
|
||||||
|
- **【采纳自原文档 D1】render-plan 无执行闭环 · high · M**:`validateRenderPlanGate`(SRP 拆分后已迁至 `AiDraftGateValidator.java:246`)纯字段校验,Playwright 只在生成的人工指令字符串里,`READY_FOR_HUMAN_REVIEW` 不含渲染证据。→ 新增 headless render runner 真跑 renderTests 后回写 `runEvidence`。
|
||||||
|
- **✅【已完成 2026-06-25】AiAgentService(曾 1846 LOC)SRP 收窄**:原状=~28 public 入口 + 内联 9+ `validate*Gate` + 部署/回滚 SQL 生成 + 运行记录映射揉一类。**已做**:① 部署/回滚 SQL 簇 → `AiDeploymentSqlBuilder`(黄金串测试钉死红线 SQL 字节);② 草稿门禁电池(validateDraft + 各 `validate*Gate` + SchemaGate 懒加载状态 + 正则常量)→ `AiDraftGateValidator`(直测各类 pass/fail,D3 红线判定零变更)。主类 **1846→1329 行(-28%)** 收敛为薄编排门面(29 public 方法协调 store + 抽出的 collaborator)。**验证**:逐方法/逐字搬迁、行为零变更——AiAgentServiceTest 22/22 + AiAgentControllerTest 11/11 + pipeline 无回归,platform-ai 79 全绿 + 全 reactor `mvn clean install` 绿;新增 AiDeploymentSqlBuilderTest 8 + AiDraftGateValidatorTest 7。**有意丢弃 AiRunStore**:持久化已由现有 `AiAgentStore`(saveTask/saveDraft/saveRun/…)承担,另抽会重复。分支 `feat/ai-agent-service-split` --no-ff 合 main,origin/main=`285d601`。
|
||||||
|
- **【采纳自原文档 A1/A3】platform-metadata 过厚(31 Controller / 4 Service / 0 Repository)+ Controller 互注入 · medium · L**:`EntityController.java:46/:398` 直接注入并调用 `PickerController`。→ 抽 `PickerService`/`ReferenceResolutionService` 切断互注入;建 web/service/repository 分层(与 ArchUnit 合并做)。
|
||||||
|
- **🟡【有界安全修已完成 2026-06-25,完整支持仍 L】前端 scriptCommands 联动静默哑火**:原状=`scriptCommands.ts` 把 `setLabel/setRequired/setFilter/setOptions/setNullSelection/setStyle` 翻成 amis `setValue`,但核实 amis `setValue`(CmptAction)只读 `args.value`、丢弃语义 args → 运行时 no-op(且 `args.value` 为 undefined 经 onChange 路径可能清值);amis 全量 `registerAction` 无这些动词的内置 action。**已做(有界安全修,eip4-web origin/main=`68d797e`)**:6 个动词改为<strong>显式跳过(返回 null,translateCommands 自动过滤)+ 一次性 `console.warn`</strong>——消除清值风险、不再伪装「已处理」、不再用假绿单测掩盖;新增覆盖(跳过/整体过滤/告警去重),full vitest 83/83 + tsc -b 干净。**仍 L(未做)**:要让「动态必填/选项/过滤」真生效需<strong>转换器侧生成数据绑定 schema</strong>(`requiredOn`/`source` 绑数据变量)+ 重放改数据变量 + Playwright 真 DOM e2e,跨 platform-converter + eip4-web,对冻结 amis-fork 有回归面,需独立排期。
|
||||||
|
- **WritePrivilegeChecker 复杂规则 fail-open(读写权限不对称)· medium · M**:`WritePrivilegeChecker.java:156-159` 对部门集合/范围比较类规则 default 放行,而读侧对同类型生成真实约束 → 若客户库含此类写规则可越权 update/delete。→ 不支持类型改 fail-closed。
|
||||||
|
|
||||||
|
### 10.3 P2 — 整洁度 / 一致性收敛(多为采纳自原文档的真问题,但属低优先)
|
||||||
|
|
||||||
|
- **✅【已完成 2026-06-24】【D5】抽共享 `LocalHostPolicy`**:原状=`AiToolRegistry`/`AiSmokeRunner`/`AiLocalReleaseExecutor` 三处本机白名单互异(ToolRegistry 认展开式 `0:0:0:0:0:0:0:1` 漏 `[::1]`,另两处反之)。**已做**:新增 `LocalHostPolicy.isLocalHost`(去 IPv6 方括号归一 + 精确比对回环集 `{localhost,127.0.0.1,::1,0:0:0:0:0:0:0:1}`,杜绝 `127.0.0.1.evil.com` 伪本地绕过),三处删本地副本统一委托。**验证**:新增 `LocalHostPolicyTest`(接受全部回环形态 + 拒绝伪本地/非本机)3/3 + 三处既有测试(AiToolRegistry 6/AiSmokeRunner 3/AiLocalReleaseExecutor 3)无回归,整套 platform-ai 69/69 绿。
|
||||||
|
- **✅【已完成 2026-06-24·eip4-web】【B4】抽 `isAdminProfile(profile)` 单函数**:原状=`profile?.account==='admin'||profile?.userId==='ADMIN'` 在 Topbar/ModelerPage/NewFeatureShell/AiFeatureForm/DesignCenterPage 5 处逐字硬编码。**已做**:`auth/token.ts` 加纯函数 `isAdminProfile`(口径逐字保留),5 处统一委托。顺带把 5 个页面测试的 `vi.mock('../auth/token')` 从整模块替换改为 `importOriginal` 只覆盖 `getProfile`(不再 mock 纯函数,修复因 mock 漏 `isAdminProfile` 致的 render 崩)。**验证**:新增 `token.test.ts` 4 测试 + `tsc -b` 干净 + `vitest` 18 文件/77 测试全绿。
|
||||||
|
- **✅【已完成 2026-06-24·eip4-web】【B2】删 `api/schema.ts` overlay 死代码**:核实 `fetchSchemaLayer`/`putOverlay`/`restoreStandard` 全仓(含 e2e)零引用(真实 overlay API 在 `editor/overlayApi.ts`)后删除;tsc 干净 + vitest 77/77。**未做【B1/B5】**:拆 AmisRenderer SDK 注册逻辑、合并 todo.ts/done.ts 503 降级——均**低优先整洁度**,非架构风险。
|
||||||
|
- **【D2/D3】AI 多入口来源审计**:REST/CLI/MCP 三通道 actor 恒「agent」无区分,加 `X-EIP4-Agent-Channel` 头 + 审计;`runLocalSmoke` 过 `smoke.run` 工具门对齐 `applyLocalRelease`(localhost 硬门已兜底,非可利用洞)。
|
||||||
|
- **converter 单测 4820 行/164 用例塞 1 文件**(按控件族拆 6-10 个);**cli/mcp 各仅 1 测试文件**(对外 AI 门面加契约/快照测试);**e2e 5 套 config 碎片化**(合并为 1 主 config + projects)。
|
||||||
|
- **保真层级联/附件加载残留 N+1**(`loadDoc` 按子行 id 集合一次 IN);端口契约(8084/8093/8094 漂移)+ 源码树 `.omc` 卫生。
|
||||||
|
|
||||||
|
### 10.4 严重度纠偏与已缓解(核实原文档后修正,避免误导排期)
|
||||||
|
|
||||||
|
| 原文档断言 | 核实结论 | 纠偏 |
|
||||||
|
|---|---|---|
|
||||||
|
| **ColumnSQL =最大残余注入面(high/P0)** | **降为 low/二阶纵深防御** | 裸拼属实(`POInfo.java:377` `LEFT JOIN lateral ("+ColumnSQL+")`),但**无可达写路径**:`MetaController.saveAttr` 不写 columnsql、`FieldEditorController` 改业务数据且受 `IdentifierWhitelist` 守卫、`MasterDetailLinker` INSERT 列清单不含它=需 DBA 直改库才触发。价值在加守卫禁任何写路径设 columnsql,优先级远低于 10.1 |
|
||||||
|
| Admin/AdminWrite 拼 SQL+级联删+调引擎 | **归因部分不实** | AdminController **只读、不调引擎**;级联删只在 AdminWriteController;调引擎实为 EntityController |
|
||||||
|
| `deleteByType` 列为待修注入热点 | **已缓解** | 已被 `LogController.deleteByType:73` 枚举白名单闸住(非法 type 拒绝);保真层主 CRUD 值位置多数已 `escapeSqlLiteral` 转义 |
|
||||||
|
| NewFeatureShell/AiFeatureForm 各内联 250+ 行 schema | **夸大** | 合计 ~290 行,但 AiFeatureForm 仅 ~69 行 |
|
||||||
|
| LLM 修复客户端泄露风险(high) | **已默认关闭** | `HttpAiLlmRepairClient` 经 `@ConditionalOnProperty havingValue=true` + endpoint 空串双重默认关;聚焦「开启时脱敏 + https 白名单」 |
|
||||||
|
|
||||||
|
### 10.5 有意取舍(design-intent,不当缺陷)
|
||||||
|
|
||||||
|
不引 ORM / 保真层 `com.dsasp.*` 逐字节复刻不重写(故保真层字符串拼接、类级 `@Transactional`、`DataLogManager` 的 `DiscardOldestPolicy` 均源于此,改写须跨流回归不可当普通坏味道)/ 无多租户单客户私有化 / 保真层 MD5 无盐口令(复刻旧 `EncryptUtil` 验存量库)/ AI 红线焊死(部署包恒人审、本机三处校验、LLM 默认关)。这些是已记录的有意决策,**别当 bug**。
|
||||||
|
|
||||||
|
> **采纳裁决一句话**:原文档的「工程整洁度 + AI 门禁」清单(A4/A5/D1/D5/B2/B4 等)核实属实、可放心采纳为 P1/P2;但其安全威胁建模做反了(把不可达的 ColumnSQL 当 critical、漏了可达的 RCE/permitAll/asUser),**安全 P0 以本节 10.1 为准**。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 11. 报表保真层(套打 JOR)重宿主 + 安全/OOM 收口(2026-06-25/26)
|
||||||
|
|
||||||
|
真实报表 = jatools JOR 套打模板(633 个),**重宿主非重建**:复用客户预编译引擎在无界面环境 headless 渲染为 HTML/PDF/XLS。Phase 1-3(渲染服务 + `/api/report/render` 三格式 + `/api/report/frame` amis 信封 + 转换器对 type=200 产报表查看器 crud,铺全 339)已完成并 push(origin/main `53f3c25`)。其上做了一轮**安全 / 性能 / OOM 审计与收口**(8 维度审计 + 安全 reviewer 对抗复审,TDD + 真库 live e2e),分三批合入 origin/main:
|
||||||
|
|
||||||
|
| 批次 | 内容 | merge |
|
||||||
|
|---|---|---|
|
||||||
|
| 1 | SQLi 参数门(模板引用名白名单 + 字符白名单值校验 + 身份/数据域注入)/ IDOR 对象级菜单授权 / XXE(字节级拒 DOCTYPE,防 BOM/UTF-16 绕过)/ 渲染并发闸(429) / 产物字节上限(413) / DB `statement_timeout`+`socketTimeout` / 错误响应通用化 | `e6c73a4` |
|
||||||
|
| 2 | 残留收口:结果集 `maxResultBuffer` 驱动层封顶(防 `TYPE_SCROLL_INSENSITIVE` 全量物化 OOM)+ 多值 `IN (${LIST})` 逗号放行 | `dccca17` |
|
||||||
|
| 3 | CVE 依赖替换(commons-collections 3.0→3.2.2 / log4j 1.2.8→reload4j 1.2.25,引擎 jar 不可改但依赖可换)+ 报表只读数据源(`eip4.report.db.*`,未配回落主源,向后兼容)+ 只读账号 GRANT/巡检 SQL | `d697885` |
|
||||||
|
|
||||||
|
**审计头号风险**:报表 SQL 的 `${PARAM}` 经 jatools `evalTemplate` **字符串拼接**进 SQL 后 `prepareStatement` 执行(无占位符绑定)→ 全参数 SQL 注入。引擎为预编译 jar 不可改,故全部在包装层收口(`ReportParamGuard` 等 11 个类、79 单测)。
|
||||||
|
|
||||||
|
**关键验证**:数值上下文注入 `?PROJECTID=0 union select…` → 400;IDOR 非超管越权 → 403、超管 bypass → 200;`maxResultBuffer` 经独立 JDBC 探针在同款 `TYPE_SCROLL_INSENSITIVE` 路径实证超限即抛非 OOM;CVE 替换后依赖树/运行时 classpath 实证生效、live HTML/PDF=200 无 ClassNotFound。
|
||||||
|
|
||||||
|
**仍开口(引擎/部署层)**:凭据外泄不可在渲染层修(模板 `<Connection>` 经同一 `property("DBPassword")` 解析口令,巡检脚本实测当前 326 模板 0 处泄露)→ 真 containment = 只读 DB 账号(脚本已交付 `platform-report/docs/security/`,待运维执行并配 `eip4.report.db.*`);结果集 OOM 对多并发非完全封顶(`maxResultBuffer` 是单查询上限×并发数);裸 `DriverManager` 连接池化未做;`bsh`(jatools fork)/`itext`(只生成不解析 PDF)/`xerces 2.6.2`(XXE 已被前置 DOCTYPE 拒绝兜住) 三 CVE 件不可换,已记录理由。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*本文为人工可读的进度权威;逐视图细目见 framework backlog + TODO,方法论/部署 recipe 见用户管理 Delta 移植交接文档,特性设计见 plans/ 下 06-19/06-20 三份 design。架构改进待办见 §10(2026-06-24 并入,取代已删除的《EIP4 架构分析与改进建议》)。*
|
||||||
21
flowable-service/Dockerfile
Normal file
21
flowable-service/Dockerfile
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
# flowable-service 生产镜像(A10 W2)。
|
||||||
|
# 前置:先 `mvn -pl flowable-service -am package -DskipTests` 产出 fat jar(见 deploy/README.md)。
|
||||||
|
FROM eclipse-temurin:21-jre
|
||||||
|
|
||||||
|
WORKDIR /app
|
||||||
|
COPY target/flowable-service-*.jar /app/app.jar
|
||||||
|
|
||||||
|
RUN useradd -r -u 10002 eip4flw \
|
||||||
|
&& chown -R 10002:10002 /app
|
||||||
|
USER 10002
|
||||||
|
|
||||||
|
ENV SPRING_PROFILES_ACTIVE=prod \
|
||||||
|
SERVER_PORT=8089 \
|
||||||
|
JAVA_OPTS=""
|
||||||
|
EXPOSE 8089
|
||||||
|
|
||||||
|
# flowable-service 未配 actuator,健康探针用 TCP 端口可达(bash /dev/tcp,temurin 基础镜像自带 bash)。
|
||||||
|
HEALTHCHECK --interval=15s --timeout=5s --start-period=90s --retries=12 \
|
||||||
|
CMD bash -c "echo > /dev/tcp/127.0.0.1/${SERVER_PORT}" || exit 1
|
||||||
|
|
||||||
|
ENTRYPOINT ["sh", "-c", "exec java $JAVA_OPTS -jar /app/app.jar"]
|
||||||
@@ -38,9 +38,11 @@ import com.dsasp.server.wf.support.WfTypes;
|
|||||||
* 仅用其 processInstanceId,经引擎运行时反查,避免对实现类的硬转型,与 PoC 桩同口径)。</li>
|
* 仅用其 processInstanceId,经引擎运行时反查,避免对实现类的硬转型,与 PoC 桩同口径)。</li>
|
||||||
* </ol>
|
* </ol>
|
||||||
*
|
*
|
||||||
* <p><b>当前未接入的分支(WARN 降级,报告登记):</b>{@code scriptUser}(JUEL 脚本,26 处,
|
* <p><b>分支覆盖现状:</b>{@code scriptUser}(JUEL 脚本)已于 2026-06-26 接入
|
||||||
* 需服务流脚本引擎,超独立服务精简边界)、{@code agentService} 代理人替换后处理(项目定制扩展)。
|
* {@link #resolveScriptUsers}(单变量直读流程变量 + 复杂表达式回退引擎 ExpressionManager 求值
|
||||||
* 占主导的 user/position/depart/formSpecifiedDimension/initiator 等类型(实测分布见报告)全部覆盖。</p>
|
* + coerceUserList 归一,支撑招投标/总包合同/施工技术交底等会签流的 {@code ${APPLYUSERS}});
|
||||||
|
* 占主导的 user/position/depart/formSpecifiedDimension/initiator 等类型(实测分布见报告)全部覆盖。
|
||||||
|
* <b>仍未接入:</b>{@code agentService} 代理人替换后处理(项目定制扩展,WARN 降级)。</p>
|
||||||
*/
|
*/
|
||||||
public class CandidateUsersHandler {
|
public class CandidateUsersHandler {
|
||||||
|
|
||||||
@@ -86,11 +88,11 @@ public class CandidateUsersHandler {
|
|||||||
? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER;
|
? WfTypes.INITIATORLEADER : WfTypes.INITIATORDEPARTMANAGER;
|
||||||
users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null);
|
users = directory.assignmentUser(t, userProperty.getContent(), beforeUser, null);
|
||||||
}else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){
|
}else if(WfTypes.SCRIPTUSER.equals(userProperty.getType())){
|
||||||
// 原版经 ScriptingEngines.evaluate(content,"juel",execution) 求值;
|
// scriptUser:content 为 JUEL 表达式(会签等多实例办理人集合多用此类型,绝大多数形如 ${VARNAME},
|
||||||
// 独立服务不内置服务流脚本引擎(精简边界),WARN 降级,报告登记。
|
// 如招投标/总包合同/施工技术交底会签的 ${APPLYUSERS})。原版经服务流脚本引擎求值;此处优先按
|
||||||
log.warn("candidateUsersHandler: scriptUser(JUEL 脚本)分支独立服务暂未接入,跳过该项"
|
// 单变量名直读流程变量(稳,无命令上下文依赖),复杂表达式回退 flowable 表达式管理器对 execution 求值,
|
||||||
+ "(影响面≈0.5%/26 处;命中则该任务无此类候选人,生产可监控)");
|
// 结果按 List/数组/逗号分隔串/单值归一为 userId 列表。修复前此分支 WARN 降级返空 → 这类会签节点无办理人被跳过。
|
||||||
users = new ArrayList<String>();
|
users = resolveScriptUsers(runtimeService, processInstanceId, execution, userProperty.getContent());
|
||||||
}else if(WfTypes.PROJECTROLETYPE.equals(userProperty.getType())){
|
}else if(WfTypes.PROJECTROLETYPE.equals(userProperty.getType())){
|
||||||
users = directory.getUsersByProjectRole(projectId, userProperty.getContent());
|
users = directory.getUsersByProjectRole(projectId, userProperty.getContent());
|
||||||
}
|
}
|
||||||
@@ -207,6 +209,93 @@ public class CandidateUsersHandler {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** {@code ${VAR}} 单变量名匹配(会签 scriptUser 绝大多数为此形态)。 */
|
||||||
|
private static final java.util.regex.Pattern SINGLE_VAR =
|
||||||
|
java.util.regex.Pattern.compile("\\$\\{\\s*([A-Za-z_][A-Za-z0-9_]*)\\s*\\}");
|
||||||
|
|
||||||
|
/**
|
||||||
|
* scriptUser 类型办理人解析:content 为 JUEL 表达式。绝大多数(含会签 {@code ${APPLYUSERS}})是单变量名,
|
||||||
|
* 优先直读该流程变量(稳,无命令上下文依赖);非单变量的复杂表达式回退 flowable 表达式管理器对 execution 求值。
|
||||||
|
* 结果按 List/数组/逗号分号(全/半角)分隔串/单值归一为去重 userId 列表;解析不出返回空(安全降级)。
|
||||||
|
*/
|
||||||
|
protected List<String> resolveScriptUsers(RuntimeService runtimeService, String processInstanceId,
|
||||||
|
Object execution, String content) {
|
||||||
|
if (content == null || content.isBlank()) {
|
||||||
|
return new ArrayList<String>();
|
||||||
|
}
|
||||||
|
Object value = null;
|
||||||
|
String varName = singleVarName(content);
|
||||||
|
if (varName != null && runtimeService != null && processInstanceId != null) {
|
||||||
|
value = getVariable(runtimeService, processInstanceId, varName);
|
||||||
|
}
|
||||||
|
if (value == null) {
|
||||||
|
value = evalExpression(execution, content);
|
||||||
|
}
|
||||||
|
List<String> users = coerceUserList(value);
|
||||||
|
if (users.isEmpty()) {
|
||||||
|
log.warn("candidateUsersHandler: scriptUser 表达式解析出空候选人 content={}(检查流程变量是否已设置)", content);
|
||||||
|
}
|
||||||
|
return users;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 单变量表达式 {@code ${VAR}} → 变量名;非单变量(复杂表达式/含运算)返回 null。 */
|
||||||
|
static String singleVarName(String content) {
|
||||||
|
if (content == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
java.util.regex.Matcher m = SINGLE_VAR.matcher(content.trim());
|
||||||
|
return m.matches() ? m.group(1) : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 把表达式求值结果归一为去重 userId 列表:支持 Collection/数组/逗号分号(全角半角)分隔串/单值。 */
|
||||||
|
static List<String> coerceUserList(Object value) {
|
||||||
|
List<String> out = new ArrayList<String>();
|
||||||
|
if (value == null) {
|
||||||
|
return out;
|
||||||
|
}
|
||||||
|
if (value instanceof java.util.Collection<?> col) {
|
||||||
|
for (Object o : col) {
|
||||||
|
addUser(out, o);
|
||||||
|
}
|
||||||
|
} else if (value instanceof Object[] arr) {
|
||||||
|
for (Object o : arr) {
|
||||||
|
addUser(out, o);
|
||||||
|
}
|
||||||
|
} else if (value instanceof String s) {
|
||||||
|
for (String part : s.split("[,;,;\\s]+")) {
|
||||||
|
addUser(out, part);
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
addUser(out, value);
|
||||||
|
}
|
||||||
|
return out;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static void addUser(List<String> out, Object o) {
|
||||||
|
if (o == null) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
String s = o.toString().trim();
|
||||||
|
if (!s.isEmpty() && !out.contains(s)) {
|
||||||
|
out.add(s);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 复杂 JUEL 表达式回退:命令上下文内经 flowable 表达式管理器对 execution(VariableScope)求值。 */
|
||||||
|
private Object evalExpression(Object execution, String content) {
|
||||||
|
try {
|
||||||
|
if (execution instanceof org.flowable.variable.api.delegate.VariableScope vs) {
|
||||||
|
var pec = org.flowable.engine.impl.context.Context.getProcessEngineConfiguration();
|
||||||
|
if (pec != null) {
|
||||||
|
return pec.getExpressionManager().createExpression(content).getValue(vs);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.warn("candidateUsersHandler: scriptUser 复杂表达式求值失败 content={}: {}", content, e.toString());
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
private static boolean isEmpty(String s) {
|
private static boolean isEmpty(String s) {
|
||||||
return s == null || s.trim().isEmpty();
|
return s == null || s.trim().isEmpty();
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -26,4 +26,10 @@ public class ApprovalContextDto {
|
|||||||
public boolean ended;
|
public boolean ended;
|
||||||
/** 任务/实例是否挂起(挂起不可办理)。 */
|
/** 任务/实例是否挂起(挂起不可办理)。 */
|
||||||
public boolean suspended;
|
public boolean suspended;
|
||||||
|
/** 是否会签(BPMN 多实例)任务:true 时下面三个计数有效,前端显「已会签 N/M」。 */
|
||||||
|
public boolean cosign;
|
||||||
|
/** 会签总人数(多实例 nrOfInstances)。 */
|
||||||
|
public int cosignTotal;
|
||||||
|
/** 会签已完成人数(多实例 nrOfCompletedInstances)。 */
|
||||||
|
public int cosignCompleted;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,134 @@
|
|||||||
|
package com.eip4.flowservice.api;
|
||||||
|
|
||||||
|
import java.util.LinkedHashMap;
|
||||||
|
import java.util.LinkedHashSet;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.Set;
|
||||||
|
import java.util.regex.Matcher;
|
||||||
|
import java.util.regex.Pattern;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* BPMN id 净化/还原(可逆双射)。
|
||||||
|
*
|
||||||
|
* <p>迁移的 1512 个真实流程里,1445 个的 process id 就是中文(如「总包合同交底」),BPMN 常把中文用作
|
||||||
|
* process/diagram/节点 id。bpmn-js / moddle 的 NCName 校验拒非 ASCII id → 整图无法渲染,且 moddle-xml
|
||||||
|
* 在 import 前就会拒中文 id。{@link #sanitize} 把非法(非 ASCII NCName)id 及其全部引用一致重写为安全
|
||||||
|
* ASCII id(稳定哈希),保存原→净化映射;{@link #restore} 依映射逆向还原——发布存量流程时把中文原 key
|
||||||
|
* 原样写回引擎,保证 process key 不变(D7 硬需求)。</p>
|
||||||
|
*
|
||||||
|
* <p><b>双射保证</b>:同一文档内两个不同中文 id 若哈希相同(Java String.hashCode 存在碰撞),基名冲突时
|
||||||
|
* 追加 {@code -2}/{@code -3} 序号;生成的净化 id 亦不与文档内既有合法 id 冲突。故净化后引用不串、restore
|
||||||
|
* 可精确逆向。<b>非碰撞场景</b>下净化输出与历史实现({@code "n"+hex(hashCode)})逐字节一致,保住查看器回归。</p>
|
||||||
|
*
|
||||||
|
* <p><b>restore 前缀安全</b>:还原一律复用 {@link #ID_ATTR} 正则逐个属性值精确匹配,绝不裸 {@code String.replace}
|
||||||
|
* 子串替换——否则净化 id {@code n1} 会误伤前缀相同的 {@code n1x}。映射外的 id(如设计器新增的 ASCII 节点)原样保留。</p>
|
||||||
|
*/
|
||||||
|
final class BpmnIdSanitizer {
|
||||||
|
|
||||||
|
private BpmnIdSanitizer() {
|
||||||
|
}
|
||||||
|
|
||||||
|
/** id/引用类属性(值须为合法 NCName);name/value 等展示属性不在内,避免改坏中文节点名。 */
|
||||||
|
static final Pattern ID_ATTR = Pattern.compile(
|
||||||
|
"\\b(id|bpmnElement|sourceRef|targetRef|attachedToRef|processRef|default)\\s*=\\s*\"([^\"]+)\"");
|
||||||
|
|
||||||
|
/** 净化结果:{@code xml}=净化后 XML;{@code idMap}=原 id→净化 id(双射,供 {@link #restore} 逆向)。 */
|
||||||
|
record Result(String xml, Map<String, String> idMap) {
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id。
|
||||||
|
* 只重写 id/引用类属性,name 等展示属性不动。返回净化 XML 与「原 id→净化 id」映射。
|
||||||
|
*/
|
||||||
|
static Result sanitize(String xml) {
|
||||||
|
if (xml == null || xml.isEmpty()) {
|
||||||
|
return new Result(xml, Map.of());
|
||||||
|
}
|
||||||
|
// 先登记文档内所有合法 id,占位保证生成的净化 id 不与既有合法 id 冲突(双射 + restore 安全)。
|
||||||
|
Set<String> used = new LinkedHashSet<>();
|
||||||
|
Matcher scanLegal = ID_ATTR.matcher(xml);
|
||||||
|
while (scanLegal.find()) {
|
||||||
|
String val = scanLegal.group(2);
|
||||||
|
if (isValidNcName(val)) {
|
||||||
|
used.add(val);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// 收集非法 id → 唯一净化 id;基名冲突(含 hash 碰撞)时追加 -2/-3… 保双射。
|
||||||
|
Map<String, String> map = new LinkedHashMap<>();
|
||||||
|
Matcher scan = ID_ATTR.matcher(xml);
|
||||||
|
while (scan.find()) {
|
||||||
|
String val = scan.group(2);
|
||||||
|
if (!isValidNcName(val) && !map.containsKey(val)) {
|
||||||
|
String base = "n" + Integer.toHexString(val.hashCode() & 0x7fffffff);
|
||||||
|
String safe = base;
|
||||||
|
int seq = 2;
|
||||||
|
while (used.contains(safe)) {
|
||||||
|
safe = base + "-" + seq++;
|
||||||
|
}
|
||||||
|
map.put(val, safe);
|
||||||
|
used.add(safe);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (map.isEmpty()) {
|
||||||
|
return new Result(xml, Map.of());
|
||||||
|
}
|
||||||
|
return new Result(rewrite(xml, map), map);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 依 {@code idMap}(原→净化)逆向还原:把净化 id 精确写回原 id。映射外的 id(如新增 ASCII 节点)原样保留。
|
||||||
|
* 逐个属性值精确匹配(复用 {@link #ID_ATTR}),前缀安全。
|
||||||
|
*/
|
||||||
|
static String restore(String xml, Map<String, String> idMap) {
|
||||||
|
if (xml == null || xml.isEmpty() || idMap == null || idMap.isEmpty()) {
|
||||||
|
return xml;
|
||||||
|
}
|
||||||
|
// 反转前校验双射:idMap 值(净化 id)重复会让 inverse 静默覆盖 → 还原错。fail-fast
|
||||||
|
// (T2.1 起 idMap 从 metaInfo JSON 反序列化,损坏数据须炸不能静默还原成别的 key)。
|
||||||
|
Map<String, String> inverse = new LinkedHashMap<>();
|
||||||
|
for (Map.Entry<String, String> e : idMap.entrySet()) {
|
||||||
|
String clash = inverse.put(e.getValue(), e.getKey());
|
||||||
|
if (clash != null) {
|
||||||
|
throw new IllegalArgumentException("idMap 非双射:净化 id \"" + e.getValue()
|
||||||
|
+ "\" 同时映射自 \"" + clash + "\" 与 \"" + e.getKey() + "\"");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return rewrite(xml, inverse);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。
|
||||||
|
* 未改值的属性原样回写(append group(0) 原文),不重构 → 不归一 {@code id = "x"} 这类等号周围空白,保逐字节契约。
|
||||||
|
*/
|
||||||
|
private static String rewrite(String xml, Map<String, String> map) {
|
||||||
|
Matcher rw = ID_ATTR.matcher(xml);
|
||||||
|
StringBuilder sb = new StringBuilder();
|
||||||
|
while (rw.find()) {
|
||||||
|
String val = rw.group(2);
|
||||||
|
String repl = map.getOrDefault(val, val);
|
||||||
|
String replacement = repl.equals(val) ? rw.group(0) : rw.group(1) + "=\"" + repl + "\"";
|
||||||
|
rw.appendReplacement(sb, Matcher.quoteReplacement(replacement));
|
||||||
|
}
|
||||||
|
rw.appendTail(sb);
|
||||||
|
return sb.toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** ASCII NCName:首字符字母/下划线,其余字母/数字/下划线/连字符/点;非 ASCII(中文等)视为非法。 */
|
||||||
|
private static boolean isValidNcName(String s) {
|
||||||
|
if (s == null || s.isEmpty()) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
char c0 = s.charAt(0);
|
||||||
|
if (!((c0 >= 'A' && c0 <= 'Z') || (c0 >= 'a' && c0 <= 'z') || c0 == '_')) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
for (int i = 1; i < s.length(); i++) {
|
||||||
|
char c = s.charAt(i);
|
||||||
|
if (!((c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9')
|
||||||
|
|| c == '_' || c == '-' || c == '.')) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -40,6 +40,8 @@ public class FlowController {
|
|||||||
/** 默认审批流程 key:命名流程定义未部署时回退到此,保「提交审批」闭环可走(dev 无客户 BPMN 时)。 */
|
/** 默认审批流程 key:命名流程定义未部署时回退到此,保「提交审批」闭环可走(dev 无客户 BPMN 时)。 */
|
||||||
private static final String DEFAULT_APPROVAL_KEY = "EIP4_DEFAULT_APPROVAL";
|
private static final String DEFAULT_APPROVAL_KEY = "EIP4_DEFAULT_APPROVAL";
|
||||||
private static final int STATUS_PROCESSING = 2;
|
private static final int STATUS_PROCESSING = 2;
|
||||||
|
/** 协办/转阅单次最多派发人数(防滥用刷任务,对齐人工选人场景的合理上限)。 */
|
||||||
|
private static final int MAX_FANOUT = 50;
|
||||||
private static final Set<String> WITHDRAW_COMMENT_WHITELIST =
|
private static final Set<String> WITHDRAW_COMMENT_WHITELIST =
|
||||||
Set.of("回退", "主动召回", "更换任务处理人员");
|
Set.of("回退", "主动召回", "更换任务处理人员");
|
||||||
|
|
||||||
@@ -437,6 +439,168 @@ public class FlowController {
|
|||||||
return ResponseEntity.ok(t != null ? TaskDto.of(t) : null);
|
return ResponseEntity.ok(t != null ? TaskDto.of(t) : null);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@PostMapping("/tasks/{taskId}/assist")
|
||||||
|
@org.springframework.transaction.annotation.Transactional
|
||||||
|
@Operation(summary = "协办(加签)",
|
||||||
|
description = "对齐老 ProcessCoreServiceImpl.createSubTask:为每个目标用户建一条独立子任务"
|
||||||
|
+ "(assignee=该用户,parentTaskId=当前任务,name=协办,formKey=父任务formKey 以便协办人渲染业务单据),父任务记意见。"
|
||||||
|
+ "子任务进协办人待办,办毕各自 complete,不阻断主任务办理。父任务不存在 → 404,targetUserIds 为空 → 400,超 "
|
||||||
|
+ MAX_FANOUT + " 人 → 400。整批 @Transactional 原子。")
|
||||||
|
public ResponseEntity<Map<String, Object>> assist(@PathVariable String taskId,
|
||||||
|
@RequestBody(required = false) Requests.ActionRequest req) {
|
||||||
|
List<String> userIds = targetUserIds(req);
|
||||||
|
ResponseEntity<Map<String, Object>> bad = validateFanout(userIds, "协办");
|
||||||
|
if (bad != null) {
|
||||||
|
return bad;
|
||||||
|
}
|
||||||
|
var parent = taskService.createTaskQuery().taskId(taskId).singleResult();
|
||||||
|
if (parent == null) {
|
||||||
|
return ResponseEntity.notFound().build();
|
||||||
|
}
|
||||||
|
// 协办子任务也带 formKey(取父任务 formKey),使协办人打开能渲染同一业务单据。
|
||||||
|
String formKey = formKeyResolver.resolve(parent.getFormKey(),
|
||||||
|
parent.getProcessDefinitionId(), parent.getTaskDefinitionKey());
|
||||||
|
addCommentIfPresent(taskId, parent, req == null ? null : req.comment);
|
||||||
|
for (String userId : userIds) {
|
||||||
|
org.flowable.task.api.Task sub = taskService.newTask();
|
||||||
|
sub.setAssignee(userId);
|
||||||
|
sub.setParentTaskId(taskId);
|
||||||
|
sub.setName("协办");
|
||||||
|
if (formKey != null) {
|
||||||
|
sub.setFormKey(formKey);
|
||||||
|
}
|
||||||
|
taskService.saveTask(sub);
|
||||||
|
}
|
||||||
|
Map<String, Object> r = new java.util.LinkedHashMap<>();
|
||||||
|
r.put("assisted", true);
|
||||||
|
r.put("count", userIds.size());
|
||||||
|
r.put("taskId", taskId);
|
||||||
|
return ResponseEntity.ok(r);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/tasks/{taskId}/circulate")
|
||||||
|
@org.springframework.transaction.annotation.Transactional
|
||||||
|
@Operation(summary = "转阅(抄送)",
|
||||||
|
description = "对齐老 ProcessCoreServiceImpl.createNewTask:为每个目标用户建一条只读转阅任务"
|
||||||
|
+ "(name=转阅,assignee=该用户,parentTaskId=当前任务,formKey=父任务formKey 以便转阅人渲染同一业务单据)。"
|
||||||
|
+ "转阅不阻断、不推进主流程。父任务不存在 → 404,targetUserIds 为空 → 400,超 " + MAX_FANOUT
|
||||||
|
+ " 人 → 400。整批 @Transactional 原子。")
|
||||||
|
public ResponseEntity<Map<String, Object>> circulate(@PathVariable String taskId,
|
||||||
|
@RequestBody(required = false) Requests.ActionRequest req) {
|
||||||
|
List<String> userIds = targetUserIds(req);
|
||||||
|
ResponseEntity<Map<String, Object>> bad = validateFanout(userIds, "转阅");
|
||||||
|
if (bad != null) {
|
||||||
|
return bad;
|
||||||
|
}
|
||||||
|
var parent = taskService.createTaskQuery().taskId(taskId).singleResult();
|
||||||
|
if (parent == null) {
|
||||||
|
return ResponseEntity.notFound().build();
|
||||||
|
}
|
||||||
|
String formKey = formKeyResolver.resolve(parent.getFormKey(),
|
||||||
|
parent.getProcessDefinitionId(), parent.getTaskDefinitionKey());
|
||||||
|
addCommentIfPresent(taskId, parent, req == null ? null : req.comment);
|
||||||
|
for (String userId : userIds) {
|
||||||
|
org.flowable.task.api.Task copy = taskService.newTask();
|
||||||
|
copy.setName("转阅");
|
||||||
|
copy.setAssignee(userId);
|
||||||
|
// 用 setFormKey(而非塞 description)使审批渲染路径 FormKeyResolver 直接命中。
|
||||||
|
if (formKey != null) {
|
||||||
|
copy.setFormKey(formKey);
|
||||||
|
}
|
||||||
|
copy.setParentTaskId(taskId);
|
||||||
|
taskService.saveTask(copy);
|
||||||
|
}
|
||||||
|
Map<String, Object> r = new java.util.LinkedHashMap<>();
|
||||||
|
r.put("circulated", true);
|
||||||
|
r.put("count", userIds.size());
|
||||||
|
r.put("taskId", taskId);
|
||||||
|
return ResponseEntity.ok(r);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 协办/转阅派发人数校验:空 → 400「需指定」;超 {@link #MAX_FANOUT} → 400。合法返回 null。 */
|
||||||
|
private ResponseEntity<Map<String, Object>> validateFanout(List<String> userIds, String verb) {
|
||||||
|
if (userIds.isEmpty()) {
|
||||||
|
return ResponseEntity.badRequest().body(errorBody(verb + "需指定 targetUserIds"));
|
||||||
|
}
|
||||||
|
if (userIds.size() > MAX_FANOUT) {
|
||||||
|
return ResponseEntity.badRequest().body(errorBody(verb + "人数超过上限 " + MAX_FANOUT));
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 协办/转阅目标用户:优先 targetUserIds 列表,回退单个 targetUserId;去空白去重。 */
|
||||||
|
private static List<String> targetUserIds(Requests.ActionRequest req) {
|
||||||
|
java.util.LinkedHashSet<String> set = new java.util.LinkedHashSet<>();
|
||||||
|
if (req != null && req.targetUserIds != null) {
|
||||||
|
for (String u : req.targetUserIds) {
|
||||||
|
if (u != null && !u.isBlank()) {
|
||||||
|
set.add(u.trim());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (req != null && req.targetUserId != null && !req.targetUserId.isBlank()) {
|
||||||
|
set.add(req.targetUserId.trim());
|
||||||
|
}
|
||||||
|
return new java.util.ArrayList<>(set);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 父任务存在且意见非空时记入流程评论(对齐老 addComment:用父任务的 processInstanceId)。 */
|
||||||
|
private void addCommentIfPresent(String taskId, org.flowable.task.api.Task parent, String comment) {
|
||||||
|
if (parent != null && comment != null && !comment.isBlank()) {
|
||||||
|
taskService.addComment(taskId, parent.getProcessInstanceId(), comment);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 父任务回溯出的业务上下文(供协办/转阅独立任务渲染同一业务单据)。 */
|
||||||
|
private record ParentContext(String processInstanceId, String formKey,
|
||||||
|
String processDefinitionId, String taskDefinitionKey) {
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 按 parentTaskId 取父任务的业务上下文:运行库优先,否则历史库;都查不到返回 null。 */
|
||||||
|
private ParentContext resolveParentContext(String parentTaskId) {
|
||||||
|
var p = taskService.createTaskQuery().taskId(parentTaskId).singleResult();
|
||||||
|
if (p != null) {
|
||||||
|
return new ParentContext(p.getProcessInstanceId(), p.getFormKey(),
|
||||||
|
p.getProcessDefinitionId(), p.getTaskDefinitionKey());
|
||||||
|
}
|
||||||
|
HistoricTaskInstance hp = historyService.createHistoricTaskInstanceQuery()
|
||||||
|
.taskId(parentTaskId).singleResult();
|
||||||
|
if (hp != null) {
|
||||||
|
return new ParentContext(hp.getProcessInstanceId(), hp.getFormKey(),
|
||||||
|
hp.getProcessDefinitionId(), hp.getTaskDefinitionKey());
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static boolean isBlank(String s) {
|
||||||
|
return s == null || s.isBlank();
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 会签(BPMN 多实例)进度:沿执行树从任务执行向上找带 {@code nrOfInstances} 局部变量的多实例根执行,
|
||||||
|
* 读总人数/已完成数填入 dto(前端显「已会签 N/M」)。非多实例任务找不到 → 不改 dto(cosign=false)。
|
||||||
|
*/
|
||||||
|
private void fillCosign(ApprovalContextDto dto, String executionId) {
|
||||||
|
String execId = executionId;
|
||||||
|
for (int depth = 0; depth < 12 && !isBlank(execId); depth++) {
|
||||||
|
Map<String, Object> locals;
|
||||||
|
try {
|
||||||
|
locals = runtimeService.getVariablesLocal(execId);
|
||||||
|
} catch (RuntimeException e) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
if (locals != null && locals.get("nrOfInstances") instanceof Number total) {
|
||||||
|
dto.cosign = true;
|
||||||
|
dto.cosignTotal = total.intValue();
|
||||||
|
dto.cosignCompleted = locals.get("nrOfCompletedInstances") instanceof Number done
|
||||||
|
? done.intValue() : 0;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
var exec = runtimeService.createExecutionQuery().executionId(execId).singleResult();
|
||||||
|
execId = exec != null ? exec.getParentId() : null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
@GetMapping("/tasks/{taskId}/approval-context")
|
@GetMapping("/tasks/{taskId}/approval-context")
|
||||||
@Operation(summary = "任务审批上下文",
|
@Operation(summary = "任务审批上下文",
|
||||||
description = "聚合返回 WfTemplate 驱动审批界面所需事实:formKey(=view_wftemplate_id,经 FormKeyResolver 历史回补)、"
|
description = "聚合返回 WfTemplate 驱动审批界面所需事实:formKey(=view_wftemplate_id,经 FormKeyResolver 历史回补)、"
|
||||||
@@ -453,13 +617,49 @@ public class FlowController {
|
|||||||
dto.processDefinitionId = t.getProcessDefinitionId();
|
dto.processDefinitionId = t.getProcessDefinitionId();
|
||||||
dto.taskDefinitionKey = t.getTaskDefinitionKey();
|
dto.taskDefinitionKey = t.getTaskDefinitionKey();
|
||||||
dto.suspended = t.isSuspended();
|
dto.suspended = t.isSuspended();
|
||||||
dto.formKey = formKeyResolver.resolve(t.getFormKey(), t.getProcessDefinitionId(), t.getTaskDefinitionKey());
|
fillCosign(dto, t.getExecutionId());
|
||||||
dto.startFormKey = startFormKeyResolver.resolve(t.getProcessDefinitionId());
|
|
||||||
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
|
String formKeyRaw = t.getFormKey();
|
||||||
.processInstanceId(t.getProcessInstanceId()).singleResult();
|
String procDefId = t.getProcessDefinitionId();
|
||||||
if (pi != null) {
|
String taskDefKey = t.getTaskDefinitionKey();
|
||||||
dto.businessKey = pi.getBusinessKey();
|
String pid = t.getProcessInstanceId();
|
||||||
dto.ended = false;
|
|
||||||
|
// 协办/转阅是独立任务(无 processInstanceId/businessKey):沿 parentTaskId 回溯父任务取业务上下文,
|
||||||
|
// 使协办人/转阅人打开能渲染同一业务单据。同时避免下面用 null pid 查 runtime 抛 IllegalArgument。
|
||||||
|
if (isBlank(pid) && !isBlank(t.getParentTaskId())) {
|
||||||
|
ParentContext pc = resolveParentContext(t.getParentTaskId());
|
||||||
|
if (pc != null) {
|
||||||
|
pid = pc.processInstanceId();
|
||||||
|
if (isBlank(formKeyRaw)) {
|
||||||
|
formKeyRaw = pc.formKey();
|
||||||
|
}
|
||||||
|
if (isBlank(procDefId)) {
|
||||||
|
procDefId = pc.processDefinitionId();
|
||||||
|
}
|
||||||
|
if (isBlank(taskDefKey)) {
|
||||||
|
taskDefKey = pc.taskDefinitionKey();
|
||||||
|
}
|
||||||
|
dto.processInstanceId = pid; // 让前端轨迹/business-data 能定位父流程
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
dto.formKey = formKeyResolver.resolve(formKeyRaw, procDefId, taskDefKey);
|
||||||
|
dto.startFormKey = startFormKeyResolver.resolve(procDefId);
|
||||||
|
if (!isBlank(pid)) {
|
||||||
|
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
|
||||||
|
.processInstanceId(pid).singleResult();
|
||||||
|
if (pi != null) {
|
||||||
|
dto.businessKey = pi.getBusinessKey();
|
||||||
|
dto.ended = false;
|
||||||
|
} else {
|
||||||
|
// 父流程可能已进历史(协办/转阅后主流程已结束)
|
||||||
|
var hpi = historyService.createHistoricProcessInstanceQuery()
|
||||||
|
.processInstanceId(pid).singleResult();
|
||||||
|
if (hpi != null) {
|
||||||
|
dto.businessKey = hpi.getBusinessKey();
|
||||||
|
dto.ended = hpi.getEndTime() != null;
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
return ResponseEntity.ok(dto);
|
return ResponseEntity.ok(dto);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,202 @@
|
|||||||
|
package com.eip4.flowservice.api;
|
||||||
|
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.LinkedHashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
|
import org.flowable.engine.HistoryService;
|
||||||
|
import org.flowable.engine.RepositoryService;
|
||||||
|
import org.flowable.engine.RuntimeService;
|
||||||
|
import org.flowable.engine.history.HistoricProcessInstance;
|
||||||
|
import org.flowable.engine.repository.ProcessDefinition;
|
||||||
|
import org.flowable.engine.runtime.ProcessInstance;
|
||||||
|
import org.slf4j.Logger;
|
||||||
|
import org.slf4j.LoggerFactory;
|
||||||
|
import org.springframework.http.ResponseEntity;
|
||||||
|
import org.springframework.util.StreamUtils;
|
||||||
|
import org.springframework.web.bind.annotation.GetMapping;
|
||||||
|
import org.springframework.web.bind.annotation.PathVariable;
|
||||||
|
import org.springframework.web.bind.annotation.RequestMapping;
|
||||||
|
import org.springframework.web.bind.annotation.RestController;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.Operation;
|
||||||
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 流程图(BPMN)查看端点:返回流程定义的 BPMN 2.0 XML + 当前/历史活动节点,供前端 bpmn-js 渲染并高亮。
|
||||||
|
*
|
||||||
|
* <p>迁移的 1512 个流程定义中 1501(99.3%)含 BPMNDI 布局段,bpmn-js 可直接据此排版。
|
||||||
|
* 节点名为中文 → 用前端 bpmn-js(浏览器字体)而非服务端出图(PNG 中文易乱码且需服务器字体)。</p>
|
||||||
|
*
|
||||||
|
* <p>只读:仅查询引擎,不改任何流程/任务/业务数据。运行中实例取运行库 procDefId 与当前节点;
|
||||||
|
* 已结束实例回退历史库取 procDefId(无当前节点)。实例不存在返回 {@code found=false}(前端降级)。</p>
|
||||||
|
*/
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/api/flow")
|
||||||
|
@Tag(name = "流程图", description = "BPMN XML + 当前/历史节点(bpmn-js 渲染高亮)")
|
||||||
|
public class ProcessDiagramController {
|
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(ProcessDiagramController.class);
|
||||||
|
|
||||||
|
private final RepositoryService repositoryService;
|
||||||
|
private final RuntimeService runtimeService;
|
||||||
|
private final HistoryService historyService;
|
||||||
|
|
||||||
|
public ProcessDiagramController(RepositoryService repositoryService, RuntimeService runtimeService,
|
||||||
|
HistoryService historyService) {
|
||||||
|
this.repositoryService = repositoryService;
|
||||||
|
this.runtimeService = runtimeService;
|
||||||
|
this.historyService = historyService;
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/process/{processInstanceId}/diagram")
|
||||||
|
@Operation(summary = "流程图数据",
|
||||||
|
description = "返回 {found, bpmnXml, activeActivityIds(当前停留), finishedActivityIds(已走过)}。"
|
||||||
|
+ "运行中实例取运行库 procDefId + getActiveActivityIds;已结束取历史库 procDefId(无当前节点);"
|
||||||
|
+ "实例不存在 found=false。bpmnXml = repositoryService.getProcessModel(procDefId)。")
|
||||||
|
public ResponseEntity<Map<String, Object>> diagram(@PathVariable String processInstanceId) {
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("processInstanceId", processInstanceId);
|
||||||
|
|
||||||
|
// procDefId:运行库优先(含当前活动节点),否则历史库(已结束)
|
||||||
|
ProcessInstance pi = runtimeService.createProcessInstanceQuery()
|
||||||
|
.processInstanceId(processInstanceId).singleResult();
|
||||||
|
String procDefId = pi != null ? pi.getProcessDefinitionId() : null;
|
||||||
|
boolean running = pi != null;
|
||||||
|
if (procDefId == null) {
|
||||||
|
HistoricProcessInstance hpi = historyService.createHistoricProcessInstanceQuery()
|
||||||
|
.processInstanceId(processInstanceId).singleResult();
|
||||||
|
procDefId = hpi != null ? hpi.getProcessDefinitionId() : null;
|
||||||
|
}
|
||||||
|
if (procDefId == null) {
|
||||||
|
resp.put("found", false);
|
||||||
|
resp.put("activeActivityIds", List.of());
|
||||||
|
resp.put("finishedActivityIds", List.of());
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
String bpmnXml = readProcessModel(procDefId);
|
||||||
|
if (bpmnXml == null) {
|
||||||
|
resp.put("found", false);
|
||||||
|
resp.put("activeActivityIds", List.of());
|
||||||
|
resp.put("finishedActivityIds", List.of());
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
// 当前停留节点(仅运行中实例有)
|
||||||
|
List<String> active = running ? safeActiveActivityIds(processInstanceId) : List.of();
|
||||||
|
// 已走过的历史节点
|
||||||
|
List<String> finished = historyService.createHistoricActivityInstanceQuery()
|
||||||
|
.processInstanceId(processInstanceId).finished().list().stream()
|
||||||
|
.map(a -> a.getActivityId())
|
||||||
|
.filter(id -> id != null && !id.isBlank())
|
||||||
|
.distinct()
|
||||||
|
.collect(Collectors.toList());
|
||||||
|
|
||||||
|
// 迁移的 BPMN 常用中文做 process/diagram id(如「招投标工程评审流程」),bpmn-js/moddle 的 NCName
|
||||||
|
// 校验拒非 ASCII id → 整图「no diagram to display」。服务端把非法 id 及其所有引用一致重写为安全 ASCII id
|
||||||
|
// (只动 id/ref 类属性,不碰 name;活动 id 多为 sid-* 合法),并同步重映射当前/历史节点 id。
|
||||||
|
List<String> mutableActive = new java.util.ArrayList<>(active);
|
||||||
|
List<String> mutableFinished = new java.util.ArrayList<>(finished);
|
||||||
|
String safeXml = sanitizeBpmnIds(bpmnXml, mutableActive, mutableFinished);
|
||||||
|
|
||||||
|
resp.put("found", true);
|
||||||
|
resp.put("bpmnXml", safeXml);
|
||||||
|
resp.put("activeActivityIds", mutableActive);
|
||||||
|
resp.put("finishedActivityIds", mutableFinished);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/process-definitions/{procDefId}/source")
|
||||||
|
@Operation(summary = "按流程定义 id 取净化源 XML",
|
||||||
|
description = "返回 {procDefId, found, bpmnXml(净化后), idMap(原id→净化id), procDefKey, version},供 bpmn-js Modeler 在线编辑载入。"
|
||||||
|
+ "流程定义不存在 / BPMN 读取失败或为空 → found=false(HTTP 200,前端降级)。"
|
||||||
|
+ "中文 process id 经 BpmnIdSanitizer 可逆净化,idMap 供发布时逆向还原原 key(D7)。")
|
||||||
|
public ResponseEntity<Map<String, Object>> source(@PathVariable String procDefId) {
|
||||||
|
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
|
||||||
|
.processDefinitionId(procDefId).singleResult();
|
||||||
|
return sourceResponse(procDefId, def);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/process-definitions/by-key/{key}/source")
|
||||||
|
@Operation(summary = "按流程 key 取最新版净化源 XML",
|
||||||
|
description = "返回与 by-id 端点完全相同的形状 {procDefId, found, bpmnXml, idMap, procDefKey, version},"
|
||||||
|
+ "供 Modeler 打开器按真流程 key 载入(process-select 的 source='model' 项 id 是 act_re_model id 而非 procDefId,"
|
||||||
|
+ "by-id 永远 found:false → 改用本端点)。processDefinitionKey(key).latestVersion() 取最新版,key 不存在 found:false。")
|
||||||
|
public ResponseEntity<Map<String, Object>> sourceByKey(@PathVariable String key) {
|
||||||
|
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
|
||||||
|
.processDefinitionKey(key).latestVersion().singleResult();
|
||||||
|
String procDefId = def == null ? null : def.getId();
|
||||||
|
return sourceResponse(procDefId, def);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 按已解析的流程定义构建源响应(by-id / by-key 共用,逻辑单一不复制):净化 XML + 原→净化 idMap + key/version。
|
||||||
|
* {@code def==null}(不存在)或 BPMN 空/读失败 → {@code found:false}(HTTP 200,前端降级)。
|
||||||
|
* {@code procDefId} 是读取部署 BPMN 资源用的定义 id(by-id=入参、by-key=解析出的最新版 id),命中时随响应回显。
|
||||||
|
*/
|
||||||
|
private ResponseEntity<Map<String, Object>> sourceResponse(String procDefId, ProcessDefinition def) {
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
if (procDefId != null) {
|
||||||
|
resp.put("procDefId", procDefId);
|
||||||
|
}
|
||||||
|
if (def == null) {
|
||||||
|
resp.put("found", false);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
String bpmnXml = readProcessModel(procDefId);
|
||||||
|
if (bpmnXml == null || bpmnXml.isBlank()) {
|
||||||
|
log.warn("[流程源] BPMN 为空或读取失败 procDefId={}", procDefId);
|
||||||
|
resp.put("found", false);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(bpmnXml);
|
||||||
|
resp.put("found", true);
|
||||||
|
resp.put("bpmnXml", r.xml());
|
||||||
|
resp.put("idMap", r.idMap());
|
||||||
|
resp.put("procDefKey", def.getKey());
|
||||||
|
resp.put("version", def.getVersion());
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 把 BPMN 里非法(非 ASCII NCName)的 id 及其全部引用一致重写为安全 ASCII id,使 bpmn-js 能解析渲染,
|
||||||
|
* 并同步重映射 active/finished 节点 id。净化算法委托 {@link BpmnIdSanitizer}(含可逆映射与 hash 碰撞消解)。
|
||||||
|
*/
|
||||||
|
static String sanitizeBpmnIds(String xml, List<String> active, List<String> finished) {
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
Map<String, String> map = r.idMap();
|
||||||
|
active.replaceAll(id -> map.getOrDefault(id, id));
|
||||||
|
finished.replaceAll(id -> map.getOrDefault(id, id));
|
||||||
|
return r.xml();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 读流程定义 BPMN XML(getProcessModel 返回部署的 BPMN 资源流)。读失败返回 null(前端降级)。 */
|
||||||
|
private String readProcessModel(String procDefId) {
|
||||||
|
try (InputStream is = repositoryService.getProcessModel(procDefId)) {
|
||||||
|
if (is == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return StreamUtils.copyToString(is, StandardCharsets.UTF_8);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.warn("[流程图] 读取 BPMN 失败 procDefId={}: {}", procDefId, e.toString());
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** getActiveActivityIds 对已结束/不存在实例会抛异常 → 包裹降级为空。 */
|
||||||
|
private List<String> safeActiveActivityIds(String processInstanceId) {
|
||||||
|
try {
|
||||||
|
List<String> ids = runtimeService.getActiveActivityIds(processInstanceId);
|
||||||
|
return ids == null ? List.of() : ids;
|
||||||
|
} catch (RuntimeException e) {
|
||||||
|
log.debug("[流程图] 取当前节点降级 pi={}: {}", processInstanceId, e.toString());
|
||||||
|
return List.of();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,620 @@
|
|||||||
|
package com.eip4.flowservice.api;
|
||||||
|
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.Date;
|
||||||
|
import java.util.LinkedHashMap;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
import java.util.regex.Pattern;
|
||||||
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
|
import org.flowable.bpmn.converter.BpmnXMLConverter;
|
||||||
|
import org.flowable.bpmn.model.BpmnModel;
|
||||||
|
import org.flowable.common.engine.impl.util.io.StringStreamSource;
|
||||||
|
import org.flowable.engine.RepositoryService;
|
||||||
|
import org.flowable.engine.RuntimeService;
|
||||||
|
import org.flowable.engine.repository.Model;
|
||||||
|
import org.flowable.engine.repository.ProcessDefinition;
|
||||||
|
import org.flowable.validation.ProcessValidator;
|
||||||
|
import org.flowable.validation.ProcessValidatorFactory;
|
||||||
|
import org.flowable.validation.ValidationError;
|
||||||
|
import org.slf4j.Logger;
|
||||||
|
import org.slf4j.LoggerFactory;
|
||||||
|
import org.springframework.beans.factory.annotation.Autowired;
|
||||||
|
import org.springframework.http.HttpStatus;
|
||||||
|
import org.springframework.http.ResponseEntity;
|
||||||
|
import org.springframework.util.StreamUtils;
|
||||||
|
import org.springframework.web.bind.annotation.DeleteMapping;
|
||||||
|
import org.springframework.web.bind.annotation.GetMapping;
|
||||||
|
import org.springframework.web.bind.annotation.PathVariable;
|
||||||
|
import org.springframework.web.bind.annotation.PostMapping;
|
||||||
|
import org.springframework.web.bind.annotation.PutMapping;
|
||||||
|
import org.springframework.web.bind.annotation.RequestBody;
|
||||||
|
import org.springframework.web.bind.annotation.RequestMapping;
|
||||||
|
import org.springframework.web.bind.annotation.RestController;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.core.type.TypeReference;
|
||||||
|
import com.fasterxml.jackson.databind.ObjectMapper;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.Operation;
|
||||||
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 流程草稿 CRUD(flowable 原生 Model API 存 act_re_model,本控制器为全仓首次启用 Model API)。
|
||||||
|
*
|
||||||
|
* <p>在线 Modeler 的草稿仓:编辑中的 BPMN 存为 flowable Model(editorSource=BPMN XML,metaInfo=EIP4 元数据 JSON),
|
||||||
|
* 不进部署库;发布(T3.1)时才 restore 中文原 key + 校验门 + deploy。act_re_model 表已有 143 行存量、schema 已在,
|
||||||
|
* {@code databaseSchemaUpdate=false} 不涉 DDL。</p>
|
||||||
|
*
|
||||||
|
* <p><b>存量隔离</b>:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类,
|
||||||
|
* 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。</p>
|
||||||
|
*
|
||||||
|
* <p>写入前 XML 一律过解析守卫({@link #parseGuard}):①字节级拒 DOCTYPE(XXE 门);②{@link BpmnXMLConverter}
|
||||||
|
* 以 {@code validateSchema=false}(草稿是半成品,不做严格 XSD——bpmn-js 默认命名空间输出与严格 XSD 已知固有不兼容,
|
||||||
|
* 完整校验属部署门)+ {@code enableSafeBpmnXml=true}(加固解析器,双保险防外部实体)解析。坏 XML 返 422 且绝不落库;
|
||||||
|
* 422 只回通用文案,原始解析原因仅进日志。守卫异常就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}
|
||||||
|
* (那里 FlowableException→400,语义不符)。
|
||||||
|
* {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法,
|
||||||
|
* 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿,
|
||||||
|
* 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。</p>
|
||||||
|
*
|
||||||
|
* <p><b>鉴权</b>:本控制器随 flowable-service 跑在裸 8089,进程本身无鉴权栈;所有写端点
|
||||||
|
* (POST/PUT/from-procdef)必须经 platform-flow-gateway 的超管门访问(T2.2),生产环境 8089 不对外暴露。</p>
|
||||||
|
*/
|
||||||
|
@RestController
|
||||||
|
@RequestMapping("/api/flow")
|
||||||
|
@Tag(name = "流程草稿", description = "flowable Model API 草稿 CRUD(act_re_model)+ 从流程定义建草稿")
|
||||||
|
public class ProcessModelController {
|
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(ProcessModelController.class);
|
||||||
|
|
||||||
|
/** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */
|
||||||
|
static final String EIP4_CATEGORY = "eip4";
|
||||||
|
|
||||||
|
/** DOCTYPE 门 prolog 扫描字节上限(BOM/XML 声明/注释/DOCTYPE 都在最前)。 */
|
||||||
|
private static final int PROLOG_SCAN_BYTES = 8192;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* bpmn-js {@code saveXML} 补的 {@code <*:incoming>/<*:outgoing>} 文本引用元素(前缀可选:bpmn/bpmn2/默认)。
|
||||||
|
* 发布前整体剥除——Flowable 从 {@code sequenceFlow} 的 sourceRef/targetRef 自行推导入出边,这些元素冗余;
|
||||||
|
* 且它们把节点/流 id 存为<b>元素文本</b>(非属性),{@link BpmnIdSanitizer#restore} 只还原属性位不碰文本
|
||||||
|
* → 不剥则落库「属性=中文原 key、文本引用=净化 id」的脏 XML(T1.3 评审 I-2)。
|
||||||
|
*/
|
||||||
|
private static final Pattern FLOW_REF_ELEMENT = Pattern.compile(
|
||||||
|
"<(?:[\\w.-]+:)?(?:incoming|outgoing)>[^<]*</(?:[\\w.-]+:)?(?:incoming|outgoing)>");
|
||||||
|
|
||||||
|
private final RepositoryService repositoryService;
|
||||||
|
private final RuntimeService runtimeService;
|
||||||
|
private final ProcessValidator processValidator;
|
||||||
|
private final ObjectMapper objectMapper = new ObjectMapper();
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
public ProcessModelController(RepositoryService repositoryService, RuntimeService runtimeService) {
|
||||||
|
this(repositoryService, runtimeService, new ProcessValidatorFactory().createDefaultProcessValidator());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 单参构造:既有草稿 CRUD 单测保留零改动地 {@code new ProcessModelController(repositoryService)}
|
||||||
|
* (那些用例不触发发布/影响路径,无需 RuntimeService/校验器)。
|
||||||
|
*/
|
||||||
|
ProcessModelController(RepositoryService repositoryService) {
|
||||||
|
this(repositoryService, null, new ProcessValidatorFactory().createDefaultProcessValidator());
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 全参构造:发布/影响端点单测注入 <b>mock</b> {@link ProcessValidator}
|
||||||
|
* ({@code ProcessValidatorFactory} 产的默认校验器无法 mock,须构造注入以断言 ERROR-vs-WARNING 分支)。
|
||||||
|
*/
|
||||||
|
ProcessModelController(RepositoryService repositoryService, RuntimeService runtimeService,
|
||||||
|
ProcessValidator processValidator) {
|
||||||
|
this.repositoryService = repositoryService;
|
||||||
|
this.runtimeService = runtimeService;
|
||||||
|
this.processValidator = processValidator;
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/models")
|
||||||
|
@Operation(summary = "草稿列表",
|
||||||
|
description = "createModelQuery().modelCategory(\"eip4\").orderByLastUpdateTime().desc() → "
|
||||||
|
+ "{models:[{id,name,key,lastUpdateTime(ISO)}]}。只列 EIP4 建的草稿,隔离存量 act_re_model。")
|
||||||
|
public ResponseEntity<Map<String, Object>> list() {
|
||||||
|
List<Map<String, Object>> models = repositoryService.createModelQuery()
|
||||||
|
.modelCategory(EIP4_CATEGORY)
|
||||||
|
.orderByLastUpdateTime().desc().list().stream()
|
||||||
|
.map(m -> {
|
||||||
|
Map<String, Object> row = new LinkedHashMap<>();
|
||||||
|
row.put("id", m.getId());
|
||||||
|
row.put("name", m.getName());
|
||||||
|
row.put("key", m.getKey());
|
||||||
|
row.put("lastUpdateTime", toIso(m.getLastUpdateTime()));
|
||||||
|
return row;
|
||||||
|
})
|
||||||
|
.collect(Collectors.toList());
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("models", models);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/models/{id}")
|
||||||
|
@Operation(summary = "取草稿",
|
||||||
|
description = "getModel + getModelEditorSource → {found,id,name,key,bpmnXml,metaInfo}。"
|
||||||
|
+ "草稿不存在或编辑源为空 → {found:false}(HTTP 200,前端降级)。")
|
||||||
|
public ResponseEntity<Map<String, Object>> get(@PathVariable String id) {
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
Model model = repositoryService.getModel(id);
|
||||||
|
if (model == null) {
|
||||||
|
resp.put("found", false);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
byte[] source = repositoryService.getModelEditorSource(id);
|
||||||
|
if (source == null) {
|
||||||
|
resp.put("found", false);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
resp.put("found", true);
|
||||||
|
resp.put("id", model.getId());
|
||||||
|
resp.put("name", model.getName());
|
||||||
|
resp.put("key", model.getKey());
|
||||||
|
resp.put("bpmnXml", new String(source, StandardCharsets.UTF_8));
|
||||||
|
resp.put("metaInfo", model.getMetaInfo());
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/models")
|
||||||
|
@Operation(summary = "建草稿",
|
||||||
|
description = "body {name,key,bpmnXml,metaInfo?}。name/key 空白→422;XML 过 BpmnXMLConverter 解析守卫"
|
||||||
|
+ "(坏 XML→422 不落库);过门后 newModel+setCategory(eip4)+saveModel+addModelEditorSource → {modelId}。")
|
||||||
|
public ResponseEntity<Map<String, Object>> create(@RequestBody CreateModelRequest req) {
|
||||||
|
// key 是 T3.1 部署资源名/中文原 key 还原的依赖,name 用于列表展示:空白一律拒。
|
||||||
|
if (isBlank(req.name) || isBlank(req.key)) {
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "name 与 key 不能为空");
|
||||||
|
}
|
||||||
|
ResponseEntity<Map<String, Object>> rejected = parseGuard(req.bpmnXml);
|
||||||
|
if (rejected != null) {
|
||||||
|
return rejected;
|
||||||
|
}
|
||||||
|
Model model = repositoryService.newModel();
|
||||||
|
model.setName(req.name);
|
||||||
|
model.setKey(req.key);
|
||||||
|
model.setCategory(EIP4_CATEGORY);
|
||||||
|
if (req.metaInfo != null) {
|
||||||
|
model.setMetaInfo(req.metaInfo);
|
||||||
|
}
|
||||||
|
repositoryService.saveModel(model);
|
||||||
|
repositoryService.addModelEditorSource(model.getId(), req.bpmnXml.getBytes(StandardCharsets.UTF_8));
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("modelId", model.getId());
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PutMapping("/models/{id}")
|
||||||
|
@Operation(summary = "更新草稿",
|
||||||
|
description = "草稿不存在→404;更新 name/metaInfo(仅当请求提供,避免覆盖 eip4IdMap)与 editorSource(XML 同守卫 422) → {status:0}。")
|
||||||
|
public ResponseEntity<Map<String, Object>> update(@PathVariable String id, @RequestBody UpdateModelRequest req) {
|
||||||
|
Model model = repositoryService.getModel(id);
|
||||||
|
if (model == null) {
|
||||||
|
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
|
||||||
|
}
|
||||||
|
ResponseEntity<Map<String, Object>> rejected = parseGuard(req.bpmnXml);
|
||||||
|
if (rejected != null) {
|
||||||
|
return rejected;
|
||||||
|
}
|
||||||
|
if (req.name != null) {
|
||||||
|
model.setName(req.name);
|
||||||
|
}
|
||||||
|
// metaInfo 仅当请求显式提供时更新:草稿存 eip4IdMap 于 metaInfo,普通保存不重发 metaInfo 时不能抹掉它。
|
||||||
|
if (req.metaInfo != null) {
|
||||||
|
model.setMetaInfo(req.metaInfo);
|
||||||
|
}
|
||||||
|
repositoryService.saveModel(model);
|
||||||
|
repositoryService.addModelEditorSource(id, req.bpmnXml.getBytes(StandardCharsets.UTF_8));
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("status", 0);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@DeleteMapping("/models/{id}")
|
||||||
|
@Operation(summary = "删草稿",
|
||||||
|
description = "草稿不存在→404;存在则 deleteModel(id)(连带 editorSource/metaInfo 一并删) → {status:0}。")
|
||||||
|
public ResponseEntity<Map<String, Object>> delete(@PathVariable String id) {
|
||||||
|
Model model = repositoryService.getModel(id);
|
||||||
|
if (model == null) {
|
||||||
|
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
|
||||||
|
}
|
||||||
|
repositoryService.deleteModel(id);
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("status", 0);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/models/from-procdef")
|
||||||
|
@Operation(summary = "从流程定义建草稿",
|
||||||
|
description = "body {procDefId}。读部署 BPMN → BpmnIdSanitizer.sanitize 净化中文 id → 建草稿"
|
||||||
|
+ "(name/key=procDef,editorSource=净化 XML,metaInfo={eip4IdMap,sourceProcDefId,originalKey}) → {modelId}。"
|
||||||
|
+ "procDef 不存在或 BPMN 空 → {found:false}(HTTP 200,前端降级)。")
|
||||||
|
public ResponseEntity<Map<String, Object>> fromProcDef(@RequestBody FromProcDefRequest req) {
|
||||||
|
ProcessDefinition def = repositoryService.createProcessDefinitionQuery()
|
||||||
|
.processDefinitionId(req.procDefId).singleResult();
|
||||||
|
if (def == null) {
|
||||||
|
return found(false);
|
||||||
|
}
|
||||||
|
String bpmnXml = readProcessModel(req.procDefId);
|
||||||
|
if (bpmnXml == null || bpmnXml.isBlank()) {
|
||||||
|
return found(false);
|
||||||
|
}
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(bpmnXml);
|
||||||
|
|
||||||
|
Map<String, Object> meta = new LinkedHashMap<>();
|
||||||
|
meta.put("eip4IdMap", r.idMap());
|
||||||
|
meta.put("sourceProcDefId", req.procDefId);
|
||||||
|
meta.put("originalKey", def.getKey());
|
||||||
|
String metaInfoJson;
|
||||||
|
try {
|
||||||
|
metaInfoJson = objectMapper.writeValueAsString(meta);
|
||||||
|
} catch (Exception e) {
|
||||||
|
// 纯 Map<String,String/Object> 序列化理论上不会失败;防御性 500
|
||||||
|
log.error("[流程草稿] metaInfo 序列化失败 procDefId={}", req.procDefId, e);
|
||||||
|
return status(HttpStatus.INTERNAL_SERVER_ERROR, "metaInfo 序列化失败");
|
||||||
|
}
|
||||||
|
|
||||||
|
Model model = repositoryService.newModel();
|
||||||
|
model.setName(def.getName());
|
||||||
|
model.setKey(def.getKey());
|
||||||
|
model.setCategory(EIP4_CATEGORY);
|
||||||
|
model.setMetaInfo(metaInfoJson);
|
||||||
|
repositoryService.saveModel(model);
|
||||||
|
repositoryService.addModelEditorSource(model.getId(), r.xml().getBytes(StandardCharsets.UTF_8));
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("modelId", model.getId());
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@PostMapping("/models/{id}/deploy")
|
||||||
|
@Operation(summary = "发布草稿为流程定义",
|
||||||
|
description = "草稿不存在→404;还原 eip4IdMap 里的中文原 key(存量流程 D7 硬需求,新建流程无 idMap 跳过)+"
|
||||||
|
+ "剥除 bpmn-js 补的 incoming/outgoing 文本引用 → 引擎 ProcessValidator 语义校验(仅 ERROR 级阻断,"
|
||||||
|
+ "返 422 {errors:[{activityId,problem,defaultDescription}]} 不部署;WARNING 放行)→ "
|
||||||
|
+ "createDeployment().disableSchemaValidation()(只跳 XSD:bpmn-js 默认命名空间与严格 XSD 已知不兼容,"
|
||||||
|
+ "语义校验已在上一步)部署 → {status:0,deploymentId,processKey,newVersion}。")
|
||||||
|
public ResponseEntity<Map<String, Object>> deploy(@PathVariable String id) {
|
||||||
|
Model model = repositoryService.getModel(id);
|
||||||
|
if (model == null) {
|
||||||
|
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
|
||||||
|
}
|
||||||
|
byte[] source = repositoryService.getModelEditorSource(id);
|
||||||
|
if (source == null) {
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空,无法发布: " + id);
|
||||||
|
}
|
||||||
|
String deployXml;
|
||||||
|
BpmnModel bpmnModel;
|
||||||
|
try {
|
||||||
|
// resolveIdMap 在 try 内:存量草稿 metaInfo 不可读/丢 eip4IdMap 时 fail-fast(评审 I1),不静默跳过还原。
|
||||||
|
Map<String, String> idMap = resolveIdMap(model.getMetaInfo());
|
||||||
|
deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap);
|
||||||
|
// XXE 兜底:还原后 XML 再过字节级 DOCTYPE 守卫(与 parseGuard 同源防御);enableSafeBpmnXml 亦禁 DOCTYPE,双保险。
|
||||||
|
if (hasDoctypeInBytes(deployXml.getBytes(StandardCharsets.UTF_8))) {
|
||||||
|
log.warn("[流程发布] 拒绝: 还原后 XML 含 DOCTYPE 声明(XXE 防御) id={}", id);
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
|
||||||
|
}
|
||||||
|
// validateSchema=false:bpmn-js 默认命名空间输出与严格 XSD 已知不兼容,语义交给下方 ProcessValidator;
|
||||||
|
// enableSafeBpmnXml=true:加固解析器关外部实体/DTD。
|
||||||
|
bpmnModel = new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(deployXml), false, true);
|
||||||
|
} catch (IllegalStateException e) {
|
||||||
|
// resolveIdMap 的 fail-fast:存量草稿 metaInfo 不可读/丢 eip4IdMap,还原不出中文原 key→拒发,防落库 nXXX 坏 key(D7)。
|
||||||
|
log.warn("[流程发布] id 映射不可用 id={}: {}", id, e.toString());
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射不可用,无法还原原 key");
|
||||||
|
} catch (IllegalArgumentException e) {
|
||||||
|
// BpmnIdSanitizer.restore 的 fail-fast:idMap 非双射(metaInfo 损坏)——须炸不能静默还原成别的 key。
|
||||||
|
log.warn("[流程发布] id 还原失败(idMap 损坏) id={}: {}", id, e.toString());
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射损坏,无法还原原 key");
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.warn("[流程发布] BPMN 解析失败 id={}: {}", id, e.toString());
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
|
||||||
|
}
|
||||||
|
// 引擎校验门:区分 ERROR/WARNING,只 ERROR 级阻断部署。此处仅引擎「结构」校验(节点连通/网关/多实例等);
|
||||||
|
// EIP4 「语义」校验(formKey 存在于 view_wftemplate、办理人/会签内嵌 JSON 白名单)在网关 ModelSemanticValidator(T3.2)。
|
||||||
|
List<Map<String, Object>> blocking = new ArrayList<>();
|
||||||
|
for (ValidationError ve : processValidator.validate(bpmnModel)) {
|
||||||
|
if (ve.isWarning()) {
|
||||||
|
log.info("[流程发布] 校验告警(放行) id={} activityId={} problem={} desc={}",
|
||||||
|
id, ve.getActivityId(), ve.getProblem(), ve.getDefaultDescription());
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
Map<String, Object> err = new LinkedHashMap<>();
|
||||||
|
err.put("activityId", ve.getActivityId());
|
||||||
|
err.put("problem", ve.getProblem());
|
||||||
|
err.put("defaultDescription", ve.getDefaultDescription());
|
||||||
|
blocking.add(err);
|
||||||
|
}
|
||||||
|
if (!blocking.isEmpty()) {
|
||||||
|
log.warn("[流程发布] ProcessValidator 拒绝 id={} errorCount={}", id, blocking.size());
|
||||||
|
Map<String, Object> body = new LinkedHashMap<>();
|
||||||
|
body.put("status", 1);
|
||||||
|
body.put("msg", "流程校验未通过");
|
||||||
|
body.put("errors", blocking);
|
||||||
|
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY).body(body);
|
||||||
|
}
|
||||||
|
// 部署资源名用中文原 key(仅 act_ge_bytearray 名,不决定 process key——后者取自 XML 的 <process id>)。
|
||||||
|
String resource = model.getKey() + ".bpmn20.xml";
|
||||||
|
var deployment = repositoryService.createDeployment()
|
||||||
|
.disableSchemaValidation()
|
||||||
|
.name(model.getName())
|
||||||
|
.addString(resource, deployXml)
|
||||||
|
.deploy();
|
||||||
|
var deployed = repositoryService.createProcessDefinitionQuery()
|
||||||
|
.deploymentId(deployment.getId()).singleResult();
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("status", 0);
|
||||||
|
resp.put("deploymentId", deployment.getId());
|
||||||
|
resp.put("processKey", deployed != null ? deployed.getKey() : model.getKey());
|
||||||
|
resp.put("newVersion", deployed != null ? deployed.getVersion() : 0);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
@GetMapping("/models/{id}/impact")
|
||||||
|
@Operation(summary = "发布影响摘要",
|
||||||
|
description = "草稿不存在→404;还原后解析 processKey → {processKey,currentVersion(该 key 最新已部署版本,"
|
||||||
|
+ "无则 0),runningInstances(该 key 运行中实例数)}。供同人确认弹窗展示「新版本/旧版本实例不受影响」。")
|
||||||
|
public ResponseEntity<Map<String, Object>> impact(@PathVariable String id) {
|
||||||
|
Model model = repositoryService.getModel(id);
|
||||||
|
if (model == null) {
|
||||||
|
return status(HttpStatus.NOT_FOUND, "草稿不存在: " + id);
|
||||||
|
}
|
||||||
|
byte[] source = repositoryService.getModelEditorSource(id);
|
||||||
|
if (source == null) {
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空: " + id);
|
||||||
|
}
|
||||||
|
String processKey;
|
||||||
|
try {
|
||||||
|
// impact 是只读预览:resolveIdMap 抛(存量草稿 metaInfo 不可读)/半成品草稿解析失败,一律回退 model.key
|
||||||
|
// ——from-procdef 建草稿的 model.key 就是中文原 key(创建时 setKey(def.getKey())),回退即得正确 processKey,
|
||||||
|
// 不该因草稿未完成/元数据损坏而 500;真正阻断坏 key 部署由 deploy 端点 fail-fast 负责。
|
||||||
|
// 无独立 DOCTYPE 字节守卫:impact 只查计数不部署,且 convertToBpmnModel 的 enableSafeBpmnXml=true 已禁 DOCTYPE/外部实体。
|
||||||
|
Map<String, String> idMap = resolveIdMap(model.getMetaInfo());
|
||||||
|
String deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap);
|
||||||
|
BpmnModel bpmnModel = new BpmnXMLConverter()
|
||||||
|
.convertToBpmnModel(new StringStreamSource(deployXml), false, true);
|
||||||
|
var mainProcess = bpmnModel.getMainProcess();
|
||||||
|
processKey = mainProcess != null ? mainProcess.getId() : model.getKey();
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.warn("[流程发布] 影响摘要解析失败,回退 model.key id={}: {}", id, e.toString());
|
||||||
|
processKey = model.getKey();
|
||||||
|
}
|
||||||
|
var latest = repositoryService.createProcessDefinitionQuery()
|
||||||
|
.processDefinitionKey(processKey).latestVersion().singleResult();
|
||||||
|
long runningInstances = runtimeService.createProcessInstanceQuery()
|
||||||
|
.processDefinitionKey(processKey).count();
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("processKey", processKey);
|
||||||
|
resp.put("currentVersion", latest != null ? latest.getVersion() : 0);
|
||||||
|
resp.put("runningInstances", runningInstances);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 发布/影响摘要前的 XML 规范化:①{@link #FLOW_REF_ELEMENT} 剥除 bpmn-js 补的 incoming/outgoing 文本引用元素;
|
||||||
|
* ②{@link BpmnIdSanitizer#restore} 依 {@code idMap} 把净化 id 还原为中文原 key(idMap 空=新建流程,原样返回)。
|
||||||
|
* restore 在剥除后跑:文本引用已消除,还原只作用于属性位,最终部署 XML 无残留净化 id。
|
||||||
|
* idMap 非双射时 restore fail-fast 抛 {@link IllegalArgumentException},由调用方转 422。
|
||||||
|
*/
|
||||||
|
private static String prepareDeployXml(String xml, Map<String, String> idMap) {
|
||||||
|
String stripped = FLOW_REF_ELEMENT.matcher(xml).replaceAll("");
|
||||||
|
return BpmnIdSanitizer.restore(stripped, idMap);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** from-procdef 建草稿写入 metaInfo 的存量标记键(其一存在即表明本草稿源自既有流程定义,editorSource 是净化 XML)。 */
|
||||||
|
private static final String[] FROM_PROCDEF_MARKERS = {"sourceProcDefId", "originalKey"};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 metaInfo JSON 取 {@code eip4IdMap}(原→净化),供 {@link BpmnIdSanitizer#restore} 还原中文原 key。
|
||||||
|
*
|
||||||
|
* <p><b>坏 key 地雷收口(评审 I1)</b>:绝不把「idMap 不可读」静默塌成「空 idMap→跳过还原」——那会让 from-procdef
|
||||||
|
* 存量草稿(editorSource 的 {@code <process id>} 是净化 {@code nXXX})在 metaInfo 损坏时静默部署出 key=nXXX 而非
|
||||||
|
* 中文原 key(HTTP 200 无声,违 D7;且与 restore 非双射 fail-fast 自相矛盾)。据 from-procdef 写的
|
||||||
|
* {@link #FROM_PROCDEF_MARKERS} 判存量草稿:</p>
|
||||||
|
* <ul>
|
||||||
|
* <li>metaInfo 空/null → 真·新建,空 Map(跳过还原,key 原样)。</li>
|
||||||
|
* <li>metaInfo 非空但 JSON 解析失败 → 损坏,{@link IllegalStateException} fail-fast(调用方转 422)。</li>
|
||||||
|
* <li>解析成功、{@code eip4IdMap} <b>存在</b>(是 Map,含空 {@code {}})→ 直接用(空=全 ASCII 存量流程无需还原,正常)。</li>
|
||||||
|
* <li>解析成功、{@code eip4IdMap} <b>缺失/非 Map</b> 且带 from-procdef 标记 → 存量草稿丢了映射,无法还原原 key,
|
||||||
|
* {@link IllegalStateException} fail-fast(宁拒不发坏 key)。</li>
|
||||||
|
* <li>解析成功、无 {@code eip4IdMap} 且无标记 → 真·新建(前端另存了别的 metaInfo),空 Map 正常放行。</li>
|
||||||
|
* </ul>
|
||||||
|
*/
|
||||||
|
private Map<String, String> resolveIdMap(String metaInfo) {
|
||||||
|
if (metaInfo == null || metaInfo.isBlank()) {
|
||||||
|
return Map.of();
|
||||||
|
}
|
||||||
|
Map<String, Object> meta;
|
||||||
|
try {
|
||||||
|
meta = objectMapper.readValue(metaInfo, new TypeReference<Map<String, Object>>() {});
|
||||||
|
} catch (Exception e) {
|
||||||
|
// 非空 metaInfo 却解析不了=损坏,不能猜它是不是存量草稿→一律 fail-fast(宁拒不发可能的坏 key)。
|
||||||
|
throw new IllegalStateException("metaInfo 无法解析,无法确认 id 映射: " + e, e);
|
||||||
|
}
|
||||||
|
Object raw = meta.get("eip4IdMap");
|
||||||
|
if (raw instanceof Map<?, ?> m) {
|
||||||
|
// eip4IdMap 存在(即使空):空=全 ASCII 存量流程无需还原,直接用。
|
||||||
|
Map<String, String> idMap = new LinkedHashMap<>();
|
||||||
|
for (Map.Entry<?, ?> e : m.entrySet()) {
|
||||||
|
idMap.put(String.valueOf(e.getKey()), String.valueOf(e.getValue()));
|
||||||
|
}
|
||||||
|
return idMap;
|
||||||
|
}
|
||||||
|
// eip4IdMap 缺失/非 Map:带 from-procdef 标记=存量草稿丢了映射(editorSource 是净化 XML)→fail-fast 防坏 key。
|
||||||
|
for (String marker : FROM_PROCDEF_MARKERS) {
|
||||||
|
if (meta.containsKey(marker)) {
|
||||||
|
throw new IllegalStateException(
|
||||||
|
"存量草稿 metaInfo 缺 eip4IdMap,无法还原净化 id 为中文原 key(marker=" + marker + ")");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return Map.of(); // 无标记=真·新建,key 原样部署。
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* BPMN 解析守卫:过则返回 {@code null}(放行),坏 XML 返回 422 ResponseEntity({status:1,msg})。
|
||||||
|
* 就地 catch 一切异常,不让引擎 XMLException/FlowableException 逸出到全局 advice(那里映射成 400,语义不符)。
|
||||||
|
*
|
||||||
|
* <p><b>两道关</b>:①解析前字节级 {@link #hasDoctypeInBytes} 拒 DOCTYPE 声明(XXE 兜底,不依赖 flowable
|
||||||
|
* 内部 {@code supportDTD=false} 实现);②{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)}
|
||||||
|
* 解析——{@code validateSchema=false}:草稿是可视化工具编辑的半成品,<b>不做</b>严格 BPMN 2.0 XSD 校验。
|
||||||
|
* bpmn-js {@code saveXML} 用默认命名空间(无前缀 definitions/process)重序列化,Flowable 严格 Xerces XSD 校验
|
||||||
|
* 会拒({@code cvc-complex-type.2.4.a})——这是 bpmn-js(面向 BPMN 模型,非字节级 XSD 合规)与严格 XSD 的
|
||||||
|
* <b>已知固有不兼容</b>;完整校验属部署门(T3.1 {@code ProcessValidator} 在解析后的模型上跑,非 XSD)。
|
||||||
|
* {@code validateSchema=false} 仍解析(非良构 XML 抛→422);{@code enableSafeBpmnXml=true} 保加固解析器
|
||||||
|
* (禁外部 DTD/参数实体/DOCTYPE),双保险关 XXE/SSRF。</p>
|
||||||
|
*
|
||||||
|
* <p>422 只回通用文案;原始解析原因(可能含内部路径/实体细节)仅进 {@code log.warn},不回显给调用方。</p>
|
||||||
|
*/
|
||||||
|
private ResponseEntity<Map<String, Object>> parseGuard(String xml) {
|
||||||
|
// ① XXE 兜底:解析前字节级拒 DOCTYPE。按 StringStreamSource 喂解析器的 UTF-8 字节视角扫描(含 BOM/UTF-16
|
||||||
|
// 识别),消除「扫描端 vs 解析端编码错位」绕过。null XML 同走 422(与解析必抛等价)。
|
||||||
|
if (xml == null || hasDoctypeInBytes(xml.getBytes(StandardCharsets.UTF_8))) {
|
||||||
|
log.warn("[流程草稿] BPMN 拒绝: {}", xml == null ? "空 XML" : "含 DOCTYPE 声明(XXE 防御)");
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
// ② validateSchema=false(不做严格 XSD)+ enableSafeBpmnXml=true(加固解析器);详见方法 javadoc。
|
||||||
|
new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(xml), false, true);
|
||||||
|
return null;
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.warn("[流程草稿] BPMN 解析守卫拒绝: {}", e.toString());
|
||||||
|
return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 字节级 DOCTYPE 检测(XXE 门):按 BOM / 无 BOM 的 UTF-16 空字节特征识别编码后解码 prolog,再走
|
||||||
|
* {@link #hasDoctype}。消除「扫描端与解析端编码视角不一致」的绕过(UTF-8 BOM / UTF-16 会让纯字节扫描漏判
|
||||||
|
* {@code <!DOCTYPE},而 xerces 仍按 BOM 正确解析触发 XXE)。移植 platform-report {@code ReportXmlGuard}
|
||||||
|
* (flowable-service 不依赖 platform-* 模块,故就地复刻,不引依赖)。
|
||||||
|
*/
|
||||||
|
static boolean hasDoctypeInBytes(byte[] raw) {
|
||||||
|
if (raw == null || raw.length == 0) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
java.nio.charset.Charset cs;
|
||||||
|
int off = 0;
|
||||||
|
int u0 = raw[0] & 0xFF;
|
||||||
|
int u1 = raw.length > 1 ? raw[1] & 0xFF : -1;
|
||||||
|
int u2 = raw.length > 2 ? raw[2] & 0xFF : -1;
|
||||||
|
if (u0 == 0xEF && u1 == 0xBB && u2 == 0xBF) {
|
||||||
|
cs = StandardCharsets.UTF_8;
|
||||||
|
off = 3; // UTF-8 BOM
|
||||||
|
} else if (u0 == 0xFF && u1 == 0xFE) {
|
||||||
|
cs = StandardCharsets.UTF_16LE;
|
||||||
|
off = 2; // UTF-16LE BOM
|
||||||
|
} else if (u0 == 0xFE && u1 == 0xFF) {
|
||||||
|
cs = StandardCharsets.UTF_16BE;
|
||||||
|
off = 2; // UTF-16BE BOM
|
||||||
|
} else if (u0 == '<' && u1 == 0x00) {
|
||||||
|
cs = StandardCharsets.UTF_16LE; // 无 BOM UTF-16LE(ASCII 起始字符夹空字节)
|
||||||
|
} else if (u0 == 0x00 && u1 == '<') {
|
||||||
|
cs = StandardCharsets.UTF_16BE; // 无 BOM UTF-16BE
|
||||||
|
} else {
|
||||||
|
cs = StandardCharsets.ISO_8859_1; // UTF-8 / Latin1:prolog 为 ASCII,字节级保真扫描
|
||||||
|
}
|
||||||
|
int scanLen = Math.min(raw.length - off, PROLOG_SCAN_BYTES);
|
||||||
|
return hasDoctype(new String(raw, off, scanLen, cs));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 文档 prolog(根元素之前)是否含 DOCTYPE 声明(大小写不敏感)。正确跳过 XML 声明 {@code <?xml?>} 与注释
|
||||||
|
* {@code <!-- -->},命中根元素起始标签即停(元素内容里的字面 {@code <!DOCTYPE} 文本不算)。
|
||||||
|
*/
|
||||||
|
static boolean hasDoctype(String xml) {
|
||||||
|
if (xml == null) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
int i = 0;
|
||||||
|
int n = xml.length();
|
||||||
|
while (i < n) {
|
||||||
|
char c = xml.charAt(i);
|
||||||
|
if (c == ' ' || c == '\t' || c == '\n' || c == '\r' || c == '') {
|
||||||
|
i++;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if (c != '<') {
|
||||||
|
return false; // prolog 里非标记的文本 → 视为无 DOCTYPE
|
||||||
|
}
|
||||||
|
if (xml.regionMatches(true, i, "<!DOCTYPE", 0, 9)) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
if (xml.startsWith("<!--", i)) { // 注释:整段跳过
|
||||||
|
int end = xml.indexOf("-->", i + 4);
|
||||||
|
if (end < 0) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
i = end + 3;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if (xml.startsWith("<?", i)) { // XML 声明 / 处理指令:整段跳过
|
||||||
|
int end = xml.indexOf("?>", i + 2);
|
||||||
|
if (end < 0) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
i = end + 2;
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
return false; // 到达根元素起始标签,prolog 结束,无 DOCTYPE
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 读流程定义部署 BPMN XML(getProcessModel 返回资源流)。读失败/为空返回 null(前端降级)。 */
|
||||||
|
private String readProcessModel(String procDefId) {
|
||||||
|
try (InputStream is = repositoryService.getProcessModel(procDefId)) {
|
||||||
|
if (is == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
return StreamUtils.copyToString(is, StandardCharsets.UTF_8);
|
||||||
|
} catch (Exception e) {
|
||||||
|
log.warn("[流程草稿] 读取 BPMN 失败 procDefId={}: {}", procDefId, e.toString());
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static ResponseEntity<Map<String, Object>> found(boolean value) {
|
||||||
|
Map<String, Object> resp = new LinkedHashMap<>();
|
||||||
|
resp.put("found", value);
|
||||||
|
return ResponseEntity.ok(resp);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static ResponseEntity<Map<String, Object>> status(HttpStatus httpStatus, String msg) {
|
||||||
|
Map<String, Object> body = new LinkedHashMap<>();
|
||||||
|
body.put("status", 1);
|
||||||
|
body.put("msg", msg);
|
||||||
|
return ResponseEntity.status(httpStatus).body(body);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** {@link Date} → ISO-8601 UTC 字符串(如 {@code 1970-01-01T00:00:00Z});null 原样透传。 */
|
||||||
|
private static String toIso(Date d) {
|
||||||
|
return d == null ? null : d.toInstant().toString();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** null 或纯空白(含全角/半角空格)视为空白。 */
|
||||||
|
private static boolean isBlank(String s) {
|
||||||
|
return s == null || s.isBlank();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 建草稿入参。 */
|
||||||
|
public static class CreateModelRequest {
|
||||||
|
public String name;
|
||||||
|
public String key;
|
||||||
|
public String bpmnXml;
|
||||||
|
public String metaInfo;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 更新草稿入参(editorSource 走 bpmnXml;name/metaInfo 为 null 表示不改)。 */
|
||||||
|
public static class UpdateModelRequest {
|
||||||
|
public String name;
|
||||||
|
public String bpmnXml;
|
||||||
|
public String metaInfo;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 从流程定义建草稿入参。 */
|
||||||
|
public static class FromProcDefRequest {
|
||||||
|
public String procDefId;
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -39,8 +39,10 @@ public final class Requests {
|
|||||||
public static class ActionRequest {
|
public static class ActionRequest {
|
||||||
/** 审批意见(记入流程评论)。 */
|
/** 审批意见(记入流程评论)。 */
|
||||||
public String comment;
|
public String comment;
|
||||||
/** 目标用户(转办/协办/转阅用;reject/reback 不需要)。 */
|
/** 目标用户(转办用;reject/reback 不需要)。 */
|
||||||
public String targetUserId;
|
public String targetUserId;
|
||||||
|
/** 多目标用户(协办/转阅:老系统用 MultiSelectField 选多人,每人各建一条子/转阅任务)。 */
|
||||||
|
public java.util.List<String> targetUserIds;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -16,15 +16,15 @@ flowable:
|
|||||||
datasource:
|
datasource:
|
||||||
# Hikari 原生属性名 jdbc-url(@ConfigurationProperties 绑到已 build 的 HikariDataSource,
|
# Hikari 原生属性名 jdbc-url(@ConfigurationProperties 绑到已 build 的 HikariDataSource,
|
||||||
# 须用 jdbc-url 而非 url,否则报 "jdbcUrl is required with driverClassName")
|
# 须用 jdbc-url 而非 url,否则报 "jdbcUrl is required with driverClassName")
|
||||||
jdbc-url: ${FLOWABLE_JDBC_URL:jdbc:postgresql://localhost:5433/eip4flow?currentSchema=eip3}
|
jdbc-url: ${FLOWABLE_JDBC_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
|
||||||
username: ${FLOWABLE_JDBC_USER:zhengwr}
|
username: ${FLOWABLE_JDBC_USER:zhengwr}
|
||||||
password: ${FLOWABLE_JDBC_PASS:}
|
password: ${FLOWABLE_JDBC_PASS:}
|
||||||
driver-class-name: org.postgresql.Driver
|
driver-class-name: org.postgresql.Driver
|
||||||
|
|
||||||
biz:
|
biz:
|
||||||
datasource:
|
datasource:
|
||||||
# F2-13: 本地验证用本地 eip4dev(5435 不可达,人名解析正降级)
|
# F2-13: 本地验证用合并库 eip4(业务+流程同库;原 eip4dev 已并入)。5435 不可达,人名解析正降级。
|
||||||
jdbc-url: ${BIZ_JDBC_URL:jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3}
|
jdbc-url: ${BIZ_JDBC_URL:jdbc:postgresql://localhost:5433/eip4?currentSchema=eip3}
|
||||||
username: ${BIZ_JDBC_USER:zhengwr}
|
username: ${BIZ_JDBC_USER:zhengwr}
|
||||||
password: ${BIZ_JDBC_PASS:}
|
password: ${BIZ_JDBC_PASS:}
|
||||||
driver-class-name: org.postgresql.Driver
|
driver-class-name: org.postgresql.Driver
|
||||||
|
|||||||
@@ -0,0 +1,64 @@
|
|||||||
|
package com.dsasp.server.wf.user.assignee;
|
||||||
|
|
||||||
|
import static org.assertj.core.api.Assertions.assertThat;
|
||||||
|
|
||||||
|
import java.util.Arrays;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* scriptUser 会签办理人解析的纯函数单测(同包以访问包级 helper):
|
||||||
|
* 单变量名提取 + 求值结果归一为 userId 列表。修复前 scriptUser 分支 WARN 降级返空,
|
||||||
|
* 致招投标/总包合同/施工技术交底等会签节点(集合用 ${APPLYUSERS})无办理人被跳过。
|
||||||
|
*/
|
||||||
|
class CandidateUsersScriptUserTest {
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void singleVarName_提取简单变量() {
|
||||||
|
assertThat(CandidateUsersHandler.singleVarName("${APPLYUSERS}")).isEqualTo("APPLYUSERS");
|
||||||
|
assertThat(CandidateUsersHandler.singleVarName(" ${ APPLYUSERS } ")).isEqualTo("APPLYUSERS");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void singleVarName_复杂表达式返回null() {
|
||||||
|
assertThat(CandidateUsersHandler.singleVarName("${a + b}")).isNull();
|
||||||
|
assertThat(CandidateUsersHandler.singleVarName("${users[0]}")).isNull();
|
||||||
|
assertThat(CandidateUsersHandler.singleVarName("ADMIN")).isNull();
|
||||||
|
assertThat(CandidateUsersHandler.singleVarName(null)).isNull();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void coerceUserList_支持List() {
|
||||||
|
assertThat(CandidateUsersHandler.coerceUserList(List.of("u1", "u2")))
|
||||||
|
.containsExactly("u1", "u2");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void coerceUserList_支持数组() {
|
||||||
|
assertThat(CandidateUsersHandler.coerceUserList(new String[] { "u1", "u2" }))
|
||||||
|
.containsExactly("u1", "u2");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void coerceUserList_逗号分号全角半角分隔串() {
|
||||||
|
assertThat(CandidateUsersHandler.coerceUserList("u1,u2; u3,u4;u5"))
|
||||||
|
.containsExactly("u1", "u2", "u3", "u4", "u5");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void coerceUserList_单值() {
|
||||||
|
assertThat(CandidateUsersHandler.coerceUserList("ADMIN")).containsExactly("ADMIN");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void coerceUserList_去重去空白() {
|
||||||
|
assertThat(CandidateUsersHandler.coerceUserList(Arrays.asList(" u1 ", "u1", "", "u2", null)))
|
||||||
|
.containsExactly("u1", "u2");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void coerceUserList_null返回空() {
|
||||||
|
assertThat(CandidateUsersHandler.coerceUserList(null)).isEmpty();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,223 @@
|
|||||||
|
package com.eip4.flowservice.api;
|
||||||
|
|
||||||
|
import static org.assertj.core.api.Assertions.assertThat;
|
||||||
|
|
||||||
|
import java.util.LinkedHashMap;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* BpmnIdSanitizer 可逆双射单测:净化(中文 id→安全 ASCII)与还原(restore)严格互逆,
|
||||||
|
* 覆盖 hash 碰撞消解、restore 前缀安全、合法 id 不动、混合场景。
|
||||||
|
*
|
||||||
|
* <p>非碰撞净化输出须与 ProcessDiagramController 旧实现逐字节一致(由既有 ProcessDiagramControllerTest 兜底),
|
||||||
|
* 本类聚焦「可逆」这一新增契约。</p>
|
||||||
|
*/
|
||||||
|
class BpmnIdSanitizerTest {
|
||||||
|
|
||||||
|
/** 中文 process id + processRef/sourceRef/targetRef/default/attachedToRef 全引用面净化→restore 须逐字节还原。 */
|
||||||
|
@Test
|
||||||
|
void 净化后还原_逐字节等于原文() {
|
||||||
|
String xml = """
|
||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL">
|
||||||
|
<process id="总包合同交底" name="总包合同交底">
|
||||||
|
<startEvent id="start"/>
|
||||||
|
<userTask id="审批" name="审批人"/>
|
||||||
|
<boundaryEvent id="超时" attachedToRef="审批"/>
|
||||||
|
<exclusiveGateway id="gw" default="回退"/>
|
||||||
|
<sequenceFlow id="回退" sourceRef="gw" targetRef="审批"/>
|
||||||
|
<sequenceFlow id="通过" sourceRef="审批" targetRef="end"/>
|
||||||
|
<endEvent id="end"/>
|
||||||
|
</process>
|
||||||
|
<collaboration id="collab">
|
||||||
|
<participant id="part" processRef="总包合同交底"/>
|
||||||
|
</collaboration>
|
||||||
|
<bpmndi:BPMNDiagram id="di" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI">
|
||||||
|
<bpmndi:BPMNPlane bpmnElement="总包合同交底"/>
|
||||||
|
</bpmndi:BPMNDiagram>
|
||||||
|
</definitions>""";
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
|
||||||
|
// 中文 id 不再出现在 id/引用类属性中;name 展示属性照旧保留中文
|
||||||
|
assertThat(r.xml()).doesNotContain("id=\"总包合同交底\"");
|
||||||
|
assertThat(r.xml()).doesNotContain("processRef=\"总包合同交底\"");
|
||||||
|
assertThat(r.xml()).doesNotContain("attachedToRef=\"审批\"");
|
||||||
|
assertThat(r.xml()).contains("name=\"总包合同交底\"");
|
||||||
|
assertThat(r.xml()).contains("name=\"审批人\"");
|
||||||
|
// idMap 覆盖全部 5 个中文 id(合法 ASCII id 不入 map)
|
||||||
|
assertThat(r.idMap()).containsOnlyKeys("总包合同交底", "审批", "超时", "回退", "通过");
|
||||||
|
|
||||||
|
// restore 逐字节还原
|
||||||
|
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* hash 碰撞消解:Java String.hashCode 下 "中Aa" 与 "中BB" 撞哈希('A'*31+'a' == 'B'*31+'B' == 2112),
|
||||||
|
* 二者又都是非法 NCName(含中文)→ 旧实现会撞成同一净化 id(非双射)。sanitize 须给两者不同净化 id,restore 仍完整还原。
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void 撞哈希两中文id_净化后仍双射可逆() {
|
||||||
|
// 前置自证:确实撞哈希
|
||||||
|
assertThat("中Aa".hashCode()).isEqualTo("中BB".hashCode());
|
||||||
|
|
||||||
|
String xml = """
|
||||||
|
<definitions>
|
||||||
|
<process id="p">
|
||||||
|
<userTask id="中Aa"/>
|
||||||
|
<userTask id="中BB"/>
|
||||||
|
<sequenceFlow id="f1" sourceRef="中Aa" targetRef="中BB"/>
|
||||||
|
</process>
|
||||||
|
</definitions>""";
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
|
||||||
|
String s1 = r.idMap().get("中Aa");
|
||||||
|
String s2 = r.idMap().get("中BB");
|
||||||
|
// 双射:两净化 id 互不相同(否则 sourceRef/targetRef 引用会串)
|
||||||
|
assertThat(s1).isNotNull();
|
||||||
|
assertThat(s2).isNotNull();
|
||||||
|
assertThat(s1).isNotEqualTo(s2);
|
||||||
|
// 碰撞消解序号:其一为基名,另一为基名 +"-2"
|
||||||
|
assertThat(s1 + "|" + s2).containsPattern("-2");
|
||||||
|
// 净化后中文 id 消失
|
||||||
|
assertThat(r.xml()).doesNotContain("中Aa");
|
||||||
|
assertThat(r.xml()).doesNotContain("中BB");
|
||||||
|
// restore 逐字节还原(引用不串)
|
||||||
|
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* restore 前缀安全:idMap 同时含净化 id "n1" 与 "n1x"(后者以前者为前缀)。
|
||||||
|
* 裸 String.replace("n1",..) 会把 "n1x" 误伤成 "<orig1>x";必须锚定完整属性值精确匹配。
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void restore前缀安全_n1不误伤n1x() {
|
||||||
|
Map<String, String> idMap = new LinkedHashMap<>();
|
||||||
|
idMap.put("原A", "n1");
|
||||||
|
idMap.put("原B", "n1x");
|
||||||
|
String xml = "<userTask id=\"n1x\"/><sequenceFlow id=\"f\" sourceRef=\"n1\" targetRef=\"n1x\"/>";
|
||||||
|
|
||||||
|
String out = BpmnIdSanitizer.restore(xml, idMap);
|
||||||
|
|
||||||
|
assertThat(out).isEqualTo("<userTask id=\"原B\"/><sequenceFlow id=\"f\" sourceRef=\"原A\" targetRef=\"原B\"/>");
|
||||||
|
assertThat(out).doesNotContain("原Ax"); // 无前缀误伤
|
||||||
|
assertThat(out).doesNotContain("n1x");
|
||||||
|
assertThat(out).doesNotContain("n1\"");
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 全合法 NCName id:不改写,idMap 为空,restore 无副作用。 */
|
||||||
|
@Test
|
||||||
|
void 合法NCName_id不改写_映射为空() {
|
||||||
|
String xml = "<process id=\"p\"><userTask id=\"sid-A\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"p\" targetRef=\"sid-A\" default=\"f1\"/></process>";
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
|
||||||
|
assertThat(r.idMap()).isEmpty();
|
||||||
|
assertThat(r.xml()).isEqualTo(xml);
|
||||||
|
// 空 idMap 的 restore 原样返回
|
||||||
|
assertThat(BpmnIdSanitizer.restore(xml, r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 混合:部分中文部分合法,只映射中文者;合法 id 原样保留;restore 还原。 */
|
||||||
|
@Test
|
||||||
|
void 混合_只映射中文id_合法id原样保留() {
|
||||||
|
String xml = "<process id=\"审批流程\"><userTask id=\"legalTask\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"审批流程\" targetRef=\"legalTask\"/></process>";
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
|
||||||
|
assertThat(r.idMap()).containsOnlyKeys("审批流程");
|
||||||
|
assertThat(r.xml()).contains("id=\"legalTask\"");
|
||||||
|
assertThat(r.xml()).contains("targetRef=\"legalTask\"");
|
||||||
|
assertThat(r.xml()).doesNotContain("审批流程");
|
||||||
|
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** restore 只回写映射内 id;净化后新增的 ASCII 节点 id(不在 idMap)原样保留。 */
|
||||||
|
@Test
|
||||||
|
void restore只回写映射内id_新增ascii_id保留() {
|
||||||
|
Map<String, String> idMap = new LinkedHashMap<>();
|
||||||
|
idMap.put("审批", "n5");
|
||||||
|
// n9 是设计器新增节点,不在 idMap → restore 不得改动
|
||||||
|
String xml = "<userTask id=\"n5\"/><userTask id=\"n9\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f\" sourceRef=\"n5\" targetRef=\"n9\"/>";
|
||||||
|
|
||||||
|
String out = BpmnIdSanitizer.restore(xml, idMap);
|
||||||
|
|
||||||
|
assertThat(out).isEqualTo("<userTask id=\"审批\"/><userTask id=\"n9\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f\" sourceRef=\"审批\" targetRef=\"n9\"/>");
|
||||||
|
}
|
||||||
|
|
||||||
|
/** null/空 XML 防御:不抛,idMap 为空。 */
|
||||||
|
@Test
|
||||||
|
void 空xml不抛_映射为空() {
|
||||||
|
assertThat(BpmnIdSanitizer.sanitize(null).idMap()).isEmpty();
|
||||||
|
assertThat(BpmnIdSanitizer.sanitize("").idMap()).isEmpty();
|
||||||
|
assertThat(BpmnIdSanitizer.restore(null, Map.of())).isNull();
|
||||||
|
assertThat(BpmnIdSanitizer.restore("<a/>", Map.of())).isEqualTo("<a/>");
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 生成的净化 id 不与文档内既有合法字面 id 冲突(used 占位契约)。
|
||||||
|
* "审批".hashCode()&0x7fffffff 的 hex 恰为 b7af8 → 基名 "nb7af8" 与合法字面 id "nb7af8" 撞
|
||||||
|
* → sanitize 须让 审批 映射为 nb7af8-2(否则 restore 会误改那个合法 id),restore 逐字节还原。
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void 净化id不与既有合法id冲突_让位加序号() {
|
||||||
|
assertThat(Integer.toHexString("审批".hashCode() & 0x7fffffff)).isEqualTo("b7af8"); // 前置自证
|
||||||
|
|
||||||
|
String xml = """
|
||||||
|
<process id="p">
|
||||||
|
<userTask id="nb7af8"/>
|
||||||
|
<userTask id="审批"/>
|
||||||
|
<sequenceFlow id="f" sourceRef="nb7af8" targetRef="审批"/>
|
||||||
|
</process>""";
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
|
||||||
|
// 中文 id 让位到 -2;既有合法字面 id nb7af8 原样不动、不入 map
|
||||||
|
assertThat(r.idMap()).containsOnlyKeys("审批");
|
||||||
|
assertThat(r.idMap().get("审批")).isEqualTo("nb7af8-2");
|
||||||
|
assertThat(r.xml()).contains("id=\"nb7af8\"");
|
||||||
|
assertThat(r.xml()).contains("sourceRef=\"nb7af8\"");
|
||||||
|
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* M-1 逐字节契约:未改值的合法属性(含等号周围空白)须原样回写,不被重构归一。
|
||||||
|
* 即便 map 非空(另有中文 id 被改),带空白的合法属性 round-trip 后原文不变。
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void 未改值属性含等号空白_原样保留不归一() {
|
||||||
|
// legalTask 用 `id = "..."`(等号带空格)合法写法;审批 是被净化的中文 id → map 非空
|
||||||
|
String xml = "<userTask id = \"legalTask\"/>"
|
||||||
|
+ "<userTask id=\"审批\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f\" sourceRef=\"legalTask\" targetRef=\"审批\"/>";
|
||||||
|
|
||||||
|
BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml);
|
||||||
|
|
||||||
|
// 审批被改;legalTask 的等号空白写法逐字保留(旧实现会归一成 id="legalTask")
|
||||||
|
assertThat(r.idMap()).containsOnlyKeys("审批");
|
||||||
|
assertThat(r.xml()).contains("id = \"legalTask\"");
|
||||||
|
// round-trip 后原文逐字节不变
|
||||||
|
assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** M-2 fail-fast:idMap 值(净化 id)重复=非双射(损坏 metaInfo),restore 抛而非静默还原错。 */
|
||||||
|
@Test
|
||||||
|
void restore_idMap值重复_抛非双射异常() {
|
||||||
|
Map<String, String> broken = new LinkedHashMap<>();
|
||||||
|
broken.put("原A", "n1");
|
||||||
|
broken.put("原B", "n1"); // 两个原 id 映到同一净化 id → 反转会静默覆盖
|
||||||
|
String xml = "<userTask id=\"n1\"/>";
|
||||||
|
|
||||||
|
org.assertj.core.api.Assertions.assertThatThrownBy(() -> BpmnIdSanitizer.restore(xml, broken))
|
||||||
|
.isInstanceOf(IllegalArgumentException.class)
|
||||||
|
.hasMessageContaining("非双射")
|
||||||
|
.hasMessageContaining("n1");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -330,4 +330,163 @@ class FlowControllerTest {
|
|||||||
.andExpect(status().isOk())
|
.andExpect(status().isOk())
|
||||||
.andExpect(org.springframework.test.web.servlet.result.MockMvcResultMatchers.content().string("1509"));
|
.andExpect(org.springframework.test.web.servlet.result.MockMvcResultMatchers.content().string("1509"));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ---------------------------------------------------------------- 协办(assist) / 转阅(circulate)
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 协办缺少目标用户返回400() throws Exception {
|
||||||
|
mvc.perform(post("/api/flow/tasks/task-9/assist")
|
||||||
|
.contentType("application/json")
|
||||||
|
.content("{\"comment\":\"请协助\"}"))
|
||||||
|
.andExpect(status().isBadRequest());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 协办为每个目标用户建子任务并记意见() throws Exception {
|
||||||
|
// 父任务查得(取 processInstanceId 记意见)
|
||||||
|
when(taskService.createTaskQuery()).thenReturn(taskQuery);
|
||||||
|
when(taskQuery.taskId("task-9")).thenReturn(taskQuery);
|
||||||
|
Task parent = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(parent.getProcessInstanceId()).thenReturn("pi-9");
|
||||||
|
when(taskQuery.singleResult()).thenReturn(parent);
|
||||||
|
// 每次 newTask() 返回一个新子任务桩
|
||||||
|
Task sub = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(taskService.newTask()).thenReturn(sub);
|
||||||
|
|
||||||
|
mvc.perform(post("/api/flow/tasks/task-9/assist")
|
||||||
|
.contentType("application/json")
|
||||||
|
.content("{\"comment\":\"请协助\",\"targetUserIds\":[\"u-a\",\"u-b\"]}"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.assisted").value(true))
|
||||||
|
.andExpect(jsonPath("$.count").value(2));
|
||||||
|
|
||||||
|
// 两个子任务:各设受托人/父任务/名称「协办」后保存
|
||||||
|
verify(sub).setAssignee("u-a");
|
||||||
|
verify(sub).setAssignee("u-b");
|
||||||
|
verify(sub, org.mockito.Mockito.times(2)).setParentTaskId("task-9");
|
||||||
|
verify(sub, org.mockito.Mockito.times(2)).setName("协办");
|
||||||
|
verify(taskService, org.mockito.Mockito.times(2)).saveTask(sub);
|
||||||
|
verify(taskService).addComment("task-9", "pi-9", "请协助");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 转阅为每个目标用户建转阅任务并存formKey() throws Exception {
|
||||||
|
when(taskService.createTaskQuery()).thenReturn(taskQuery);
|
||||||
|
when(taskQuery.taskId("task-10")).thenReturn(taskQuery);
|
||||||
|
Task parent = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(parent.getProcessInstanceId()).thenReturn("pi-10");
|
||||||
|
when(parent.getFormKey()).thenReturn("wf-tpl-77"); // FormKeyResolver: 原始非空直接返回
|
||||||
|
when(taskQuery.singleResult()).thenReturn(parent);
|
||||||
|
Task copy = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(taskService.newTask()).thenReturn(copy);
|
||||||
|
|
||||||
|
mvc.perform(post("/api/flow/tasks/task-10/circulate")
|
||||||
|
.contentType("application/json")
|
||||||
|
.content("{\"comment\":\"请阅\",\"targetUserIds\":[\"u-c\"]}"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.circulated").value(true))
|
||||||
|
.andExpect(jsonPath("$.count").value(1));
|
||||||
|
|
||||||
|
verify(copy).setName("转阅");
|
||||||
|
verify(copy).setAssignee("u-c");
|
||||||
|
verify(copy).setFormKey("wf-tpl-77"); // 用 setFormKey 而非 description,审批渲染 FormKeyResolver 直接命中
|
||||||
|
verify(copy).setParentTaskId("task-10");
|
||||||
|
verify(taskService).saveTask(copy);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 转阅父任务不存在返回404() throws Exception {
|
||||||
|
when(taskService.createTaskQuery()).thenReturn(taskQuery);
|
||||||
|
when(taskQuery.taskId("nope")).thenReturn(taskQuery);
|
||||||
|
when(taskQuery.singleResult()).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(post("/api/flow/tasks/nope/circulate")
|
||||||
|
.contentType("application/json")
|
||||||
|
.content("{\"targetUserIds\":[\"u-c\"]}"))
|
||||||
|
.andExpect(status().isNotFound());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 协办独立任务approvalContext回溯父任务取业务上下文() throws Exception {
|
||||||
|
// 协办/转阅建的是独立任务:无 processInstanceId,有 parentTaskId。审批上下文须回溯父任务取 businessKey/formKey,
|
||||||
|
// 否则协办人/转阅人打开看不到业务单据(code review HIGH 修复点)。
|
||||||
|
when(taskService.createTaskQuery()).thenReturn(taskQuery);
|
||||||
|
Task sub = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(sub.getName()).thenReturn("协办");
|
||||||
|
when(sub.getProcessInstanceId()).thenReturn(null);
|
||||||
|
when(sub.getParentTaskId()).thenReturn("parent-1");
|
||||||
|
when(sub.getFormKey()).thenReturn(null);
|
||||||
|
TaskQuery subQuery = org.mockito.Mockito.mock(TaskQuery.class);
|
||||||
|
when(taskQuery.taskId("sub-1")).thenReturn(subQuery);
|
||||||
|
when(subQuery.singleResult()).thenReturn(sub);
|
||||||
|
// 父任务:真实流程任务,带 processInstanceId/formKey
|
||||||
|
Task parent = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(parent.getProcessInstanceId()).thenReturn("pi-1");
|
||||||
|
when(parent.getFormKey()).thenReturn("wf-77");
|
||||||
|
when(parent.getProcessDefinitionId()).thenReturn("def-1");
|
||||||
|
when(parent.getTaskDefinitionKey()).thenReturn("node-a");
|
||||||
|
TaskQuery parentQuery = org.mockito.Mockito.mock(TaskQuery.class);
|
||||||
|
when(taskQuery.taskId("parent-1")).thenReturn(parentQuery);
|
||||||
|
when(parentQuery.singleResult()).thenReturn(parent);
|
||||||
|
// 父流程实例 businessKey
|
||||||
|
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.processInstanceId("pi-1")).thenReturn(processInstanceQuery);
|
||||||
|
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
|
||||||
|
when(pi.getBusinessKey()).thenReturn("BK-1");
|
||||||
|
when(processInstanceQuery.singleResult()).thenReturn(pi);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/tasks/sub-1/approval-context"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(true))
|
||||||
|
.andExpect(jsonPath("$.formKey").value("wf-77"))
|
||||||
|
.andExpect(jsonPath("$.businessKey").value("BK-1"))
|
||||||
|
.andExpect(jsonPath("$.processInstanceId").value("pi-1"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 会签任务approvalContext回填会签进度() throws Exception {
|
||||||
|
// 会签(多实例)任务:approval-context 沿执行树向上找带 nrOfInstances 的多实例根执行,回填进度
|
||||||
|
when(taskService.createTaskQuery()).thenReturn(taskQuery);
|
||||||
|
when(taskQuery.taskId("mi-1")).thenReturn(taskQuery);
|
||||||
|
Task t = org.mockito.Mockito.mock(Task.class);
|
||||||
|
when(t.getProcessInstanceId()).thenReturn("pi-mi");
|
||||||
|
when(t.getExecutionId()).thenReturn("exec-leaf");
|
||||||
|
when(taskQuery.singleResult()).thenReturn(t);
|
||||||
|
// fillCosign:叶执行无 nrOfInstances → 向上到根执行命中
|
||||||
|
when(runtimeService.getVariablesLocal("exec-leaf")).thenReturn(java.util.Map.of());
|
||||||
|
when(runtimeService.getVariablesLocal("exec-root"))
|
||||||
|
.thenReturn(java.util.Map.of("nrOfInstances", 3, "nrOfCompletedInstances", 1));
|
||||||
|
var execQuery = org.mockito.Mockito.mock(org.flowable.engine.runtime.ExecutionQuery.class);
|
||||||
|
when(runtimeService.createExecutionQuery()).thenReturn(execQuery);
|
||||||
|
when(execQuery.executionId("exec-leaf")).thenReturn(execQuery);
|
||||||
|
org.flowable.engine.runtime.Execution leaf = org.mockito.Mockito.mock(org.flowable.engine.runtime.Execution.class);
|
||||||
|
when(leaf.getParentId()).thenReturn("exec-root");
|
||||||
|
when(execQuery.singleResult()).thenReturn(leaf);
|
||||||
|
// 业务实例查不到(聚焦会签字段),走 PI null 分支
|
||||||
|
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.processInstanceId("pi-mi")).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.singleResult()).thenReturn(null);
|
||||||
|
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
|
||||||
|
when(historicProcessInstanceQuery.processInstanceId("pi-mi")).thenReturn(historicProcessInstanceQuery);
|
||||||
|
when(historicProcessInstanceQuery.singleResult()).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/tasks/mi-1/approval-context"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.cosign").value(true))
|
||||||
|
.andExpect(jsonPath("$.cosignTotal").value(3))
|
||||||
|
.andExpect(jsonPath("$.cosignCompleted").value(1));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 协办超过上限返回400() throws Exception {
|
||||||
|
StringBuilder ids = new StringBuilder("[");
|
||||||
|
for (int i = 0; i < 51; i++) {
|
||||||
|
ids.append(i == 0 ? "" : ",").append("\"u").append(i).append("\"");
|
||||||
|
}
|
||||||
|
ids.append("]");
|
||||||
|
mvc.perform(post("/api/flow/tasks/t/assist")
|
||||||
|
.contentType("application/json")
|
||||||
|
.content("{\"targetUserIds\":" + ids + "}"))
|
||||||
|
.andExpect(status().isBadRequest());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,257 @@
|
|||||||
|
package com.eip4.flowservice.api;
|
||||||
|
|
||||||
|
import static org.mockito.ArgumentMatchers.eq;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||||
|
|
||||||
|
import java.io.ByteArrayInputStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import org.flowable.engine.HistoryService;
|
||||||
|
import org.flowable.engine.RepositoryService;
|
||||||
|
import org.flowable.engine.RuntimeService;
|
||||||
|
import org.flowable.engine.history.HistoricActivityInstance;
|
||||||
|
import org.flowable.engine.history.HistoricActivityInstanceQuery;
|
||||||
|
import org.flowable.engine.history.HistoricProcessInstance;
|
||||||
|
import org.flowable.engine.history.HistoricProcessInstanceQuery;
|
||||||
|
import org.flowable.engine.repository.ProcessDefinition;
|
||||||
|
import org.flowable.engine.repository.ProcessDefinitionQuery;
|
||||||
|
import org.flowable.engine.runtime.ProcessInstance;
|
||||||
|
import org.flowable.engine.runtime.ProcessInstanceQuery;
|
||||||
|
import org.junit.jupiter.api.BeforeEach;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.junit.jupiter.api.extension.ExtendWith;
|
||||||
|
import org.mockito.Mock;
|
||||||
|
import org.mockito.junit.jupiter.MockitoExtension;
|
||||||
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
|
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 流程图端点薄层单测:mock 引擎,验证 BPMN XML 透出 + 当前/历史节点收敛 + 实例不存在降级。
|
||||||
|
*/
|
||||||
|
@ExtendWith(MockitoExtension.class)
|
||||||
|
class ProcessDiagramControllerTest {
|
||||||
|
|
||||||
|
@Mock RepositoryService repositoryService;
|
||||||
|
@Mock RuntimeService runtimeService;
|
||||||
|
@Mock HistoryService historyService;
|
||||||
|
@Mock ProcessInstanceQuery processInstanceQuery;
|
||||||
|
@Mock HistoricProcessInstanceQuery historicProcessInstanceQuery;
|
||||||
|
@Mock HistoricActivityInstanceQuery historicActivityInstanceQuery;
|
||||||
|
@Mock ProcessDefinitionQuery processDefinitionQuery;
|
||||||
|
|
||||||
|
MockMvc mvc;
|
||||||
|
|
||||||
|
@BeforeEach
|
||||||
|
void setUp() {
|
||||||
|
ProcessDiagramController controller = new ProcessDiagramController(repositoryService, runtimeService, historyService);
|
||||||
|
mvc = MockMvcBuilders.standaloneSetup(controller).build();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 运行中流程返回XML与当前及历史节点() throws Exception {
|
||||||
|
ProcessInstance pi = org.mockito.Mockito.mock(ProcessInstance.class);
|
||||||
|
when(pi.getProcessDefinitionId()).thenReturn("def-1");
|
||||||
|
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.processInstanceId("pi-1")).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.singleResult()).thenReturn(pi);
|
||||||
|
when(runtimeService.getActiveActivityIds("pi-1")).thenReturn(List.of("task_b"));
|
||||||
|
|
||||||
|
String xml = "<?xml version=\"1.0\"?><definitions><process id=\"p\"/></definitions>";
|
||||||
|
when(repositoryService.getProcessModel("def-1"))
|
||||||
|
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
|
||||||
|
|
||||||
|
HistoricActivityInstance a1 = org.mockito.Mockito.mock(HistoricActivityInstance.class);
|
||||||
|
when(a1.getActivityId()).thenReturn("task_a");
|
||||||
|
when(historyService.createHistoricActivityInstanceQuery()).thenReturn(historicActivityInstanceQuery);
|
||||||
|
when(historicActivityInstanceQuery.processInstanceId("pi-1")).thenReturn(historicActivityInstanceQuery);
|
||||||
|
when(historicActivityInstanceQuery.finished()).thenReturn(historicActivityInstanceQuery);
|
||||||
|
when(historicActivityInstanceQuery.list()).thenReturn(List.<HistoricActivityInstance>of(a1));
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process/pi-1/diagram"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(true))
|
||||||
|
.andExpect(jsonPath("$.bpmnXml").value(xml))
|
||||||
|
.andExpect(jsonPath("$.activeActivityIds[0]").value("task_b"))
|
||||||
|
.andExpect(jsonPath("$.finishedActivityIds[0]").value("task_a"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 已结束流程走历史取XML无当前节点() throws Exception {
|
||||||
|
// 运行库查不到
|
||||||
|
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.processInstanceId("pi-2")).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.singleResult()).thenReturn(null);
|
||||||
|
// 历史库查得 procDefId
|
||||||
|
HistoricProcessInstance hpi = org.mockito.Mockito.mock(HistoricProcessInstance.class);
|
||||||
|
when(hpi.getProcessDefinitionId()).thenReturn("def-2");
|
||||||
|
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
|
||||||
|
when(historicProcessInstanceQuery.processInstanceId("pi-2")).thenReturn(historicProcessInstanceQuery);
|
||||||
|
when(historicProcessInstanceQuery.singleResult()).thenReturn(hpi);
|
||||||
|
|
||||||
|
String xml = "<definitions/>";
|
||||||
|
when(repositoryService.getProcessModel("def-2"))
|
||||||
|
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
|
||||||
|
when(historyService.createHistoricActivityInstanceQuery()).thenReturn(historicActivityInstanceQuery);
|
||||||
|
when(historicActivityInstanceQuery.processInstanceId("pi-2")).thenReturn(historicActivityInstanceQuery);
|
||||||
|
when(historicActivityInstanceQuery.finished()).thenReturn(historicActivityInstanceQuery);
|
||||||
|
when(historicActivityInstanceQuery.list()).thenReturn(List.<HistoricActivityInstance>of());
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process/pi-2/diagram"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(true))
|
||||||
|
.andExpect(jsonPath("$.bpmnXml").value(xml))
|
||||||
|
.andExpect(jsonPath("$.activeActivityIds").isEmpty());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 实例不存在返回found_false不报错() throws Exception {
|
||||||
|
when(runtimeService.createProcessInstanceQuery()).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.processInstanceId(eq("nope"))).thenReturn(processInstanceQuery);
|
||||||
|
when(processInstanceQuery.singleResult()).thenReturn(null);
|
||||||
|
when(historyService.createHistoricProcessInstanceQuery()).thenReturn(historicProcessInstanceQuery);
|
||||||
|
when(historicProcessInstanceQuery.processInstanceId("nope")).thenReturn(historicProcessInstanceQuery);
|
||||||
|
when(historicProcessInstanceQuery.singleResult()).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process/nope/diagram"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void sanitizeBpmnIds_中文id重写为安全ascii并同步引用与节点() {
|
||||||
|
// 迁移 BPMN 用中文 process id + 中文 diagram id,bpmn-js 拒非 ASCII NCName。重写后引用须一致,name 不动。
|
||||||
|
String xml = "<definitions>"
|
||||||
|
+ "<process id=\"招投标流程\" name=\"招投标流程\">"
|
||||||
|
+ "<userTask id=\"sid-A\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"招投标流程\" targetRef=\"sid-A\"/>"
|
||||||
|
+ "</process>"
|
||||||
|
+ "<bpmndi:BPMNDiagram id=\"BPMNDiagram_招投标流程\">"
|
||||||
|
+ "<bpmndi:BPMNPlane bpmnElement=\"招投标流程\"/>"
|
||||||
|
+ "</bpmndi:BPMNDiagram></definitions>";
|
||||||
|
List<String> active = new java.util.ArrayList<>(List.of("sid-A"));
|
||||||
|
List<String> finished = new java.util.ArrayList<>(List.of("招投标流程"));
|
||||||
|
|
||||||
|
String out = ProcessDiagramController.sanitizeBpmnIds(xml, active, finished);
|
||||||
|
|
||||||
|
// 中文 id 不再出现在 id/ref 属性里,但 name 保留中文
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(out.contains("id=\"招投标流程\""));
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(out.contains("bpmnElement=\"招投标流程\""));
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(out.contains("sourceRef=\"招投标流程\""));
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(out.contains("name=\"招投标流程\"")); // 展示名不动
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(out.contains("id=\"sid-A\"")); // 合法 id 不动
|
||||||
|
// 同一中文 id 的所有引用映射到同一安全 id(process id 与 sourceRef/bpmnElement 一致)
|
||||||
|
java.util.regex.Matcher m = java.util.regex.Pattern.compile("<process id=\"(n[0-9a-f]+)\"").matcher(out);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(m.find());
|
||||||
|
String safe = m.group(1);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(out.contains("sourceRef=\"" + safe + "\""));
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(out.contains("bpmnElement=\"" + safe + "\""));
|
||||||
|
// 历史节点 id 同步重映射,当前节点 sid-A 不变
|
||||||
|
org.junit.jupiter.api.Assertions.assertEquals(safe, finished.get(0));
|
||||||
|
org.junit.jupiter.api.Assertions.assertEquals("sid-A", active.get(0));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void source_按procDefId返净化XML与idMap及key版本() throws Exception {
|
||||||
|
// 存量流程 process id 为中文(如「总包合同交底」),moddle 载入前须净化;端点透出原→净化映射供发布时逆向。
|
||||||
|
ProcessDefinition def = org.mockito.Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(def.getKey()).thenReturn("总包合同交底");
|
||||||
|
when(def.getVersion()).thenReturn(3);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionId("def-1")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(def);
|
||||||
|
|
||||||
|
String xml = "<definitions>"
|
||||||
|
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
|
||||||
|
+ "<userTask id=\"sid-A\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
|
||||||
|
+ "</process></definitions>";
|
||||||
|
when(repositoryService.getProcessModel("def-1"))
|
||||||
|
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process-definitions/def-1/source"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(true))
|
||||||
|
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.version").value(3))
|
||||||
|
// idMap 非空且含中文原 key;净化后 XML 的 id 属性不再含中文(name 展示位不受影响)
|
||||||
|
.andExpect(jsonPath("$.idMap").isNotEmpty())
|
||||||
|
.andExpect(jsonPath("$.idMap['总包合同交底']").isNotEmpty())
|
||||||
|
.andExpect(jsonPath("$.bpmnXml",
|
||||||
|
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("id=\"总包合同交底\""))))
|
||||||
|
// sequenceFlow 的 sourceRef 引用也须随 process id 一致重写,不白放(评审 M-1)
|
||||||
|
.andExpect(jsonPath("$.bpmnXml",
|
||||||
|
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("sourceRef=\"总包合同交底\""))));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void source_定义不存在返found_false() throws Exception {
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionId("nope")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process-definitions/nope/source"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void sourceByKey_按key命中返最新版净化XML与idMap及版本() throws Exception {
|
||||||
|
// process-select options 的 source='model' 项 id 是 act_re_model id(非 procDefId),by-id 永远 found:false;
|
||||||
|
// 打开器改用 option.key(真流程 key)走本端点。latestVersion() 在两版本(v1/v2)里取 v2。
|
||||||
|
ProcessDefinition v2 = org.mockito.Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(v2.getId()).thenReturn("总包合同交底:2:aa22");
|
||||||
|
when(v2.getKey()).thenReturn("总包合同交底");
|
||||||
|
when(v2.getVersion()).thenReturn(2);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionKey("总包合同交底")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(v2);
|
||||||
|
|
||||||
|
String xml = "<definitions>"
|
||||||
|
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
|
||||||
|
+ "<userTask id=\"sid-A\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
|
||||||
|
+ "</process></definitions>";
|
||||||
|
when(repositoryService.getProcessModel("总包合同交底:2:aa22"))
|
||||||
|
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process-definitions/by-key/{key}/source", "总包合同交底"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(true))
|
||||||
|
.andExpect(jsonPath("$.procDefId").value("总包合同交底:2:aa22"))
|
||||||
|
.andExpect(jsonPath("$.procDefKey").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.version").value(2))
|
||||||
|
.andExpect(jsonPath("$.idMap['总包合同交底']").isNotEmpty())
|
||||||
|
.andExpect(jsonPath("$.bpmnXml",
|
||||||
|
org.hamcrest.Matchers.not(org.hamcrest.Matchers.containsString("id=\"总包合同交底\""))));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void sourceByKey_key不存在返found_false() throws Exception {
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionKey("无此流程")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process-definitions/by-key/{key}/source", "无此流程"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void source_读取XML异常返found_false不抛500() throws Exception {
|
||||||
|
ProcessDefinition def = org.mockito.Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionId("def-x")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(def);
|
||||||
|
when(repositoryService.getProcessModel("def-x")).thenThrow(new RuntimeException("boom"));
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/process-definitions/def-x/source"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,743 @@
|
|||||||
|
package com.eip4.flowservice.api;
|
||||||
|
|
||||||
|
import static org.mockito.ArgumentMatchers.any;
|
||||||
|
import static org.mockito.ArgumentMatchers.anyString;
|
||||||
|
import static org.mockito.ArgumentMatchers.eq;
|
||||||
|
import static org.mockito.Mockito.never;
|
||||||
|
import static org.mockito.Mockito.verify;
|
||||||
|
import static org.mockito.Mockito.when;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||||
|
|
||||||
|
import java.io.ByteArrayInputStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.Date;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import org.flowable.engine.RepositoryService;
|
||||||
|
import org.flowable.engine.RuntimeService;
|
||||||
|
import org.flowable.engine.repository.Deployment;
|
||||||
|
import org.flowable.engine.repository.DeploymentBuilder;
|
||||||
|
import org.flowable.engine.repository.Model;
|
||||||
|
import org.flowable.engine.repository.ModelQuery;
|
||||||
|
import org.flowable.engine.repository.ProcessDefinition;
|
||||||
|
import org.flowable.engine.repository.ProcessDefinitionQuery;
|
||||||
|
import org.flowable.engine.runtime.ProcessInstanceQuery;
|
||||||
|
import org.flowable.validation.ProcessValidator;
|
||||||
|
import org.flowable.validation.ValidationError;
|
||||||
|
import org.junit.jupiter.api.BeforeEach;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.junit.jupiter.api.extension.ExtendWith;
|
||||||
|
import org.mockito.ArgumentCaptor;
|
||||||
|
import org.mockito.Mock;
|
||||||
|
import org.mockito.Mockito;
|
||||||
|
import org.mockito.junit.jupiter.MockitoExtension;
|
||||||
|
import org.springframework.http.MediaType;
|
||||||
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
|
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 流程草稿 CRUD 端点薄层单测:mock RepositoryService + Model API(newModel/saveModel/addModelEditorSource/
|
||||||
|
* getModelEditorSource/createModelQuery),验证列表/取草稿/建草稿(坏 XML 不落库)/PUT 404/from-procdef
|
||||||
|
* 净化 XML 与 idMap 落 metaInfo。standaloneSetup 不挂 FlowExceptionHandler——422/404 由控制器本地 ResponseEntity
|
||||||
|
* 显式产出(不经引擎异常映射)。
|
||||||
|
*/
|
||||||
|
@ExtendWith(MockitoExtension.class)
|
||||||
|
class ProcessModelControllerTest {
|
||||||
|
|
||||||
|
@Mock RepositoryService repositoryService;
|
||||||
|
@Mock ModelQuery modelQuery;
|
||||||
|
@Mock ProcessDefinitionQuery processDefinitionQuery;
|
||||||
|
|
||||||
|
MockMvc mvc;
|
||||||
|
|
||||||
|
// 最小 schema 合法 BPMN(default ns=BPMN20 MODEL)。
|
||||||
|
private static final String VALID_BPMN = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
|
||||||
|
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" targetNamespace=\"http://eip4\">"
|
||||||
|
+ "<process id=\"p1\" name=\"p1\">"
|
||||||
|
+ "<startEvent id=\"start\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"start\" targetRef=\"end\"/>"
|
||||||
|
+ "<endEvent id=\"end\"/>"
|
||||||
|
+ "</process></definitions>";
|
||||||
|
|
||||||
|
// bpmn-js saveXML 风格:默认命名空间(无前缀 definitions/process)+ 带前缀 BPMNDI 布局段。
|
||||||
|
// 此处 BPMNDiagram 排在 process 之前(触发严格 XSD 的 cvc-complex-type.2.4.a 序列违例——definitions 内容
|
||||||
|
// 模型要求 rootElement* 在 BPMNDiagram* 之前)——模拟 bpmn-js 输出被严格 XSD 拒的真实故障族。
|
||||||
|
// 草稿保存关 validateSchema 后应良构解析通过 → 200。
|
||||||
|
private static final String BPMN_JS_STYLE = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
|
||||||
|
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\""
|
||||||
|
+ " xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\""
|
||||||
|
+ " xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\""
|
||||||
|
+ " xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\""
|
||||||
|
+ " id=\"Definitions_1\" targetNamespace=\"http://bpmn.io/schema/bpmn\">"
|
||||||
|
+ "<bpmndi:BPMNDiagram id=\"BPMNDiagram_1\">"
|
||||||
|
+ "<bpmndi:BPMNPlane id=\"BPMNPlane_1\" bpmnElement=\"Process_1\">"
|
||||||
|
+ "<bpmndi:BPMNShape id=\"StartEvent_1_di\" bpmnElement=\"StartEvent_1\">"
|
||||||
|
+ "<dc:Bounds x=\"152\" y=\"82\" width=\"36\" height=\"36\"/>"
|
||||||
|
+ "</bpmndi:BPMNShape></bpmndi:BPMNPlane></bpmndi:BPMNDiagram>"
|
||||||
|
+ "<process id=\"Process_1\" isExecutable=\"true\">"
|
||||||
|
+ "<startEvent id=\"StartEvent_1\" name=\"开始\"/>"
|
||||||
|
+ "</process></definitions>";
|
||||||
|
|
||||||
|
// 含 DOCTYPE 声明(XXE 面):正文良构、关严格 XSD 后本可解析,但字节级 DOCTYPE 守卫必须拒。
|
||||||
|
private static final String DOCTYPE_XML = "<?xml version=\"1.0\"?>"
|
||||||
|
+ "<!DOCTYPE definitions [<!ENTITY xxe \"payload\">]>"
|
||||||
|
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\">"
|
||||||
|
+ "<process id=\"p1\"><startEvent id=\"s\"/></process></definitions>";
|
||||||
|
|
||||||
|
// 存量流程编辑器导出态(发布路径 fixture):process id + sequenceFlow id 原为中文,已被 sanitize 成净化 id
|
||||||
|
// (n1a2b3c / nflow1 / nflow2);bpmn-js saveXML 给流节点补了 <incoming>/<outgoing> 文本引用(内含净化 id)。
|
||||||
|
// metaInfo.eip4IdMap 记「中文原 id→净化 id」,发布时 restore 逆向还原。model.key=中文原 key「总包合同交底」。
|
||||||
|
private static final String DRAFT_SANITIZED_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>"
|
||||||
|
+ "<definitions xmlns=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" targetNamespace=\"http://eip4\">"
|
||||||
|
+ "<process id=\"n1a2b3c\" name=\"总包合同交底\" isExecutable=\"true\">"
|
||||||
|
+ "<startEvent id=\"start1\"><outgoing>nflow1</outgoing></startEvent>"
|
||||||
|
+ "<userTask id=\"taskA\" name=\"交底\"><incoming>nflow1</incoming><outgoing>nflow2</outgoing></userTask>"
|
||||||
|
+ "<endEvent id=\"end1\"><incoming>nflow2</incoming></endEvent>"
|
||||||
|
+ "<sequenceFlow id=\"nflow1\" sourceRef=\"start1\" targetRef=\"taskA\"/>"
|
||||||
|
+ "<sequenceFlow id=\"nflow2\" sourceRef=\"taskA\" targetRef=\"end1\"/>"
|
||||||
|
+ "</process></definitions>";
|
||||||
|
|
||||||
|
// 对应上面 fixture 的 metaInfo:eip4IdMap 三条(process + 两条 sequenceFlow) + sourceProcDefId + 中文 originalKey。
|
||||||
|
private static final String DRAFT_META_INFO = "{\"eip4IdMap\":{\"总包合同交底\":\"n1a2b3c\","
|
||||||
|
+ "\"流转1\":\"nflow1\",\"流转2\":\"nflow2\"},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}";
|
||||||
|
|
||||||
|
@BeforeEach
|
||||||
|
void setUp() {
|
||||||
|
ProcessModelController controller = new ProcessModelController(repositoryService);
|
||||||
|
mvc = MockMvcBuilders.standaloneSetup(controller).build();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 列表只查eip4分类并按最近更新降序返回id名key时间() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getId()).thenReturn("m1");
|
||||||
|
when(m.getName()).thenReturn("总包合同交底");
|
||||||
|
when(m.getKey()).thenReturn("总包合同交底");
|
||||||
|
when(m.getLastUpdateTime()).thenReturn(new Date(0L)); // 1970-01-01T00:00:00Z
|
||||||
|
when(repositoryService.createModelQuery()).thenReturn(modelQuery);
|
||||||
|
when(modelQuery.modelCategory("eip4")).thenReturn(modelQuery);
|
||||||
|
when(modelQuery.orderByLastUpdateTime()).thenReturn(modelQuery);
|
||||||
|
when(modelQuery.desc()).thenReturn(modelQuery);
|
||||||
|
when(modelQuery.list()).thenReturn(List.of(m));
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/models"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.models[0].id").value("m1"))
|
||||||
|
.andExpect(jsonPath("$.models[0].name").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.models[0].key").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.models[0].lastUpdateTime").value("1970-01-01T00:00:00Z"));
|
||||||
|
|
||||||
|
// 列表只列 EIP4 建的草稿:隔离库里 143 条老 shape 存量 act_re_model(打不开)
|
||||||
|
verify(modelQuery).modelCategory("eip4");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 取草稿返回XML与metaInfo() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getId()).thenReturn("m1");
|
||||||
|
when(m.getName()).thenReturn("总包合同交底");
|
||||||
|
when(m.getKey()).thenReturn("总包合同交底");
|
||||||
|
when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\"}}");
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn("<definitions/>".getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/models/m1"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(true))
|
||||||
|
.andExpect(jsonPath("$.id").value("m1"))
|
||||||
|
.andExpect(jsonPath("$.key").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.bpmnXml").value("<definitions/>"))
|
||||||
|
.andExpect(jsonPath("$.metaInfo").value("{\"eip4IdMap\":{\"总包合同交底\":\"n1\"}}"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 取草稿_model不存在返found_false() throws Exception {
|
||||||
|
when(repositoryService.getModel("nope")).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/models/nope"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 取草稿_editorSource为空返found_false() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(repositoryService.getModel("m2")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m2")).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(get("/api/flow/models/m2"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 建草稿_合法XML落库返modelId() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getId()).thenReturn("newid");
|
||||||
|
when(repositoryService.newModel()).thenReturn(m);
|
||||||
|
|
||||||
|
String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":"
|
||||||
|
+ jsonString(VALID_BPMN) + ",\"metaInfo\":\"{}\"}";
|
||||||
|
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.modelId").value("newid"));
|
||||||
|
|
||||||
|
verify(m).setName("新流程");
|
||||||
|
verify(m).setKey("newproc");
|
||||||
|
verify(m).setCategory("eip4"); // 建草稿打 EIP4 分类,供 list() 过滤隔离存量
|
||||||
|
verify(repositoryService).saveModel(m);
|
||||||
|
ArgumentCaptor<byte[]> src = ArgumentCaptor.forClass(byte[].class);
|
||||||
|
verify(repositoryService).addModelEditorSource(eq("newid"), src.capture());
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(
|
||||||
|
new String(src.getValue(), StandardCharsets.UTF_8).contains("<process id=\"p1\""));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 建草稿_空白name或key返422且不落库() throws Exception {
|
||||||
|
// key 是 T3.1 部署资源名/中文原 key 还原的依赖:空白一律拒,在解析守卫之前拦。
|
||||||
|
String body = "{\"name\":\" \",\"key\":\"\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
|
||||||
|
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1))
|
||||||
|
.andExpect(jsonPath("$.msg").isNotEmpty());
|
||||||
|
|
||||||
|
verify(repositoryService, never()).newModel();
|
||||||
|
verify(repositoryService, never()).saveModel(any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 建草稿_坏XML返422且不落库() throws Exception {
|
||||||
|
String body = "{\"name\":\"坏流程\",\"key\":\"bad\",\"bpmnXml\":"
|
||||||
|
+ jsonString("<definitions><broken") + "}";
|
||||||
|
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1))
|
||||||
|
.andExpect(jsonPath("$.msg").isNotEmpty());
|
||||||
|
|
||||||
|
// 解析守卫先于任何写:坏 XML 一律不落库
|
||||||
|
verify(repositoryService, never()).newModel();
|
||||||
|
verify(repositoryService, never()).saveModel(any());
|
||||||
|
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 建草稿_bpmnJs默认命名空间输出_关严格XSD后200落库() throws Exception {
|
||||||
|
// 回归锚点:bpmn-js saveXML 默认命名空间输出被严格 XSD 拒(改前必红=422)。草稿保存不该做完整 XSD 校验
|
||||||
|
// (完整校验属部署时 ProcessValidator,非 XSD)→ 关 validateSchema 后良构解析通过 → 200 建草稿成功。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getId()).thenReturn("draft-js");
|
||||||
|
when(repositoryService.newModel()).thenReturn(m);
|
||||||
|
|
||||||
|
String body = "{\"name\":\"新流程\",\"key\":\"newproc\",\"bpmnXml\":" + jsonString(BPMN_JS_STYLE) + "}";
|
||||||
|
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.modelId").value("draft-js"));
|
||||||
|
|
||||||
|
verify(repositoryService).saveModel(m);
|
||||||
|
verify(repositoryService).addModelEditorSource(eq("draft-js"), any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 建草稿_含DOCTYPE声明_字节级XXE守卫返422不落库() throws Exception {
|
||||||
|
// 正文良构(关 XSD 后本可解析),但 DOCTYPE 声明是 XXE 面 → 解析前字节级守卫拒,不依赖 flowable 内部实现。
|
||||||
|
String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":" + jsonString(DOCTYPE_XML) + "}";
|
||||||
|
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).saveModel(any());
|
||||||
|
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 建草稿_非良构XML_关严格XSD后仍返422不落库() throws Exception {
|
||||||
|
// 关 validateSchema=false 仅关严格 XSD,仍解析:标签不匹配是非良构 XML,解析必抛 → 422。
|
||||||
|
String body = "{\"name\":\"x\",\"key\":\"k\",\"bpmnXml\":"
|
||||||
|
+ jsonString("<definitions><process></definitions>") + "}";
|
||||||
|
mvc.perform(post("/api/flow/models").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).saveModel(any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 更新_草稿不存在返404() throws Exception {
|
||||||
|
when(repositoryService.getModel("nope")).thenReturn(null);
|
||||||
|
|
||||||
|
String body = "{\"name\":\"x\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
|
||||||
|
mvc.perform(put("/api/flow/models/nope").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isNotFound())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).saveModel(any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 更新_合法XML更新name与editorSource返status0() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
|
||||||
|
String body = "{\"name\":\"改名\",\"bpmnXml\":" + jsonString(VALID_BPMN) + ",\"metaInfo\":\"{}\"}";
|
||||||
|
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.status").value(0));
|
||||||
|
|
||||||
|
verify(m).setName("改名");
|
||||||
|
verify(m).setMetaInfo("{}");
|
||||||
|
verify(repositoryService).saveModel(m);
|
||||||
|
verify(repositoryService).addModelEditorSource(eq("m1"), any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 更新_只带name不带metaInfo时不改metaInfo() throws Exception {
|
||||||
|
// 草稿的 eip4IdMap 存于 metaInfo,普通保存草稿只发 name+XML 不重发 metaInfo:此时绝不能 setMetaInfo(null)
|
||||||
|
// 抹掉它——这是 T3.1 发布逆向还原原 key 的命根契约。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
|
||||||
|
String body = "{\"name\":\"只改名\",\"bpmnXml\":" + jsonString(VALID_BPMN) + "}";
|
||||||
|
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.status").value(0));
|
||||||
|
|
||||||
|
verify(m).setName("只改名");
|
||||||
|
verify(m, never()).setMetaInfo(any());
|
||||||
|
verify(repositoryService).saveModel(m);
|
||||||
|
verify(repositoryService).addModelEditorSource(eq("m1"), any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 更新_坏XML返422且不落库() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
|
||||||
|
String body = "{\"name\":\"x\",\"bpmnXml\":" + jsonString("<nope") + "}";
|
||||||
|
mvc.perform(put("/api/flow/models/m1").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).saveModel(any());
|
||||||
|
verify(repositoryService, never()).addModelEditorSource(anyString(), any());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 删草稿_存在则删除返status0() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
|
||||||
|
mvc.perform(delete("/api/flow/models/m1"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.status").value(0));
|
||||||
|
|
||||||
|
verify(repositoryService).deleteModel("m1");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 删草稿_不存在返404不删除() throws Exception {
|
||||||
|
when(repositoryService.getModel("nope")).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(delete("/api/flow/models/nope"))
|
||||||
|
.andExpect(status().isNotFound())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).deleteModel(anyString());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void fromProcDef_净化XML与idMap落metaInfo() throws Exception {
|
||||||
|
// 存量流程 process id 为中文,from-procdef 净化后建草稿:editorSource 无中文 id,metaInfo JSON 含
|
||||||
|
// eip4IdMap + sourceProcDefId + 中文 originalKey(发布时逆向还原原 key)。
|
||||||
|
ProcessDefinition def = Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(def.getName()).thenReturn("总包合同交底");
|
||||||
|
when(def.getKey()).thenReturn("总包合同交底");
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionId("def-1")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(def);
|
||||||
|
|
||||||
|
String xml = "<definitions>"
|
||||||
|
+ "<process id=\"总包合同交底\" name=\"总包合同交底\">"
|
||||||
|
+ "<userTask id=\"sid-A\"/>"
|
||||||
|
+ "<sequenceFlow id=\"f1\" sourceRef=\"总包合同交底\" targetRef=\"sid-A\"/>"
|
||||||
|
+ "</process></definitions>";
|
||||||
|
when(repositoryService.getProcessModel("def-1"))
|
||||||
|
.thenReturn(new ByteArrayInputStream(xml.getBytes(StandardCharsets.UTF_8)));
|
||||||
|
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getId()).thenReturn("draft-1");
|
||||||
|
when(repositoryService.newModel()).thenReturn(m);
|
||||||
|
|
||||||
|
String body = "{\"procDefId\":\"def-1\"}";
|
||||||
|
mvc.perform(post("/api/flow/models/from-procdef").contentType(MediaType.APPLICATION_JSON).content(body))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.modelId").value("draft-1"));
|
||||||
|
|
||||||
|
verify(m).setName("总包合同交底");
|
||||||
|
verify(m).setKey("总包合同交底");
|
||||||
|
verify(m).setCategory("eip4"); // from-procdef 建的草稿同样打 EIP4 分类
|
||||||
|
// metaInfo:JSON 含 eip4IdMap + sourceProcDefId + 中文 originalKey
|
||||||
|
ArgumentCaptor<String> meta = ArgumentCaptor.forClass(String.class);
|
||||||
|
verify(m).setMetaInfo(meta.capture());
|
||||||
|
String metaJson = meta.getValue();
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("eip4IdMap"), metaJson);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("\"sourceProcDefId\":\"def-1\""), metaJson);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("\"originalKey\":\"总包合同交底\""), metaJson);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(metaJson.contains("总包合同交底"), metaJson); // idMap 键含中文原 id
|
||||||
|
// editorSource:净化后 XML 不再含中文 id(id/ref 属性),name 保留中文
|
||||||
|
ArgumentCaptor<byte[]> src = ArgumentCaptor.forClass(byte[].class);
|
||||||
|
verify(repositoryService).addModelEditorSource(eq("draft-1"), src.capture());
|
||||||
|
String savedXml = new String(src.getValue(), StandardCharsets.UTF_8);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(savedXml.contains("id=\"总包合同交底\""), savedXml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(savedXml.contains("sourceRef=\"总包合同交底\""), savedXml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(savedXml.contains("name=\"总包合同交底\""), savedXml);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void fromProcDef_procDef不存在返found_false不落库() throws Exception {
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionId("nope")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(post("/api/flow/models/from-procdef")
|
||||||
|
.contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"nope\"}"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).newModel();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void fromProcDef_BPMN读取为空返found_false不落库() throws Exception {
|
||||||
|
// procDef 存在但部署 BPMN 资源读不出(getProcessModel 返 null)→ 降级 found:false,不建空草稿。
|
||||||
|
ProcessDefinition def = Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionId("def-empty")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(def);
|
||||||
|
when(repositoryService.getProcessModel("def-empty")).thenReturn(null);
|
||||||
|
|
||||||
|
mvc.perform(post("/api/flow/models/from-procdef")
|
||||||
|
.contentType(MediaType.APPLICATION_JSON).content("{\"procDefId\":\"def-empty\"}"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.found").value(false));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).newModel();
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===== T3.1 发布(deploy)/ 影响摘要(impact) =====
|
||||||
|
|
||||||
|
/** 建带 mock ProcessValidator + RuntimeService 的控制器与 MockMvc(发布/影响端点专用,校验器须可 mock)。 */
|
||||||
|
private MockMvc deployMvc(RuntimeService runtimeService, ProcessValidator validator) {
|
||||||
|
return MockMvcBuilders.standaloneSetup(
|
||||||
|
new ProcessModelController(repositoryService, runtimeService, validator)).build();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_还原中文原key与剥除incoming_outgoing后部署XML无残留净化id且disableSchemaValidation() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getName()).thenReturn("总包合同交底");
|
||||||
|
when(m.getKey()).thenReturn("总包合同交底"); // 中文原 key(from-procdef 时存,发布资源名/还原目标)
|
||||||
|
when(m.getMetaInfo()).thenReturn(DRAFT_META_INFO);
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
// 校验器无 ERROR → 放行部署。
|
||||||
|
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
|
||||||
|
when(validator.validate(any())).thenReturn(List.of());
|
||||||
|
|
||||||
|
// 部署链 mock:disableSchemaValidation().name().addString().deploy()。
|
||||||
|
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
|
||||||
|
when(repositoryService.createDeployment()).thenReturn(db);
|
||||||
|
when(db.disableSchemaValidation()).thenReturn(db);
|
||||||
|
when(db.name(any())).thenReturn(db);
|
||||||
|
when(db.addString(anyString(), anyString())).thenReturn(db);
|
||||||
|
Deployment dep = Mockito.mock(Deployment.class);
|
||||||
|
when(dep.getId()).thenReturn("dep-1");
|
||||||
|
when(db.deploy()).thenReturn(dep);
|
||||||
|
ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(deployed.getKey()).thenReturn("总包合同交底");
|
||||||
|
when(deployed.getVersion()).thenReturn(2);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.deploymentId("dep-1")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(deployed);
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.status").value(0))
|
||||||
|
.andExpect(jsonPath("$.deploymentId").value("dep-1"))
|
||||||
|
.andExpect(jsonPath("$.processKey").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.newVersion").value(2));
|
||||||
|
|
||||||
|
// disableSchemaValidation 必被调用(防有人回退成严格 XSD,咬 bpmn-js 默认命名空间输出→cvc-complex-type)。
|
||||||
|
verify(db).disableSchemaValidation();
|
||||||
|
// 捕获部署 XML:属性位还原为中文原 key/流 id,incoming/outgoing 文本引用剥除 → 全程无残留净化 id。
|
||||||
|
ArgumentCaptor<String> deployXml = ArgumentCaptor.forClass(String.class);
|
||||||
|
verify(db).addString(eq("总包合同交底.bpmn20.xml"), deployXml.capture());
|
||||||
|
String xml = deployXml.getValue();
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"总包合同交底\""), xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"流转1\""), xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertTrue(xml.contains("id=\"流转2\""), xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("n1a2b3c"), "残留净化 process id: " + xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("nflow1"), "残留净化流 id(incoming/outgoing 未剥除): " + xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("nflow2"), "残留净化流 id(incoming/outgoing 未剥除): " + xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("<incoming>"), "incoming 元素未剥除: " + xml);
|
||||||
|
org.junit.jupiter.api.Assertions.assertFalse(xml.contains("<outgoing>"), "outgoing 元素未剥除: " + xml);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_ProcessValidator_ERROR级返422带明细且不部署() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
// metaInfo 默认 null → 无 idMap(新建流程分支,不还原);getKey 在 ERROR 返回前不会被读,不 stub 免 strict-stub。
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
ValidationError err = new ValidationError();
|
||||||
|
err.setActivityId("taskA");
|
||||||
|
err.setProblem("flowable-usertask-no-assignment");
|
||||||
|
err.setDefaultDescription("用户任务无办理人");
|
||||||
|
err.setWarning(false);
|
||||||
|
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
|
||||||
|
when(validator.validate(any())).thenReturn(List.of(err));
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1))
|
||||||
|
.andExpect(jsonPath("$.errors[0].activityId").value("taskA"))
|
||||||
|
.andExpect(jsonPath("$.errors[0].problem").value("flowable-usertask-no-assignment"))
|
||||||
|
.andExpect(jsonPath("$.errors[0].defaultDescription").value("用户任务无办理人"));
|
||||||
|
|
||||||
|
// ERROR 级校验失败 → 绝不部署。
|
||||||
|
verify(repositoryService, never()).createDeployment();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_ProcessValidator仅WARNING放行部署() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getName()).thenReturn("新流程");
|
||||||
|
when(m.getKey()).thenReturn("newproc");
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
ValidationError warn = new ValidationError();
|
||||||
|
warn.setActivityId("taskA");
|
||||||
|
warn.setProblem("some-warning");
|
||||||
|
warn.setWarning(true);
|
||||||
|
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
|
||||||
|
when(validator.validate(any())).thenReturn(List.of(warn));
|
||||||
|
|
||||||
|
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
|
||||||
|
when(repositoryService.createDeployment()).thenReturn(db);
|
||||||
|
when(db.disableSchemaValidation()).thenReturn(db);
|
||||||
|
when(db.name(any())).thenReturn(db);
|
||||||
|
when(db.addString(anyString(), anyString())).thenReturn(db);
|
||||||
|
Deployment dep = Mockito.mock(Deployment.class);
|
||||||
|
when(dep.getId()).thenReturn("dep-2");
|
||||||
|
when(db.deploy()).thenReturn(dep);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.deploymentId("dep-2")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(null); // 查不到也不炸:回退 model.key/0
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.status").value(0))
|
||||||
|
.andExpect(jsonPath("$.deploymentId").value("dep-2"))
|
||||||
|
.andExpect(jsonPath("$.processKey").value("newproc"))
|
||||||
|
.andExpect(jsonPath("$.newVersion").value(0));
|
||||||
|
|
||||||
|
// 仅 WARNING → 放行:部署照常发生。
|
||||||
|
verify(db).deploy();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_草稿不存在返404不部署() throws Exception {
|
||||||
|
when(repositoryService.getModel("nope")).thenReturn(null);
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(post("/api/flow/models/nope/deploy"))
|
||||||
|
.andExpect(status().isNotFound())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).createDeployment();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 影响摘要_还原后解析processKey返当前版本与运行实例数() throws Exception {
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
// processKey 取自还原后 XML 的 <process id>(=总包合同交底),不读 model.getKey → 不 stub 免 strict-stub。
|
||||||
|
when(m.getMetaInfo()).thenReturn(DRAFT_META_INFO);
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
ProcessDefinition latest = Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(latest.getVersion()).thenReturn(3);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.processDefinitionKey("总包合同交底")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.latestVersion()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(latest);
|
||||||
|
|
||||||
|
RuntimeService runtimeService = Mockito.mock(RuntimeService.class);
|
||||||
|
ProcessInstanceQuery piq = Mockito.mock(ProcessInstanceQuery.class);
|
||||||
|
when(runtimeService.createProcessInstanceQuery()).thenReturn(piq);
|
||||||
|
when(piq.processDefinitionKey("总包合同交底")).thenReturn(piq);
|
||||||
|
when(piq.count()).thenReturn(5L);
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(runtimeService, Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(get("/api/flow/models/m1/impact"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.processKey").value("总包合同交底"))
|
||||||
|
.andExpect(jsonPath("$.currentVersion").value(3))
|
||||||
|
.andExpect(jsonPath("$.runningInstances").value(5));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 影响摘要_草稿不存在返404() throws Exception {
|
||||||
|
when(repositoryService.getModel("nope")).thenReturn(null);
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(get("/api/flow/models/nope/impact"))
|
||||||
|
.andExpect(status().isNotFound())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_非双射idMap_restore_fail_fast返422不部署() throws Exception {
|
||||||
|
// metaInfo 的 eip4IdMap 两个中文原 id 映射到同一净化 id(n1)→restore 反转检测到非双射抛 IllegalArgumentException
|
||||||
|
// →deploy catch→422,绝不部署(损坏映射还原会指错 key)。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\",\"其他流程\":\"n1\"}}");
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1))
|
||||||
|
.andExpect(jsonPath("$.msg").isNotEmpty());
|
||||||
|
|
||||||
|
verify(repositoryService, never()).createDeployment();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_存量草稿metaInfo缺eip4IdMap_fail_fast返422不部署() throws Exception {
|
||||||
|
// I1 坏 key 地雷:from-procdef 标记(sourceProcDefId/originalKey)在但 eip4IdMap 键丢了→editorSource 是净化 nXXX
|
||||||
|
// 却无从还原→绝不能静默塌成「空 idMap 跳过还原」部署出 key=nXXX(违 D7)→resolveIdMap fail-fast→422 不部署。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getMetaInfo()).thenReturn("{\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}");
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1))
|
||||||
|
.andExpect(jsonPath("$.msg").isNotEmpty());
|
||||||
|
|
||||||
|
verify(repositoryService, never()).createDeployment();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_metaInfo解析失败_fail_fast返422不部署() throws Exception {
|
||||||
|
// 非空 metaInfo 却是坏 JSON:无从确认是不是存量草稿→宁拒不发(可能的坏 key)→resolveIdMap fail-fast→422 不部署。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getMetaInfo()).thenReturn("{坏JSON不可解析");
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).createDeployment();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_存量草稿eip4IdMap为空_全ASCII流程不误拒正常部署() throws Exception {
|
||||||
|
// 防 I1 修过头:from-procdef 的全 ASCII 存量流程 sanitize 出空 eip4IdMap {}(present),editorSource 本就是 ASCII key,
|
||||||
|
// 无需还原→eip4IdMap 存在(空)即「可用」,不该被 fail-fast 误拒→正常部署。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
when(m.getName()).thenReturn("ascii流程");
|
||||||
|
when(m.getKey()).thenReturn("asciiKey");
|
||||||
|
when(m.getMetaInfo())
|
||||||
|
.thenReturn("{\"eip4IdMap\":{},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"asciiKey\"}");
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
ProcessValidator validator = Mockito.mock(ProcessValidator.class);
|
||||||
|
when(validator.validate(any())).thenReturn(List.of());
|
||||||
|
|
||||||
|
DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class);
|
||||||
|
when(repositoryService.createDeployment()).thenReturn(db);
|
||||||
|
when(db.disableSchemaValidation()).thenReturn(db);
|
||||||
|
when(db.name(any())).thenReturn(db);
|
||||||
|
when(db.addString(anyString(), anyString())).thenReturn(db);
|
||||||
|
Deployment dep = Mockito.mock(Deployment.class);
|
||||||
|
when(dep.getId()).thenReturn("dep-3");
|
||||||
|
when(db.deploy()).thenReturn(dep);
|
||||||
|
ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class);
|
||||||
|
when(deployed.getKey()).thenReturn("p1");
|
||||||
|
when(deployed.getVersion()).thenReturn(1);
|
||||||
|
when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.deploymentId("dep-3")).thenReturn(processDefinitionQuery);
|
||||||
|
when(processDefinitionQuery.singleResult()).thenReturn(deployed);
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator);
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(jsonPath("$.status").value(0))
|
||||||
|
.andExpect(jsonPath("$.processKey").value("p1"));
|
||||||
|
|
||||||
|
verify(db).deploy();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void 发布_editorSource含DOCTYPE_字节级XXE守卫返422不部署() throws Exception {
|
||||||
|
// deploy 路径自带的字节级 DOCTYPE 守卫(还原后 XML 再过一道):即便存储的 editorSource 含 DOCTYPE(理论不该,
|
||||||
|
// 因写入端已拒),部署也在解析前拒,绝不部署。
|
||||||
|
Model m = Mockito.mock(Model.class);
|
||||||
|
// metaInfo 默认 null→真·新建分支,resolveIdMap 返空,prepareDeployXml 剥除+空还原=原样→deployXml 仍含 DOCTYPE。
|
||||||
|
when(repositoryService.getModel("m1")).thenReturn(m);
|
||||||
|
when(repositoryService.getModelEditorSource("m1"))
|
||||||
|
.thenReturn(DOCTYPE_XML.getBytes(StandardCharsets.UTF_8));
|
||||||
|
|
||||||
|
MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class));
|
||||||
|
localMvc.perform(post("/api/flow/models/m1/deploy"))
|
||||||
|
.andExpect(status().isUnprocessableEntity())
|
||||||
|
.andExpect(jsonPath("$.status").value(1));
|
||||||
|
|
||||||
|
verify(repositoryService, never()).createDeployment();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** 把任意字符串编成 JSON 字符串字面量(转义引号/反斜杠/换行),用于拼请求体。 */
|
||||||
|
private static String jsonString(String s) {
|
||||||
|
StringBuilder sb = new StringBuilder("\"");
|
||||||
|
for (int i = 0; i < s.length(); i++) {
|
||||||
|
char c = s.charAt(i);
|
||||||
|
switch (c) {
|
||||||
|
case '"' -> sb.append("\\\"");
|
||||||
|
case '\\' -> sb.append("\\\\");
|
||||||
|
case '\n' -> sb.append("\\n");
|
||||||
|
case '\r' -> sb.append("\\r");
|
||||||
|
case '\t' -> sb.append("\\t");
|
||||||
|
default -> sb.append(c);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return sb.append("\"").toString();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -13,5 +13,12 @@
|
|||||||
<description>P5 占位:MCP Server、schema 双闸校验</description>
|
<description>P5 占位:MCP Server、schema 双闸校验</description>
|
||||||
<dependencies>
|
<dependencies>
|
||||||
<dependency><groupId>com.eip4</groupId><artifactId>platform-legacy-core</artifactId></dependency>
|
<dependency><groupId>com.eip4</groupId><artifactId>platform-legacy-core</artifactId></dependency>
|
||||||
|
<dependency><groupId>com.eip4</groupId><artifactId>platform-converter</artifactId></dependency>
|
||||||
|
<dependency><groupId>com.eip4</groupId><artifactId>platform-metadata</artifactId></dependency>
|
||||||
|
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>
|
||||||
|
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jdbc</artifactId></dependency>
|
||||||
|
<dependency><groupId>org.springdoc</groupId><artifactId>springdoc-openapi-starter-webmvc-ui</artifactId></dependency>
|
||||||
|
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId></dependency>
|
||||||
|
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency>
|
||||||
</dependencies>
|
</dependencies>
|
||||||
</project>
|
</project>
|
||||||
|
|||||||
@@ -0,0 +1,10 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiAgentRepairContext(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
AiRepairPlan repairPlan,
|
||||||
|
List<AiDraft> drafts) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiAgentRepairResult(
|
||||||
|
String status,
|
||||||
|
List<AiRepairDraftPatch> draftPatches,
|
||||||
|
List<String> messages) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiApplyRun(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String baseUrl,
|
||||||
|
String status,
|
||||||
|
long startedAt,
|
||||||
|
long finishedAt,
|
||||||
|
List<AiApplyStepResult> steps,
|
||||||
|
AiSmokeRun smokeRun) {
|
||||||
|
|
||||||
|
public boolean passed() {
|
||||||
|
boolean stepsPassed = steps != null && steps.stream()
|
||||||
|
.allMatch(s -> "APPLIED".equals(s.status()) || "SKIPPED".equals(s.status()));
|
||||||
|
return stepsPassed && smokeRun != null && smokeRun.passed();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiApplyStepResult(
|
||||||
|
String id,
|
||||||
|
AiArtifactType artifactType,
|
||||||
|
String target,
|
||||||
|
String status,
|
||||||
|
String message,
|
||||||
|
Map<String, Object> details) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Agent 允许产生的受控产物类型。
|
||||||
|
*
|
||||||
|
* <p>这里刻意不用自由字符串:后续 MCP 工具、发布门禁和审计都需要按类型施加不同规则。
|
||||||
|
*/
|
||||||
|
public enum AiArtifactType {
|
||||||
|
ENTITY,
|
||||||
|
PAGE_SCHEMA,
|
||||||
|
SERVICEFLOW,
|
||||||
|
MENU,
|
||||||
|
CODE,
|
||||||
|
TEST
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiAuditEntry(
|
||||||
|
String id,
|
||||||
|
String taskId,
|
||||||
|
String action,
|
||||||
|
String actor,
|
||||||
|
long createdAt,
|
||||||
|
Map<String, Object> details) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
public record AiAutoDevelopmentRequest(
|
||||||
|
AiFeatureRequest feature,
|
||||||
|
String baseUrl,
|
||||||
|
Boolean generateDeploymentPackage,
|
||||||
|
Integer maxRepairAttempts) {
|
||||||
|
|
||||||
|
public boolean shouldGenerateDeploymentPackage() {
|
||||||
|
return generateDeploymentPackage == null || generateDeploymentPackage;
|
||||||
|
}
|
||||||
|
|
||||||
|
public int repairAttemptLimit() {
|
||||||
|
if (maxRepairAttempts == null) {
|
||||||
|
return 2;
|
||||||
|
}
|
||||||
|
return Math.max(0, Math.min(5, maxRepairAttempts));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiAutoDevelopmentRun(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String originalChangeSetId,
|
||||||
|
String status,
|
||||||
|
long startedAt,
|
||||||
|
long finishedAt,
|
||||||
|
AiFeatureDevelopment development,
|
||||||
|
AiReleasePlan releasePlan,
|
||||||
|
AiApplyRun applyRun,
|
||||||
|
AiDeploymentPackage deploymentPackage,
|
||||||
|
List<AiRepairExecution> repairExecutions,
|
||||||
|
List<String> messages) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiChangeSet(
|
||||||
|
String id,
|
||||||
|
String taskId,
|
||||||
|
String status,
|
||||||
|
long createdAt,
|
||||||
|
List<String> draftIds,
|
||||||
|
Map<String, Object> summary) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiDeploymentPackage(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String status,
|
||||||
|
boolean requiresHumanApproval,
|
||||||
|
long generatedAt,
|
||||||
|
Map<String, Object> manifest,
|
||||||
|
List<String> sqlStatements,
|
||||||
|
List<String> rollbackSqlStatements,
|
||||||
|
List<String> warnings,
|
||||||
|
List<AiRunRecord> runEvidence) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode;
|
||||||
|
|
||||||
|
public record AiDraft(
|
||||||
|
String id,
|
||||||
|
String taskId,
|
||||||
|
AiArtifactType artifactType,
|
||||||
|
String targetId,
|
||||||
|
JsonNode payload,
|
||||||
|
long createdAt,
|
||||||
|
List<AiGateResult> gates,
|
||||||
|
Map<String, Object> metadata) {
|
||||||
|
|
||||||
|
public boolean passed() {
|
||||||
|
return gates == null || gates.stream().allMatch(AiGateResult::passed);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiEmployeeDefinition(
|
||||||
|
String id,
|
||||||
|
String name,
|
||||||
|
String role,
|
||||||
|
List<String> toolNames,
|
||||||
|
List<String> requiredScopes,
|
||||||
|
List<String> policies) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiFeatureDevelopment(
|
||||||
|
AiTask task,
|
||||||
|
List<AiDraft> drafts,
|
||||||
|
AiChangeSet changeSet) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
public record AiFeatureField(
|
||||||
|
String column,
|
||||||
|
String label,
|
||||||
|
String type,
|
||||||
|
Integer length,
|
||||||
|
Boolean required) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiFeaturePackage(
|
||||||
|
String id,
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String status,
|
||||||
|
long createdAt,
|
||||||
|
Map<String, Object> manifest,
|
||||||
|
AiDeploymentPackage deploymentPackage) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiFeatureRequest(
|
||||||
|
String objective,
|
||||||
|
String featureName,
|
||||||
|
String tableName,
|
||||||
|
String entityName,
|
||||||
|
String templateId,
|
||||||
|
String menuName,
|
||||||
|
List<AiFeatureField> fields,
|
||||||
|
String pageRecipe) {
|
||||||
|
|
||||||
|
public AiFeatureRequest(String objective,
|
||||||
|
String featureName,
|
||||||
|
String tableName,
|
||||||
|
String entityName,
|
||||||
|
String templateId,
|
||||||
|
String menuName,
|
||||||
|
List<AiFeatureField> fields) {
|
||||||
|
this(objective, featureName, tableName, entityName, templateId, menuName, fields, null);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,9 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiGateResult(
|
||||||
|
String name,
|
||||||
|
boolean passed,
|
||||||
|
List<String> messages) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode;
|
||||||
|
|
||||||
|
public record AiGeneratedDraft(
|
||||||
|
AiArtifactType artifactType,
|
||||||
|
String targetId,
|
||||||
|
JsonNode payload,
|
||||||
|
Map<String, Object> metadata) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiReleasePlan(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String status,
|
||||||
|
boolean requiresHumanApproval,
|
||||||
|
Map<String, Object> environmentPolicy,
|
||||||
|
List<AiReleaseStep> steps,
|
||||||
|
List<String> rollbackNotes) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiReleaseStep(
|
||||||
|
String id,
|
||||||
|
AiArtifactType artifactType,
|
||||||
|
String title,
|
||||||
|
String mode,
|
||||||
|
String target,
|
||||||
|
String action,
|
||||||
|
Map<String, Object> details) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
public record AiRepairAction(
|
||||||
|
String id,
|
||||||
|
String source,
|
||||||
|
String actionType,
|
||||||
|
String artifactType,
|
||||||
|
String targetId,
|
||||||
|
boolean automated,
|
||||||
|
String rationale,
|
||||||
|
Map<String, Object> details) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,12 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.Map;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode;
|
||||||
|
|
||||||
|
public record AiRepairDraftPatch(
|
||||||
|
AiArtifactType artifactType,
|
||||||
|
String targetId,
|
||||||
|
JsonNode payload,
|
||||||
|
Map<String, Object> metadata) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiRepairExecution(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String status,
|
||||||
|
long startedAt,
|
||||||
|
long finishedAt,
|
||||||
|
AiRepairPlan repairPlan,
|
||||||
|
List<AiDraft> generatedDrafts,
|
||||||
|
AiChangeSet repairedChangeSet,
|
||||||
|
AiApplyRun retryApplyRun,
|
||||||
|
AiDeploymentPackage deploymentPackage,
|
||||||
|
List<String> messages) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,4 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
public record AiRepairExecutionRequest(String baseUrl) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
public record AiRepairPlan(
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String sourceRunId,
|
||||||
|
String status,
|
||||||
|
long generatedAt,
|
||||||
|
List<AiRepairAction> actions,
|
||||||
|
List<String> messages) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode;
|
||||||
|
|
||||||
|
public record AiRevision(
|
||||||
|
String id,
|
||||||
|
String taskId,
|
||||||
|
String packageId,
|
||||||
|
String status,
|
||||||
|
String note,
|
||||||
|
long createdAt,
|
||||||
|
JsonNode snapshot) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
import com.fasterxml.jackson.databind.JsonNode;
|
||||||
|
|
||||||
|
public record AiRunRecord(
|
||||||
|
String id,
|
||||||
|
String taskId,
|
||||||
|
String changeSetId,
|
||||||
|
String runType,
|
||||||
|
String status,
|
||||||
|
long createdAt,
|
||||||
|
JsonNode payload) {
|
||||||
|
}
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
package com.eip4.platform.ai.model;
|
||||||
|
|
||||||
|
public record AiSmokeResult(
|
||||||
|
String name,
|
||||||
|
String method,
|
||||||
|
String url,
|
||||||
|
int expectedHttpStatus,
|
||||||
|
int actualHttpStatus,
|
||||||
|
boolean passed,
|
||||||
|
long durationMillis,
|
||||||
|
String error,
|
||||||
|
String responseSnippet) {
|
||||||
|
}
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user