docs: 依 JKDA00002 联调实测校准接口契约

- 成功码实测为字符串 "01"(docx 误写 "1"),判定按去前导零
- 查询类同走 uploadinfo 信封(baseInfo+manageInfo),非裸 baseInfo
- 三种机构码分层:18位统信码 / 9位机构码 / 12位区划码
- docs/04 新增 §8 JKDA00002 实测契约(请求信封+响应结构,已脱敏)
- docs/06 回填 A1~A9/B3/B6/C3/D2/D3 联调状态

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-07-06 20:09:43 +08:00
co-authored by Claude Opus 4.8
parent 1fd256993b
commit d7b769742b
4 changed files with 108 additions and 42 deletions
+2 -2
View File
@@ -9,7 +9,7 @@
- [ ] 初始化 Go module、单 `main.go`(`-mode server|deliver`)、`config/`(viper)。
- [ ] 落地 `osi/sign.go`(MD5 签名)+ 单测:用文档约定的 `ts/ask` 校验 `password` 形态(32 位小写)。
- [ ] 移植旧项目 `transport.go`/`http_client.go` → `osi/transport.go`(保留 SOCKS5/超时,去 cookiejar 与拟态头)。
- [ ] `osi/client.go` 的 `Call(serviceId, body, out)`:注入头+信封+发送+判码(`code=="1"`/`405`)。
- [ ] `osi/client.go` 的 `Call(serviceId, body, out)`:注入头+信封+发送+判码(成功码实测 `"01"`,按去前导零判定;`405` 可重试,见 docs/01 §1)。
- [ ] `contract/envelope.go` + `osi/codes.go`(serviceId 常量 + `pathOf` 路由)。
- **验收**:对任一最简查询接口(如机构查询 CXJG00002)发真实请求,拿到 `code/message`。
@@ -26,7 +26,7 @@
- [ ] `osi/jkda.go`:Create/Update/Find/FindRqbj。
- [ ] `handler` + `router`:暴露 `/api/health-record/save`(server 模式联调用)。
- [ ] 用 01 文档样例 + 联调样本写映射单测。
- **验收**:一条 PHIS 档案 → 映射 → create → 平台返回 `code:"1"` 与 `phrId`;重复投递被幂等跳过。
- **验收**:一条 PHIS 档案 → 映射 → create → 平台返回成功码(实测 `"01"`)与 `phrId`;重复投递被幂等跳过。
## 阶段 3 · 投递流水线