Ver código fonte

verify(T04-S2-GATE): 第二段验收门槛只读验算报告 — 三门槛全红,不放行

只读验算测试库 192.168.16.251/zxyj(仅 SELECT,无 DDL/写库),依据规格 docs/superpowers/specs/2026-10-25-indicator-timeline-display-design.md §2860-2900 的 Q1/Q2/Q3。

结果:L1 报告级时序覆盖率 = 60.00% (6/10) < 85% FAIL;L2 成员可用率 = 50.00% (1/2) < 90% FAIL;L3 抽样 20 份 gut_flora 中 15 份可mapping数值指标覆盖率 < 90%(含 14 份零观测)FAIL,L3b 误判全部『首次记录』0 份 PASS。

差距:subject_id=8 的 4 份历史报告零观测(124 行);9 份未绑定成员报告零观测(348 行);rid=18 部分回填缺 20 指标;合计 backfill 缺口约 492 行。结论:先补 backfill 再重跑验算,第二段暂不放行。

同时记录规格 Q2 SQL 两处缺陷:d.definition_id 列不存在(主键为 id);GROUP BY 粒度错误导致结果恒为 1.0。基线:mvn compile BUILD SUCCESS;cfc-web npm run build DONE。
Sisyphus Agent 3 semanas atrás
pai
commit
3a50d40c51
1 arquivos alterados com 179 adições e 0 exclusões
  1. 179 0
      T04-S2-GATE_REPORT.md

+ 179 - 0
T04-S2-GATE_REPORT.md

