docs: 拆出 T-305 体检名单查询并登记 JKTJLIST00002 契约

- docs/04 §11.4 记录 JKTJLIST00002 请求/响应契约（docx，部署待验证）
- tasks 拆 T-305（契约齐全，TODO 可领）、T-304 收窄为缺 serviceId 的列表
- 纠正 T-304 一刀切 BLOCKED

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

docs/04-字段与接口映射.md

@@ -291,3 +291,21 @@ T-206 已建立本地契约与客户端方法，真实写入验收暂未执行
 | `medicineSituations` | array | - | 用药情况（本样本空，结构待样本） |
 
 > 命名坑点：`constriction`=收缩压、`diastolic`=舒张压（`_l` 疑为左侧）；辅助检查用大量医学缩写。建 create 映射时逐字段加中文注释。
+
+### 11.4 已检/待检人员名单查询 JKTJLIST00002（docx 契约，沙箱部署待验证）
+
+> **不是体检数据源**，是机构级"某年度已检/未检人员名单/进度"：返回**人员一行 + 体检状态**，不含体检明细。
+> 来源：docx。沙箱是否部署未实测（对应 T-305；先用 Python 探针 `SERVICE="list"` 确认）。
+
+- serviceId `JKTJLIST00002`，`POST /osi/api/auto/jktjlist/query`，信封同查询式（`uploadinfo{baseInfo, manageInfo}`）。
+- **请求 `baseInfo`**（page/rows 也在 baseInfo 内）：
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| `checkYear` | ✅ | 检查年度（如 `2025`）——无"默认所有年度" |
+| `page` `rows` | ✅ | 分页，rows 默认 10 |
+| `idCard` | 否 | 过滤到某人某年度状态 |
+| `checkType` | 否 | `0`已检 / `1`未检 / `2`全部 |
+| `personName` `sex` `age` `personGroup` `gridAddress` `beginDate` `endDate` | 否 | 各类筛选。⚠ docx 参数表与样例字段名不一致（表 `ageBegin/ageEnd`/`sexCode`/`regionCode` vs 样例 `age`/`sex`/`gridAddress`）——以联调实测为准 |
+
+- **响应 `data`（list，每人一行）**：`idCard`/`personName`/`age`/`birthDay`/`regionCode`/`regionCodeText`/`manaUnitId`/`manaUnitText`/`sexCode`/`mobileNumber`/`contact`/`contactPhone`/`signFlag`(y/n 签约)/`address`/`manadoctorId`/`phrid`/**`checkType`(0已检/1未检)**/`rqbj`(人群标志，同 personSign 码表)。

progress.md

@@ -209,3 +209,10 @@
 - 发现：① 单条 JKTJ00002 `auto/jktj/query` 平台实测"没有url的接口配置"（未部署），`auto/jktj/find` 待确认 → docs/06 B5。② 体检 data 为单对象（档案 find 是数组）。③ 体检身份证字段小写 `idcard`（档案 `idCard`）。④ 体检主键 `checkId`（与档案幂等 checkId 同名不同义），子节点 `healthCheck` 外键指向它。
 - 决策：查询只强类型化定位字段，完整内容留 `Result.Raw`；~260 全量字段建模留到体检 create（写入才需逐字段，避免照单样本猜 null 类型）。
 - 下一步：T-302 体检 HTTP 查询端点（复用 T-208 handler 模式）；或按 docs/06 催厂家确认单查/列表接口。
+
+## 2026-07-08 拆分 T-305 体检名单查询、收窄 T-304
+
+- 状态：DONE（看板+文档维护）
+- 变更：从 docx 扒出 JKTJLIST00002 完整契约（checkYear/page/rows 在 baseInfo，返回人员名单+checkType 状态），记入 `docs/04 §11.4`；`tasks.md` 拆出 **T-305（体检已检/未检名单，契约齐全仅待沙箱部署验证，TODO 可领）**，把 T-304 收窄为真正缺 serviceId 的列表（档案/老年人/中医指导）；`scripts/query_health_check.py` 的 list 模式改为 docx 正确参数。
+- 决策：JKTJLIST00002 契约不缺（docx 完整），不该被 B1/B2 阻塞——只差运行时确认端点是否部署，故独立成可领任务；纠正原 T-304"一刀切 BLOCKED"把能做的和真卡的混在一起。它是名单/进度接口，不含体检明细，非数据源。
+- 下一步：跑 list 探针确认部署 → 若通即领 T-305 建 osi 方法；未部署则归 docs/06 B5 催厂家。

tasks.md

@@ -76,7 +76,8 @@
 | T-301 | 体检查询打通：`contract/jktj.go` + `osi/jktj.go`（最近一次 JKTJLSJL00002） | T-004 | 真实请求拿到 `code="01"` 与体检数据；响应字段（~260 项/7 节点）记入 docs/04 §11 | DONE（单条 JKTJ00002 平台未部署，见 §11） |
 | 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 厂家回填） |
+| T-305 | 体检已检/未检名单查询 JKTJLIST00002（`osi` 方法 + 契约）| T-004 | 先用 Python 探针确认 `auto/jktjlist/query` 已部署；通后建 `osi.ListHealthCheckPeople`，按 checkYear+idCard 返回名单（含 checkType 状态），契约见 docs/04 §11.4 | TODO（契约齐全，仅待沙箱部署验证）|
+| T-304 | 列表类查询（**档案 / 老年人自理·体质 / 中医指导** 列表，serviceId docx 缺漏）| T-004 | 各列表路径+serviceId 到位后返回分页数组 | BLOCKED（待 docs/06 B1/B2 厂家回填）|
 
 ## 里程碑