d4l-data4life/covapp

The app lets everyone assess their symptoms using a questionnaire. The app also informs users about next steps, for example, precautionary measures or contacting healthcare providers and health authorities.

⚠️ Since 25 June 2021, there is a new CovApp version 2.0.0, including a new questionnaire and risk assessment developed by the Charité. This repository contains the CovApp version 1.0.0 and is outdated since June 2021.

The latest CovApp Version code is now maintained here: https://github.com/CovOpen/CovApp-2.0

---

CovApp

😷 Solution for assessing the risk of contagious viral infections (COVID-19)

The CovApp is an application developed in collaboration by Charité – Universitätsmedizin Berlin and Data4Life. It can help users to assess their medical condition better, provide recommendations regarding doctor’s visits or coronavirus testing by answering a few questions.

Additionally, every filled out questionnaire summarizes relevant medical information for future doctor’s consultation in the form of a summary page, printout or a QR code. Institutions with the technical setup can scan the provided QR code and retrieve the patient information quickly and without any physical contact.

By implementing the CovApp, any medical institution can reduce the number of new incoming patients, avoid physical contact and speed up the patient registration process.

---

This repository holds a white-labeled version of the original application, free to use licensed under MIT License. Application logic, print functionality and QR code generation are still provided.

The application and underlying questionnaire logic are versioned and future updates will be provided.

⚠️ Any institution/doctor’s office is free to implement CovApp on their domains – the medical responsibility and legal liability lie with the implementing institution.

⚠️ This application is only meant to be set up by software developers. Unfortunately, we can't provide a non-technical solution now.

Technical overview

The application runs dynamically in the browser. It can be built and deployed to any service that provides a static web server with custom routing.

It is based on a JavaScript software stack and uses the following technologies:

• Stencil
• TypeScript
• WebComponents

Installation and development

To get further information on how to set up and deploy your custom CovApp application, see the development documentation.

Customization

The CovApp provides the following customization options:

• change words or add a new language

⚠️ Note that there are several placeholder texts you must provide yourself.

⚠️ Note that the default fallback language is English (en) and it has to be available.

• change colors
• change the application logo

To learn more about these options, see the customization documentation.

Questionnaire answers in FHIR format

In addition to the XML representation of the questionnaire answers that is stored in the QR code, there is the possibility to generate a FHIR R4 representation. You find documentation for the FHIR version of the questionnaire and its resources on Simplifier.net. In the src/global/fhir folder, you find a module that lets you create a FHIR R4 QuestionnaireResponse resource which contains the answers.

To generate the FHIR format, add the following code to the src/components/qr-code/qr-code.tsx file:

import { createFHIRQuestionnaireResponse } from '../../global/fhir';

createFHIR = () => {
  const valuePairs = this.generateValuePairs(this.answers);
  const fhir = createFHIRQuestionnaireResponse(valuePairs, this.language);
  return fhir;
};

Note: Since you’re changing the code outside of the general customization process, this might bring merge conflicts for future app updates.

Support and contributing

Due to today's urgency and dynamic nature, we cannot offer support for this repository. We'll continue the development of the official CovApp internally. Changes and releases will be white-labeled and propagated into this repository.

We won't be able to react to issues and/or pull requests, but we would still encourage you to provide feedback. We will monitor the appearing problems, new ideas and possible feature requests and might consider them for future releases. Feel free to collaborate and work on your forks to move forward with custom development.

Before you open an issue, see the customization documentation.

Application updates

While the development of the original CovApp continues internally, we'll provide regularly updated GitHub releases. If you followed the setup instructions and created a fork of this repository on GitHub, an automation process will open pull requests in your repository whenever then application and the underlying questionnaire received an update. This way, you'll be informed about updates and the development process stays as easy as possible.

Additionally, GitHub provides documentation on how to sync forks manually.

Frequently asked questions

If you have further questions, you can find additional information on d4l.io.

Code of conduct

Contributor Code of Conduct. By participating in this project, you agree to abide by its terms.

License

The CovApp is MIT licensed.

Copyright

Copyright 2020 by Charité Universitaetsmedizin Berlin and D4L data4life gGmbH

Contributors: Dr. Alexander Henry Thieme and others

covapp's Issues

Bug fix for issue with app.css in stencil.config.ts, color customization not working!

There's a bug in the stencil.config.ts file which prevents any color customization!

The following code at line 14 f.:

globalStyle: process.env.LAYOUT === 'OFFICIAL_COLLABORATION_BZGA' ? 'src/global/app-collaboration-bzga.css' : 'src/global/app.css',

should be replaced by:

globalStyle: 'src/custom/styles/app.css',

Took me a day to finally track down the problem and find the solution.
Hope this is helpful for others who run into the same issue! :)

Think about how to visualize the data

Closed issue.

Incorrect date format on US iPhone when setting the app language to German

To reproduce this issue:

1. Use an iPhone configured for the US market. Could potentially be reproduced on a German iPhone configured for US language settings too.
2. Install the CovPass app from the US app store
3. In the Settings app, configure the CovPass app to use "German" as the preferred language

3. Open the CovPass app. Notice that the date of the certificate is shown in Month/Day/Year format (the default for US english) instead of the expected Day.Month.Year format.
   

