muse-agent-example/docs/系统架构/新版设计/文件设计/数据库与迁移.md

数据库与迁移：文件合同

本页从目标文件清单投影，共 48 个目标条目。测试身份与行为合同在现行用例清单；文件和目标合同不代表实现或验收已完成。

返回目录 · 完整项目树 · 现行用例清单

本部分文件树

agent-example/
└── 数据库/
    ├── 初始化/
    │   └── 用途角色.sql  # 初始化生产、评测、维护三个固定用途角色
    └── 迁移/
        ├── V0001__共享标识与版本.sql  # 共享标识与版本结构迁移
        ├── V0002__元数据结构与策略.sql  # 元数据结构与策略结构迁移
        ├── V0003__正式变更.sql  # 正式变更结构迁移
        ├── V0004__任务运行与证据.sql  # 任务、作用域租约、原文保留授权、完整归档、清理回执和证据迁移
        ├── V0005__作品规划.sql  # 作品规划结构迁移
        ├── V0006__故事世界.sql  # 故事世界结构迁移
        ├── V0007__资料研究.sql  # 资料研究结构迁移
        ├── V0009__正文写作.sql  # 正文写作结构迁移
        ├── V0013__上下文与检索索引.sql  # 上下文与检索索引结构迁移
        ├── V0015__运行配置版本.sql  # 运行配置版本结构迁移
        ├── V0016__流程定义与版本.sql  # 流程定义与版本结构迁移
        ├── V0020__上下文快照与消费.sql  # 上下文快照与消费记录结构迁移
        ├── V0021__模型候选与审校报告.sql  # 模型候选来源与审校报告结构迁移
        ├── V0022__知识方法.sql  # 知识方法结构迁移
        ├── V0023__模型规划与调用级消费.sql  # 模型规划来源绑定与调用级消费唯一键
        ├── V0024__模型派发授权依据.sql  # 为模型派发授权增加独立技术证据种类；不升级历史调用
        ├── V0025__旧库迁移来源与映射.sql  # 隔离目标标记与迁移台账的表、权限和不可变约束
        ├── V0026__参考分析版本.sql  # B03完整分析单权威、源版本外键与只追加约束
        ├── V0027__作品声音版本.sql  # 作品声音候选、不可变确认版本与当前指针
        ├── V0028__文学审校报告.sql  # 不可变文学片记录与完整报告
        ├── V0029__规则候选与诊断.sql  # 不可变规则候选版本、实际启用定位与诊断历史
        ├── V0030__模型修订结果.sql  # 不可变模型修订结果及候选关联
        ├── V0031__正文分支来源.sql  # B05分支起点与合并候选来源不可变关联
        ├── V0032__选段修订依据.sql  # 诊断与作者圈选两类修订依据的约束
        ├── V0033__质量案例.sql  # B06不可变案例版本与可追溯当前指针
        ├── V0034__隔离数据集与实验.sql  # 隔离数据集、答案、实验条件与匿名映射的封存
        ├── V0035__评测逐例执行.sql  # 固定执行计划、单元任务绑定与真实交付
        ├── V0036__评测停止决定.sql  # 独立保存停止决定，保留计划和已发生交付
        ├── V0037__逐调用交付确认.sql  # S02在实际响应保存后同事务确认每次调用，保存顺序不被最后调用指针覆盖
        ├── V0038__评测引文拒绝.sql  # B10不可变判断拒绝、原回合与前序哈希，限制纠正次数
        ├── V0039__评测条件第三.sql  # 不可变的第三评必要性和原调用依据
        ├── V0040__标定金标准与凭据.sql  # 维护封存的oracle标签与evaluation标定凭据
        ├── V0041__评测语义检测单元.sql  # 沿用不可变单元与S02，只扩充语义检测种类
        ├── V0042__效果判据凭据.sql  # 隔离评测域不可变效果凭据，不向生产角色开放
        ├── V0043__目标启用凭据.sql  # 最小目标凭据和只读停止投影，保持生产评测权限隔离
        ├── V0044__作者偏好与反馈.sql  # B07偏好当前指针、不可变历史和真实版本反馈
        ├── V0045__具体改进与目标回执.sql  # 具体改进、实际owner回执与分版本作者观察
        ├── V0046__作者长期观察.sql  # 具体改进、实际owner回执与分版本作者观察
        ├── V0047__定稿与导出产物.sql  # 不可变定稿清单及导出产物
        ├── V0048__连载发布与读者反馈.sql  # 完整定稿、实际导出与版本发布反馈
        ├── V0049__运行版本只读核对.sql  # 用途隔离与数据权限结构迁移
        ├── V0050__跨模块交付引用约束.sql  # 跨模块引用约束结构迁移
        ├── V0051__工作台任务盘点视图.sql  # 工作台查询视图结构迁移
        ├── V0052__持久返修会话.sql  # 返修会话、轮次与作者动作的持久状态和约束
        ├── V0053__返修独立比较证明.sql  # 不可变返修比较证明及生产只读投影
        ├── V0054__规则诊断资格与启停.sql  # 独立规则验证、最小凭据及S01启停历史
        └── V0055__运行观察来源.sql  # 非空来源的只追加运行观察与幂等命令

