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

docs/设计文档/5.部署设计.md

@@ -18,6 +18,8 @@ python manage.py runserver
 
 本地运行使用 SQLite、`data/uploads` 和 `data/chroma`。
 
+当前本地方式会在启动时自动读取根目录 `.env`，因此 `runserver`、`pytest` 和日常脚本可以共享同一套配置。
+
 ## 3. Docker 运行方式
 
 建议命令：
@@ -47,6 +49,12 @@ V1 Docker Compose 只需要一个 Django Web 服务。Chroma 使用本地持久
 
 `.env.example` 应提供这些变量的样例，不写真实密钥。
 
+当前实现说明：
+
+- 本地 Python 方式启动时，会先加载根目录 `.env`，再读取进程环境中的覆盖值。
+- Docker Compose 方式可通过 `env_file` 向容器注入环境变量；当前仓库默认读取 `.env`。
+- 因此本地运行和容器运行可以默认共用一份 `.env`，但演示前仍应确认密钥和模型参数是否正确。
+
 ## 5. 目录挂载设计
 
 Docker 需要持久化以下目录：

docs/设计文档/模块设计/1.配置模块详细设计.md

@@ -97,6 +97,12 @@ V1 可使用标准库 `os.environ.get()`，不强制引入复杂配置库。
 
 `DJANGO_ALLOWED_HOSTS` 使用逗号分隔，空值时默认 `["*"]`。
 
+当前实现约束：
+
+- 本地直接运行 Django 命令时，会先尝试解析根目录 `.env` 文件，再读取进程环境中的覆盖值。
+- Docker Compose 方式可以通过 `env_file` 传入同一批变量；当前仓库默认读取 `.env`。
+- `.env.example` 只保留占位符示例，不保存真实 API Key。
+
 ## 8. 验收标准
 
 - `python manage.py check` 通过。