---
name: detail-design
when: '详细设计, 模块内部设计, 实现设计'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-artifact_template-详细设计模版
asset_kind: acceptance_template
lifecycle_status: active
owner_mechanism_id: mc-generic-artifact
authority: supporting
routes:
  - '*'
primary_triggers:
  - 详细设计
  - 模块内部设计
  - 实现设计
priority: P2
specificity: 3
version: 1.1.0
last_reviewed: '2026-06-01'
consumes: []
emits:
  - acceptance_report
secondary_triggers: []
negative_triggers: []
type: acceptance_template
stages: ["架构设计"]
---

# 详细设计文档

## 1. 设计前提
- 对接的架构设计文档：
- 依赖的接口/模块：

## 2. 数据结构（DDL/Model）
- 表结构定义（字段名、类型、约束、注释、默认值）
- 实体关系图
- 索引策略
- 审计字段（create_time/update_time/create_by/update_by）

## 3. 接口定义
- 内部接口（模块间调用）
- 方法签名、入参、出参、异常
- 幂等性声明

## 4. 核心逻辑
- 状态机定义（状态、事件、守卫、动作）
- 异常处理策略（每种异常的处理方式）
- 并发控制方案（乐观锁/悲观锁/分布式锁/幂等键）
- 缓存方案（缓存 key、TTL、失效策略）

## 5. 前后端适配矩阵
| 前端页面/组件 | 后端接口 | 数据字段映射 | 交互行为 |
|-------------|---------|------------|---------|
|             |         |            |         |

## 6. 菜单权限映射
| 菜单路径 | 角色 | 权限标识 | 关联接口 |
|---------|------|---------|---------|
|         |      |         |         |
