ilaandClaude Opus 4.8
4a5134093b
- T-001/T-002 标记 DONE，current-state 更新 Go 骨架现实 - 看板重排 Phase 1/2 → Q(查询)/M(映射)/D(字典+创建)，查询档案不依赖字典 - osi/jkda.go 拆为 T-203(Find)/T-206(Create)，显式化 Create 对字典缓存的依赖 - docs/05 加执行顺序注记 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
3.3 KiB
3.3 KiB
当前实现状态
可覆盖的当前快照：记录仓库现实、可运行命令、blocker 和下一步，防止只看计划而忽略现状。 历史流水追加到
../progress.md；任务状态以../tasks.md为准。
当前快照
- 日期：2026-07-06
- 阶段：Phase 0 进行中；T-001/T-002 已完成，Go module、CLI/config 骨架与 MD5 签名已建立
- 技术栈：Go 1.24 单二进制；
main.go -mode server|deliver；配置读取使用 viper - 生产代码：已有
main.go、config/、osi/sign.go、go.mod/go.sum；contract/ mapping/ pipeline/等业务目录仍待后续任务建立 - 联调现实：JKDA00002 个人档案查询已用 Python 脚本打通真实沙箱（
code="01"），实测契约沉淀在docs/04 §8 - 测试：
go test ./...通过；当前测试覆盖 mode 解析、config.yaml.example加载、MD5 签名和头部组装 - 标准启动路径：
./init.sh（需要 bash/WSL 环境；当前 Windows 环境未安装 WSL，直接运行会失败） - 标准验证路径：
go test ./...、go build ./... - 当前 blocker：无硬 blocker。软阻塞：厂家侧 B1/B2/B4/B5 契约缺口（见
docs/06），只影响阶段 4，不阻塞阶段 0~3
当前目录要点
| 路径 | 状态 | 说明 |
|---|---|---|
main.go |
已有 | 单入口，解析 `-mode server |
config/ |
已有 | viper 配置加载，含最小单测 |
osi/sign.go |
已有 | OSI 请求头 MD5 签名与 headers 组装 |
config.yaml.example |
已有 | 占位配置，不含真实凭据 |
go.mod go.sum |
已有 | module chis_osi，依赖 viper |
docs/ |
已有 | 设计文档集 01~06 + 本快照；账号.txt 本地留存不入库 |
tasks.md progress.md |
已有 | 任务看板 / 执行流水（根目录） |
scripts/ |
已有·不入库 | Python 联调脚本（硬编码真实凭据与身份证，勿提交） |
config.yaml |
已有·不入库 | 真实凭据；不要提交 |
contract/ mapping/ pipeline/ 等 |
待建 | 路线图阶段 0~2 后续任务 |
已验证事实（写代码时直接依赖）
- 签名：
password = md5("ts=<13位毫秒ts>&ask=<ask>")32 位小写，与 Pythonhashlib向量一致。 - 信封：查询也走
{"serviceId", "uploadinfo": {"baseInfo", "manageInfo"}}，见docs/04 §8。 - 成功码：字符串
"01"（判定按去前导零 =="1"），见docs/01 §1。 - 机构码分层：请求头
orgCode=18 位统信码 ≠manaUnitId=9 位机构码 ≠ 12 位区划码，见docs/01 §3。 deviceSN查询可空。
当前可运行内容
# Go 骨架验证
go test ./...
go build ./...
go test ./osi
go run . -mode server -config config.yaml.example
go run . -mode deliver -config config.yaml.example
# 统一入口（需要 bash/WSL）
./init.sh
# 本地联调查询（脚本硬编码凭据，勿提交）
python3 scripts/query_health_record.py
下一步
- T-003：
osi/transport.go传输层骨架，保留 SOCKS5/超时。 - T-004：
osi/client.go+contract/envelope.go+osi/codes.go。
维护规则
发生以下变化时覆盖更新本文：入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照，不留历史。