docs: 接入 harness coding 执行工件
- 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>
This commit is contained in:
@@ -23,6 +23,19 @@
|
||||
| [04-字段与接口映射.md](04-字段与接口映射.md) | OSI 接口↔内部能力映射、PHIS→OSI 字段/字典映射策略、checkId 幂等键 |
|
||||
| [05-实施路线图.md](05-实施路线图.md) | 分阶段落地计划、配置项、可观测性、测试与联调清单 |
|
||||
| [06-厂家联调清单.md](06-厂家联调清单.md) | 向厂家索要的凭据/环境/契约/样本清单,带回填状态,可直接发对接人 |
|
||||
| [current-state.md](current-state.md) | **当前实现状态快照**(可覆盖):仓库现实、已验证事实、可运行命令、blocker |
|
||||
|
||||
## 执行工件(根目录)
|
||||
|
||||
| 文件 | 作用 |
|
||||
| --- | --- |
|
||||
| [`../CLAUDE.md`](../CLAUDE.md) | 仓库级硬规则(Claude Code 入口,唯一权威规则源) |
|
||||
| [`../AGENTS.md`](../AGENTS.md) | 通用 agent 薄入口,导航到 CLAUDE.md 与三件套 |
|
||||
| [`../tasks.md`](../tasks.md) | 任务看板:小步任务 + 依赖 + 验收 + 状态,一次只领一个 |
|
||||
| [`../progress.md`](../progress.md) | 执行流水(只追加):每轮变更/验证/阻塞/决策 |
|
||||
| [`../init.sh`](../init.sh) | 统一启动与验证入口(Go 骨架建立后:download → test → run) |
|
||||
|
||||
维护原则:需求/契约变化先改文档再改代码;任务状态变化同步 `tasks.md` + `progress.md` + `current-state.md`;接口契约以 `01`/`04`(含 §8 实测)为准,代码不得另起一套。
|
||||
|
||||
## 一句话结论
|
||||
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
# 当前实现状态
|
||||
|
||||
> 可覆盖的当前快照:记录仓库现实、可运行命令、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。
|
||||
|
||||
## 维护规则
|
||||
|
||||
发生以下变化时覆盖更新本文:入口/目录变动、任务状态变化、新增可运行命令、发现文档与代码现实不一致。本文只留当前快照,不留历史。
|
||||
Reference in New Issue
Block a user