---
name: database-design
id: ka-artifact_template-database-design
asset_kind: acceptance_template
lifecycle_status: active
authority: supporting
scope:
  - backend
products:
  - '*'
routes:
  - artifact_generation
primary_triggers:
  - 数据库设计文档
priority: P1
specificity: 4
version: 1.1.0
last_reviewed: '2026-06-01'
owner_mechanism_id: mc-design-artifact-pack
consumes:
  - docs/architecture/00-架构决策记录.md
  - docs/architecture/01-架构设计文档.md
emits:
  - docs/architecture/02-数据库设计文档.md
  - db/migrations
  - db/schema
required_evidence:
  - executable_sql_or_migration
  - api_database_traceability
type: acceptance_template
artifact_schema:
  kind: design_doc
  required_sections:
    - 目标数据库与权威SQL
    - 实体与关系
    - 表字段与敏感级别
    - 约束索引与查询场景
    - 租户安全审计与数据生命周期
    - Migration回滚备份恢复
    - API/DTO至字段追踪矩阵
    - 真实验证证据与未决项
  required_tables:
    - 目标数据库表
    - 表字段与敏感级别表
  required_fields:
    表字段与敏感级别表:
      - 表
      - 字段
      - 类型
      - 可空
      - 默认值
      - 业务含义
      - 敏感级别
      - 生命周期
  required_artifacts:
    - SQL/migration 文件
  forbidden_gaps:
    - 缺少字段表的表定义
stages: ["联调验证"]
---

# 数据库设计文档

## 1. 目标数据库与权威 SQL

| 项目 | 内容 |
|------|------|
| 数据库及版本 | |
| SQL/migration 权威路径 | |
| 执行验证命令及结果 | |

## 2. 实体与关系

## 3. 表字段与敏感级别

| 表 | 字段 | 类型 | 可空 | 默认值 | 业务含义 | 敏感级别 | 生命周期 |
|----|------|------|------|--------|----------|----------|----------|

## 4. 约束、索引与查询场景

## 5. 租户、安全、审计与数据生命周期

## 6. Migration、回滚、备份恢复

## 7. API/DTO 至字段追踪矩阵

## 8. 真实验证证据与未决项
