设计文档
目录说明
设计文档用于存储功能设计、架构设计等设计相关文档。
核心原则
- 抽象与实现分离:设计文档描述"做什么"和"为什么",不描述"怎么做"
- 引用知识库:设计文档应引用知识库中的规范和参考
- 关联决策:设计文档应关联相关的决策记录(ADR)
📋 需求设计
位置:需求设计/
用途:功能需求、业务需求
文档类型
- 功能需求文档
- 数据库类型差异分析
- 业务规则说明
🏗️ 架构设计
位置:架构设计/
用途:系统架构、组件架构设计
文档类型
- 前端架构设计
- 后端架构设计
- 事件系统设计
- 右键菜单系统设计
⚙️ 功能设计
位置:功能设计/
用途:具体功能的设计文档
文档类型
- 表结构查看功能设计
- 多表结构查看方案分析
- 待讨论问题汇总
🎨 样式设计
位置:根目录
用途:前端布局和样式系统设计
文档类型
- 前端布局样式系统设计
📝 设计文档模板
功能设计模板
# {功能名称}设计
**状态**:{设计中|已完成|已废弃}
**创建日期**:YYYY-MM-DD
**最后更新**:YYYY-MM-DD
## 一、设计目标
功能要解决什么问题?
## 二、设计约束
引用:[知识库/规范/编码规范.md](../../知识库/规范/编码规范.md)
## 三、设计方案
### 3.1 方案概述
### 3.2 详细设计
## 四、相关决策
- [ADR-{序号}](../../决策记录/ADR-{序号}.md)
## 五、待讨论问题
- [问题追踪/待讨论/{问题}.md](../../问题追踪/待讨论/{问题}.md)
## 六、实现计划
1. 步骤1
2. 步骤2
🔗 关联关系
设计文档应明确关联:
- 知识库:引用的规范和参考
- 决策记录:相关的架构决策
- 问题追踪:待讨论和待实现的问题