逐文件合同

数据库/迁移/V0001__共享标识与版本.sql

• 归属与种类：数据演进；迁移。
• 意图：为 共享标识与版本 提供版本化数据库演进。
• 职责：共享标识与版本结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0002__元数据结构与策略.sql

• 归属与种类：数据演进；迁移。
• 意图：为 元数据结构与策略 提供版本化数据库演进。
• 职责：元数据结构与策略结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0003__正式变更.sql

• 归属与种类：数据演进；迁移。
• 意图：为 正式变更 提供版本化数据库演进。
• 职责：正式变更结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0004__任务运行与证据.sql

• 归属与种类：数据演进；迁移。
• 意图：为 任务、步骤、作用域互斥、调用和证据的 提供版本化数据库演进。
• 职责：任务、作用域租约、原文保留授权、完整归档、清理回执和证据迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0005__作品规划.sql

• 归属与种类：数据演进；迁移。
• 意图：为 作品规划 提供版本化数据库演进。
• 职责：作品规划结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0006__故事世界.sql

• 归属与种类：数据演进；迁移。
• 意图：为 故事世界 提供版本化数据库演进。
• 职责：故事世界结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0007__资料研究.sql

• 归属与种类：数据演进；迁移。
• 意图：为 资料研究 提供版本化数据库演进。
• 职责：资料研究结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0022__知识方法.sql

• 归属与种类：数据演进；迁移。
• 意图：为 知识方法 提供版本化数据库演进。
• 职责：知识方法结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0009__正文写作.sql

• 归属与种类：数据演进；迁移。
• 意图：为 正文写作 提供版本化数据库演进。
• 职责：正文写作结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0044__作者偏好与反馈.sql

• 归属与种类：数据演进；迁移。
• 意图：为 作者经验 提供版本化数据库演进。
• 职责：作者经验结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0047__定稿与导出产物.sql

• 归属与种类：数据演进；迁移。
• 意图：为 交付连载 提供版本化数据库演进。
• 职责：交付连载结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0013__上下文与检索索引.sql

• 归属与种类：数据演进；迁移。
• 意图：为 上下文与检索索引 提供版本化数据库演进。
• 职责：上下文与检索索引结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0034__隔离数据集与实验.sql

• 归属与种类：数据演进；迁移。
• 意图：为 效果评测 提供版本化数据库演进。
• 职责：效果评测结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0015__运行配置版本.sql

• 归属与种类：数据演进；迁移。
• 意图：为 运行配置版本 提供版本化数据库演进。
• 职责：运行配置版本结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0016__流程定义与版本.sql

• 归属与种类：数据演进；迁移。
• 意图：为 流程定义与版本 提供版本化数据库演进。
• 职责：流程定义与版本结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0050__跨模块交付引用约束.sql

• 归属与种类：数据演进；迁移。
• 意图：为 跨模块引用约束 提供版本化数据库演进。
• 职责：跨模块引用约束结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0051__工作台任务盘点视图.sql

• 归属与种类：数据演进；迁移。
• 意图：为 工作台查询视图 提供版本化数据库演进。
• 职责：工作台查询视图结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0049__运行版本只读核对.sql

• 归属与种类：数据演进；迁移。
• 意图：为 用途隔离与数据权限 提供版本化数据库演进。
• 职责：用途隔离与数据权限结构迁移。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/初始化/用途角色.sql

• 归属与种类：基础设施；DDL。
• 意图：在独立目标实例初始化固定用途角色。
• 职责：创建无超级权限的生产、评测、维护登录角色，不记录凭据。
• 边界：显式管理命令执行，应用启动及迁移不创建角色。
• 目标：后续迁移通过维护角色设定权限，生产拒读 oracle，评测不能写业务对象。
• 合同依据：存储与对象关系。

