HealthCarePregnant/7-indicator-PCM.md

PCM 孕期监测指标体系（指标字典）

文档定位：本文件是孕妇监测指标体系的单一事实来源（Single Source of Truth）——把基础构想中"数十种指标"的愿景落成结构化、可扩展、可配置的指标字典，供分析规则引擎、数据质控、处置达标判定、孕期数据湖共同引用。

关系：上承 0-1-基础构想.md（§5 产品范围、附录2.2 监测指标体系、附录三 孕妇时间轴）、0-req-PCM.md（REQ-1/REQ-3 监测与分析）、1-prd-PCM.md；与 6-exec-PCM.md（§4.4 达标参数表引用本字典）、4-arch-PCM.md、5-compliance-PCM.md 协同。规则阈值与可测项受 2-task-PCM.md 阻塞项 C-2（设备可测指标清单 + 精度 + 认证） 制约。

重要约束：本系统定位为健康管理 / 临床决策支持，非诊断。本文所有阈值/分段为通用临床常识占位，须由运营方专业医生最终确认；可测指标以设备实际能力为准（C-2）。

---

1. 目的与原则

1. 单一事实来源 + 统一编码：每个指标在系统中只定义一次，设备数据、规则、知识库、处置、数据湖均引用同一定义（基础构想附录二"先建统一术语表/指标字典"）。
2. 孕周分段：阈值按孕早/中/晚期切换（同一数值在不同孕周判定可能不同）。
3. 个体化收紧：依据静态风险基线（高龄、既往 GDM/PIH、超重、多胎等）对默认阈值收紧或提高监测频率。
4. 可解释、可追溯：风险判定可回溯到具体指标、规则、知识依据与观测值。
5. 可配置扩展：指标与规则以数据驱动（NFR-7），新增指标/调整阈值不改代码（当前 MVP 为硬编码，本文给出向配置化迁移的结构）。
6. 设备能力为准 + 渐进：先做设备可测、临床价值高的指标（GDM 血糖 + 妊高征血压），随设备清单与数据积累横向扩展。
7. 数据质控前置：每个指标定义生理合理范围，超范围或缺失不得直接驱动高风险结论。

---

2. 指标字典数据结构（实现指引）

每个指标是一条字典记录，建议落为可配置表（替代当前硬编码 INDICATORS + DEFAULT_RULES）：

IndicatorDef {
  code            // 内部唯一键，如 'fasting_glucose'
  label           // 中文名
  unit            // 单位
  category        // metabolic|cardiovascular|anthropometric|nutrition|fetal|tcm|psych|other
  source          // device | manual | both
  plausibleMin    // 生理合理下限（质控）
  plausibleMax    // 生理合理上限（质控）
  redFlagRelated  // 是否参与红旗组合
  standardCode    // 对接编码（LOINC/SNOMED，待术语表落定）
  status          // implemented | rule_pending | device_pending | v2
  thresholds: ThresholdByStage[]   // 按孕周分段的判定（可空=待填）
}

ThresholdByStage {
  stage           // any | first(0-13w) | second(14-27w) | third(28w+)
  grades: { op, value, level, message }[]   // 如 { '>=', 5.1, 'medium', '...' }
}

达标判定（复测目标）见 6-exec-PCM.md §4.4；本文负责"异常/风险阈值"，6-exec 负责"处置后回落目标"，二者共用同一 code 与单位。

---

3. 指标分类总览与状态图例

分类（对齐基础构想附录2.2）：

类别 code	名称	临床意义
metabolic	代谢类	血糖系列、糖化血红蛋白——GDM 监测核心
cardiovascular	心血管类	血压、心率——妊娠期高血压/子痫前期核心
anthropometric	体格/生长	体重、增重、BMI
nutrition	营养/微量元素	维生素D、铁/血红蛋白、钙等
fetal	胎儿相关	胎动、胎心
tcm	中医辨证	体质、舌象、脉象、证候
psych	心理/身心	情绪自评、焦虑自评
other	其他生命体征/生化	尿蛋白、体温、血氧等

状态图例：

状态	含义
✅ implemented	已在后端指标目录且有规则
🟡 rule_pending	已在目录、阈值规则待补
🟠 device_pending	临床价值明确，待 C-2 设备清单确认可测性
🔵 v2	列入二期（中医辨证、趋势预测等）
🟢 mvp-planned	本期计划新增（已在 6-exec 设计，未实现）

---

4. 指标明细

阈值列：already in code 的为后端 rule-engine.ts 现值（通用占位）；其余为框架占位，标注待确认。所有阈值待医生确认，并须补孕周分段（见 §5）。

