mitre/canary

Canary EDRS测试框架

Canary是一个开源测试框架，支持基于标准的死亡数据交换系统开发。它提供测试和工具，帮助开发人员实现生命记录死亡报告（VRDR）FHIR死亡记录格式（[***]

版本

• Canary项目v2.x.x版本支持FHIR STU3，与VRDR的5月投票版本（v0.1.0）一致
• Canary项目v3.x.x版本支持FHIR R4，与即将发布的VRDR规范版本一致

从2.x.x升级到3.x.x时，请注意FHIR STU3和R4之间的差异会影响VRDR死亡记录的结构。https://github.com/nightingaleproject/vrdr-dotnet/commit/2b4c2026fdab80e7233f3a7d7ed6e17d5d63f38e%E3%80%82%E5%8D%87%E7%BA%A7%E5%88%B0Canary 3版本时，死亡记录数据可能需要从STU3到R4进行类似更新。

核心功能与特性

Canary可以测试数据提供者的以下能力：

• 生成FHIR VRDR记录
• 消费FHIR VRDR记录
• 往返转换：FHIR（消费）与IJE死亡率格式（生成）之间的转换
• 往返转换：IJE死亡率格式（消费）与FHIR（生成）之间的转换
• 生成Connectathons测试过的预定义FHIR VRDR记录
• 生成FHIR VRDR消息
• 生成Connectathons测试过的预定义FHIR VRDR消息

Canary还包含以下工具：

• 生成合成VRDR记录
• FHIR VRDR记录语法检查器
• VRDR记录格式转换器
• FHIR VRDR记录检查器
• FHIR VRDR记录创建器
• IJE死亡率记录检查器
• FHIR VRDR消息语法检查器
• 创建FHIR VRDR消息

背景

美国各地的司法管辖区收集、分析和共享死亡率数据，以洞察重要的健康趋势，包括慢性病的影响、减少机动车事故死亡的进展以及药物滥用的演变挑战。许多系统用于收集和共享死者信息，包括人口统计数据和与确定死因相关的***信息。通过使用FHIR等现代标准连接这些系统，我们可以实施减轻认证者负担、提高数据质量并改善数据收集和报告及时性的流程。Canary通过提供测试实现和处理死亡率数据格式的工具，支持互操作系统的开发。

使用方法

Canary的Docker化版本已发布到Docker Hub。要确保获得最新版本的Canary：

bash
docker pull mitre/canary:latest

运行Canary非常简单：

bash
docker run --rm -p 8080:80 mitre/canary:latest

这些命令将从Docker Hub拉取最新版本的Canary并运行它。您可以通过Web浏览器访问http://localhost:8080。要运行特定版本，只需在上述docker run命令后附加版本号。您可以在https://hub.docker.com/r/mitre/canary/tags%E6%9F%A5%E7%9C%8BDockerHub%E4%B8%8A%E5%8F%AF%E7%94%A8%E7%9A%84%E6%89%80%E6%9C%89Canary%E7%89%88%E6%9C%AC%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%9A

bash
docker run --rm -p 8080:80 mitre/canary:3.0.0-RC5

如果要从 scratch（从源代码）构建Docker化的Canary，可以通过在项目根目录中运行以下命令来实现：

bash
docker build -t canary .
docker run -d -p 8080:80 --name mycanary canary

如果您不想使用Docker，可以使用global.json中列出的.NET Core版本和Node.js安装，从项目根目录运行Canary：

bash
dotnet --version # 验证此命令仅返回版本号且无错误
node --version # 验证Node已成功安装
dotnet tool install --global dotnet-ef
dotnet ef database update --project canary
dotnet run --project canary

执行dotnet run命令后，应用程序可通过Web浏览器访问http://localhost:5000。

发布版本

Canary的主要部署方法是DockerHub。每当提交合并到master分支时，DockerHub会自动构建该提交并在DockerHub上标记为latest，因此任何运行docker pull mitre/canary:latest的用户都将收到该镜像的副本。

每当创建格式为vX.Y.Z的Canary标签时，Dockerhub会自动构建该git标签并在DockerHub上标记为X.Y.Z。这意味着任何运行docker pull mitre/canary:X.Y.Z的用户都将收到版本为X.Y.Z的应用程序副本。

许可证

版权所有 2017, 2018, 2019, 2020 The MITRE Corporation

根据Apache许可证2.0版（"许可证"）授权；除非遵守许可证，否则您不得使用此文件。您可以在以下位置获取许可证副本：

http://www.apache.org/licenses/LICENSE-2.0

除非适用***要求或书面同意，否则根据许可证分发的软件按"原样"分发，不提供任何明示或暗示的担保或条件。有关许可证下权限和限制的具体语言，请参阅许可证。

联系信息

有关Canary的问题或意见，请发送电子邮件至：