us_quality_core_test_kit 0.1.2 → 0.2.0

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter/encounter_provenance_revinclude_search_test.rb

@@ -0,0 +1,51 @@
+require_relative '../../../search_test'
+require_relative '../../../generator/group_metadata'
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class EncounterProvenanceRevincludeSearchTest < Inferno::Test
+      include USQualityCoreTestKit::SearchTest
+
+      title 'Server returns Provenance resources from Encounter search by patient + revInclude:Provenance:target'
+      description %(
+        A server SHALL be capable of supporting _revIncludes:Provenance:target.
+
+        This test will perform a search by patient + revInclude:Provenance:target and
+        will pass if a Provenance resource is found in the response.
+      %)
+
+      id :us_quality_core_v100_ballot_encounter_provenance_revinclude_search_test
+  
+      input :patient_ids,
+        title: 'Patient IDs',
+        description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+  
+      def properties
+        @properties ||= SearchTestProperties.new(
+          resource_type: 'Encounter',
+        search_param_names: ['patient']
+        )
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+      end
+
+      def self.provenance_metadata
+        @provenance_metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, '..', 'provenance', 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:encounter_resources] ||= {}
+      end
+
+      def scratch_provenance_resources
+        scratch[:provenance_resources] ||= {}
+      end
+
+      run do
+        run_provenance_revinclude_search_test
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter/encounter_read_test.rb

@@ -0,0 +1,27 @@
+require_relative '../../../read_test'
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class EncounterReadTest < Inferno::Test
+      include USQualityCoreTestKit::ReadTest
+
+      title 'Server returns correct Encounter resource from Encounter read interaction'
+
+      description 'A server SHALL support the Encounter read interaction.'
+
+      id :us_quality_core_v100_ballot_encounter_read_test
+
+      def resource_type
+        'Encounter'
+      end
+
+      def scratch_resources
+        scratch[:encounter_resources] ||= {}
+      end
+
+      run do
+        perform_read_test(scratch.dig(:references, 'Encounter'), delayed_reference: true)
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter/encounter_reference_resolution_test.rb

@@ -0,0 +1,45 @@
+require_relative '../../../reference_resolution_test'
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class EncounterReferenceResolutionTest < Inferno::Test
+      include USQualityCoreTestKit::ReferenceResolutionTest
+
+      title 'MustSupport references within Encounter resources are valid'
+
+      description %(
+        This test will attempt to read external references provided within elements
+        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.
+
+        Elements which may provide external references include:
+
+        * Encounter.location.location
+        * Encounter.participant.individual
+        * Encounter.reasonReference
+        * Encounter.serviceProvider
+        * Encounter.subject
+      )
+
+      id :us_quality_core_v100_ballot_encounter_reference_resolution_test
+
+      def resource_type
+        'Encounter'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:encounter_resources] ||= {}
+      end
+
+      run do
+        perform_reference_resolution_test(scratch_resources[:all])
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter/encounter_validation_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../../validation_test'
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class EncounterValidationTest < Inferno::Test
+      include USQualityCoreTestKit::ValidationTest
+
+      id :us_quality_core_v100_ballot_encounter_validation_test
+
+      title 'Encounter resources returned during previous tests conform to the US Quality Core Encounter Profile'
+
+      description %(
+This test verifies resources returned from the first search conform to
+the [US Quality Core Encounter Profile](http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-encounter).
+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.
+
+      )
+
+      output :dar_code_found, :dar_extension_found
+
+      def resource_type
+        'Encounter'
+      end
+
+      def scratch_resources
+        scratch[:encounter_resources] ||= {}
+      end
+
+      run do
+        perform_validation_test(scratch_resources[:all] || [],
+                                'http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-encounter',
+                                '1.0.0-ballot',
+                                skip_if_empty: true)
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter/interpreter_required_extension_test.rb

