chore(config): 初始化项目配置与部署基础

docs/需求分析/1.V1总需求文档.md

@@ -362,12 +362,28 @@ V1 模型适配器需要支持：
 环境变量示例：
 
 ```env
+DJANGO_SECRET_KEY=replace-with-a-local-secret-key
+DJANGO_DEBUG=true
+DJANGO_ALLOWED_HOSTS=*
+
 LLM_API_KEY=your_api_key
 LLM_BASE_URL=https://api.openai.com/v1
 LLM_MODEL=gpt-4.1-mini
+EMBEDDING_API_KEY=
+EMBEDDING_BASE_URL=
 EMBEDDING_MODEL=text-embedding-3-small
+SCENARIO_CONFIG_DIR=configs
+UPLOAD_ROOT=data/uploads
+CHROMA_PATH=data/chroma
 ```
 
+补充说明：
+
+- `EMBEDDING_API_KEY` 为空时可复用 `LLM_API_KEY`。
+- `EMBEDDING_BASE_URL` 为空时可复用 `LLM_BASE_URL`。
+- `.env.example` 仅作为模板，不允许放真实密钥。
+- 当前 V1 代码会在 settings 初始化时自动读取根目录 `.env`，本地运行与 `pytest` 可复用同一套配置；当前 Docker Compose 配置也通过 `env_file` 读取 `.env`。
+
 ## 10. Dify 集成策略
 
 V1 不把 Dify 作为核心依赖。

docs/需求分析/3.配置模块需求.md

@@ -55,6 +55,12 @@ Config 模块是 Django 项目的基础配置模块，负责系统启动、路
 | `UPLOAD_ROOT` | `data/uploads` | 上传文件目录 |
 | `SCENARIO_CONFIG_DIR` | `configs` | 场景配置目录 |
 
+补充要求：
+
+- `.env.example` 仅作为模板文件，不得写入真实密钥。
+- 本地直接执行 `python manage.py runserver` 时，应自动读取根目录 `.env`。
+- Docker 运行时可通过 `env_file` 或容器环境变量注入同一组配置；当前仓库默认由 Compose 读取 `.env`。
+
 ## 5. 目录需求
 
 系统启动时需要保证以下目录存在：
@@ -91,6 +97,8 @@ python manage.py migrate
 python manage.py runserver
 ```
 
+说明：上述命令执行前，应先准备好根目录 `.env`；当前 V1 代码会在启动时自动加载该文件。
+
 Docker 启动：
 
 ```bash