docs(design): 补全中文设计文档体系
This commit is contained in:
71
docs/设计文档/0.设计文档索引.md
Normal file
71
docs/设计文档/0.设计文档索引.md
Normal file
@@ -0,0 +1,71 @@
|
||||
# 模块详细设计文档索引
|
||||
|
||||
## 1. 设计文档说明
|
||||
|
||||
本目录存放 Universal Agent Demo Framework V1 的设计文档。需求文档回答“要做什么”,设计文档回答“怎么实现、边界在哪里、如何验证”。
|
||||
|
||||
文档命名统一使用中文编号,便于复试讲解和按顺序阅读。
|
||||
|
||||
## 2. 模块设计文档列表
|
||||
|
||||
| 顺序 | 文档 | 说明 |
|
||||
|---|---|---|
|
||||
| 0 | `0.设计文档索引.md` | 当前索引 |
|
||||
| 1 | `1.智能体总体设计.md` | 智能核心总体链路、配置、输出和 Adapter |
|
||||
| 2 | `2.功能流程设计.md` | 复试准备、演示、上传、入库、对话和审计流程 |
|
||||
| 3 | `3.数据库设计.md` | Django 数据模型、字段、索引和初始化策略 |
|
||||
| 4 | `4.页面与路由设计.md` | 页面结构、URL、跳转和异常状态 |
|
||||
| 5 | `5.部署设计.md` | 本地、Docker、环境变量和持久化 |
|
||||
|
||||
模块详细设计位于 `模块设计/`:
|
||||
|
||||
| 模块 | 文档 |
|
||||
|---|---|
|
||||
| 配置 | `模块设计/1.配置模块详细设计.md` |
|
||||
| 场景 | `模块设计/2.场景模块详细设计.md` |
|
||||
| 文档 | `模块设计/3.文档模块详细设计.md` |
|
||||
| 对话 | `模块设计/4.对话模块详细设计.md` |
|
||||
| 审计 | `模块设计/5.审计模块详细设计.md` |
|
||||
| 智能核心 | `模块设计/6.智能核心模块详细设计.md` |
|
||||
|
||||
## 3. 模块依赖关系
|
||||
|
||||
```text
|
||||
config
|
||||
|-- apps.scenarios
|
||||
|-- apps.documents
|
||||
|-- apps.chat
|
||||
|-- apps.audit
|
||||
|
||||
apps.scenarios
|
||||
|-- reads configs/*.yaml
|
||||
|
||||
apps.documents
|
||||
|-- depends on apps.scenarios
|
||||
|-- calls agent_core.rag.ingest
|
||||
|
||||
apps.chat
|
||||
|-- depends on apps.scenarios
|
||||
|-- calls agent_core.orchestrator
|
||||
|-- calls apps.audit.services
|
||||
|
||||
apps.audit
|
||||
|-- stores AgentResult snapshots
|
||||
|
||||
agent_core
|
||||
|-- consumes scenario config
|
||||
|-- uses RAG, tools, LLM provider and structured output parser
|
||||
```
|
||||
|
||||
## 4. 推荐阅读顺序
|
||||
|
||||
1. `docs/需求分析/1.V1总需求文档.md`
|
||||
2. `docs/需求分析/2.模块需求索引.md`
|
||||
3. `docs/设计文档/1.智能体总体设计.md`
|
||||
4. `docs/设计文档/2.功能流程设计.md`
|
||||
5. `docs/设计文档/3.数据库设计.md`
|
||||
6. `docs/设计文档/4.页面与路由设计.md`
|
||||
7. `docs/设计文档/5.部署设计.md`
|
||||
8. `docs/设计文档/模块设计/*.md`
|
||||
|
||||
后续编码时,每个模块应先对照对应需求文档和详细设计,再实现模型、服务、视图和测试。
|
||||
Reference in New Issue
Block a user