This is a React app that demonstrates the capabilities of the fqm-execution library in calculating FHIR-based electronic Clinical Quality Measures (eCQMs).
This app is hosted on GitHub Pages, at https://projecttacoma.github.io/fqm-execution-demo/, for demonstration use without standing up a local development environment.
In order to run calculation, the demo app requires a Bundle resource that includes the Measure resource, all required Library resources, and all required ValueSet resources. Users can provide measure bundles in three different ways:
- By uploading a measure bundle from their local computer, by clicking on the box below
Upload From File Systemor dragging a bundle from their file browser to that box. - By selecting a measure bundle from the
Select From Connectathon Repositorydropdown list, which is populated with the measure bundles from the DBCG/connectathon repository. - By selecting a measure bundle from the
Select From eCQM Measure Content Repositorydropdown, which is populated from the cqframework/ecqm-content-r4 repository.
In order to run calculation, the demo app requires a Bundle resource that includes the Patient resource, and all other required clinical resources (Procedures, Encounters, etc.). Users can provide patient bundles in four different ways:
- By uploading a patient bundle from their local computer, by clicking on the box below
Upload From File Systemor dragging a bundle from their file browser to that box. - By selecting a patient bundle from the
Select From Connectathon Repositorydropdown list, which is populated from the DBCG/connectathon repository if a matching measure is selected in theMeasure Bundlefield. - By selecting a patient bundle from the
Select From FHIR Patient Generator Repositorydropdown list, which is populated from the [projecttacoma/fhir-patient-generator] repository if a matching measure is selected in theMeasure Bundlefield. - By selecting a patient bundle from the
Select From eCQM Measure Content Repositorydropdown, which is populated from the cqframework/ecqm-content-r4 repository if a matching measure is selected in theMeasure Bundlefield.
This field selects the type of output from fqm-execution's calculation engine:
Raw: the raw results of executing the patient data against the provided ELM in the measure bundle.Detailed: detailed results from the calculation engine, including results for each measure population for the patient.Measure Reports: A FHIRMeasureReportobject containing the calculation results, as well as the evaluated resources.Gaps In Care: A report detailing the gaps in care for a given patient (if any).
Calculate SDEs: Check to enable calculation of "Supplemental Data Elements" for the provided patient/measureCalculate HTML: Check to enable generation of HTML output detailing the logic results for the provided patient/measure, including highlighting.
Measurement Start: The first day of theMeasurement Periodused by the measure. Defaults to January 1, 2019.Measurement End: The last day of theMeasurement Periodused by the measure. Defaults to December 31, 2019.
To run fqm-execution-demo locally, you will need Node.JS installed on your system. fqm-execution-demo is tested with Node version 12, but more recent versions may also work.
To install the prerequisites for development: in a terminal window open to the fqm-execution-demo base directory, run npm install.
To serve the app in development mode, run npm start. This will start a webserver that will compile the app and serve it locally on http://localhost:3000/fqm-execution-demo. This server will automatically re-compile the app when code in the src directory is changed.
To execute the test suite, run npm test. This will run all the unit tests, and will "watch" the src/ directory and re-run the test suite when the source code changes. Press q to quit the test watcher.
To execute code style checking, run npm run prettier. This will check the style of all code in src/ against the specified styles for the project. To autofix any automatically fixable issues, run npm run prettier:fix.
Copyright 2020 The MITRE Corporation
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.