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 功能清单/约束。