docs: define chis proxy config
This commit is contained in:
@@ -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,逐步补字段测试 |
|
||||
|
||||
Reference in New Issue
Block a user