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>
130 lines
7.5 KiB
SQL
130 lines
7.5 KiB
SQL
-- ============================================================================
|
||
-- 生产建表脚本: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';
|