feat(osi): 实现通用 Call 与响应判码（T-004）

2026-07-06 22:31:02 +08:00
parent 56acc01d92
commit 2a77a4dbc1
10 changed files with 413 additions and 11 deletions
@@ -80,3 +80,11 @@
 - 验证：先运行 `go test ./osi` 看到 `NewTransport`/`TransportConfig` 未定义的预期失败；实现后 `go test ./osi` 通过；`go test ./...` 通过；`go build ./...` 通过。
 - 决策：`socks5_proxy` 支持 `host:port` 和 `socks5://host:port` 两种写法；非空时只配置 OSI 客户端代理，不做直连回退；传输层只返回 HTTP status 和原始响应体，业务判码留给 T-004 的 client/codes。
 - 下一步：T-004（`osi/client.go` `Call` + `osi/codes.go` + `contract/envelope.go`）。
+
+## 2026-07-06 T-004 OSI Client Call + 信封 + 判码
+
+- 状态：DONE
+- 变更：新增 `contract/envelope.go`、`osi/codes.go`、`osi/client.go` 及对应单测；`Client.Call` 负责拼 `/osi/api` 路径、组装 MD5 签名请求头、构造 `serviceId + uploadinfo{baseInfo,manageInfo}` 信封、发送 JSON、解析 `{code,message,data}`；`tasks.md` 标记 T-004 完成；`docs/05` 勾选 client/codes/envelope 两项。
+- 验证：先运行 `go test ./contract ./osi` 看到 `Envelope`、`NewClient`、`IsSuccessCode` 等未定义的预期失败；实现后 `go test -count=1 ./contract ./osi` 通过；`go test ./...` 通过；`go build ./...` 通过。
+- 决策：成功码统一按去前导零后等于 `"1"` 判定，兼容实测 `"01"`；`405` 归类为可重试；`osi.base_url` 按主机地址处理，Client 自动拼 `/osi/api`，同时兼容已带 `/osi/api` 的输入。
+- 下一步：T-005（阶段 0 验收：Go 侧真实请求打通 + 配置 `init.sh`）。