数据库/迁移/V0020__上下文快照与消费.sql

• 归属与种类：数据演进；迁移。
• 意图：为 上下文快照与消费记录 提供版本化数据库演进。
• 职责：上下文快照与消费结构迁移。
• 边界：只执行本版本声明的结构变化；不复用其他迁移序号，不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0021__模型候选与审校报告.sql

• 归属与种类：数据演进；迁移。
• 意图：为模型候选来源证据与版本化审校报告提供数据库演进。
• 职责：扩展候选来源约束接纳 model；新增模型候选证据绑定表与审校报告表（绑定候选版本与所依据快照）。
• 边界：只执行本版本声明的结构变化；候选来源约束显式核对后扩展；报告与绑定只追加不改写。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：存储与对象关系。

数据库/迁移/V0023__模型规划与调用级消费.sql

职责：模型规划来源绑定与调用级消费唯一键。

合同依据：结构迁移。机械范围与用例绑定见目标文件清单中同路径条目。

数据库/迁移/V0024__模型派发授权依据.sql

职责：为模型派发授权增加独立技术证据种类；不升级历史调用。

合同依据：结构迁移。机械范围与用例绑定见目标文件清单中同路径条目。

数据库/迁移/V0025__旧库迁移来源与映射.sql

职责：隔离目标标记与迁移台账的表、权限和不可变约束。

合同依据：数据模型/旧知识记录分流.md。机械范围与用例绑定见目标文件清单中同路径条目。

数据库/迁移/V0026__参考分析版本.sql

职责：B03完整分析单权威、源版本外键与只追加约束。

合同依据：模块设计/B03-资料研究.md。机械范围与用例绑定见目标文件清单中同路径条目。

数据库/迁移/V0027__作品声音版本.sql

职责：作品声音候选、不可变确认版本与当前指针。

合同依据：结构迁移。机械范围与用例绑定见目标文件清单中同路径条目。

数据库/迁移/V0028__文学审校报告.sql

职责：不可变文学片记录与完整报告。

合同依据：结构迁移。机械范围与用例绑定见目标文件清单中同路径条目。

数据库/迁移/V0033__质量案例.sql

• 归属与种类：数据演进；迁移。
• 意图与职责：B06不可变案例版本与可追溯当前指针。
• 边界：以案例与行为场景合同为限；不把候选、合成观察或结构映射当作真实模型和文学效果。
• 验证入口：现行用例登记及隔离PG、公开CLI/HTTP与行为场景裁决。

数据库/迁移/V0035__评测逐例执行.sql

• 归属与种类：数据演进；迁移。
• 意图：固定执行计划、单元任务绑定与真实交付。
• 职责：固定执行计划、单元任务绑定与真实交付。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0036__评测停止决定.sql

• 归属与种类：数据演进；迁移。
• 意图：独立保存停止决定，保留计划和已发生交付。
• 职责：独立保存停止决定，保留计划和已发生交付。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0037__逐调用交付确认.sql

• 意图：S02在实际响应保存后同事务确认每次调用，保存顺序不被最后调用指针覆盖。
• 职责：S02在实际响应保存后同事务确认每次调用，保存顺序不被最后调用指针覆盖。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0038__评测引文拒绝.sql

• 意图：B10不可变判断拒绝、原回合与前序哈希，限制纠正次数。
• 职责：B10不可变判断拒绝、原回合与前序哈希，限制纠正次数。
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史。
• 目标：迁移顺序与校验和可复验，失败不留下假完成版本。
• 合同依据：结构迁移。

数据库/迁移/V0039__评测条件第三.sql

• 意图：不可变的第三评必要性和原调用依据。
• 职责：不可变的第三评必要性和原调用依据。
• 边界：不确认正式创作内容、不标定文学效果或授予启用许可。
• 目标：与冻结数据、实际S02调用和原交付可核对，失败不能增加未批准的调用。
• 合同依据：模块设计/B10-效果评测.md。

数据库/迁移/V0040__标定金标准与凭据.sql

• 意图：维护封存的oracle标签与evaluation标定凭据。
• 职责：维护封存的oracle标签与evaluation标定凭据。
• 边界：不写正式内容，不用旧金标准或人工汇总授予启用权限。
• 目标：只从原候选、金标准与实际S02交付推导当前标定记录。
• 合同依据：模块设计/B10-效果评测.md。

