-- ============================================================================ -- 生产建表脚本:SYS_AI_AGENT(AI Agent 运行态平台表) -- ---------------------------------------------------------------------------- -- 归属:platform-ai(P5 Agent 开发底座)。 -- 契约:/api/ai/tasks、/api/ai/tasks/{taskId}/drafts、change-sets、runs、audit。 -- -- 【Flyway 待办(P5)】 -- 架构条款(docs/架构设计.md §「平台表管理」):SYS_* 平台表由 Flyway 管理。 -- 本工程当前未引入 Flyway。本脚本即「生产建表脚本」,P5 引入 Flyway 时 -- 原样改名为 V{n}__create_sys_ai_agent.sql 纳入 src/main/resources/db/migration 即可。 -- 本地 / CI 自举副本见 platform-ai/src/main/resources/bootstrap/bootstrap-ai-agent.sql。 -- -- 边界:这些表只保存 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';