W1 引入 db/migration/V1-V3 后,平台表 DDL 在迁移与各模块 bootstrap-*.sql 重复
(评审揪出的"易漂移")。本次收敛,db/migration 成唯一真相:
- 删 3 份重复 bootstrap:bootstrap-page-schema(=V1)/bootstrap-datastatus(=V2)/
bootstrap-ai-agent(=V3)。三者无运行态 classpath 消费者(已全仓核实)。
- AiAgentDdlTest(platform-ai,原读 bootstrap-ai-agent.sql)删除,等价覆盖迁入
platform-app 新增 PlatformMigrationDdlGuardTest:① 守 V3 声明全部 AI 平台表/索引;
② 守 SchemaImportCli.CREATE_DDL ≡ V1(独立 CLI 兜底 DDL 防漂移)。
- SchemaImportCli.CREATE_DDL 由包私有改 public 供上述 guard 比对;两处过时注释改指 V1。
- ci.sh 平台表预灌改指 db/migration/V1(注:app 启动 Flyway 已幂等建表,此预灌仅冗余兜底)。
- docs 对齐:AI_AGENT_AUTO_DEVELOPMENT(spring.sql.init→Flyway)、docs/sql/SYS_PAGE_SCHEMA
/SYS_AI_AGENT 头注释(待办→已落地)、A10 design 残留收敛标完成、deploy/README 残留项标完成。
边界:platform-parity 的 bootstrap-{sys,privilege,auth,xservice,multidim,flow}.sql 是
eip3 schema 对拍测试 fixture,非平台表副本,原样保留。
验证:全 reactor mvn clean install 绿;PlatformMigrationDdlGuardTest 2/2;独立 code-reviewer
评审 GO(零 CRITICAL/HIGH/MEDIUM,含 guard substring 逻辑对真实 V1 仿真核实)。
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
53 lines
4.8 KiB
Markdown
53 lines
4.8 KiB
Markdown
# 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(含密钥,勿入库)。
|