# 执行进度记录

> 本文件是只追加的历史流水，用来记录任务执行过程、验证命令、阻塞点和关键决策。
> 当前目录、当前命令、下一个可领取任务等可覆盖快照，写入 [docs/current-state.md](docs/current-state.md)。

## 职责边界

- `docs/06-tasks.md`：任务看板，维护任务状态、依赖和验收要点。
- `progress.md`：历史流水，只追加记录每轮执行发生了什么。
- `docs/current-state.md`：当前快照，可覆盖更新仓库现实、可运行命令和下一步。

## 记录格式

每完成或中断一轮任务，在文件末尾追加一条记录：

```markdown
## YYYY-MM-DD T-编号 任务名

- 状态：DONE / BLOCKED / PARTIAL
- 变更：修改了哪些文件或模块
- 验证：运行的真实命令和结果
- 阻塞：如有，写明原因和需要谁决策
- 决策：如有，记录本轮确定的关键取舍
- 下一步：建议下一个任务 ID 或待确认事项
```

## 执行记录

## 2026-07-04 DOC-001 建立 harness coding 项目文档

- 状态：DONE
- 变更：新增根目录入口文档和 `docs/` 项目文档。
- 验证：已执行 `Get-ChildItem -Recurse -File | Select-Object FullName,Length | Sort-Object FullName`、`rg` 检查 Markdown 链接和关键占位 / 敏感词；发现并修正根目录任务编号漂移。
- 阻塞：无。
- 决策：当前文档只记录已确认事实；CHIS 登录、会话有效性、字段转换细节等待后续代码和样例补充。
- 下一步：T-001 初始化 Flask 项目骨架。

## 2026-07-04 DOC-002 更新 CHIS 登录与只读查询验证路线

- 状态：DONE
- 变更：更新 `docs/06-tasks.md`、`docs/04-architecture.md`、`docs/api.md`、`docs/02-requirements.md`、`docs/current-state.md`、`docs/00-ai-start-here.md`、`docs/03-tech-stack.md`、`README.md` 和 `tasks.md`。
- 验证：已执行 `Get-ChildItem -Recurse -File`、`rg` 检查任务编号、查询 HAR、public key、登录代码引用和 Markdown 链接；发现并修正 `AGENTS.md` 中过时的“后续补充登录代码”描述。
- 阻塞：无。
- 决策：public key 由配置提供；`D:\hans\chupd\chis\login_client_v2.py` 作为登录链路参考但不能原样依赖 Django；保存上报前新增只读体检详情查询阶段；第一版详情查询需要 `healthCheck + phrId + idCard + checkDate`，不假设只传体检 id 即可查询。
- 下一步：T-001 初始化 Flask 项目骨架。

## 2026-07-04 DOC-003 明确使用系统 Python 3.8

- 状态：DONE
- 变更：更新 `docs/06-tasks.md`、`docs/03-tech-stack.md`、`docs/current-state.md` 和 `README.md`。
- 验证：已执行 `rg` 检查 `虚拟环境`、`venv`、`requirements.txt`、`pip install` 等关键词，并执行 `git diff` 确认仅包含系统 Python 3.8 环境决策相关文档变更。
- 阻塞：无。
- 决策：项目使用当前系统 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 项目骨架。