HL7-FHIRパイプラインのテスト戦略:シミュレーションと境界定義によるアプローチ
Testing HL7-to-FHIR Pipelines Without a Hospital: Mocking HAPI FHIR with respx
サマリー
筆者は、レガシーなHL7 v2.5メッセージをFHIR R4リソースに変換するオープンソースのパイプライン構築経験に基づき、実際の病院システムがない環境での信頼性の高いテスト手法を解説した。本記事では、ユニットテストとインテグレーションテストにおいて、外部依存(HAPI FHIRサーバーやMLLP接続)を`respx`を用いてモック化し、分離された境界で検証する具体的な方法論を紹介している。
詳細
筆者が開発したMaternity HL7-to-FHIRパイプラインは、HL7 v2.5メッセージをAustralianおよびEuropean FHIRプロファイルを持つR4リソースに変換するシステムである。このパイプラインは、Mirth Connect(HL7取り込み)、FastAPI(FHIR変換)、HAPI FHIR Server(永続化)の三層構造を持つ。本記事が焦点を当てるのは「テスト」部分であり、特に実際の病院環境やライブサーバーがない状況での検証方法論である。従来のE2Eテストでは、Mirth ConnectとHAPI FHIRサーバーなど多くのコンポーネントが必要となり、CI/CDパイプラインの速度低下や不安定なテスト(flaky tests)の原因となっていた。筆者は、FastAPIレイヤーがMLLPではなくJSONペイロードを受け取り、FHIRリソースをHTTP経由でHAPIに送信するという「境界」を利用し、テストを分離した。ユニットテストでは変換ロジックのみを検証し、インテグレーションテストでは`httpx.AsyncClient`と`respx`を用いてHAPI FHIRへのHTTP通信(PUT/POSTなど)をモック化することで、サーバーやDockerコンテナに依存しない形でエンドポイントのライフサイクル全体を網羅的にテストできることを示している。
Original content copyright by respective publishers