结核病家庭接触调查设计{ #tb-hh-design }¶

    结束
    子图 BC[TPT］
      id7[TPT 资格<br> TPT 开始日期<br> TPT 方案<br> 预计 TPT 结束日期] end
    结束
    BA --> BC -->BD
    BA -.主动结核病检测请求 .-> BB
    子图 BD[TPT 结果］
      id8[TPT 结果<br> 最终延迟结果<br> 意见 ]。
    结束

### 计划结构和设计{ #program-structure-and-design } 

跟踪器的设计遵循了世界卫生组织关于报告家庭接触者结核病预防活动的建议。该程序允许回顾性和接近实时的数据输入。用户会根据输入的数据收到反馈信息和建议。这些建议不具有限制性，旨在支持数据录入，并在可能的情况下找出服务质量方面的差距。该计划分为以下几个阶段：注册、筛查和测试、TPT 和 TPT 成果。

  1. 注册

     该阶段收集了基本的 TEI 属性。某些属性显示 "GEN - "前缀。有关通用元数据的详细信息，请参阅[**通用元数据图书馆**](https://docs.dhis2.org/en/topics/metadata/dhis2-who-digital-health-data-toolkit/common-metadata-library/design.html) 文档部分。

  2. 筛查和检测

     该阶段从 "HIV 感染状况 "部分开始。由于 5 岁以下儿童和艾滋病毒感染者无需进行筛查，因此尽早获取年龄和艾滋病毒感染状况数据可简化工作流程。如果患者已接受筛查，则在相应部分记录 X 光、IGRA 和 TST 的筛查和检测结果。如果建议、要求并进行了积极的结核病检测，则在 "积极的结核病检测 "部分也可记录诊断检测的结果。结核病例监测和家庭接触调查之间没有自动数据交换。结核病例监测 "中的实验室阶段将包含详细的诊断检测结果。家庭接触调查 "中的 "活动性肺结核检测 "部分只包含检测结果是阳性、阴性还是未知的信息。如果病例无症状且所有检测结果均为阴性，则会通知用户 TPT 不适用。

     **该阶段不可重复**。

  3. TPT

     该阶段从 TPT 资格部分开始。如果病例不符合 TPT 资格，系统将提示用户提供不符合资格的原因并关闭注册。如果病例符合条件，则可进入 TPT 部分，提示用户输入病例是否已开始 TPT、开始日期和治疗方案等数据。将根据所选疗程的长度生成 TPT 预计完成日期，并提示用户根据该日期安排结果事件。

     **该阶段不可重复**。如果实施计划建议注册多个 TPT 阶段（即重新分配疗程），则可以使该阶段可重复，并在 TPT 阶段中添加以下数据元素：
      - TPT 结束日期
      - 终止 TPT 的原因

     这样，用户就可以跟踪治疗方案的变化，并计算 TPT 的预计完成日期。还可以编辑可用于 TPT 的治疗方案，并调整 TPT 预计完成日期的自动计算。

  4. TPT 成果

     TPT 结果事件的日期是记录结果的日期。失去随访 "和 "死亡 "结果与 "停止 "结果是分开的。如果 TPT 结果被停止，系统会提示用户提供停止 TPT 的原因。将显示结果的最终延迟（预期结果日期与实际结果日期之间的月数差异）。然后，用户可以关闭注册。

### 关系配置{ #relationship-configuration } 

追踪器的默认设计是通过追踪器捕获/捕捉应用程序中的关系部件登记家庭联系人。结核病例监测计划的登记人员与住户接触调查计划的登记人员之间会建立关系。关系类型为双向关系。有关关系类型配置的更多信息，请参阅[安装指南]（#tb-hh-installation）。

### 用户组{ #user-groups } 

该软件包与结核病例监测软件包使用相同的用户组：

TB 管理员：可以编辑/查看元数据；无法访问数据 [所有计划阶段］
TB 数据采集：可以查看元数据，可以采集数据 [所有程序阶段］
TB 访问：可以查看元数据，可以查看数据 [所有程序阶段］

## 分析工具 { #analytics } 

住户接触追踪调查软件包中收集的原始数据可为建议的分析输出提供分子和分母。该软件包中包含的数据交换组件经配置后可按季度汇总数据，并填充结核病 HMIS 模块中的 "住户联系人仪表板"。

### 汇总数据交换{ #aggregate-data-exchange } 

汇总数据交换组件是软件包中包含的一个可编辑对象。它被配置为汇总计划指标数据，并将季度值分配给[家庭联系人数据集]（#tb-agg-hh-design）的相应数据元素和类别选项组合，该数据集是 DHIS2 结核病 HMIS 软件包的一部分。

### 指标 { #indicators } 

Intital 软件包包括一套计划指标，可分为以下两组：

- 识别、筛选和 TPT

  | 指标定义
  |-|-|
  | 已确定的联系人（0-4 岁，5 岁以上） | 所有注册 **注册日期在报告期内** | 所有注册
  已筛选的联系人（0-4 岁，5 岁以上） | 所有标记为已筛选的注册人** 注册日期在报告期内** | 所有标记为已筛选的注册人** 注册日期在报告期内** | 所有标记为已筛选的注册人** 注册日期在报告期内**
  符合 TPT 条件的联系人（0-4 岁，5 岁以上） | 所有标记为符合 TPT 条件的注册人** 注册日期在报告期内** | 所有标记为符合 TPT 条件的注册人** 注册日期在报告期内** | 所有标记为符合 TPT 条件的注册人** 注册日期在报告期内**
  在 TPT 上开始的联系人（0-4 年，5 年以上） | 所有标记为在 TPT 上开始的注册 **注册日期在报告期内** | 所有标记为在 TPT 上开始的注册 **注册日期在报告期内** | 所有标记为在 TPT 上开始的注册

- TPT 成果

  | 指标定义
  |-|-|
  已完成 TPT 的联系人（0-4 年，5 年以上） | 已完成 TPT 的所有注册人员 **注册日期为报告期之前 9 个月（3 个季度）期间** | 所有注册人员**注册日期为报告期之前 9 个月（3 个季度）期间** | 完成 TPT 的所有注册人员
  | 停止 TPT 的联系人（0-4 年，5 年以上） | 所有停止 TPT 的注册人 **注册日期为报告期之前 9 个月（3 个季度）** | 所有停止 TPT 的注册人

**TPT 成果的报告和计算**

记录结果的实际期限取决于 TPT 疗程的长短。在当前模块中，建议的最长 TPT 方案为 9 个月。活动队列的结果报告期设定为活动队列成员在住户接触调查项目中登记期间结束后的 9 个月。这一时期可能会根据国家指导方针（如可用的最长疗程）发生变化。
下表介绍了 DHIS2 中报告和计算 TPT 结果的算法。

美人鱼

%%{init：{'mirrorActors':false,'theme':'dark' }}%%

时间轴
    2023 年 1-3 月<br> 2023Q1
      活跃群组（在 2023Q1 期间确定的家庭联系人开始使用 TPT）：如果在此期间有结果，则包括在报告中
    2023 年 4-6 月<br> 2023Q2
      有结果的活跃群组的成员：如果在此期间有结果，则包括在报告中
    2023 年 7 月至 9 月<br> 2023Q3
      有结果的在职群体成员：如果在此期间有结果，则包括在报告中
    2023 年 10 月至 12 月<br> 2023Q4
      有结果的在职群体成员：如果在此期间有结果，则包括在报告中：2023Q4 有结果的在役队列成员：如果在此期间有结果，则包括在报告中： 在役队列成员的结果将在此期间报告
    2024 年 1 月
      提供在役队列的最终结果报告