docs: 看板重排为读先行(Phase Q2 查询优先,写入后置)
- tasks.md 新增 Phase Q2(体检/老年人/列表查询),T-206/T-204 写入降到其后 - docs/06 顶部归拢当前批次三项优先催办(写入授权/缺失 serviceId/写入规则) - 里程碑与 current-state 下一步同步为 T-301 起 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -7,6 +7,16 @@
|
||||
|
||||
---
|
||||
|
||||
## ★ 当前批次优先催办(读先行阶段,2026-07-08)
|
||||
|
||||
查询链路已打通,接下来"其余业务线查询 + 将来写入"被以下三件卡着,**建议同一封邮件一起催**,避免写入阶段既缺授权又缺规则双重卡壳:
|
||||
|
||||
1. **写入授权 + 安全测试档案**(见 D3)——解 T-206(档案 create)阻塞,进而解 T-204。
|
||||
2. **缺失的列表/查询接口 serviceId + 路径**(见 B1、B2、B4)——解 T-304 列表查询、T-303 老年人查询的 serviceId 缺口。
|
||||
3. **写入业务规则**:checkId 去重语义 + 完整度谁算(见 C1、C2)——写入阶段前置,现在问以免后置返工。
|
||||
|
||||
---
|
||||
|
||||
## A. 接入凭据与环境(最高优先级)
|
||||
|
||||
没有这些,一个请求都发不出。
|
||||
|
||||
@@ -86,8 +86,12 @@ python3 scripts/query_health_record.py
|
||||
|
||||
## 下一步
|
||||
|
||||
1. 解除 T-206 阻塞:提供可写入沙箱的安全测试居民资料,或明确授权使用某条测试数据执行 `JKDA00001` create。
|
||||
2. T-206 真实 create 成功后,补 `phrId` 返回样本与 `checkId` 幂等语义,再进入 T-204 server 模式 `/api/health-record/save`。
|
||||
> 读先行调整(2026-07-08):写入(T-206/T-204)被厂家授权锁死,先推其余业务线查询。
|
||||
|
||||
1. **T-301 体检查询打通**(`contract/jktj.go` + `osi/jktj.go`,JKTJ00002 / JKTJLSJL00002),响应字段记入 docs/04 —— 当前可领。
|
||||
2. T-302 体检 HTTP 查询端点(复用 T-208 handler 模式)。
|
||||
3. 并行催厂家(docs/06 ★ 优先催办):写入授权+测试档案、缺失列表 serviceId、checkId/完整度规则。
|
||||
4. 授权到位后回到 T-206 真实 create 验收 → T-204。
|
||||
|
||||
## 维护规则
|
||||
|
||||
|
||||
@@ -193,3 +193,10 @@
|
||||
- 验证:用户在 Windows 侧 `go test ./...`、`go build ./...` 通过;`go run . -mode server` 起服务后 `curl .../find?idCard=<..>` 返回平台完整档案 JSON。(本 WSL 离线无 go 工具链,未在本环境复跑。)
|
||||
- 决策:查询端点直接回写 `Result.Raw`(平台原始 `{code,message,data}`),保证未建模字段不丢失;默认监听 `127.0.0.1:8080` 而非 `:8080`,因端点返回真实档案 PII,避免绑 0.0.0.0 暴露到局域网;身份证经 URL query 传入,仅作本机查看工具,勿反代外网。
|
||||
- 下一步:解 T-206 阻塞(真实 create),或按需为查询端点加鉴权后再考虑对外。
|
||||
|
||||
## 2026-07-08 看板重排(读先行:查询优先、写入后置)
|
||||
|
||||
- 状态:DONE(规划调整,无代码)
|
||||
- 变更:`tasks.md` 新增 Phase Q2(其余业务线查询:T-301 体检查询 / T-302 体检端点 / T-303 老年人查询 / T-304 列表查询),把写入 T-206(BLOCKED)/T-204 明确降到 Q2 之后;里程碑加 M4=体检查询、M5=创建闭环。`docs/06` 顶部加"★ 当前批次优先催办",把写入授权(D3)+缺失 serviceId(B1/B2/B4)+写入规则(C1/C2) 归拢成一封邮件一起催。`docs/current-state.md` 下一步改为 T-301 起。
|
||||
- 决策(全栈分析):真实 create 被厂家写入授权外部锁死,垂直切片走不通;改按读/写横切、读先行——读路径不被授权阻塞、只读零风险、且各查询响应是将来写入映射的事实侦察。T-206 创建代码保留不作废,授权到位再验收。
|
||||
- 下一步:T-301 体检查询打通。
|
||||
|
||||
@@ -56,19 +56,35 @@
|
||||
|
||||
## Phase D · 字典服务与创建闭环(真实主数据反查)
|
||||
|
||||
> **读先行调整(2026-07-08)**:档案**创建/更新**(T-206/T-204)真实验收依赖厂家写入授权 + 安全测试档案(docs/06 D3),当前锁死。
|
||||
> 故把**其余业务线的查询**(Phase Q2)提到写入之前先做——读路径不被授权阻塞,且顺带摸清各业务线响应字段,为将来写入去风险。
|
||||
> T-206 创建代码已完成并入库,保持不动,授权到位后再回来验收。
|
||||
|
||||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| T-101 | `osi/public.go` 四个字典查询(网格/责任医生/药品/机构) | T-005 | 真实机构码能查到下级网格、责任医生、机构树 | DONE |
|
||||
| T-103 | 字典缓存(内存 + redis 可选) | T-101, T-102 | 映射层能反查 `regionCode/manaDoctorId/manaUnitId`;redis 不可用不阻断 | DONE |
|
||||
| T-206 | `osi/jkda.go`:**Create/Update** + `contract/jkda.go` 补创建请求结构体 | T-201, T-202, T-103 | 一条档案经映射(真实字典快照)→ create → 平台返回成功码与 `phrId`;Update 沿用 checkId | BLOCKED(代码已完成;待安全测试档案/写入授权做真实 create) |
|
||||
| T-204 | `handler`+`router`:`/api/health-record/save` | T-206 | server 模式起服务,curl 全链路返回投递结果 | TODO |
|
||||
| T-206 | `osi/jkda.go`:**Create/Update** + `contract/jkda.go` 补创建请求结构体 | T-201, T-202, T-103 | 一条档案经映射(真实字典快照)→ create → 平台返回成功码与 `phrId`;Update 沿用 checkId | BLOCKED(代码完成;待写入授权/测试档案,排在 Phase Q2 之后) |
|
||||
| T-204 | `handler`+`router`:`/api/health-record/save` | T-206 | server 模式起服务,curl 全链路返回投递结果 | TODO(待 T-206 解阻塞) |
|
||||
|
||||
## Phase Q2 · 其余业务线查询(读先行)
|
||||
|
||||
> 每条查询任务都顺带把响应真实字段记入 `docs/04`(像 §8),作为将来对应业务线 create 映射的事实基线。
|
||||
|
||||
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| T-301 | 体检查询打通:`contract/jktj.go` + `osi/jktj.go`(单条 JKTJ00002 / 最近一次 JKTJLSJL00002) | T-004 | 真实请求拿到 `code="01"` 与体检数据;响应字段(hcData/lsData/exaData/aeData…)记入 docs/04 | TODO |
|
||||
| T-302 | 体检 HTTP 查询端点(复用 T-208 handler 模式) | T-301 | server 模式 curl 返回体检完整 JSON;默认仅绑本机 | TODO |
|
||||
| T-303 | 老年人查询打通:自理 LNRZLPG / 体质 LNRZYTZ(查询 serviceId 部分待确认) | T-004 | 真实请求打通;缺失 serviceId 先向厂家确认(docs/06 B4) | TODO(部分待 B4) |
|
||||
| T-304 | 列表类查询(档案/体检/老年人/中医指导列表) | T-004 | 各列表路径+serviceId 到位后返回分页数组 | BLOCKED(待 docs/06 B1/B2 厂家回填) |
|
||||
|
||||
## 里程碑
|
||||
|
||||
- M1 = T-005:Go 客户端与平台真实握手成功(签名/信封/判码全对)。
|
||||
- M2 = T-203:**Go 版查询档案打通**(Find,不碰字典)。
|
||||
- M3 = T-205:映射层就绪 + 单测基线(假字典快照)。
|
||||
- M4 = T-206:真实创建闭环 + 幂等(字典反查主数据 → create → phrId)。
|
||||
- M4 = T-301:**体检查询打通**(其余业务线读先行第一条)。
|
||||
- M5 = T-206:真实创建闭环 + 幂等(授权到位后,字典反查主数据 → create → phrId)。
|
||||
|
||||
## 待办池(Backlog,按路线图阶段 3~6 展开,进入时再拆小任务)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user