@@ -0,0 +1,25 @@
+require_relative '../../../interpreter_required_extension_test'
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class InterpreterRequiredExtensionTest < Inferno::Test
+      include USQualityCoreTestKit::InterpreterRequiredExtensionTest
+
+      title 'Certifying server system supports the US Core Interpreter Needed Extension on either the US Core Patient or US Core Encounter Profiles'
+      description %(
+        Servers can use the US Core Interpreter Needed Extension on the US Quality Core Patient
+        or US Quality Core Encounter Profiles to communicate whether a patient needs an interpreter.
+        Although the extension is marked as an Additional USCDI Requirements on both US Quality Core
+        Patient and US Quality Core Encounter Profiles, the certifying Server system is not required
+        to support the extension on both profiles, but SHALL support the extension on at least
+        one.
+      )
+
+      id :us_quality_core_v100_ballot_interpreter_required_extension_test
+
+      run do
+        verify_interpreter_required_extension_exists
+      end
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter/metadata.yml

@@ -0,0 +1,300 @@
+---
+:name: us_quality_core_encounter
+:class_name: USQualityCorev100_ballotEncounterSequence
+:version: v1.0.0-ballot
+:reformatted_version: v100_ballot
+:resource: Encounter
+:profile_url: http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-encounter
+:profile_name: US Quality Core Encounter Profile
+:profile_version: 1.0.0-ballot
+:title: Encounter
+:short_description: Verify support for the capabilities required by the US Quality
+  Core Encounter Profile.
+:is_delayed: true
+:interactions:
+- :code: read
+  :expectation: SHALL
+- :code: search-type
+  :expectation: SHALL
+:operations: []
+:searches:
+- :names:
+  - patient
+  :expectation: SHALL
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :names:
+  - _id
+  :expectation: SHALL
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHALL
+  :names:
+  - patient
+  - type
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+- :expectation: SHALL
+  :names:
+  - patient
+  - date
+  :names_not_must_support_or_mandatory: []
+  :must_support_or_mandatory: true
+:search_definitions:
+  :_id:
+    :paths:
+    - id
+    :full_paths:
+    - Encounter.id
+    :comparators: {}
+    :values: []
+    :type: http://hl7.org/fhirpath/System.String
+    :contains_multiple: false
+    :multiple_or: MAY
+  :patient:
+    :paths:
+    - subject
+    :full_paths:
+    - Encounter.subject
+    :comparators: {}
+    :values: []
+    :type: Reference
+    :contains_multiple: false
+    :multiple_or: MAY
+  :type:
+    :paths:
+    - type
+    :full_paths:
+    - Encounter.type
+    :comparators: {}
+    :values: []
+    :type: CodeableConcept
+    :contains_multiple: true
+    :multiple_or: MAY
+  :date:
+    :paths:
+    - period
+    :full_paths:
+    - Encounter.period
+    :comparators:
+      :eq: MAY
+      :ne: MAY
+      :gt: SHALL
+      :ge: SHALL
+      :lt: SHALL
+      :le: SHALL
+      :sa: MAY
+      :eb: MAY
+      :ap: MAY
+    :values: []
+    :type: Period
+    :contains_multiple: false
+    :multiple_or: MAY
+:include_params: []
+:revincludes:
+- Provenance:target
+:required_concepts: []
+:must_supports:
+  :extensions:
+  - :id: Encounter.extension:interpreterRequired
+    :path: extension
+    :url: http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed
+    :uscdi_only: true
+  - :id: Encounter.diagnosis.extension:diagnosisPresentOnAdmission
+    :path: diagnosis.extension
+    :url: http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-diagnosis-present-on-admission
+  :slices: []
+  :elements:
+  - :path: meta
+  - :path: meta.lastUpdated
+  - :path: identifier
+  - :path: identifier.system
+  - :path: identifier.value
+  - :path: status
+  - :path: class
+  - :path: type
+  - :path: priority
+    :uscdi_plus_quality: true
+  - :path: subject
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-patient
+  - :path: participant
+  - :path: participant.type
+  - :path: participant.period
+  - :path: participant.individual
+    :types:
+    - Reference
+  - :path: period
+  - :path: reasonCode
+  - :path: reasonReference
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-condition-problems-health-concerns
+    - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-condition-encounter-diagnosis
+  - :path: diagnosis
+    :uscdi_plus_quality: true
+  - :path: diagnosis.use
+    :uscdi_plus_quality: true
+  - :path: diagnosis.rank
+    :uscdi_plus_quality: true
+  - :path: hospitalization
+  - :path: hospitalization.dischargeDisposition
+  - :path: location
+  - :path: location.location
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-location
+  - :path: serviceProvider
+    :types:
+    - Reference
+    :target_profiles:
+    - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-organization
+  :choices:
+  - :paths:
+    - reasonCode
+    - reasonReference
+  - :paths:
+    - location.location
+    - serviceProvider
+:mandatory_elements:
+- Encounter.identifier.system
+- Encounter.identifier.value
+- Encounter.status
+- Encounter.statusHistory.status
+- Encounter.statusHistory.period
+- Encounter.class
+- Encounter.classHistory.class
+- Encounter.classHistory.period
+- Encounter.type
+- Encounter.subject
+- Encounter.diagnosis.condition
+- Encounter.location.location
+:bindings:
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/identifier-use
+  :path: identifier.use
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/encounter-status
+  :path: status
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/encounter-status
+  :path: statusHistory.status
+- :type: code
+  :strength: required
+  :system: http://hl7.org/fhir/ValueSet/encounter-location-status
+  :path: location.status
+- :type: Coding
+  :strength: required
+  :system: http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1267.16
+  :path: value
+  :extensions:
+  - http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed
+- :type: CodeableConcept
+  :strength: required
+  :system: http://hl7.org/fhir/us/quality-core/ValueSet/us-quality-core-present-on-admission
+  :path: value
+  :extensions:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-diagnosis-present-on-admission
+:references:
+- :path: Encounter.identifier.assigner
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Organization|4.0.1
+- :path: Encounter.subject
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-patient
+- :path: Encounter.episodeOfCare
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/EpisodeOfCare|4.0.1
+- :path: Encounter.basedOn
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/ServiceRequest|4.0.1
+- :path: Encounter.participant.individual
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-practitioner
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-practitionerrole
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-relatedperson
+- :path: Encounter.appointment
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Appointment|4.0.1
+- :path: Encounter.reasonReference
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-condition-problems-health-concerns
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-condition-encounter-diagnosis
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-procedure
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-simple-observation
+  - http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation
+- :path: Encounter.diagnosis.condition
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Condition|4.0.1
+  - http://hl7.org/fhir/StructureDefinition/Procedure|4.0.1
+- :path: Encounter.account
+  :profiles:
+  - http://hl7.org/fhir/StructureDefinition/Account|4.0.1
+- :path: Encounter.hospitalization.origin
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-location
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-location
+- :path: Encounter.hospitalization.destination
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-location
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-location
+- :path: Encounter.location.location
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-location
+- :path: Encounter.serviceProvider
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-organization
+- :path: Encounter.partOf
+  :profiles:
+  - http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-encounter
+:tests:
+- :id: us_quality_core_v100_ballot_encounter_read_test
+  :file_name: encounter_read_test.rb
+- :id: us_quality_core_v100_ballot_encounter_patient_search_test
+  :file_name: encounter_patient_search_test.rb
+- :id: us_quality_core_v100_ballot_encounter__id_search_test
+  :file_name: encounter_id_search_test.rb
+- :id: us_quality_core_v100_ballot_encounter_patient_type_search_test
+  :file_name: encounter_patient_type_search_test.rb
+- :id: us_quality_core_v100_ballot_encounter_patient_date_search_test
+  :file_name: encounter_patient_date_search_test.rb
+- :id: us_quality_core_v100_ballot_encounter_provenance_revinclude_search_test
+  :file_name: encounter_provenance_revinclude_search_test.rb
+- :id: us_quality_core_v100_ballot_encounter_validation_test
+  :file_name: encounter_validation_test.rb
+- :id: us_quality_core_v100_ballot_encounter_must_support_test
+  :file_name: encounter_must_support_test.rb
+- :id: us_quality_core_v100_ballot_encounter_reference_resolution_test
+  :file_name: encounter_reference_resolution_test.rb
+- :id: us_quality_core_v100_ballot_interpreter_required_extension_test
+  :file_name: interpreter_required_extension_test.rb
+:id: us_quality_core_v100_ballot_encounter
+:file_name: encounter_group.rb
+:delayed_references:
+- :path: participant.individual
+  :resources:
+  - Practitioner
+  - PractitionerRole
+- :path: hospitalization.origin
+  :resources:
+  - Location
+- :path: hospitalization.destination
+  :resources:
+  - Location
+- :path: location.location
+  :resources:
+  - Location
+- :path: serviceProvider
+  :resources:
+  - Organization
+- :path: partOf
+  :resources:
+  - Encounter
+:resource_conformance_expectation: SHALL

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/encounter_group.rb

