feat(osi): 实现通用 Call 与响应判码(T-004)
This commit is contained in:
+12
-8
@@ -6,11 +6,11 @@
|
||||
## 当前快照
|
||||
|
||||
- 日期:2026-07-06
|
||||
- 阶段:**Phase 0 进行中**;T-001/T-002/T-003 已完成,Go module、CLI/config 骨架、MD5 签名与 OSI 传输层已建立
|
||||
- 技术栈:Go 1.24 单二进制;`main.go -mode server|deliver`;配置读取使用 viper;OSI 传输支持超时和可选 SOCKS5 代理
|
||||
- 生产代码:已有 `main.go`、`config/`、`osi/sign.go`、`osi/transport.go`、`go.mod`/`go.sum`;`contract/ mapping/ pipeline/` 等业务目录仍待后续任务建立
|
||||
- 阶段:**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 解析、`config.yaml.example` 加载、MD5 签名、请求头组装、JSON POST 传输、超时配置和 SOCKS5 代理地址校验
|
||||
- 测试:`go test ./...` 通过;当前测试覆盖 mode 解析、配置加载、MD5 签名、请求头组装、JSON POST 传输、超时配置、SOCKS5 代理地址校验、信封结构、serviceId 路由、成功/重试判码、Client.Call 请求与响应解析
|
||||
- 标准启动路径:`./init.sh`(需要 bash/WSL 环境;当前 Windows 环境未安装 WSL,直接运行会失败)
|
||||
- 标准验证路径:`go test ./...`、`go build ./...`
|
||||
- 当前 blocker:无硬 blocker。软阻塞:厂家侧 B1/B2/B4/B5 契约缺口(见 `docs/06`),只影响阶段 4,不阻塞阶段 0~3
|
||||
@@ -21,21 +21,25 @@
|
||||
| --- | --- | --- |
|
||||
| `main.go` | 已有 | 单入口,解析 `-mode server|deliver` 与 `-config` |
|
||||
| `config/` | 已有 | viper 配置加载,含最小单测 |
|
||||
| `contract/envelope.go` | 已有 | OSI 通用信封与 `manageInfo` 结构 |
|
||||
| `osi/sign.go` | 已有 | OSI 请求头 MD5 签名与 headers 组装 |
|
||||
| `osi/transport.go` | 已有 | JSON POST 传输层;支持超时与可选 SOCKS5;不带 cookiejar/网页拟态头 |
|
||||
| `osi/codes.go` | 已有 | serviceId 路由与成功/可重试判码 |
|
||||
| `osi/client.go` | 已有 | 通用 `Call`:签名头 + 信封 + 传输 + 响应解析 |
|
||||
| `config.yaml.example` | 已有 | 占位配置,不含真实凭据 |
|
||||
| `go.mod` `go.sum` | 已有 | module `chis_osi`,依赖 viper 与 `golang.org/x/net/proxy` |
|
||||
| `docs/` | 已有 | 设计文档集 01~06 + 本快照;`账号.txt` 本地留存不入库 |
|
||||
| `tasks.md` `progress.md` | 已有 | 任务看板 / 执行流水(根目录) |
|
||||
| `scripts/` | 已有·不入库 | Python 联调脚本(硬编码真实凭据与身份证,勿提交) |
|
||||
| `config.yaml` | 已有·不入库 | 真实凭据;不要提交 |
|
||||
| `contract/` `mapping/` `pipeline/` 等 | 待建 | 路线图阶段 0~2 后续任务 |
|
||||
| `mapping/` `pipeline/` 等 | 待建 | 后续任务 |
|
||||
|
||||
## 已验证事实(写代码时直接依赖)
|
||||
|
||||
- 签名:`password = md5("ts=<13位毫秒ts>&ask=<ask>")` 32 位小写,与 Python `hashlib` 向量一致。
|
||||
- 信封:查询也走 `{"serviceId", "uploadinfo": {"baseInfo", "manageInfo"}}`,见 `docs/04 §8`。
|
||||
- 成功码:字符串 `"01"`(判定按去前导零 == `"1"`),见 `docs/01 §1`。
|
||||
- `405` 为平台服务调用超时,可重试。
|
||||
- 机构码分层:请求头 `orgCode`=18 位统信码 ≠ `manaUnitId`=9 位机构码 ≠ 12 位区划码,见 `docs/01 §3`。
|
||||
- `deviceSN` 查询可空。
|
||||
- OSI 代理语义:`socks5_proxy` 非空即只对 OSI 客户端走 SOCKS5,不做直连回退。
|
||||
@@ -46,7 +50,7 @@
|
||||
# Go 骨架验证
|
||||
go test ./...
|
||||
go build ./...
|
||||
go test ./osi
|
||||
go test ./contract ./osi
|
||||
go run . -mode server -config config.yaml.example
|
||||
go run . -mode deliver -config config.yaml.example
|
||||
|
||||
@@ -59,8 +63,8 @@ python3 scripts/query_health_record.py
|
||||
|
||||
## 下一步
|
||||
|
||||
1. T-004:`osi/client.go` `Call` + `osi/codes.go` + `contract/envelope.go`。
|
||||
2. T-201:查询响应契约结构体(T-004 后)。
|
||||
1. T-005:阶段 0 验收,Go 侧用 JKDA00002 打通真实请求并调整 `init.sh`。
|
||||
2. T-201:查询响应契约结构体(T-005 后)。
|
||||
|
||||
## 维护规则
|
||||
|
||||
|
||||
Reference in New Issue
Block a user