Implement the RA Assisted MeasureReport (CSV) operation

[rob-reynolds]

As a Payer, I need non-FHIR option for creating a RA MeasureReport that takes a CSV as input.

DESCRIPTION:

BACKGROUND: The Da Vinci Risk Adjustment IG (http://build.fhir.org/ig/HL7/davinci-ra/) has been updated to include the following stages:

• Report Generation
• Remediation
• Resolution

One option for Report Generation is a non-FHIR option that takes a CSV as input and creates a bundle of RA MeasureReports as the result. The spec describing this process has not been written yet so these requirements should be considered the specification.

A stub of this has been implemented at as a non-fhir REST POST operation that takes CSV data: https://github.com/DBCG/cqf-ruler/blob/master/plugin/ra/src/main/java/org/opencds/cqf/ruler/ra/r4/AssistedServlet.java

Preconditions: The CSV data matches the following example:

periodStart,periodEnd,modelId,modelVersion,patientId,ccCode,suspectType,evidenceStatus,evidenceStatusDate,hiearchicalStatus
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,18,historic,closed-gap,2021-04-01,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,111,historic,pending,2021-09-29,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,24,historic,open-gap,2020-07-15,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,112,historic,closed-gap,2021-04-27,applied-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,19,historic,pending,2021-09-27,applied-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,84,historic,open-gap,2020-12-15,applied-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,22,suspected,closed-gap,2021-03-15,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,96,suspected,pending,2021-09-27,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,110,suspected,open-gap,2020-07-15,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,83,net-new,pending,2021-09-28,applied-not-superseded
2021-01-01,2021-09-30,https://build.fhir.org/ig/HL7/davinci-ra/Measure-RAModelExample01,24,ra-patient01,59,historic,open-gap,2020-07-15,applied-not-superseded

The above data should create one MeasureReport, with 11 groups. Implementation:

• [ ] implement the following functionality:

  • create transaction bundle
  • foreach set of periodStart,periodEnd,modelId,modelVersion,patientId in the CSV:
    • create a RA MeasureReport (https://build.fhir.org/ig/HL7/davinci-ra/StructureDefinition-ra-measurereport.html) and add the following:
      • id = assisted-
      • meta.profile = "http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-measurereport"
      • status = complete
      • type = individual
      • measure =
      • subject =
      • date = now
      • reporter = tbd
      • period = <periodStart, periodEnd>
      • foreach ccCode (which should be unique at this level), create a group and add the following:
      • id = group-
      • code =
        • system = http://terminology.hl7.org/CodeSystem/cmshcc
        • version =
        • code =
        • display: don't enter a display
      • extension (only if there is a value for at least one of the suspectType,evidenceStatus,evidenceStatusDate,hiearchicalStatus)
        • if suspectType != null
          • url = http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-suspectType
          • valueCodeableConcept: code = , system = http://hl7.org/fhir/us/davinci-ra/CodeSystem/suspect-type
        • if evidenceStatus != null
          • url = http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatus
          • valueCodeableConcept: code = , system = http://hl7.org/fhir/us/davinci-ra/CodeSystem/evidence-status
        • if evidenceStatusDate != null
          • url = http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-evidenceStatusDate
          • valueDate = evidenceStatusDate
        • if hiearchicalStatus!= null
          • url = http://hl7.org/fhir/us/davinci-ra/StructureDefinition/ra-hierarchicalStatus"
          • valueCodeableConcept: code = , system = http://hl7.org/fhir/us/davinci-ra/CodeSystem/hierarchical-status
          • evaluatedResource: none at this time
    • add the RA MeasureReport as an entry to the Bundle

ACCEPTANCE CRITERIA:

• [ ] Given a valid CSV input, the result is a transaction Bundle with a set of valid RA MeasureReport resources
• [ ] The count of entries in the Bundle is the count of the distinct rows in the input of periodStart,periodEnd,modelId,modelVersion,patientId values
• [ ] The count of group entries in each MeasureReport is the count of the distinct number of ccCode values, per distinct periodStart,periodEnd,modelId,modelVersion,patientId value
• [ ] The count of extensions in each distinct group entry is the count of the suspectType,evidenceStatus,evidenceStatusDate,hiearchicalStatus values that are not null, per distinct ccCode, per distinct periodStart,periodEnd,modelId,modelVersion,patientId value