@@ -0,0 +1,103 @@
+require_relative 'encounter/encounter_read_test'
+require_relative 'encounter/encounter_patient_search_test'
+require_relative 'encounter/encounter_id_search_test'
+require_relative 'encounter/encounter_patient_type_search_test'
+require_relative 'encounter/encounter_patient_date_search_test'
+require_relative 'encounter/encounter_provenance_revinclude_search_test'
+require_relative 'encounter/encounter_validation_test'
+require_relative 'encounter/encounter_must_support_test'
+require_relative 'encounter/encounter_reference_resolution_test'
+require_relative 'encounter/interpreter_required_extension_test'
+
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class EncounterGroup < Inferno::TestGroup
+      title 'Encounter Tests'
+
+      short_description 'Verify support for the capabilities required by the US Quality Core Encounter Profile.'
+
+      description %(
+  # Background
+
+These tests verify that the system under test is able to provide correct
+responses for Encounter queries. These queries must contain resources
+conforming to the US Quality Core Encounter Profile as specified in the US Quality Core 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
+* _id
+* patient + type
+* patient + date
+
+### 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
+Encounter 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" or with
+"USCDI+ Quality" tags. 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 Encounter resources found
+in the first test for these elements.
+
+## Profile Validation
+Each resource returned from the first search is expected to conform to
+the [US Quality Core Encounter Profile](http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-encounter). 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 :us_quality_core_v100_ballot_encounter
+
+      run_as_group
+
+      
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'encounter', 'metadata.yml'), aliases: true))
+      end
+
+  
+      test from: :us_quality_core_v100_ballot_encounter_read_test
+      test from: :us_quality_core_v100_ballot_encounter_patient_search_test
+      test from: :us_quality_core_v100_ballot_encounter__id_search_test
+      test from: :us_quality_core_v100_ballot_encounter_patient_type_search_test
+      test from: :us_quality_core_v100_ballot_encounter_patient_date_search_test
+      test from: :us_quality_core_v100_ballot_encounter_provenance_revinclude_search_test
+      test from: :us_quality_core_v100_ballot_encounter_validation_test
+      test from: :us_quality_core_v100_ballot_encounter_must_support_test
+      test from: :us_quality_core_v100_ballot_encounter_reference_resolution_test
+      test from: :us_quality_core_v100_ballot_interpreter_required_extension_test
+    end
+  end
+end

