davinci_pdex_test_kit 0.11.0 → 0.12.0

data/lib/davinci_pdex_test_kit/pdex_payer_server/device_group.rb

@@ -0,0 +1,88 @@
+require_relative 'device/device_patient_search_test'
+require_relative 'device/device_patient_type_search_test'
+require_relative 'device/device_read_test'
+require_relative 'device/device_provenance_revinclude_search_test'
+require_relative 'device/device_validation_test'
+require_relative 'device/device_must_support_test'
+require_relative 'device/device_reference_resolution_test'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class DeviceGroup < Inferno::TestGroup
+      title 'PDex Device Tests'
+      short_description 'Verify support for the server capabilities required by the PDex Device.'
+      description %(
+        # Background
+
+        The PDex Device sequence verifies that the system under test is
+        able to provide correct responses for Device queries. These queries
+        must contain resources conforming to the PDex Device as
+        specified in the PDex v2.0.0 Implementation Guide.
+
+        # Testing Methodology
+        ## Searching
+        This test sequence will first perform each required search associated
+        with this resource. This sequence will perform searches with the
+        following parameters:
+
+        * patient
+
+        ### Search Parameters
+        The first search uses the selected patient(s) from the prior launch
+        sequence. Any subsequent searches will look for its parameter values
+        from the results of the first search. For example, the `identifier`
+        search in the patient sequence is performed by looking for an existing
+        `Patient.identifier` from any of the resources returned in the `_id`
+        search. If a value cannot be found this way, the search is skipped.
+
+        ### Search Validation
+        Inferno will retrieve up to the first 20 bundle pages of the reply for
+        Device resources and save them for subsequent tests. Each of
+        these resources is then checked to see if it matches the searched
+        parameters in accordance with [FHIR search
+        guidelines](https://www.hl7.org/fhir/search.html). The test will fail,
+        for example, if a Patient search for `gender=male` returns a `female`
+        patient.
+
+
+        ## Must Support
+        Each profile contains elements marked as "must support". This test
+        sequence expects to see each of these elements at least once. If at
+        least one cannot be found, the test will fail. The test will look
+        through the Device resources found in the first test for these
+        elements.
+
+        ## Profile Validation
+        Each resource returned from the first search is expected to conform to
+        the [PDex Device](http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-device). Each element is checked against
+        teminology binding and cardinality requirements.
+
+        Elements with a required binding are validated against their bound
+        ValueSet. If the code/system in the element is not part of the ValueSet,
+        then the test will fail.
+
+        ## Reference Validation
+        At least one instance of each external reference in elements marked as
+        "must support" within the resources provided by the system must resolve.
+        The test will attempt to read each reference found and will fail if no
+        read succeeds.
+      )
+
+      id :pdex_device
+      run_as_group
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'device', 'metadata.yml'),
+                                                                                                aliases: true))
+      end
+
+      test from: :pdex_device_patient_search
+      test from: :pdex_device_patient_type_search
+      test from: :pdex_device_read
+      test from: :pdex_device_provenance_revinclude_search
+      test from: :pdex_device_validation
+      test from: :pdex_device_must_support
+      test from: :pdex_device_ref_resolution
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_id_search_test.rb

@@ -7,38 +7,21 @@ module DaVinciPDexTestKit
     class ExplanationOfBenefitIdSearchTest < Inferno::Test
       include USCoreTestKit::SearchTest
 