4.1 代谢类 metabolic（GDM 核心）

编码	名称	单位	合理范围(质控)	来源	现有阈值/规则	关联风险	状态
fasting_glucose	空腹血糖	mmol/L	1–40	both	≥5.1 中(FG-1) / ≥7.0 高	GDM	✅
ogtt_1h	OGTT 1小时血糖	mmol/L	1–40	both	≥10.0 中(OGTT1-1)	GDM	✅
ogtt_2h	OGTT 2小时血糖	mmol/L	1–40	both	≥8.5 中(OGTT2-1)	GDM	✅
postprandial_glucose	餐后血糖	mmol/L	1–40	both	目标<6.7(达标用)，异常规则待补	GDM	🟡
hba1c	糖化血红蛋白	%	3–20	device	待补（如≥5.7 关注）	血糖控制	🟠

4.2 心血管类 cardiovascular（妊高征/子痫前期核心）

编码	名称	单位	合理范围	来源	现有阈值/规则	关联风险	红旗	状态
systolic_bp	收缩压	mmHg	50–300	both	≥140 中(SBP-1) / ≥160 高	妊娠期高血压	是	✅
diastolic_bp	舒张压	mmHg	30–200	both	≥90 中(DBP-1) / ≥110 高	妊娠期高血压	是	✅
heart_rate	心率	bpm	30–250	both	阈值待补	心血管	—	🟡

4.3 体格/生长 anthropometric

编码	名称	单位	合理范围	来源	现有阈值/规则	关联风险	状态
weight	体重	kg	30–200	both	按孕前 BMI 周增区间，规则待补	增重异常/子痫前期信号	🟡
bmi	体质指数(派生)	kg/m²	10–60	derived	孕前 BMI 分层（已用于初始风险）	基线分层	✅(基线)
weight_gain_rate	周增重(派生)	kg/周	-2–3	derived	短期骤增→子痫前期信号(待补)	子痫前期	🟡

4.4 营养/微量元素 nutrition（待设备）

编码	名称	单位	来源	临床意义	状态
vitamin_d_25oh	维生素D(25-OH)	ng/mL	device	胎儿骨骼发育、母体免疫	🟠
hemoglobin	血红蛋白	g/L	device	贫血筛查	🟠
serum_iron	血清铁	μmol/L	device	缺铁	🟠
calcium	血钙	mmol/L	device	钙代谢	🟠

4.5 胎儿相关 fetal（待设备）

编码	名称	单位	来源	临床意义	红旗	状态
fetal_movement	胎动计数	次/时段	manual/device	胎儿安危	是(明显减少/消失)	🟠
fetal_heart_rate	胎心率	bpm	device	胎儿监护	是(异常)	🟠

4.6 其他生命体征/生化 other

编码	名称	单位	来源	临床意义	红旗	状态
urine_protein	尿蛋白	定性/mg	device/试纸	子痫前期关键指标	是(显著阳性)	🟠
body_temperature	体温	℃	both	感染	—	🟠
spo2	血氧饱和度	%	device	缺氧	—	🟠

4.7 中医辨证 tcm（V2）

编码	名称	类型	来源	用途	状态
tcm_constitution	体质类型	枚举	问卷/医师	辨证调养建议	🔵
tcm_tongue	舌象	结构化/图像	采集/医师	辨证	🔵
tcm_pulse	脉象	结构化	医师/设备	辨证	🔵
tcm_syndrome	证候	枚举	辨证推理	调养方案	🔵

4.8 心理/身心 psych（本期新增，见 6-exec D3）

编码	名称	单位	来源	用途	状态
mood_self	情绪自评	0–10	manual(孕妇端)	身心信号、关怀处置触发	🟢
anxiety_self	焦虑自评	0–10	manual(孕妇端)	身心信号、焦虑改善 KPI	🟢

心理类采用轻量自评（非诊断量表），避免量表化加重焦虑；危机信号（持续低分/危机表述）旁路人工即时介入（6-exec §4.6 / 内容安全）。

---

5. 孕周分段阈值框架

时间主轴（基础构想附录三）：

分期	孕周	监测重点
孕早期 first	0–13w	建档、基线、早期风险筛查
孕中期 second	14–27w	GDM 筛查窗（24–28w）、稳定监管
孕晚期 third	28–40w+	妊高征/子痫前期高发、胎儿监护强化
产后 postpartum	分娩后	指标恢复、随访、转出

