nex_docus/docs/sdd/architecture/decisions/ADR-0007-idempotent-migrati...

18 lines
490 B
Markdown
Raw Normal View History

2026-08-19 10:05:22 +00:00
# ADR-0007轻量幂等数据库迁移非破坏性
- **状态**Accepted
## 背景
项目未引入 Alembic 可执行迁移链。
## 决策
启动时lifespan执行 `migrate_schema()`:查询 `information_schema` 判断列是否存在,仅对缺失列执行幂等 `ALTER TABLE`。只做“新增列”这类非破坏性变更。
## 后果
- 多实例/重复启动安全。
- 大规模结构变更缺少回放/回滚(见 OP-1 / OI-4
## 关联
DV-0010, NFR-7。