docs: define flask factory and archive logging

progress.md

@@ -52,3 +52,21 @@
 - 阻塞：无。
 - 决策：项目使用当前系统 Python 3.8，不创建虚拟环境；T-001 创建 `requirements.txt` 并固定 `Flask==3.0.3`；依赖安装命令使用 `python -m pip install -r requirements.txt`。
 - 下一步：T-001 初始化 Flask 项目骨架。
+
+## 2026-07-04 DOC-004 明确 Flask factory 模式
+
+- 状态：DONE
+- 变更：更新 `docs/03-tech-stack.md`、`docs/04-architecture.md`、`docs/06-tasks.md`、`docs/current-state.md` 和 `README.md`。
+- 验证：已执行 `rg` 检查 `factory`、`application factory`、`create_app`、`Flask 3.0.3` 等关键词，并执行 `git diff` 确认仅包含 Flask factory 模式相关文档变更。
+- 阻塞：无。
+- 决策：Flask 应用使用 application factory 模式；T-001 实现 `app/__init__.py:create_app(config_object=None)`；测试通过 factory 注入测试配置。
+- 下一步：T-001 初始化 Flask 项目骨架。
+
+## 2026-07-04 DOC-005 明确日志与请求归档方案
+
+- 状态：DONE
+- 变更：更新 `.gitignore`、`docs/03-tech-stack.md`、`docs/04-architecture.md`、`docs/05-coding-rules.md`、`docs/02-requirements.md`、`docs/api.md`、`docs/06-tasks.md` 和 `docs/current-state.md`。
+- 验证：已执行 `rg` 检查 `logs/`、`archives/`、`不脱敏`、`保留 1 年`、`archive`、`原子写入`、`.gitignore`、`每天一个` 等关键词，并执行 `git diff` 检查日志与归档方案相关文档变更。
+- 阻塞：无。
+- 决策：运行日志写入 `logs/`，每天一个综合日志文件，包含多级别摘要日志，保留 1 年；每个 API 请求在 `archives/` 写入一个完整原始 JSON 归档文件，包含 `api` 和 `chis` 请求 / 响应数组，archive 不脱敏，仅用于内网前置机本地受控排查；`logs/` 和 `archives/` 不提交 git。
+- 下一步：T-001 初始化 Flask 项目骨架。