现状与缺口：规则引擎结构支持按孕周适配（appliesTo），但当前规则未填分段——所有阈值不分孕周。需医生给出各指标分段阈值后填充。示例（占位，待确认）：

fasting_glucose:
  any:    >=5.1 medium, >=7.0 high     # 现状
  (建议按孕周细化诊断窗与管理目标)
systolic_bp:
  any:    >=140 medium, >=160 high     # 现状
weight_gain_rate:
  second/third: 周增 > 上限 medium     # 待医生给区间

个体化收紧：当孕妇带高龄/既往 GDM/PIH/超重/多胎等基线因子时，对应指标阈值收紧或监测频率提高（关联 PatientProfile.initialRiskFactors）。

---

6. 红旗急症指标组合（旁路升级）

红旗不走单指标常规规则，由专门旁路即时升级（REQ-4.3 / 基础构想附录五）：

红旗规则	触发组合	动作
子痫前期急症	(SBP≥160 或 DBP≥110) + (剧烈头痛/视物模糊/上腹痛 之一)	立即就医/转急诊 + 通知医生 + 升高风险
胎动异常	胎动明显减少 / 消失	立即就医提示 + 通知医生
产科出血	阴道大量出血	立即急诊
严重血糖异常	极高/极低血糖 + 症状	立即处置 + 通知医生
尿蛋白显著阳性 + 高血压	子痫前期信号	升级评估

---

7. 数据质量与质控（前置门）

• 合理范围校验：超出 plausibleMin/Max 标记存疑，不驱动高风险结论（已实现，质控 T-3.4）。
• 来源标记：device / manual，区分可信度；设备需校准与认证（C-2）。
• 缺失/中断：漏测触发提醒；缺失不外推为正常。
• 多源归一：同指标多设备/多次测量按 孕妇ID + 指标code + 时间戳 归一为时间序列（数据湖）。

---

8. 编码与标准

• 建议对接通行医学术语标准：检验项 LOINC、临床概念 SNOMED CT、诊断 ICD（基础构想附录二）。
• 具体编码待统一术语表落定；示例（待核）：空腹血糖 LOINC 1558-6、HbA1c 4548-4、收缩压 8480-6、舒张压 8462-4、维生素D(25-OH) 1989-3。
• 目的：设备数据、规则、知识库三方"说同一种语言"，支撑互操作与 FHIR 对接（NFR）。

---

9. 与分析 / 数据湖 / 处置的关系

设备/手填 → 观测值(指标code+值+孕周+来源)
   → [质控] 合理范围/来源
      → [分析] 指标字典阈值(本文) → 风险+预警(可解释)
         → [处置] 6-exec 处置单 → 达标目标(6-exec §4.4，同 code)
            → [跟进] 复测回流 → 比对达标
               → [数据湖] 全部按孕周时间轴归一(孕妇本体) → 增值礼物

指标字典是这条链的"词表地基"：分析引擎、6-exec 达标参数、数据湖时间轴、知识库指标释义全部引用本文 code。

---

10. 现状快照与落地分期

现状（诚实盘点，对齐代码）：

• 后端目录 INDICATORS 含 8 个：fasting_glucose、ogtt_1h、ogtt_2h、postprandial_glucose、systolic_bp、diastolic_bp、weight、heart_rate。
• 有阈值规则的 5 个：fasting_glucose、ogtt_1h、ogtt_2h、systolic_bp、diastolic_bp。
• 无规则：postprandial_glucose、weight、heart_rate。
• 孕周分段：结构支持、未填充。
• 其余（HbA1c、维生素D、铁/Hb、钙、胎动、胎心、尿蛋白、体温、血氧、中医、情绪）未入系统。

分期：

阶段	范围
MVP（现有 + 本期补）	巩固血糖+血压闭环；补 postprandial/weight/heart_rate 规则；新增情绪/焦虑自评；指标字典配置化（去硬编码）
待 C-2 解锁	维生素D、铁/Hb、钙、胎动、胎心、尿蛋白、体温、血氧（取决于设备可测性+认证+接口）
V2	中医辨证维度、孕周分段阈值精细化、趋势/变化率时序规则、趋势预测模型

---

11. 依赖与待确认

1. 🔴 C-2 设备可测指标清单 + 精度 + 认证：决定 nutrition/fetal/other 多数指标能否落地（阻塞）。
2. 🟠 各指标孕周分段阈值与异常判定：须医生按指南给出（阻塞规则填充）。
3. 🟠 个体化收紧参数：哪些基线因子、收紧多少。
4. 🟡 统一术语表/编码：LOINC/SNOMED 具体映射。
5. 🟡 时序规则参数：趋势/变化率判定（V2）。

