- tasks.md 任务看板(路线图阶段0~2拆为14个小步任务,一次领一个) - progress.md 只追加执行流水(补记文档初始化与JKDA00002联调) - docs/current-state.md 可覆盖当前快照(pre-code现实+已验证事实) - init.sh 统一验证入口(无 go.mod 时指向 T-001) - AGENTS.md 通用 agent 薄入口;CLAUDE.md 会话启动改为三件套流程 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
当前实现状态
可覆盖的当前快照:记录仓库现实、可运行命令、blocker 和下一步,防止只看计划而忽略现状。 历史流水追加到
../progress.md;任务状态以../tasks.md为准。
当前快照
- 日期:2026-07-06
- 阶段:pre-code(设计完成、Go 骨架未建立;路线图阶段 0 未开始)
- 技术栈:目标 Go 1.24 单二进制(未落地);当前仅有 Python 联调脚本(requests,本地不入库)
- 生产代码:无。
go.mod不存在,osi/ contract/ mapping/等目录均待建 - 联调现实:JKDA00002 个人档案查询已用 Python 脚本打通真实沙箱(
code="01"),实测契约沉淀在docs/04 §8 - 测试:
tests/test_query_health_record.py已失效(测的是被重写前的脚本 API,import 报错) - 标准启动路径:
./init.sh(阶段 0 未完成前会提示先做 T-001,属预期行为) - 标准验证路径:
go test ./...(骨架建立后生效) - 当前 blocker:无硬 blocker。软阻塞:厂家侧 B1/B2/B4/B5 契约缺口(见
docs/06),只影响阶段 4,不阻塞阶段 0~3
当前目录要点
| 路径 | 状态 | 说明 |
|---|---|---|
docs/ |
已有 | 设计文档集 01~06 + 本快照;账号.txt 本地留存不入库 |
tasks.md progress.md |
已有 | 任务看板 / 执行流水(根目录) |
scripts/ |
已有·不入库 | Python 联调脚本(硬编码真实凭据与身份证,已 gitignore) |
tests/ |
已有·失效 | 旧脚本测试,待 T-000 处理 |
config.yaml |
已有·不入库 | 真实凭据;config.yaml.example 待 T-001 建立 |
main.go 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查询可空。
当前可运行内容
# 本地联调查询(唯一可运行路径;脚本硬编码凭据,勿提交)
python3 scripts/query_health_record.py
# Go 侧(阶段 0 后)
./init.sh
go test ./...
下一步
- T-000:处理失效测试(
tasks.mdPhase B)。 - T-001:go module + 双子命令骨架,进入路线图阶段 0。
维护规则
发生以下变化时覆盖更新本文:入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照,不留历史。