data/lib/us_quality_core_test_kit/generated/v1.0.0-ballot/family_member_history/family_member_history_must_support_test.rb

@@ -0,0 +1,41 @@
+require_relative '../../../must_support_test'
+
+module USQualityCoreTestKit
+  module USQualityCoreV100_BALLOT
+    class FamilyMemberHistoryMustSupportTest < Inferno::Test
+      include USQualityCoreTestKit::MustSupportTest
+
+      title 'All must support elements are provided in the FamilyMemberHistory resources returned'
+
+      description %(
+        This test will look through the FamilyMemberHistory resources
+        found previously for the following Must Support and USCDI-flagged elements:
+
+        * FamilyMemberHistory.condition
+        * FamilyMemberHistory.condition.code
+        * FamilyMemberHistory.extension:recorder
+        * FamilyMemberHistory.patient
+        * FamilyMemberHistory.relationship
+        * FamilyMemberHistory.status
+      )
+
+      id :us_quality_core_v100_ballot_family_member_history_must_support_test
+
+      def resource_type
+        'FamilyMemberHistory'
+      end
+
+      def self.metadata
+        @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml'), aliases: true))
+      end
+
+      def scratch_resources
+        scratch[:family_member_history_resources] ||= {}
+      end
+
+      run do
+        perform_must_support_test(all_scratch_resources)
+      end
+    end
+  end
+end