chisup/docs/current-state.md

# 当前实现状态

> 本文是可覆盖的当前快照，记录代码与任务看板的现实状态。历史执行流水追加到 [../progress.md](../progress.md)。

## 当前快照

- 日期：2026-07-04
- 阶段：MVP 起步 / Flask 地基已初始化
- 技术栈：当前系统 Python 3.8、Flask 3.0.3 application factory；不创建虚拟环境
- 生产代码：`app/__init__.py`、`app/api/health.py`、`app/config.py`、`run.py`
- 测试：`tests/test_app_factory.py`
- 数据 / 资料：`reverse_file/` 下已有 CHIS HAR、前端脚本和 schema；`D:\hans\chupd\chis\login_client_v2.py` 可作为登录链路参考
- 标准启动路径：`python run.py`
- 标准验证路径：`python -m unittest discover -s tests`
- 当前 blocker：无硬阻塞；后续实现需要把 Django 登录代码迁移为 Flask 版本，并通过配置提供 CHIS public key

## 当前目录要点

| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `docs/` | 已有 | 项目规范化文档 |
| `reverse_file/` | 已有 | CHIS 逆向资料，当前重要事实来源 |
| `reverse_file/20260704_query_health_check.har` | 已有 | 体检详情只读查询 HAR，包含 `getHMNIListOfHTML` 和 `getCheckInfoDetail` |
| `D:\hans\chupd\chis\login_client_v2.py` | 外部参考 | CHIS 登录、SM2 加密、角色选择、cookie 拼接、`getLanderInfo` 会话验证 |
| `app/` | 已有 | Flask application factory 和 health check API |
| `tests/` | 已有 | `unittest` 测试 |
| `requirements.txt` | 已有 | Python 依赖，固定 `Flask==3.0.3` |

## 任务看板状态

任务状态以 [06-tasks.md](06-tasks.md) 为准。

- 已完成：DOC-001 建立 harness coding 项目文档；DOC-002 更新 CHIS 登录与只读查询验证路线；DOC-003 明确使用系统 Python 3.8；DOC-004 明确 Flask factory 模式；DOC-005 明确日志与请求归档方案；T-001 初始化 Flask 项目骨架。详见 [../progress.md](../progress.md)。
- 正在进行：无。
- 下一个可领取任务：T-002 建立基础配置与目录。

## 已确认技术事实

- CHIS public key 可通过配置文件或环境变量提供。
- 使用当前系统 Python 3.8 环境，不创建虚拟环境；T-001 创建 `requirements.txt` 固定依赖。
- Flask 应用使用 application factory 模式，`app/__init__.py` 暴露 `create_app(config_object=None)`。
- 登录链路参考 `login_client_v2.py`：`myRoles` -> 选择 `责任医生助理` / `责任医生` -> `myApps` -> 拼接 cookie。
- SM2 加密参考 `hans_chis.sm2.sm2_encrypt`：`gmssl.sm2.CryptSM2(mode=0)`，返回带 `04` 前缀密文。
- 会话验证可用 `chis.myPageService / getLanderInfo`。
- 体检详情查询第一版可用 `healthCheck + phrId + idCard` 调 `getHMNIListOfHTML`，用 `idCard + checkDate` 调 `getCheckInfoDetail`。
- 当前不能证明只传 `healthCheck` 就能查完整详情。
- 运行日志保存到 `logs/`，每天一个综合日志文件，保留 1 年。
- 每个 API 请求保存一个 `archives/` JSON 归档文件，包含完整 API 和 CHIS 请求 / 响应，archive 不脱敏，仅用于内网前置机本地受控排查。

## 当前可运行内容

```powershell
python -m pip install -r requirements.txt
python -m unittest discover -s tests
python run.py
```

## 开始编码前检查

1. 读 [../AGENTS.md](../AGENTS.md)。
2. 读 [00-ai-start-here.md](00-ai-start-here.md)。
3. 读 [05-coding-rules.md](05-coding-rules.md)。
4. 从 [06-tasks.md](06-tasks.md) 领取第一个 `TODO` 且依赖均完成的任务。
5. 将该任务状态改为 `DOING` 后再改代码。

## 维护规则

当实际代码状态发生变化时，同步更新本文件：

- 新增或移动入口文件。
- 初始化框架或模块。
- 任务从 `TODO` 进入 `DOING` 或 `DONE`。
- 新增可运行命令。
- 发现文档和代码现实不一致。