T-002: 建立基础配置与环境样例

progress.md

@@ -124,3 +124,20 @@
   - 开发命令需在 MSYS2 bash shell 中运行；`init.ps1` 在 PowerShell 中直接调用 `.venv/bin/` 路径可工作
 - 下一步：T-002 建立基础配置与环境样例。
 
+## 2026-07-06 T-002 建立基础配置与环境样例
+
+- 状态：DONE
+- 变更：
+  - `skelet/settings/base.py`：新增 `import os`；`SECRET_KEY`、`DEBUG`、`ALLOWED_HOSTS`、`WAGTAILADMIN_BASE_URL` 改为从环境变量读取（dev 安全默认值）
+  - `skelet/settings/dev.py`：精简为只设 `DEBUG=True`、`ALLOWED_HOSTS=["*"]`、`EMAIL_BACKEND`，其余继承 base
+  - `skelet/settings/production.py`：`DEBUG=False`、`ALLOWED_HOSTS` 从环境变量读取、`ManifestStaticFilesStorage`、CSRF/Session 安全头
+  - 新建 `.env.example`：含 `SECRET_KEY`、`DEBUG`、`ALLOWED_HOSTS`、`WAGTAILADMIN_BASE_URL` 占位值和逐项注释
+  - `.gitignore`：添加 `!.env.example` 例外，确保样例文件可提交
+- 验证：
+  - `manage.py check`：0 errors, 3 treebeard 兼容警告（非阻塞）
+  - `grep -riE "secret|token|password" .env.example`：仅出现 `SECRET_KEY=replace-me` 占位值，无真实密钥
+  - `git check-ignore .env .env.example`：`.env` 被忽略，`.env.example` 可提交
+- 阻塞：无。
+- 决策：环境变量命名遵循 Django 惯例；dev 环境默认值满足本地开发需求，生产部署时所有值从环境变量注入。
+- 下一步：T-003 建立最小验证基线。
+