davinci_pdex_test_kit 0.10.6 → 0.11.0

data/lib/davinci_pdex_test_kit/pdex_payer_client/client_validation_test.rb

@@ -1,57 +1,110 @@
 module DaVinciPDexTestKit
-  module ClientValidationTest
-
-    def previous_clinical_data_request_resources
-      hash = Hash.new { |hash, key| hash[key] = [] }
-      previous_clinical_data_requests.each_with_object(hash) do |request, request_resource_hash|
-        request_resources =
-          if request.status == 200
-            request.resource.entry.map(&:resource)
-          else
-            []
-          end
-        request_resource_hash[request].concat(request_resources)
+  module PDexPayerClient
+    # Common utilities for Clinical Data Request Tests
+    # This module will be included in Inferno::Entities::Test
+    module ClientValidationTest
+
+      def check_resource_type_fetched_instances(resource_type)
+        load_clinical_data_into_scratch
+        
+        skip_if scratch[resource_type].nil?, "No requests made for #{resource_type.to_s} resources."
+        
+        not_fetched = []
+        SET_TO_BE_GATHERED[resource_type].each do |target_id|
+          not_fetched << target_id unless scratch[resource_type].any? { |resource| resource.id == target_id }
+        end
+
+        assert not_fetched.length == 0, 
+              "Expected #{resource_type.to_s} instances not fetched: #{not_fetched.join(', ')}." 
       end
-    end
 
-    def connect_bundle(export_binary)
-      export_binary.split(/(?<=}\n)(?={)/).map { |str| FHIR.from_contents(str)}
-    end
+      # @return [Hash<Inferno::Entities::Request, Array<FHIR::Model>>]
+      def previous_clinical_data_request_resources
+        return_hash = Hash.new { |hash, key| hash[key] = [] }
 
-    def export_resources
-      @export_resources ||= (load_tagged_requests(BINARY_TAG).map { |binary_read| binary_read.response_body.split("\n") }.flatten).map { |resource_in_binary| FHIR.from_contents(resource_in_binary)}
-    end
+        previous_clinical_data_requests.each_with_object(return_hash) do |request, request_resource_hash|
 
-    def previous_clinical_data_requests
-      @previous_clinical_data_requests ||= load_tagged_requests(SUBMIT_TAG) + [everything_request].compact
-    end
+          request_resources = []
+          if (request.status == 200) && request.resource # XXX request.response_body ?
+            case request.resource.resourceType
+            when 'Bundle'
+              request_resources = request.resource.entry.map(&:resource)
+            # when '...' # TODO handle other special resources
+            else
+              request_resources = [request.resource]
+            end
+          end
 
-    def everything_request
-      @everything_request ||= load_tagged_requests(EVERYTHING_TAG).first
-    end
+          request_resource_hash[request].concat(request_resources)
+        end
+      end
 
-    def member_match_request
-      @member_match_request ||= load_tagged_requests(MEMBER_MATCH_TAG).first
-    end
+      def load_clinical_data_into_scratch
+        return if scratch['loaded'].present?
 
-    def export_request
-      @export_request ||= load_tagged_requests(EXPORT_TAG).first
-    end
+        previous_clinical_data_request_resources.each do |request, resources|
+          resources.each do |resource|
+            scratch[resource.resourceType.to_sym] ||= []
+            scratch[resource.resourceType.to_sym] |= [resource]
+          end
+        end
 
-    def export_status_request
-      @export_status_request ||= load_tagged_requests(EXPORT_STATUS_TAG).first
-    end
+        if !export_resources.empty?
+          info "Attempted an $export request"
+          export_resources.each do |resource|
+            scratch[resource.resourceType.to_sym] ||= []
+            scratch[resource.resourceType.to_sym] |= [resource]
+          end
+        end
 
-    # def patient_id_from_match_request
-    #   @patient_id_from_match_request ||= member_match_request ? "999" : nil #TODO: Change from static response
-    # end
+        scratch['loaded'] = true
+      end
 
-    def all_member_match_requests
-      @all_member_match_requests ||= load_tagged_requests(MEMBER_MATCH_TAG)
-    end
+      # @return [Array<Inferno::Entities::Request>]
+      def previous_clinical_data_requests
+        [] + load_tagged_requests(RESOURCE_REQUEST_TAG) + load_tagged_requests(EVERYTHING_TAG) # TODO add export request
+      end
+  
+      def everything_request
+        @everything_request ||= load_tagged_requests(EVERYTHING_TAG).first
+      end
+  
+      def member_match_request
+        @member_match_request ||= load_tagged_requests(MEMBER_MATCH_TAG).first
+      end
+  
+      def export_request
+        @export_request ||= load_tagged_requests(EXPORT_TAG).first
+      end
+  
+      def export_status_request
+        @export_status_request ||= load_tagged_requests(EXPORT_STATUS_TAG).first
+      end
+  
+      def connect_bundle(export_binary)
+        export_binary.split(/(?<=}\n)(?={)/).map { |str| FHIR.from_contents(str)}
+      end
+  
+      def export_resources
+        @export_resources ||= (load_tagged_requests(BINARY_TAG).map { |binary_read| binary_read.response_body.split("\n") }.flatten).map { |resource_in_binary| FHIR.from_contents(resource_in_binary) }
+      end
 
