chore(A10 W1): 收敛重复 bootstrap,db/migration 成平台表 DDL 单一真相

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>
This commit is contained in:
2026-06-25 15:16:35 +08:00
parent b7fbae4cae
commit fa3c92b698
12 changed files with 94 additions and 228 deletions

View File

@@ -22,8 +22,9 @@ import java.util.stream.Stream;
*
* <p>幂等:每条 upsert({@code ON CONFLICT (template_id) DO UPDATE}),同模板重导入时
* 仅当内容指纹({@code schema_etag})变化才 +1 版本并刷新;内容未变则版本不动(避免无谓版本膨胀)。
* 建表 DDL 与 {@code bootstrap-page-schema.sql} 同口径,CLI 启动时 {@code CREATE TABLE IF NOT EXISTS}
* 兜底(本地/CI 自举库可能未跑 bootstrap)。
* 建表 DDL 与平台表单一真相 {@code db/migration/V1__sys_page_schema.sql} 逐列一致,CLI 启动时
* {@code CREATE TABLE IF NOT EXISTS} 兜底(本地/CI 库可能未跑过 Flyway);防漂移由 platform-app 的
* {@code PlatformMigrationDdlGuardTest} 钉死。
*
* <p>用法:
* <pre>{@code
@@ -37,8 +38,12 @@ import java.util.stream.Stream;
*/
public final class SchemaImportCli {
/** 与 bootstrap-page-schema.sql / docs/sql/SYS_PAGE_SCHEMA.sql 完全一致的建表 DDL(CLI 自举兜底)。 */
static final String CREATE_DDL = """
/**
* 与平台表单一真相 {@code db/migration/V1__sys_page_schema.sql} 逐列一致的建表 DDL(独立 CLI 自举兜底:
* CLI 可在 Flyway 未跑过的库上独立建表)。public 以便 platform-app 的 {@code PlatformMigrationDdlGuardTest}
* 对 V1 做防漂移断言(A10 W1 收敛:散落 bootstrap 已删,此内联副本须钉死不漂移)。
*/
public static final String CREATE_DDL = """
CREATE TABLE IF NOT EXISTS sys_page_schema (
template_id character varying(64) NOT NULL,
name character varying(255),

View File

@@ -1,29 +0,0 @@
-- ============================================================================
-- eip4-platform 平台表 SYS_PAGE_SCHEMA —— bootstrap-page-schema.sql
-- ----------------------------------------------------------------------------
-- 用途:页面 schema 服务化(P4-4)。把 platform-converter 的转换产物
-- (转换产物/schema/{view_template_id}.json,1489 个) 作为初始数据源导入,
-- 由 GET /api/page/schema/{templateId} 在线下发(amis SDK 直接渲染)。
--
-- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管,业务表由引擎动态建。
-- 本工程当前尚未引入 Flyway —— 本次按「bootstrap SQL(本地/CI 自举) + 生产建表脚本
-- (docs/sql/SYS_PAGE_SCHEMA.sql) 落 docs」落地,Flyway 引入列 P5 待办
-- (见 platform-metadata/P4衔接-picker与schema接口报告.md「Flyway 待办」)。
--
-- 纪律:可重复执行(CREATE TABLE IF NOT EXISTS / DROP INDEX IF EXISTS);
-- 表名/列名一律小写(PG 不区分大小写,引擎与现代层 SQL 大小写混用,小写建库两侧皆命中)。
-- schema 列用 jsonb(amis 页面 schema 不小,jsonb 便于校验/索引,且导入侧用 ::jsonb 强校验 JSON 合法)。
-- ============================================================================
CREATE TABLE IF NOT EXISTS sys_page_schema (
template_id character varying(64) NOT NULL, -- view_template_id(转换产物文件名去 .json)
name character varying(255), -- 模板名称(取自分级清单.csv,便于运维检索)
schema_json jsonb NOT NULL, -- amis 页面 schema(顶层 type:page)
schema_etag character varying(64) NOT NULL, -- schema_json 的内容指纹(sha-256 hex),用于 HTTP ETag/304
version integer NOT NULL DEFAULT 1, -- 单调递增版本(同模板重导入 +1)
update_time bigint NOT NULL, -- epoch 毫秒(与引擎 DATE 列同口径)
CONSTRAINT pk_sys_page_schema PRIMARY KEY (template_id)
);
-- 按名称检索(运维/联调按模板名找 templateId)
CREATE INDEX IF NOT EXISTS idx_sys_page_schema_name ON sys_page_schema (name);