56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
 
|
# 当前实现状态
|
|||
|
|
|
|||
|
|
> 可覆盖的当前快照：记录仓库现实、可运行命令、blocker 和下一步，防止只看计划而忽略现状。
|
|||
|
|
> 历史流水追加到 [`../progress.md`](../progress.md)；任务状态以 [`../tasks.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` 查询可空。
|
|||
|
|
|
|||
|
|
## 当前可运行内容
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 本地联调查询（唯一可运行路径；脚本硬编码凭据，勿提交）
|
|||
|
|
python3 scripts/query_health_record.py
|
|||
|
|
|
|||
|
|
# Go 侧（阶段 0 后）
|
|||
|
|
./init.sh
|
|||
|
|
go test ./...
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 下一步
|
|||
|
|
|
|||
|
|
1. T-000：处理失效测试（`tasks.md` Phase B）。
|
|||
|
|
2. T-001：go module + 双子命令骨架，进入路线图阶段 0。
|
|||
|
|
|
|||
|
|
## 维护规则
|
|||
|
|
|
|||
|
|
发生以下变化时覆盖更新本文：入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照，不留历史。
|