-    def flattened_all_resources
-      @flattened_all_resources ||= previous_clinical_data_request_resources.values.flatten
+      # def patient_id_from_match_request
+      #   @patient_id_from_match_request ||= member_match_request ? "999" : nil #TODO: Change from static response
+      # end
+  
+
+      def all_patient_id_search_requests
+        @everything_request ||= load_tagged_requests(PATIENT_ID_REQUEST_TAG)
+      end
+
+      def all_member_match_requests
+        @all_member_match_requests ||= load_tagged_requests(MEMBER_MATCH_TAG)
+      end
+  
+      def flattened_all_resources
+        @flattened_all_resources ||= previous_clinical_data_request_resources.values.flatten
+      end
     end
   end
-end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_client/client_workflow_interaction_test.rb

@@ -0,0 +1,49 @@
+module DaVinciPDexTestKit
+  module PDexPayerClient
+    class PDexClientWorkflowInteractionTest < Inferno::Test
+  
+      id :pdex_client_workflow_interaction
+      title 'Client makes requests to Inferno'
+      description %(
+        This test will await requests from the client under test to demonstrate
+        the payer to payer data access workflow, including
+        - $member-match requests
+        - clinical data requests, including resource read and searches, patient-level $everything,
+          and group-level $export.
+      )
+      input :access_token
+      config options: { accepts_multiple_requests: true }
+  
+      run do
+        wait(
+          identifier: access_token,
+          message: %(
+            Submit PDex requests to find a matching member and retrieve clinical data covering the
+            complete scope of [member health history data defined by 
+            PDex](https://hl7.org/fhir/us/davinci-pdex/STU2/introduction.html#member-health-history).
+            Available APIs under the Inferno base FHIR include: 
+            * Single patient $member-match: `#{member_match_url}`
+            * Single Resource read and search API: `#{submit_url}`, with `:endpoint` replaced with 
+              the target resource type.
+            * Patient-level $everything: `#{everything_url}`, with `:patient` replaced with the
+              id for the target patient.
+            * All Patients $export: see workflow process at 
+              the [Bulk Data IG](https://hl7.org/fhir/uv/bulkdata/STU2/export.html#sequence-overview)
+              * Kick-off requests: `#{export_url}`.
+              * Export status requests: `#{export_status_url}?_jobId=:job` as returned in the `content-location`
+                header of the kick-off request response.
+              * Retrieval file Requests: `#{binary_url}` with `:id` replaced with an actual id as indicated
+                in the JSON manifest returned with the export status request when the job is completed.
+                Note that the `Accept` header should be `application/fhir+ndjson` on these requests.
+            
+            All requests must include the `Authorization` header with value `Bearer #{access_token}`.
+
+            [Click here](#{resume_clinical_data_url}?token=#{access_token}) when finished making requests
+            for Inferno to evaluate.
+          ),
+          timeout: 900
+        )
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/allergyintolerance_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientAllergyIntoleranceSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientAllergyIntoleranceSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_allergyintolerance_clinical_data_request
+      title 'AllergyIntolerance resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type AllergyIntollerance
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :allergyintolerance_clinical_data_request_test
-    title 'AllergyIntolerance resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned AllergyIntolerance resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:AllergyIntolerance].nil?, "No requests made for AllergyIntolerance resources"
-
-      assert scratch[:AllergyIntolerance].any? {|resource| resource.id == 'pdex-AllergyIntolerance'}, "Unable to find expected resource: pdex-AllergyIntolerance" 
+      def target_resource_type
+        :AllergyIntolerance
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/careplan_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientCarePlanSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientCarePlanSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_careplan_clinical_data_request
+      title 'CarePlan resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type CarePlan
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :careplan_clinical_data_request_test
-    title 'CarePlan resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned CarePlan resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:CarePlan].nil?, "No requests made for CarePlan resources"
-
-      assert scratch[:CarePlan].any? {|resource| resource.id == 'pdex-CarePlan'}, "Unable to find expected resource: pdex-CarePlan" 
+      def target_resource_type
+        :CarePlan
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/careteam_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientCareTeamSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientCareTeamSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_careteam_clinical_data_request
+      title 'CareTeam resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type CareTeam
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :careteam_clinical_data_request_test
-    title 'CareTeam resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned CareTeam resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:CareTeam].nil?, "No requests made for CareTeam resources"
-
-      assert scratch[:CareTeam].any? {|resource| resource.id == 'pdex-CareTeam'}, "Unable to find expected resource: pdex-CareTeam" 
+      def target_resource_type
+        :CareTeam
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/clinical_data_request_check_test.rb

@@ -0,0 +1,24 @@
+require_relative '../client_validation_test.rb'
+
+module DaVinciPDexTestKit
+  module PDexPayerClient
+    class PDexClientClinicalDataRequestCheckTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_clinical_data_request_check
+      title 'Check for Clinical Data Requests'
+      description %(
+        This test will check that clinical data requests were made and that
+        at least some of them returned data for evaluation.
+      )
+
+      run do
+        load_clinical_data_into_scratch
+
+        assert requests.length > 0, 'No clinical requests received by Inferno.'
+        assert scratch&.length > 0,
+               'No clinical data requests made by the client returned any data.'
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/condition_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientConditionSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientConditionSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_condition_clinical_data_request
+      title 'Condition resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type Condition
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :condition_clinical_data_request_test
-    title 'Condition resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned Condition resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:Condition].nil?, "No requests made for Condition resources"
-
-      assert scratch[:Condition].any? {|resource| resource.id == 'pdex-Condition'}, "Unable to find expected resource: pdex-Condition" 
+      def target_resource_type
+        :Condition
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/device_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientDeviceSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
-
-    id :device_clinical_data_request_test
-    title 'Device resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned Device resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:Device].nil?, "No requests made for Device resources"
-
-      assert scratch[:Device].any? {|resource| resource.id == 'pdex-Device'}, "Unable to find expected resource: pdex-Device" 
+  module PDexPayerClient
+    class PDexClientDeviceSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_device_clinical_data_request
+      title 'Device resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type Device
+        were fetched by the client.
+      )
+      input :access_token
+  
+      def target_resource_type
+        :Device
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/diagnosticreport_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientDiagnosticReportSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientDiagnosticReportSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_diagnosticreport_clinical_data_request
+      title 'DiagnosticReport resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type DiagnosticReport
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :diagnosticreport_clinical_data_request_test
-    title 'DiagnosticReport resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned DiagnosticReport resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:DiagnosticReport].nil?, "No requests made for DiagnosticReport resources"
-
-      assert scratch[:DiagnosticReport].any? {|resource| resource.id == 'pdex-DiagnosticReport'}, "Unable to find expected resource: pdex-DiagnosticReport" 
+      def target_resource_type
+        :DiagnosticReport
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/documentreference_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientDocumentReferenceSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientDocumentReferenceSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_documentreference_clinical_data_request
+      title 'DocumentReference resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type DocumentReference
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :documentreference_clinical_data_request_test
-    title 'DocumentReference resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned DocumentReference resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:DocumentReference].nil?, "No requests made for DocumentReference resources"
-
-      assert scratch[:DocumentReference].any? {|resource| resource.id == 'pdex-DocumentReference'}, "Unable to find expected resource: pdex-DocumentReference" 
+      def target_resource_type
+        :DocumentReference
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/encounter_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientEncounterSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientEncounterSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_encounter_clinical_data_request
+      title 'Encounter resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type Encounter
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :encounter_clinical_data_request_test
-    title 'Encounter resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned Encounter resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:Encounter].nil?, "No requests made for Encounter resources"
-
-      assert scratch[:Encounter].any? {|resource| resource.id == 'pdex-Encounter'}, "Unable to find expected resource: pdex-Encounter" 
+      def target_resource_type
+        :Encounter
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/explanationofbenefit_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientExplanationOfBenefitSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientExplanationOfBenefitSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_explanationofbenefit_clinical_data_request
+      title 'ExplanationOfBenefit resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type ExplanationOfBenefit
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :explanationofbenefit_clinical_data_request_test
-    title 'ExplanationOfBenefit resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned ExplanationOfBenefit resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:ExplanationOfBenefit].nil?, "No requests made for ExplanationOfBenefit resources"
-
-      assert scratch[:ExplanationOfBenefit].any? {|resource| resource.id == 'pdex-ExplanationOfBenefit'}, "Unable to find expected resource: pdex-ExplanationOfBenefit" 
+      def target_resource_type
+        :ExplanationOfBenefit
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end

data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/goal_clinical_data_request_test.rb

@@ -1,23 +1,25 @@
-require_relative '../../urls'
 require_relative '../client_validation_test.rb'
 
 module DaVinciPDexTestKit
-  class PDexClientGoalSubmitClinicalDataRequestTest < Inferno::Test
-    include URLs
-    include DaVinciPDexTestKit::ClientValidationTest
+  module PDexPayerClient
+    class PDexClientGoalSubmitClinicalDataRequestTest < Inferno::Test
+      include ClientValidationTest
+  
+      id :pdex_goal_clinical_data_request
+      title 'Goal resources related to the patient matched are gathered'
+      description %(
+        This test verify that the expected instances of resource type Goal
+        were fetched by the client.
+      )
+      input :access_token
 
-    id :goal_clinical_data_request_test
-    title 'Goal resources related to the patient matched are gathered'
-    description %(
-      This test will look through all returned Goal resources for a specific expected resource related to the matched patient.
-    )
-    input :access_token
-
-
-    run do
-      skip_if scratch[:Goal].nil?, "No requests made for Goal resources"
-
-      assert scratch[:Goal].any? {|resource| resource.id == 'pdex-Goal'}, "Unable to find expected resource: pdex-Goal" 
+      def target_resource_type
+        :Goal
+      end
+  
+      run do
+        check_resource_type_fetched_instances(target_resource_type)
+      end
     end
   end
 end