chis_osi/docs/current-state.md

当前实现状态

可覆盖的当前快照：记录仓库现实、可运行命令、blocker 和下一步，防止只看计划而忽略现状。 历史流水追加到 ../progress.md；任务状态以 ../tasks.md 为准。

当前快照

• 日期：2026-07-06
• 阶段：Phase 0 已起步；T-001 已完成，Go module 与 CLI/config 骨架已建立
• 技术栈：Go 1.24 单二进制；main.go -mode server|deliver；配置读取使用 viper
• 生产代码：已有 main.go、config/、go.mod/go.sum；osi/ contract/ mapping/ 等业务目录仍待后续任务建立
• 联调现实：JKDA00002 个人档案查询已用 Python 脚本打通真实沙箱（code="01"），实测契约沉淀在 docs/04 §8
• 测试：go test ./... 通过；当前测试覆盖 mode 解析与 config.yaml.example 加载
• 标准启动路径：./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 配置加载，含最小单测
config.yaml.example	已有	占位配置，不含真实凭据
go.mod go.sum	已有	module chis_osi，依赖 viper
docs/	已有	设计文档集 01~06 + 本快照；账号.txt 本地留存不入库
tasks.md progress.md	已有	任务看板 / 执行流水（根目录）
scripts/	已有·不入库	Python 联调脚本（硬编码真实凭据与身份证，勿提交）
config.yaml	已有·不入库	真实凭据；不要提交
osi/ contract/ mapping/ 等	待建	路线图阶段 0~2 后续任务

已验证事实（写代码时直接依赖）

• 签名：password = md5("ts=<13位毫秒ts>&ask=<ask>") 32 位小写，与平台一致（Python 已打通）。
• 信封：查询也走 {"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 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

下一步

1. T-002：osi/sign.go MD5 头签名 + 单测。
2. T-003：osi/transport.go 传输层骨架。

维护规则

发生以下变化时覆盖更新本文：入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照，不留历史。