数据库/迁移/V0041__评测语义检测单元.sql

• 意图：沿用不可变单元与S02，只扩充语义检测种类。
• 职责：沿用不可变单元与S02，只扩充语义检测种类。
• 边界：不写正式事实，不把检测回合当文学效果或生产启用证明。
• 目标：独立检测产物可从原调用和原文重新核验。
• 合同依据：模块设计/B10-效果评测.md；模块设计/B06-审校修订.md。

数据库/迁移/V0042__效果判据凭据.sql

• 意图：隔离评测域不可变效果凭据，不向生产角色开放。
• 职责：隔离评测域不可变效果凭据，不向生产角色开放。
• 边界：效果评测和凭据读回；不替代目标模块正式启用。
• 目标：固定目标、来源、分母与未定因素均可核对。
• 合同依据：模块设计/B10-效果评测.md。

数据库/迁移/V0043__目标启用凭据.sql

• 归属与种类：数据演进；迁移。
• 职责与目标：最小目标凭据和只读停止投影，保持生产评测权限隔离。
• 边界：只交接确切已测写手方法；生产不读答案，B04维护状态，合成结果不作生产批准。
• 合同依据：目标启用凭据。

数据库/迁移/V0045__具体改进与目标回执.sql

• 归属与种类：数据演进；迁移。
• 职责：具体改进、真实回执与长期观察。
• 边界：只通过owner改变目标，保留版本和未知值，不据此声明因果。
• 合同依据：B07作者经验。

数据库/迁移/V0046__作者长期观察.sql

• 归属与种类：数据演进；迁移。
• 职责：具体改进、真实回执与长期观察。
• 边界：只通过owner改变目标，保留版本和未知值，不据此声明因果。
• 合同依据：B07作者经验。

数据库/迁移/V0048__连载发布与读者反馈.sql

• 职责：完整定稿、实际导出与版本发布反馈。
• 边界：不覆盖工作正文、旧定稿或发布历史；不推断反馈因果。
• 目标：从真实作者入口读回固定版本与产物，失败可恢复。

完整迁移基线接缝

跨模块约束由各owner的迁移累计维护；V0050补齐交付到作品以及发布、反馈的作品一致性外键，已有指针与正文约束不重复创建。V0049只增加运行角色读取迁移账本的权限；各业务表的写权限仍由所属迁移明确授予，评测角色不因此获得生产内容权限。V0051的任务盘点视图按用途分区，仅投影作者、状态、用途和数量，S02公开入口再按作者过滤，不读取模型输入或原文。迁移使用追加编号，已发布迁移不得覆盖；基线验证使用空隔离库。

数据库/迁移/V0052__持久返修会话.sql

• 归属：数据演进。
• 职责：返修会话、轮次与作者动作的持久状态和约束。
• 合同：B06审校修订。

数据库/迁移/V0029__规则候选与诊断.sql

• 维护者：数据演进
• 职责：不可变规则候选版本、实际启用定位与诊断历史
• 设计意图：不可变规则候选版本、实际启用定位与诊断历史
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史
• 合同依据：结构迁移

数据库/迁移/V0030__模型修订结果.sql

• 维护者：数据演进
• 职责：不可变模型修订结果及候选关联
• 设计意图：不可变模型修订结果及候选关联
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史
• 合同依据：结构迁移

数据库/迁移/V0031__正文分支来源.sql

• 维护者：数据演进
• 职责：B05分支起点与合并候选来源不可变关联
• 设计意图：B05分支起点与合并候选来源不可变关联
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史
• 合同依据：结构迁移

数据库/迁移/V0032__选段修订依据.sql

• 维护者：数据演进
• 职责：诊断与作者圈选两类修订依据的约束
• 设计意图：诊断与作者圈选两类修订依据的约束
• 边界：只执行本版本声明的结构变化；不以启动自动修表或复用旧序号覆盖历史
• 合同依据：结构迁移

数据库/迁移/V0053__返修独立比较证明.sql

• 维护者：数据演进。
• 职责：不可变返修比较证明及生产只读投影。
• 合同：模块合同。

数据库/迁移/V0054__规则诊断资格与启停.sql

• 维护者：数据演进。
• 职责：独立规则验证、最小凭据及S01启停历史。
• 合同：模块合同。

数据库/迁移/V0055__运行观察来源.sql

• 维护者：数据演进。
• 职责：非空来源的只追加运行观察与幂等命令。
• 合同：模块合同。