DEMO-AGENT/docs/设计文档/0.设计文档索引.md

模块详细设计文档索引

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. 模块依赖关系

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

后续编码时，每个模块应先对照对应需求文档和详细设计，再实现模型、服务、视图和测试。