{"id":19658158,"url":"https://github.com/cdaringe/hep-c-screener","last_synced_at":"2025-04-28T20:31:14.253Z","repository":{"id":31915996,"uuid":"130157516","full_name":"cdaringe/hep-c-screener","owner":"cdaringe","description":" cds-hooks service to prompt care providers to screen baby-boomers for hepatitis c","archived":false,"fork":false,"pushed_at":"2024-01-25T05:11:49.000Z","size":2094,"stargazers_count":1,"open_issues_count":11,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-22T16:02:48.353Z","etag":null,"topics":["cds","ehr","fhir","hepatitis","nodejs","service"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cdaringe.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-19T04:08:02.000Z","updated_at":"2019-09-19T08:50:05.000Z","dependencies_parsed_at":"2024-11-11T15:38:51.239Z","dependency_job_id":"d3e9466b-edcd-4a66-a729-5257a0892b8c","html_url":"https://github.com/cdaringe/hep-c-screener","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Fhep-c-screener","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Fhep-c-screener/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Fhep-c-screener/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdaringe%2Fhep-c-screener/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdaringe","download_url":"https://codeload.github.com/cdaringe/hep-c-screener/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251383654,"owners_count":21580915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cds","ehr","fhir","hepatitis","nodejs","service"],"created_at":"2024-11-11T15:36:17.094Z","updated_at":"2025-04-28T20:31:13.894Z","avatar_url":"https://github.com/cdaringe.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hep-c-screener\n\n[![Greenkeeper badge](https://badges.greenkeeper.io/cdaringe/hep-c-screener.svg)](https://greenkeeper.io/) [![CircleCI](https://circleci.com/gh/cdaringe/hep-c-screener.svg?style=svg)](https://circleci.com/gh/cdaringe/hep-c-screener) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)\n\na [CDS Hooks](http://cds-hooks.org/) hepatitis c screening service.\n\nthis service detects if a patient needs a hepatitis c screening per CDS recommended guidelines.  if a screening is required for a patient, it can be automatically ordered into the EHR system via [FHIR](http://www.hl7.org/implement/standards/fhir/) REST services, and/or administered via CDS hook card actions.  the service is highly configurable and easy to deploy.\n\nrad! 💯\n\n## usage\n\nthe screening service can be run in two different ways--via `docker` or via `nodejs`.  how to use either of these software tools is left as an exercise for the user.  ample tutorials are available for both toolchains via a quick internet search.\n\nplease see the [CDS Hooks](http://cds-hooks.org/) website to learn how to interact with a CDS Hooks web service.\n\n### docker\n\n`docker run -p \u003chost-port\u003e:8080 cdaringe/hep-c-screener`\n\n### nodejs\n\nnodejs 8.x or higher is required.\n\n#### production mode\n\n- install, `npm install --global hep-c-screener`\n- `hep-c-screener` should now be on your `$PATH`\n\n#### dev mode\n\n- install dependencies, `yarn`, or `npm install`\n- run the server, `yarn start`, or `npm start`\n\n### configuration\n\nall configuration is delivered via environment variables.  how to set environment variables depends on the OS and deployment mechanism used.  how to set these variables is left as an exercise for the user.\n\n### server\n\n| variable | default | description                |\n| -------- | ------- | -------------------------- |\n| `PORT`   | `8080`  | HTTP port to run server on |\n\n### hepatitis c workflow\n\n| variable                             | default                        | description                                                                                                                                                                                                             |\n| ------------------------------------ | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `DISABLE_DEFAULT_SCREENING_ORDER`    | `\u003cnot set\u003e`                       | set this field to `1` to *_not_* order a HCV screen procedure by default. a card with a button to order the procedure will be presented                                                                                 |\n| `HCV_SCREEN_OBSERVATION_LOINC_CODES` | `13955-0`                      | `csv,of,codes` to check if a HCV screen has been performed for a patient before                                                                                                                                                                                                       |\n| `HCV_SCREEN_PROCEDURE_LOINC_CODE`    | `47365-2`                      | single code for ordering HCV screen                                                                                                                                                                                            |\n| `HCV_SNOMED_CODES`                   | `128302006,50711007,235866006` | csv,of,codes to check if someone has or has had HCV                                                                                                                                                                        |\n| `PROCEDURE_REQUEST_ORDER_INTENT`     | `proposal`                     | a [RequestIntent](https://www.hl7.org/fhir/valueset-request-intent.html) for the HCV screening order.  most likely, you will want `proposal` or `order`                                                                         |\n| `PROCEDURE_REQUEST_ORDER_STATUS`     | `draft`                        | the default value for the `status` field of new HCV `ProcedureRequest`s. if providers want to immediately load the order into the EHR system, set this value to `active` |\n| `VENIPUNCTURE_SNOMED_CODES`          | `22778000`                     | csv,of,codes to check for venipunction orders                                                                                                                                                                                                         |\n\nif other code systems or codes themselves are required by default, please open a pull request\n\n## fine print\n\n- when testing to see if a patient already has an outstanding HCV procedure request, we check only the `HCV_SCREEN_PROCEDURE_LOINC_CODE`, and only if that procedure request status is `draft|active|completed`.  `cancelled|suspended` etc status codes still allow the service to create a new `HCV_SCREEN_PROCEDURE_LOINC_CODE` ProcedureRequest for the patient.\n\n## contributing\n\nsee [CONTRIBUTING.md](./CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdaringe%2Fhep-c-screener","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdaringe%2Fhep-c-screener","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdaringe%2Fhep-c-screener/lists"}