feat(osi): 打通 Go 侧真实请求验收（T-005）

docs/current-state.md

@@ -6,26 +6,27 @@
 ## 当前快照
 
 - 日期：2026-07-06
-- 阶段：**Phase 0 骨架基本完成**；T-001~T-004 已完成，剩余 T-005 做 Go 侧真实请求验收与 `init.sh` 配置
-- 技术栈：Go 1.24 单二进制；`main.go -mode server|deliver`；配置读取使用 viper；OSI 客户端已具备签名、信封、传输和基础判码
-- 生产代码：已有 `main.go`、`config/`、`contract/envelope.go`、`osi/sign.go`、`osi/transport.go`、`osi/codes.go`、`osi/client.go`、`go.mod`/`go.sum`；`mapping/ pipeline/` 等业务目录仍待后续任务建立
-- 联调现实：**JKDA00002 个人档案查询已用 Python 脚本打通真实沙箱**（`code="01"`），实测契约沉淀在 `docs/04 §8`
-- 测试：`go test ./...` 通过；当前测试覆盖 mode 解析、配置加载、MD5 签名、请求头组装、JSON POST 传输、超时配置、SOCKS5 代理地址校验、信封结构、serviceId 路由、成功/重试判码、Client.Call 请求与响应解析
-- 标准启动路径：`./init.sh`（需要 bash/WSL 环境；当前 Windows 环境未安装 WSL，直接运行会失败）
+- 阶段：**Phase 0 已完成**；T-001~T-005 已验收，下一步进入 Phase Q 的 T-201
+- 技术栈：Go 1.24 单二进制；`main.go -mode server|deliver`；配置读取使用 viper，支持环境变量覆盖；OSI 客户端已具备签名、信封、传输、基础判码与 JKDA00002 验证入口
+- 生产代码：已有 `main.go`、`config/`、`contract/envelope.go`、`osi/sign.go`、`osi/transport.go`、`osi/codes.go`、`osi/client.go`、`verify_jkda.go`、`go.mod`/`go.sum`；`contract/jkda.go`、`mapping/`、`pipeline/` 等业务模块仍待后续任务建立
+- 联调现实：**JKDA00002 个人档案查询已用 Go 侧真实请求打通**，返回 `code="01" message="操作成功" data_count=1`；Python 联调样本和实测契约沉淀在 `docs/04 §8`
+- 测试：`go test ./...` 通过；当前测试覆盖 mode 解析、配置加载与环境变量覆盖、MD5 签名、请求头组装、JSON POST 传输、头名大小写保留、超时配置、SOCKS5 代理地址校验、信封结构、serviceId 路由、成功/重试判码、Client.Call 请求与响应解析、JKDA00002 验证入口
+- 标准启动路径：`./init.sh` 已配置三步：依赖下载、`go test ./...`、`go run . -mode server -config config.yaml.example`
 - 标准验证路径：`go test ./...`、`go build ./...`
-- 当前 blocker：无硬 blocker。软阻塞：厂家侧 B1/B2/B4/B5 契约缺口（见 `docs/06`），只影响阶段 4，不阻塞阶段 0~3
+- 当前 blocker：无硬 blocker。软限制：当前机器从 Git Bash 启动 Go 会出现标准库路径/构建缓存权限异常，`init.sh` 无法完整跑完；PowerShell 下等价 Go 命令和真实请求通过。厂家侧 B1/B2/B4/B5 契约缺口只影响阶段 4，不阻塞 Phase Q/M/D 的当前路径
 
 ## 当前目录要点
 
 | 路径 | 状态 | 说明 |
 | --- | --- | --- |
-| `main.go` | 已有 | 单入口，解析 `-mode server|deliver` 与 `-config` |
-| `config/` | 已有 | viper 配置加载，含最小单测 |
+| `main.go` | 已有 | 单入口，解析 `-mode server|deliver`、`-config`，并提供 `-verify-jkda-id-card` 联调验证入口 |
+| `config/` | 已有 | viper 配置加载，支持 `OSI_*` 等环境变量覆盖 |
 | `contract/envelope.go` | 已有 | OSI 通用信封与 `manageInfo` 结构 |
 | `osi/sign.go` | 已有 | OSI 请求头 MD5 签名与 headers 组装 |
-| `osi/transport.go` | 已有 | JSON POST 传输层；支持超时与可选 SOCKS5；不带 cookiejar/网页拟态头 |
+| `osi/transport.go` | 已有 | OSI JSON POST 传输层；原始 HTTP/1.1 写请求以保留头名大小写；支持超时与可选 SOCKS5 |
 | `osi/codes.go` | 已有 | serviceId 路由与成功/可重试判码 |
 | `osi/client.go` | 已有 | 通用 `Call`：签名头 + 信封 + 传输 + 响应解析 |
+| `verify_jkda.go` | 已有 | JKDA00002 真实请求验证辅助入口 |
 | `config.yaml.example` | 已有 | 占位配置，不含真实凭据 |
 | `go.mod` `go.sum` | 已有 | module `chis_osi`，依赖 viper 与 `golang.org/x/net/proxy` |
 | `docs/` | 已有 | 设计文档集 01~06 + 本快照；`账号.txt` 本地留存不入库 |
@@ -43,6 +44,7 @@
 - 机构码分层：请求头 `orgCode`=18 位统信码 ≠ `manaUnitId`=9 位机构码 ≠ 12 位区划码，见 `docs/01 §3`。
 - `deviceSN` 查询可空。
 - OSI 代理语义：`socks5_proxy` 非空即只对 OSI 客户端走 SOCKS5，不做直连回退。
+- 真实平台/代理对请求头名大小写敏感；Go `net/http` 会规范化头名，OSI 传输层需保留 `orgCode/deviceSN/userName` 的原始大小写。
 
 ## 当前可运行内容
 
@@ -54,17 +56,20 @@ go test ./contract ./osi
 go run . -mode server -config config.yaml.example
 go run . -mode deliver -config config.yaml.example
 
-# 统一入口（需要 bash/WSL）
+# 统一入口（当前 Git Bash 环境存在 Go 标准库/缓存权限限制）
 ./init.sh
 
-# 本地联调查询（脚本硬编码凭据，勿提交）
+# Go 侧 JKDA00002 联调验证（需通过环境变量或 config.yaml 提供真实凭据；不要提交真实值）
+go run . -mode server -config config.yaml -verify-jkda-id-card <idCard>
+
+# 本地 Python 联调查询（脚本硬编码凭据，勿提交）
 python3 scripts/query_health_record.py
 ```
 
 ## 下一步
 
-1. T-005：阶段 0 验收，Go 侧用 JKDA00002 打通真实请求并调整 `init.sh`。
-2. T-201：查询响应契约结构体（T-005 后）。
+1. T-201：`contract/jkda.go`，按 `docs/04 §8` 实测契约建立 JKDA00002 查询响应结构体。
+2. T-203：在结构体就绪后实现 `osi/jkda.go` 的 Find / FindRqbj。
 
 ## 维护规则