docs: define chis proxy config

This commit is contained in:
ila
2026-07-04 23:30:53 +08:00
parent 79c57a63c5
commit 3405e0c6bb
13 changed files with 36 additions and 9 deletions
+4 -1
View File
@@ -25,7 +25,7 @@ Mapper / transformer
v
CHIS client + auth manager
|
| cookies / session cache
| cookies / session cache / optional CHIS_PROXY
v
Redis
|
@@ -88,6 +88,8 @@ API / service / CHIS client
- 封装 `*.jsonRequest` 和其他 CHIS HTTP 请求。
- 自动携带会话 cookie 和必要 header。
- 读取 `CHIS_PROXY`:配置为空时直连;配置有值时对 CHIS 登录、账号信息查询和 `*.jsonRequest` 统一使用代理。
- 代理只作用于出站访问 CHIS,不代理第三方系统访问本项目的入站请求。
- 处理超时、重试、登录失效、错误码、日志脱敏。
- 先用 `getLanderInfo`、`getEncryType`、`getHMNIListOfHTML` 等只读接口验证通道,再接入保存接口。
@@ -284,6 +286,7 @@ archives/
| 难点 | 说明 | 应对 |
| --- | --- | --- |
| CHIS 登录链路 | 可能涉及公钥、加密、角色、应用、机构上下文 | 等用户提供现有代码后接入,先写 auth 边界 |
| CHIS 网络代理 | 部署在内网前置机时,访问 CHIS 可能必须走 SOCKS5 | 使用可选 `CHIS_PROXY` 配置;空值直连,有值时为 `http` / `https` 同时设置 requests proxies |
| 会话有效性 | cookie 存在不代表 CHIS 会话仍有效 | 用账号信息查询接口确认,失败则清理缓存并重登 |
| 只传体检 id 查询详情 | `getHMNIListOfHTML` 还需要 `phrId` 和 `idCard` | 先要求调用方传全参数,后续验证反查链路 |
| 体检字段转换 | CHIS 前端保存逻辑复杂,数据块多 | 先做最小样例 mapper,逐步补字段测试 |