-      title 'Server returns valid results for Patient search by _id'
+      title 'Server returns valid results for ExplanationOfBenefit search by _id'
       description %(
-A server SHALL support searching by
-_id on the ExplanationOfBenefit resource. This test
-will pass if resources are returned and match the search criteria. If
-none are returned, the test is skipped.
-
-Because this is the first search of the sequence, resources in the
-response will be used for subsequent tests.
-
-Additionally, this test will check that GET and POST search methods
-return the same number of results. Search by POST is required by the
-FHIR R4 specification, and these tests interpret search by GET as a
-requirement of DaVinci PDex v2.0.0.
-
-[PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+        A server SHALL support searching by
+        _id on the ExplanationOfBenefit resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
 
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
       )
 
       id :pdex_eob_id_search
-
-      input :patient_ids,
-            title: 'Patient IDs',
-            description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
-
-      # TODO: test if this test runs
-
       def self.properties
         @properties ||= USCoreTestKit::SearchTestProperties.new(
           resource_type: 'ExplanationOfBenefit',
           search_param_names: ['_id']
-          # TODO: any more search test properties?
         )
       end
 
@@ -48,7 +31,7 @@ requirement of DaVinci PDex v2.0.0.
       end
 
       def scratch_resources
-        scratch[:patient_resources] ||= {}
+        scratch[:explanation_of_benefit_resources] ||= {}
       end
 
       run do

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_identifier_search_test.rb

@@ -7,38 +7,24 @@ module DaVinciPDexTestKit
     class ExplanationOfBenefitIdentifierSearchTest < Inferno::Test
       include USCoreTestKit::SearchTest
 
-      title 'Server returns valid results for Patient search by identifier'
+      title 'Server returns valid results for ExplanationOfBenefit search by identifier'
       description %(
-A server SHALL support searching by
-identifier on the ExplanationOfBenefit resource. This test
-will pass if resources are returned and match the search criteria. If
-none are returned, the test is skipped.
-
-Because this is the first search of the sequence, resources in the
-response will be used for subsequent tests.
-
-Additionally, this test will check that GET and POST search methods
-return the same number of results. Search by POST is required by the
-FHIR R4 specification, and these tests interpret search by GET as a
-requirement of DaVinci PDex v2.0.0.
-
-[PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+        A server SHALL support searching by
+        identifier on the ExplanationOfBenefit resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
 
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
       )
 
       id :pdex_eob_identifier_search
-
-      input :patient_ids,
-            title: 'Patient IDs',
-            description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
-
-      # TODO: test if this test runs
+      optional
 
       def self.properties
         @properties ||= USCoreTestKit::SearchTestProperties.new(
           resource_type: 'ExplanationOfBenefit',
-          search_param_names: ['identifier']
-          # TODO: any more search test properties?
+          search_param_names: ['identifier'],
+          token_search_params: ['identifier']
         )
       end
 
@@ -48,7 +34,7 @@ requirement of DaVinci PDex v2.0.0.
       end
 
       def scratch_resources
-        scratch[:patient_resources] ||= {}
+        scratch[:explanation_of_benefit_resources] ||= {}
       end
 
       run do

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_must_support_test.rb

@@ -8,14 +8,46 @@ module DaVinciPDexTestKit
 
       title 'All must support elements are provided in the ExplanationOfBenefit resources returned'
       description %(
-        US Core Responders SHALL be capable of populating all data elements as
-        part of the query results as specified by the US Core Server Capability
+        PDex Responders SHALL be capable of populating all data elements as
+        part of the query results as specified by the PDex Server Capability
         Statement. This test will look through the ExplanationOfBenefit resources
         found previously for the following must support elements:
 
-        #### TODO: list out MS elements:
-
-        * ...
+        * ExplanationOfBenefit.adjudication
+        * ExplanationOfBenefit.adjudication.category
+        * ExplanationOfBenefit.adjudication.extension:reviewAction
+        * ExplanationOfBenefit.adjudication:adjudicationamounttype
+        * ExplanationOfBenefit.adjudication:denialreason
+        * ExplanationOfBenefit.careTeam.provider
+        * ExplanationOfBenefit.enterer
+        * ExplanationOfBenefit.extension:levelOfServiceType
+        * ExplanationOfBenefit.facility
+        * ExplanationOfBenefit.insurer
+        * ExplanationOfBenefit.item.adjudication.extension:reviewAction
+        * ExplanationOfBenefit.item.adjudication:adjudicationamounttype
+        * ExplanationOfBenefit.item.adjudication:adjudicationamounttype.amount
+        * ExplanationOfBenefit.item.adjudication:allowedunits
+        * ExplanationOfBenefit.item.adjudication:allowedunits.value
+        * ExplanationOfBenefit.item.adjudication:consumedunits
+        * ExplanationOfBenefit.item.adjudication:consumedunits.value
+        * ExplanationOfBenefit.item.adjudication:denialreason
+        * ExplanationOfBenefit.item.adjudication:denialreason.reason
+        * ExplanationOfBenefit.item.category
+        * ExplanationOfBenefit.item.extension:administrationReferenceNumber
+        * ExplanationOfBenefit.item.extension:authorizedItemDetail
+        * ExplanationOfBenefit.item.extension:authorizedProvider
+        * ExplanationOfBenefit.item.extension:itemTraceNumber
+        * ExplanationOfBenefit.item.extension:preAuthIssueDate
+        * ExplanationOfBenefit.item.extension:preAuthPeriod
+        * ExplanationOfBenefit.item.extension:previousAuthorizationNumber
+        * ExplanationOfBenefit.patient
+        * ExplanationOfBenefit.preAuthRefPeriod
+        * ExplanationOfBenefit.provider
+        * ExplanationOfBenefit.status
+        * ExplanationOfBenefit.total.category
+        * ExplanationOfBenefit.total.extension:priorauth-utilization
+        * ExplanationOfBenefit.type
+        * ExplanationOfBenefit.use
       )
 
       id :pdex_eob_must_support

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_lastupdated_search_test.rb

@@ -0,0 +1,48 @@
+require 'us_core_test_kit/search_test'
+require 'us_core_test_kit/search_test_properties'
+require 'us_core_test_kit/generator/group_metadata'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class ExplanationOfBenefitPatientLastupdatedSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for ExplanationOfBenefit search by patient + _lastUpdated'
+      description %(
+        A server SHALL support searching by
+        patient + _lastUpdated on the ExplanationOfBenefit resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
+
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+      )
+
+      id :pdex_eob_patient_last_updated_search
+      optional
+
+      input :patient_ids,
+            title: 'Patient IDs',
+            description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+      def self.properties
+        @properties ||= USCoreTestKit::SearchTestProperties.new(
+          resource_type: 'ExplanationOfBenefit',
+          search_param_names: ['patient', '_lastUpdated']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                                 aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:explanation_of_benefit_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_search_test.rb

@@ -0,0 +1,62 @@
+require 'us_core_test_kit/search_test'
+require 'us_core_test_kit/search_test_properties'
+require 'us_core_test_kit/generator/group_metadata'
+
+module DaVinciPDexTestKit
+  module PDexPayerServer
+    class ExplanationOfBenefitPatientSearchTest < Inferno::Test
+      include USCoreTestKit::SearchTest
+
+      title 'Server returns valid results for ExplanationOfBenefit search by patient'
+      description %(
+        A server SHALL support searching by
+        patient on the ExplanationOfBenefit resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
+
+        This test verifies that the server supports searching by reference using
+        the form `patient=[id]` as well as `patient=Patient/[id]`. The two
+        different forms are expected to return the same number of results. US
+        Core requires that both forms are supported by PDex responders.
+
+        Because this is the first search of the sequence, resources in the
+        response will be used for subsequent tests.
+
+        Additionally, this test will check that GET and POST search methods
+        return the same number of results. Search by POST is required by the
+        FHIR R4 specification, and these tests interpret search by GET as a
+        requirement of PDex v2.0.0.
+
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+      )
+
+      id :pdex_eob_patient_search
+      input :patient_ids,
+            title: 'Patient IDs',
+            description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+      def self.properties
+        @properties ||= USCoreTestKit::SearchTestProperties.new(
+          first_search: true,
+          resource_type: 'ExplanationOfBenefit',
+          search_param_names: ['patient'],
+          test_reference_variants: true,
+          test_post_search: true
+        )
+      end
+
+      def self.metadata
+        @metadata ||= USCoreTestKit::Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'),
+                                                                                 aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:explanation_of_benefit_resources] ||= {}
+      end
+
+      run do
+        run_search_test
+      end
+    end
+  end
+end

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_service_date_search_test.rb

@@ -9,30 +9,16 @@ module DaVinciPDexTestKit
 
       title 'Server returns valid results for ExplanationOfBenefit search by patient + service-date'
       description %(
-A server SHALL support searching by
-patient + service-date on the ExplanationOfBenefit resource. This test
-will pass if resources are returned and match the search criteria. If
-none are returned, the test is skipped.
-
-This test verifies that the server supports searching by reference using
-the form `patient=[id]` as well as `patient=Patient/[id]`. The two
-different forms are expected to return the same number of results. US
-Core requires that both forms are supported by US Core responders, and
-PDex expands upon US Core.
-
-Because this is the first search of the sequence, resources in the
-response will be used for subsequent tests.
-
-Additionally, this test will check that GET and POST search methods
-return the same number of results. Search by POST is required by the
-FHIR R4 specification, and these tests interpret search by GET as a
-requirement of PDex v2.0.0.
-
-[PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+        A server SHALL support searching by
+        patient + service-date on the ExplanationOfBenefit resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
 
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
       )
 
       id :pdex_eob_patient_service_date_search
+      optional
 
       input :patient_ids,
             title: 'Patient IDs',
@@ -41,9 +27,7 @@ requirement of PDex v2.0.0.
       def self.properties
         @properties ||= USCoreTestKit::SearchTestProperties.new(
           resource_type: 'ExplanationOfBenefit',
-          search_param_names: ['patient', 'service-date'],
-          test_post_search: true
-          # TODO: other properties?
+          search_param_names: ['patient', 'service-date']
         )
       end
 

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_type_search_test.rb

@@ -9,31 +9,15 @@ module DaVinciPDexTestKit
 
       title 'Server returns valid results for ExplanationOfBenefit search by patient + type'
       description %(
-A server SHALL support searching by
-patient + type on the ExplanationOfBenefit resource. This test
-will pass if resources are returned and match the search criteria. If
-none are returned, the test is skipped.
-
-This test verifies that the server supports searching by reference using
-the form `patient=[id]` as well as `patient=Patient/[id]`. The two
-different forms are expected to return the same number of results. US
-Core requires that both forms are supported by US Core responders, and
-PDex expands upon US Core.
-
-Because this is the first search of the sequence, resources in the
-response will be used for subsequent tests.
-
-Additionally, this test will check that GET and POST search methods
-return the same number of results. Search by POST is required by the
-FHIR R4 specification, and these tests interpret search by GET as a
-requirement of PDex v2.0.0.
-
-[PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
+        A server SHALL support searching by
+        patient + type on the ExplanationOfBenefit resource. This test
+        will pass if resources are returned and match the search criteria. If
+        none are returned, the test is skipped.
 
+        [PDex Server CapabilityStatement](https://hl7.org/fhir/us/davinci-pdex/STU2/CapabilityStatement-pdex-server.html)
       )
 
       id :pdex_eob_patient_type_search
-
       input :patient_ids,
             title: 'Patient IDs',
             description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
@@ -42,8 +26,7 @@ requirement of PDex v2.0.0.
         @properties ||= USCoreTestKit::SearchTestProperties.new(
           resource_type: 'ExplanationOfBenefit',
           search_param_names: ['patient', 'type'],
-          test_post_search: true
-          # TODO: other properties?
+          token_search_params: ['type']
         )
       end
 

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_reference_resolution_test.rb

@@ -12,13 +12,16 @@ module DaVinciPDexTestKit
         marked as 'MustSupport', if any are available.
 
         It verifies that at least one external reference for each MustSupport Reference element
-        can be accessed by the test client, and conforms to corresponding US Core or PDex profile.
+        can be accessed by the test client, and conforms to corresponding PDex profile.
 
         Elements which may provide external references include:
 
-        #### TODO: list out all references:
-
-        * ...
+        * ExplanationOfBenefit.careTeam.provider
+        * ExplanationOfBenefit.enterer
+        * ExplanationOfBenefit.facility
+        * ExplanationOfBenefit.insurer
+        * ExplanationOfBenefit.patient
+        * ExplanationOfBenefit.provider
       )
 
       id :pdex_eob_ref_resolution

data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_validation_test.rb

@@ -6,19 +6,18 @@ module DaVinciPDexTestKit
       include USCoreTestKit::ValidationTest
 
       id :pdex_eob_validation
-      title 'ExplanationOfBenefit resources returned during previous tests conform to the US Core ExplanationOfBenefit Profile'
+      title 'ExplanationOfBenefit resources returned during previous tests conform to the PDex Prior Authorization'
       description %(
-This test verifies resources returned from the first search conform to
-the [PDex ExplanationOfBenefit Profile](http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-priorauthorization).
-Systems must demonstrate at least one valid example in order to pass this test.
+        This test verifies resources returned from the first search conform to
+        the [PDex Prior Authorization](http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-priorauthorization).
+        Systems must demonstrate at least one valid example in order to pass this test.
 
-It verifies the presence of mandatory elements and that elements with
-required bindings contain appropriate values. CodeableConcept element
-bindings will fail if none of their codings have a code/system belonging
-to the bound ValueSet. Quantity, Coding, and code element bindings will
-fail if their code/system are not found in the valueset.
+        It verifies the presence of mandatory elements and that elements with
+        required bindings contain appropriate values. CodeableConcept element
+        bindings will fail if none of their codings have a code/system belonging
+        to the bound ValueSet. Quantity, Coding, and code element bindings will
+        fail if their code/system are not found in the valueset.
       )
-
       output :dar_code_found, :dar_extension_found
 
       def resource_type