---
name: design-db
description: 根据业务数据、访问模式和目标数据库版本设计或评审表、约束、索引、迁移与回滚方案。适用于数据库结构设计和 DDL 方案；ORM 映射检查、后端整体设计或未经确认直接执行数据库变更不应触发。
---

# 数据库设计

以业务不变量、访问模式和目标数据库真实能力为依据，不套用固定字段、命名或数据库方言。

## 工作流

1. 确认数据库产品、精确版本、字符集、现有模型、数据规模和迁移约束。
2. 设计实体、关系、主键、约束、类型、索引和数据生命周期。
3. 按 [官方来源](references/sources.md) 核实目标版本语法及行为，不跨数据库复制 DDL。
4. 输出结构、约束、索引依据、迁移顺序、兼容、回滚和验证查询。
5. 用户要求保存设计说明时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；先检索并更新已有权威数据设计，实质修改共享文档后按项目文档维护规范更新审核状态。
6. 默认只给方案；执行 DDL、迁移存量数据或连接数据库需要单独授权。

写入后在 `workRoot/<task>/task.json` 登记创建、更新或引用关系。已有文档属于其他任务时只登记关联，不取得删除权限；可执行迁移文件仍沿用项目迁移工具约定。

未知容量、并发和查询模式应标为假设，不凭惯例制造审计字段或业务枚举。