---

12. 需求映射（建议回写 0-req / 1-prd）

建议条目	描述	关联
REQ-I1 指标字典	THE 系统 SHALL 以可配置指标字典统一定义监测指标（编码/单位/范围/分段阈值/来源）	REQ-1/REQ-3、基础构想附录二
REQ-I2 孕周分段	WHERE 指标判定，THE 系统 SHALL 按孕周分段并支持个体化收紧	REQ-3 约束
REQ-I3 质控门	IF 观测超合理范围或缺失，THE 系统 SHALL 标记存疑且不驱动高风险结论	T-3.4
REQ-I4 编码标准	THE 系统 SHOULD 对接 LOINC/SNOMED 以支持互操作	NFR/FHIR

13. 数据汇集页「健康档案」UI 规格

孕妇详情第二页（与「工作台」用胶囊 Tab 切换，工作台为默认；见 6-exec-PCM.md §5）。本页是指标字典 + 孕妇本体数据湖的可视化——数据视角，回答"这位孕妇全方位数据全貌"。后端实体/接口不变，本页为前端信息架构。

13.1 信息架构与线框

┌─────────────────────────────────────────────────────────────────────────┐
│ ← 返回   王芳 PCM-000003          ( 工作台 ▮ 健康档案 )  ← 胶囊Tab           │
│ ┌─ 指标概览（按分类卡片：最新值 + 达标状态 + 趋势↑↓） ───────────────────┐ │
│ │ 代谢：空腹血糖 5.6↑(达标线5.1)  | 心血管：收缩压 150↑  舒张压 95↑      │ │
│ │ 体格：体重 +0.6kg/周           | 身心：情绪 6/10 →                     │ │
│ │ 营养/胎儿：待设备(C-2)                                                 │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ ┌── 选中指标趋势（孕周时间轴） ──┐ ┌── 全部观测记录（可筛选） ───────────┐ │
│ │   收缩压 近12周折线 + 阈值带    │ │ 指标/孕周/来源/质控 筛选            │ │
│ │   达标线 / 红旗线              │ │ 150 mmHg·孕31周·手填·合格 …        │ │
│ └────────────────────────────┘ └──────────────────────────────────────┘ │
│ ┌─ 个案动态时间线（全过程留痕，从工作台迁入） ─────────────────────────┐ │
│ │ 采集→预警→流转→计划→提醒→处置→跟进，最新在上，可按类型筛选            │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ ┌─ 身心曲线 ─┐ ┌─ 静态档案（基线/孕产史/风险因素） ─┐ ┌ 数据湖·增值礼物(V2) ┐│
│ └────────────┘ └──────────────────────────────────┘ └────────────────────┘│
└─────────────────────────────────────────────────────────────────────────┘

13.2 各区职责

区	职责	数据来源	复用组件
指标概览	按分类（§3）展示各指标最新值 + 达标状态 + 趋势箭头；未采集/待设备标注	指标字典 + 最新观测	新增 IndicatorOverview
指标趋势	选中指标的孕周时间轴折线 + 阈值/达标线	/trends + 字典阈值	新增 TrendChart
全部观测记录	所有观测，按指标/孕周/来源/质控筛选	observations	复用 ObservationsPanel（迁入并增强筛选）
个案动态时间线	全过程留痕（采集/预警/流转/计划/提醒/处置/跟进）	汇流事件	复用 CaseTimeline（从工作台迁入）
身心曲线	情绪/焦虑自评趋势	emotion-checkins	新增
静态档案	基线、孕产史、既往史、风险因素	PatientProfile	复用档案头扩展
数据湖·增值礼物	孕期全纪录入口（V2）	数据湖	V2

13.3 与「工作台」的互链与边界

• 工作台「分析」中点某指标 → 跳本页该指标趋势；本页发现异常 → 一键回工作台发起处置。
• 不重复：工作台呈现"要处理的事"（预警作为待办、处置、跟进）；健康档案呈现"完整数据"（观测、趋势、时间线）。同一条数据两视角各取所需。
• 响应式：窄屏分类卡片与图表上下堆叠；保持医护端专业中性风、可达性达标（3-ui-style §8）。

---

确认本字典框架后：①将指标体系从硬编码迁移为配置化字典（后端 analysis）；②医生填充孕周分段阈值；③随 C-2 设备清单扩展可测指标；④回写 0-req（REQ-I1~I4）与 1-prd 功能清单/约束。