docs: 初始化项目需求和协作文档

docs/modules/00_module_requirements_index.md

@@ -0,0 +1,86 @@
+# 模块需求文档索引
+
+本文档用于汇总 Universal Agent Demo Framework V1 的模块拆分和需求文档位置。
+
+## 1. 模块拆分原则
+
+V1 按 6 个核心模块拆分：
+
+```text
+config
+apps.scenarios
+apps.documents
+apps.chat
+apps.audit
+agent_core
+```
+
+拆分原则：
+
+- Django Apps 负责业务外壳。
+- Agent Core 负责 AI 能力。
+- RAG、工具调用、模型适配不直接写进 View。
+- 第一版不做复杂权限、多租户和完整工作流。
+- 模块数量保持克制，方便复试前快速改题。
+
+## 2. 模块文档列表
+
+| 模块 | 文档 | 说明 |
+|---|---|---|
+| Config | `01_config_module_requirements.md` | Django 项目配置、环境变量、部署配置 |
+| Scenarios | `02_scenarios_module_requirements.md` | 场景模板、场景配置、场景列表 |
+| Documents | `03_documents_module_requirements.md` | 文件上传、文件管理、RAG 入库入口 |
+| Chat | `04_chat_module_requirements.md` | 对话页面、Agent 调用、结果展示 |
+| Audit | `05_audit_module_requirements.md` | 审计日志、检索记录、工具调用记录 |
+| Agent Core | `06_agent_core_module_requirements.md` | RAG、工具、模型调用、结构化输出、编排 |
+
+## 3. 模块依赖关系
+
+```text
+apps.chat
+  |-- depends on apps.scenarios
+  |-- depends on apps.audit
+  |-- calls agent_core
+
+apps.documents
+  |-- depends on apps.scenarios
+  |-- calls agent_core.rag.ingest
+
+apps.audit
+  |-- stores result from apps.chat / agent_core
+
+agent_core
+  |-- reads scenario config object
+  |-- uses Chroma
+  |-- uses LLM Provider
+  |-- uses Tool Registry
+```
+
+## 4. 推荐开发顺序
+
+建议按以下顺序开发：
+
+1. Config 模块：保证项目可启动。
+2. Scenarios 模块：展示 5 个预置场景。
+3. Agent Core 最小闭环：输入问题，返回模拟结构化结果。
+4. Chat 模块：页面调用 Agent Core。
+5. Audit 模块：记录每次对话。
+6. Documents 模块：上传文档。
+7. Agent Core RAG：文档入库和检索。
+8. Agent Core 工具系统：增加内置工具。
+9. Docker：一键启动。
+
+## 5. V1 完成标准
+
+模块文档全部完成后，V1 的实现应满足：
+
+- 系统可以启动。
+- 首页可以看到 5 个场景。
+- 可以进入场景对话。
+- 可以上传文档。
+- 可以触发 RAG 入库。
+- Agent 可以返回结构化输出。
+- 工具调用和引用来源可以展示。
+- 每次对话都有审计日志。
+- Docker Compose 可以一键启动。
+