@@ -0,0 +1,179 @@
+# T04-S2-GATE 验收门槛验算报告(只读,无 DDL 无数据写入)
+
+**任务**:T04 第二段(report-detail.vue 改造 + L1/L2/L3 门槛)判定能否放行
+**执行时间**:2026-10-27
+**执行环境**:`C:\Users\Administrator\.local\share\opencode\worktree\527b70\t04-s2-gate`(基于 `origin/cfclub@ab797e2e4`)
+**数据库**:192.168.16.251:3306/zxyj (MySQL 5.7.44)
+**验算脚本**:`t04_gate.py` / `t04_gap.py`(仅 SELECT,无写库)
+
+---
+
+## 1. 门槛判定结果
+
+| 级别 | 指标 | 门槛 | 实测值 | 判定 |
+|---|---|---|---|---|
+| **L1** | 报告级时序覆盖率 | **≥ 85%** | **60.00% (6/10)** | ❌ **FAIL** |
+| **L2** | 成员可用率(语义修正版) | **≥ 90%** | **50.00% (1/2)** | ❌ **FAIL** |
+| **L3** | 最近 6 个月 20 份 gut_flora 报告逐份核对 | **每份 ≥ 90% 可 mapping 数值指标有 ≥1 期观测** & **无一份被误判为全部「首次记录」** | 15/20 份不达标(含 0 观测份) | ❌ **FAIL** |
+
+> **结论:三个门槛全部未达标,第二段不得放行。建议先补全 backfill(跑 `/api/admin/indicator/backfill?dryRun=false`),再重跑验算。**
+
+---
+
+## 2. 详细数值与证据
+
+### L1 · Q1 报告级时序覆盖率
+> **规格原 SQL(未改动)**
+```sql
+SELECT SUM(CASE WHEN iv_cnt>0 THEN 1 ELSE 0 END)/COUNT(*) AS report_coverage
+FROM (
+  SELECT r.id,
+         (SELECT COUNT(*) FROM indicator_values v
+           WHERE v.source_type=r.report_type AND v.source_id=r.id) AS iv_cnt
+  FROM health_reports r
+  WHERE r.status='active' AND r.subject_id IS NOT NULL
+) t;
+```
+
+**结果**:
+```
+with_obs=6, total=10, report_coverage=0.6000
+```
+
+**分母 10 份 active+subject_id 报告明细**:
+| report_id | subject_id | report_date   | indicator_values 行数 |
+|---|---|---|---|
+| 1 | 8   | 2026-06-14 | 0 |
+| 2 | 8   | 2026-06-14 | 0 |
+| 3 | 8   | 2026-06-14 | 0 |
+| 4 | 8   | 2026-06-14 | 0 |
+| 18 | 1020 | 2026-08-28 | 13 |
+| 19 | 1021 | 2026-08-28 | 33 |
+| 20 | 1018 | 2026-08-28 | 33 |
+| 21 | 1017 | 2026-08-28 | 33 |
+| 28 | 1022 | 2026-08-01 | 68 |
+| 29 | 1022 | 2026-09-11 | 61 |
+
+**根因**:subject_id=8 的 4 份历史报告(2026-06-14)与 subject_id IS NULL 的 10 份报告均无 `indicator_values` 观测。前者是 `NormalizeIndicatorPipeline` 尚未回填的历史数据;后者是 Q18 G3(`bindReportToMember` 绑定成员时 pipeline 未补跑)。
+
+---
+
+### L2 · Q2 成员可用率
+
+**规格 SQL 存在两处缺陷**(已修正后验算):
+
+1. `indicator_definitions` 主键为 `id`,规格写 `d.definition_id` → 报错 `Unknown column`。
+2. `GROUP BY m.subject_id, v.definition_id` 导致每行 `multi_period_defs=1`,分子分母同值 → 恒返回 1.0。
+
+**语义修正版 SQL**(按门槛表文字口径:分子 =「至少有 1 个指标 ≥2 期」的成员数;分母 =「≥2 份 active 报告」的成员数):
+```sql
+SELECT SUM(CASE WHEN multi_period_defs>0 THEN 1 ELSE 0 END)/COUNT(*) AS member_usable_rate
+FROM (
+  SELECT m.subject_id, COUNT(DISTINCT x.definition_id) AS multi_period_defs
+  FROM ( ...有≥2份报告的成员... ) m
+  LEFT JOIN ( ...有≥2期观测的指标... ) x ON ...
+  GROUP BY m.subject_id
+) z;
+```
+
+**结果**:
+```
+usable_members=1, denom_members=2, member_usable_rate=0.5000
+```
+
+**分母 2 个成员明细**:
+| subject_id | report_type | cnt_reports | has_multi_period_def |
+|---|---|---|---|
+| 8    | gut_flora | 4 | 0(无 indicator_values) |
+| 1022 | gut_flora | 2 | 1(41 个指标各有 2 期) |
+
+subject_id=8 的 4 份历史报告全无 indicator_values,导致该成员 0 个多期指标 → 分子缺 1。
+
+---
+
+### L3 · Q3 抽样(最近 6 个月 gut_flora,LIMIT 20)
+
+| rid | rdate       | subj | hi | mappable | obs | cov% | earl | nEarly | misj |
+|---|---|---|---|---|---|---|---|---|---|
+| 35 | 2026-09-14 | NULL | 0  | 0  | 0  | NA   | NULL | 0      | F |
+| 34 | 2026-09-14 | NULL | 71 | 50 | 0  | 0.0% | NULL | 0      | F |
+| 33 | 2026-09-14 | NULL | 71 | 50 | 0  | 0.0% | NULL | 0      | F |
+| 31 | 2026-09-11 | NULL | 71 | 50 | 0  | 0.0% | NULL | 0      | F |
+| 29 | 2026-09-11 | 1022 | 71 | 50 | 50 | 100% | 1    | 40     | F |
+| 27 | 2026-09-03 | NULL | 43 | 33 | 0  | 0.0% | NULL | 0      | F |
+| 26 | 2026-09-02 | NULL | 43 | 33 | 0  | 0.0% | NULL | 0      | F |
+| 25 | 2026-08-31 | NULL | 43 | 33 | 0  | 0.0% | NULL | 0      | F |
+| 24 | 2026-08-30 | NULL | 43 | 33 | 0  | 0.0% | NULL | 0      | F |
+| 23 | 2026-08-30 | NULL | 43 | 33 | 0  | 0.0% | NULL | 0      | F |
+| 22 | 2026-08-30 | NULL | 43 | 33 | 0  | 0.0% | NULL | 0      | F |
+| 21 | 2026-08-28 | 1017 | 43 | 33 | 33 | 100% | 0    | 0      | F |
+| 20 | 2026-08-28 | 1018 | 43 | 33 | 33 | 100% | 0    | 0      | F |
+| 19 | 2026-08-28 | 1021 | 43 | 33 | 33 | 100% | 0    | 0      | F |
+| 18 | 2026-08-28 | 1020 | 43 | 33 | 13 | 39.4%| 0    | 0      | F |
+| 28 | 2026-08-01 | 1022 | 79 | 53 | 53 | 100% | 0    | 0      | F |
+| 4  | 2026-06-14 | 8    | 51 | 31 | 0  | 0.0% | 3    | 0      | F |
+| 3  | 2026-06-14 | 8    | 51 | 31 | 0  | 0.0% | 2    | 0      | F |
+| 2  | 2026-06-14 | 8    | 51 | 31 | 0  | 0.0% | 1    | 0      | F |
+| 1  | 2026-06-14 | 8    | 51 | 31 | 0  | 0.0% | 0    | 0      | F |
+
+**L3a 不达标 15 份**:rid ∈ {35,34,33,31,27,26,25,24,23,22,18,4,3,2,1}(其中 10 份 subject_id IS NULL 无 indicator_values,4 份 subject_id=8 历史回填缺失,1 份 rid=18 部分回填)。
+
+**L3b 误判「首次记录」**:0 份(无一份同时满足:有更早报告 & 所有可 mapping 数值指标在本报告有观测 & 无更早观测)。通过。
+
+> `obs` = 该报告 `health_indicators` 中可 mapping(匹配 active definition 按名)且有 ≥1 期观测的指标数。
+> 注:rid 28/29 的 `indicator_values` 行数分别为 68/61,其中含报告自身 `health_indicators` 之外的 definition(跨报告冗余),故按「可 mapping 指标」口径计为 53/50。
+
+---
+
+## 3. 差距明细与补全建议
+
+| 缺口类别 | 涉及报告 / 成员 | 缺口量 | 原因 | 建议动作 |
+|---|---|---|---|---|
+| **历史回填缺失(subject_id=8)** | rid 1-4 | 4 份报告 × 31 可mapping指标 = 124 行 | T01 pipeline 2026-08 前不存在 | 执行 `/api/admin/indicator/backfill`(含 `fixReportDates=true`) |
+| **Q18 G3 未绑定成员 pipeline 跳过** | rid 22-27,31,33,34(9 份有 health_indicators) | 198+150 = 348 行(rid 35 无健康指标) | 上传时 `subject_id` 为 NULL → pipeline 跳过;后绑定未补跑 | T01 已修 `bindReportToMember` 尾部补跑 pipeline;回填旧数据跑 backfill |
+| **部分回填(rid=18)** | rid 18 | 缺 20 个指标(吲哚、苯酚、腐胺 等) | pipeline 仅写了 13/33 个 definition | 检查 mapping 规则覆盖,回填缺口 |
+| **subject_id=1022 多期已就绪** | rid 28,29 | 0(已 100%,41 个指标各 2 期) | — | 无需动作 |
+
+**backfill 缺口估算(SQL 推导,非 API dryRun 实跑)**:按「可 mapping 指标数 − 已有观测定义数」合计 ≈ **492 行**,分布在 14 份无/缺观测的报告(4 份历史 + 9 份未绑定 + rid 18)。
+
+---
+
+## 4. 基线验证(构建通过)
+
+| 验证项 | 命令 | 结果 |
+|---|---|---|
+| 后端编译 | `mvn -f cfc-backend/pom.xml -DskipTests compile` | ✅ BUILD SUCCESS (1955 files, 1m24s) |
+| Web 管理端构建 | `cd cfc-web && npm run build` | ✅ DONE Build complete (70s) |
+
+无新增迁移,无 schema 变更,无代码改动。
+
+---
+
+## 5. 规格 SQL 缺陷记录(供后续 PR 修正)
+
+| 缺陷 | 位置 | 影响 | 修正建议 |
+|---|---|---|---|
+| Q1 无缺陷 | — | — | — |
+| Q2 `d.definition_id` 不存在 | `indicator_definitions.id` 为主键 | 直接报错 | 改为 `d.id` |
+| Q2 `GROUP BY m.subject_id, v.definition_id` 语义错误 | 内层分组导致每行 = 1 指标 | 恒返回 1.0,失去区分度 | 按 `m.subject_id` 聚合,计数 `COUNT(DISTINCT v.definition_id)` |
+| Q3 `:report_id` 参数化占位符 | 需改为具体值或 IN 列表 | 不可直接在 MySQL CLI 跑 | 在验算脚本中展开为循环 |
+
+---
+
+## 6. 分支与提交
+
+- 报告文件:`T04-S2-GATE_REPORT.md`(repo 根目录)
+- 分支:`verify/t04-s2-gate`(基于 `origin/cfclub@ab797e2e4`)
+- 提交:提交信息见 `git log`,提交哈希在推送后回报(避免文件自引用)。
+
+```bash
+git checkout -b verify/t04-s2-gate origin/cfclub
+# 添加报告文件
+git add T04-S2-GATE_REPORT.md
+git commit -m "verify: T04-S2-GATE 报告 — 三门槛均不达标,建议先补 backfill 再放行"
+git push -u origin verify/t04-s2-gate
+```
+
+---
+
+**结论再述**:当前测试库数据下,**L1=60% (<85%)、L2=50% (<90%)、L3a=15/20 不达标**,三级门槛全红。第二段**不得放行**。需先执行历史 backfill(含 Q18 G3 修正后的 pipeline 补跑),回填完成后重跑本验算脚本,三门槛全绿才可放行。