fix(stage1): verify survey design fields

This commit is contained in:
Jinotech
2026-09-20 09:24:14 +12:00
parent 9508c01b62
commit 22d58f0d46
10 changed files with 381 additions and 59 deletions
+19 -6
View File
@@ -1,9 +1,9 @@
# 项目进度档案
版本:1.15
版本:1.16
建立日期:2026-09-20
当前总状态:`in_progress`
当前阶段:阶段 1 `in_progress`84 个主要结局题目实例及 919,863 行回答长表已形成并通过结构校验,YRBS 17 年完整表可用;设计复核和实际双人审核尚未完成
当前阶段:阶段 1 `in_progress`题库、回答字典、919,863 行回答长表及三调查设计字段/方法均已核验;Gate 1 仅剩主要结局的两名实际人工审核者签署
## 1. 管理规则
@@ -28,7 +28,7 @@
| 阶段 | 名称 | 状态 | 当前判定 |
|---|---|---|---|
| 0 | 冻结研究问题、范围与版本 | `passed` | 四项交付物齐备,Gate 0 已通过;研究工具链补强与锁定完成 |
| 1 | 有来源证据的题库和回答层 | `in_progress` | 主要结局题库、回答字典和回答长表已生成并通过结构校验;设计复核和实际双重审核尚未完成 |
| 1 | 有来源证据的题库和回答层 | `in_progress` | 七项机器交付物齐备,来源/编码/总体/缺失与设计层已形成;尚缺工作流强制要求的两名实际审核者签署 |
| 2 | 可行性、可识别性和连接审计 | `not_started` | 等待 Gate 1 |
| 3 | 冻结验证协议与已知真值模拟 | `not_started` | 等待 Gate 2 |
| 4 | 直接协调和传统基线 | `not_started` | 等待 Gate 3 |
@@ -789,6 +789,19 @@ Gate 0 当前判定:`passed`。四项交付物齐备;目标总体政策、
- 推送状态:`pushed`;研究提交 `89c20f3` 与认证失败状态提交 `9497d1c` 已在仅清除失效站点凭据并由 Git Credential Manager 重新授权后推送至 `origin/main`
- 下一步:逐调查核验权重、PSU、stratum 和方差方法的官方来源;随后落实两名实际审核者签署。
### A-20260920-062:核验设计来源并修复 YRBS 2017/2019 设计字段
- 时间:2026-09-20
- 阶段:1(有来源证据的题库和回答层)
- 动作:行动前完整读取工作流、进度档案并检查 Git;复核 WHO GSHS 目录/方法页、17 份 CDC YRBS 年度指南及 SAMHSA NSDUH 公用数据指南;按官方定长位置恢复 YRBS 2017/2019 的 weight、stratum、PSU,并同步年度完整表及 19912019 selected 表。
- 输出:新增 `repair_yrbs_2017_2019_design.py``yrbs_2017_2019_design_repair_audit.{json,md}``survey_design_source_audit.md`;更新 `survey_design.csv` 构建规则及入口结构审计。
- 检查:2017 的 14,765 行和 2019 的 13,677 行三项设计字段均恢复为全量非空且权重为正;权重和分别为 14,765.0049 与 13,677.0071,与指南所述缩放到样本量一致。GSHS 七个主要结局组件共 21,533 人的 canonical/raw 权重、PSU、stratum 数值完全一致、全量非空且为正。NSDUH 232,441 行满足 `C2=C1/2``C3=C1/3``C4=C1/4` 精确等式,确认 C1 为单年权重、C2–C4 为合并 2–4 年的年均权重。
- 方法决策:YRBS 使用 WEIGHT/STRATUM/PSU 的复杂抽样程序;NSDUH 使用 VESTR_C/VEREP、Taylor 线性化和单年 ANALWT2_C1,青少年分析必须作为全样本设计内的 domain 而非先物理删成人;GSHS 跨组件前为 PSU/stratum 增加组件命名空间。
- 剩余例外:YRBS 1997 仍有 1 行同时缺三项设计字段,已显式登记,不能静默进入设计型方差估计。
- 工程记录:PDF 工具路径不匹配在任何结论写入前失败,改用工作区 PDF runtime 后完成并记录为 `ERR-20260920-042`
- 推送状态:`push_pending`;验证、提交并推送后更新。
- 下一步:由两名实际审核者独立处理 84 条主结局审核队列;完成签署与分歧裁决后执行 Gate 1 最终验收。
## 9. 剩余工作量估算(2026-09-20 基线)
| 阶段 | 主要工作 | 预计人周 | 主要波动来源 |
@@ -811,6 +824,6 @@ Gate 0 当前判定:`passed`。四项交付物齐备;目标总体政策、
阶段 1 下一行动:
1. 复核 GSHS、YRBS、NSDUH 的年度/组件设计字段与官方方差说明,禁止凭字段名推断方差方法
2. 核对长表各题的阳性/缺失计数与原始审计,形成回答层验收摘要
3. 安排两名实际审核者逐项处理 `primary_outcome_human_review_queue.csv`;审核完成前保持全部主要结局为 `provisional`
1. 由两名实际审核者独立处理 `primary_outcome_human_review_queue.csv`,核对题文、构念、总体、语言、编码、跳题和缺失规则
2. 对两位审核者的分歧执行显式裁决,不得由 AI 冒充审核者或自动填写签名
3. 审核通过后重建题库/回答层并执行 Gate 1 逐项验收;未签署前保持全部主要结局为 `provisional`