Failed to load module script: The server responded with a non-JavaScript MIME type of "text/x-js". Strict MIME type checking is enforced for module scripts per HTML spec.

Tried to install the App on my server and the page does not load. We get the error:
Failed to load module script: The server responded with a non-JavaScript MIME type of "text/x-js". Strict MIME type checking is enforced for module scripts per HTML spec.

Any idea how to solve that?

Fallback language failed

If 'en' is not part of the SUPPORTED_LANGUAGES-Const in .env, the fallback language breaks the app if the the default language of the browser is 'en'.

Internationalization

Hi, I can provide the crowdin.com platform for internationalization of the app.

I already created an approved OpenSource Organization for the #WeVsVirus Hackathon here: https://wevsvirushack.crowdin.com/

I created a project for translation for you:
https://wevsvirushack.crowdin.com/covapp

You can integrate it easily into your repo so updates are provided automatically, till then I can update it via a PR. Just contact me via email for integration:

Improve FHIR code for NUM project

related fkaercher#1

Errors in fhir/respons.ts

See the png for the errors while compiling

Build not working

Hi, I tried to set it up.
But it is running into errors:

npm run start

> [email protected] prestart C:\Develop\GitHub\CovOpen\covapp-1
> npm run prepare-customization


> [email protected] prepare-customization C:\Develop\GitHub\CovOpen\covapp-1
> node ./scripts/prepare-customization.js


> [email protected] start C:\Develop\GitHub\CovOpen\covapp-1
> stencil build --dev --watch --serve --no-open

[28:33.2]  @stencil/core v1.11.3
[28:37.1]  build, app, dev mode, started ...
[28:37.1]  transpile started ...
[28:45.8]  transpile finished in 8.69 s

[ ERROR ]  Component Tag Name "ia-recommendation" Must Be Unique
           Please update the components so "ia-recommendation" is only used once:
           ./src/components/recommendation/recommendation.tsx ./src/components/views/recommendation/recommendation.tsx

[28:45.8]  build failed, watching for changes... in 8.71 s

[28:45.8]  http://localhost:3333/

After removing the module:

npm run start

> [email protected] prestart C:\Develop\GitHub\CovOpen\covapp-1
> npm run prepare-customization


> [email protected] prepare-customization C:\Develop\GitHub\CovOpen\covapp-1
> node ./scripts/prepare-customization.js


> [email protected] start C:\Develop\GitHub\CovOpen\covapp-1
> stencil build --dev --watch --serve --no-open

[27:12.4]  @stencil/core v1.11.3
[27:18.5]  build, app, dev mode, started ...
[27:18.5]  transpile started ...
[27:26.1]  transpile finished in 7.54 s

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:1:10
           Module '"../../../../../../../Develop/GitHub/CovOpen/covapp-1/src/global/fhir"' has no exported member
           'CATEGORIES_VALUESET'.

      L1:  import { CATEGORIES_VALUESET } from '.';
      L2:  import { KeyValue } from '../../components/qr-code/utils';

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:9:3
           Module '"../../../../../../../Develop/GitHub/CovOpen/covapp-1/src/global/fhir/types"' has no exported member
           'FHIRValueCoding'.

      L8:  FHIRQuestionnaireResponse,
      L9:  FHIRValueCoding,
     L10:  FHIRValueDate,

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:10:3
           Module '"../../../../../../../Develop/GitHub/CovOpen/covapp-1/src/global/fhir/types"' has no exported member
           'FHIRValueDate'. Did you mean 'FHIRValueSet'?

      L9:    FHIRValueCoding,
     L10:    FHIRValueDate,
     L11:  } from './types';

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:86:7
           Property 'type' is missing in type '{ linkId: string; text: any; item: any[]; }' but required in type
           'FHIRQuestionnaireItem'.

     L86:    let item: FHIRQuestionnaireItem = {
     L87:      linkId: answers[0].key[0],

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:102:31
           Property 'split' does not exist on type 'string | number'.Property 'split' does not exist on type 'number'.

    L101:  answerItem = {
    L102:    valueDate: answer.value.split('.').join('-'),
    L103:  };

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:116:5
           Type '{ linkId: string; text: any; answer: any[]; }' is not assignable to type
           'FHIRQuestionnaireItem'.Object literal may only specify known properties, and 'answer' does not exist in
           type 'FHIRQuestionnaireItem'.

    L115:    text: LANGUAGE_RESOURCES[language].translation[`q_${answer.key}_text`],
    L116:    answer: [answerItem],
    L117:  };

[ ERROR ]  TypeScript: ./src/global/fhir/response.ts:124:19
           Property 'AGE' does not exist on type '{ POSTAL_CODE: string; ABOVE_65: string; HOUSING: string; CARING:
           string; WORKSPACE: string; CONTACT_DATE: string; OUT_OF_BREATH: string; SYMPTOM_DATE: string; DATA_DONATION:
           string; }'.

    L123:  switch (answer.key) {
    L124:    case QUESTION.AGE:
    L125:      return 'http://fhir.data4life.care/covid-19/r4/CodeSystem/age-group';

[27:26.1]  build failed, watching for changes... in 7.57 s

[27:26.1]  http://localhost:3333/