---
name: schema-change-pipeline
type: pipeline_procedure
when: '数据库结构变更, 加字段, 改字段, 新建表, 加索引, DDL变更, schema变更, 数据库迁移'
scope:
  - backend
products:
  - '*'
id: ka-procedure-Schema变更流水线
asset_kind: pipeline_procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-knowledge-asset-governance
routes:
  - code_change
primary_triggers:
  - Schema变更流水线
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-knowledge-asset-governance
emits:
  - schema_change_plan
  - migration_script
  - schema_change_verification_result
required_evidence:
  - execution_evidence
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["编码与单元测试", "联调验证"]
---

# 数据库变更管线

### 第1步：变更设计
评估变更类型（加列/改列/删列/加索引/数据迁移/新建表）。确认向前兼容性（新列默认值或允许 NULL）。制定四层兼容策略（数据库→接口契约→前端展示→导出逻辑）。
模版：数据库变更方案模版.md
产出保存到：.soloforge/output/01-变更方案.md
工具：sf_classify

### 第2步：迁移脚本
编写 migration 脚本（正向 + 回滚），确保幂等。大表加列使用分批更新策略。大表加索引使用 ONLINE DDL。禁止 migration 中写业务逻辑。
产出保存到：.soloforge/output/02-migration.sql
工具：sf_expand

### 第3步：代码适配
更新 Entity/DTO 映射。更新接口契约（请求/响应字段）。更新前端展示和表单。更新导出逻辑（如有）。更新相关测试数据和测试用例。
工具：sf_expand

### 第4步：验证验收
开发环境执行 migration 验证表结构。运行全量测试。代码审查重点关注：四层兼容完整性、回滚脚本有效性、大表性能影响评估。
工具：sf_verify, sf_review, sf_learn
