当前实现状态

本文是可覆盖的当前快照，记录代码与任务看板的现实状态。历史执行流水追加到 ../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 为准。

已完成：DOC-001 建立 harness coding 项目文档；DOC-002 更新 CHIS 登录与只读查询验证路线；DOC-003 明确使用系统 Python 3.8；DOC-004 明确 Flask factory 模式；DOC-005 明确日志与请求归档方案；T-001 初始化 Flask 项目骨架。详见 ../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 不脱敏，仅用于内网前置机本地受控排查。

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

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