Change mapping in "type of contact classification" [2]

[JaquM-HZI]

Summary for implementation: https://github.com/hzi-braunschweig/SORMAS-Project/issues/4550#issuecomment-791728139

Up to changes in type of contact classicication because of new recommendations of RKI, description and classification has to be changed. This recommendations are german only.

• For better handling, allow multiple selections for type of context
• select classification to strictest variation (K1A>K1>K1B>K2>K3)

Use following mapping instead of current mapping for:

Type of contact	Classification
At least 15 minutes of cumulative facial ("face-to-face") contact without proper wearing of a MNS/MNB by both	K1
At least 15 minutes of cumulative facial ("face-to-face") contact with proper wearing of a MNS/MNB by both	K2
Persons with direct contact with secretions and body fluids e.g. by kissing, coughing on, sneezing on, contact with vomit, mouth-to-mouth ventilation, etc.	K1
Persons who have been exposed to infectious aerosols in the room (e.g., partying, singing together, or playing sports indoors without adequate ventilation). Independent of wearing a MNS/MNB.	K1
Medical personnel at high risk of exposure e.g. unprotected exposure to secretions, exposure to aerosols from covid cases	K1A
Medical personnel with limited exposure risk e.g. contact under 2m to Covid-19 cases without protective equipment, ≥15 min face-to-face contact (without exposure to secretions).	K1B
Persons who were in the same room as a confirmed case with adequate ventilation	K2
Medical personnel who were in the same room as the confirmed case without using adequate protective clothing	K2
Medical personnel at a safe distance (>2m, <30min) or when adequate protective clothing has been worn	K3
Medical personnel with contact >2m without direct contact with secretions or excretions of the patient and without exposure to aerosols	K3

Conclusion:

• The part "Face-to-face contact of less than 15 minues" would be removed, cause it is not neccessary and german translation is not technically founded. There are no changes to the contact category, as it remains the same even without the type of contact.

• replace mapping

• allow multiple selection

@kwa20

Development Specifications

• Add a new value to ContactProximity (only enabled for German systems, see ContactProximity.getValues):
  • FACE_TO_FACE_LONG_PROTECTED (caption: "At least 15 minutes of cumulative facial ("face-to-face") contact with proper wearing of a MNS/MNB by both")
  • Add this value to the code that automatically selects a contact category based on the selected proximity; the selected contact category should be LOW_RISK
• Remove FACE_TO_FACE_SHORT from ContactProximity and write SQL script that migrates any contacts set to this value to SAME_ROOM (also needs to be done in the mobile app)
• Change the captions for the following values according to the table specified in comment https://github.com/hzi-braunschweig/SORMAS-Project/issues/4550#issuecomment-791728139
  • FACE_TO_FACE_LONG, TOUCHED_FLUID, AEROSOL, MEDICAL_LIMITED, SAME_ROOM, MEDICAL_SAFE

[bernardsilenou]

@JaquM @kwa20

• The point of having more than one contact type is something we need to think of how it would affect the whole system. It would have affect on transmission diagram and also on filters. From a person view, i see no challenge.
• The categories in the DE instances were the same as what was provided by RKI some month in the past, but with shorter text in order to fit on an electronic device for the mobile app. We only reduced the text. The main difference I can see with this new specification is the addition of the text proper wearing of a MNS/MNB by based on my memory.
• "Face-to-face contact of less than 15 minues" was the short form of the old version "At least 15 minutes of cumulative facial ("face-to-face") contact"
• Will remapping + translation not be enough?

[marko-arn]

@JaquM @kwa20 @bernardsilenou I see here also a benefit if the field contact category becomes mandatory with the options "not yet classified" and "no contact category" or similar. We have in our instance since we are using Sormas (December 20) around 100 contacts (of 6700 total) without any category. I know that the main problem my be caused by the user and not filling it in, but a mandatory field yould assist them.

The only contact were it must not mandatory is the travel returnees as they don't fit in any category. Maybe the classification could ne hidden if travel return is selected, but I'm nut sury if this makes sense.

[kwa20]

I would also add the following to this issue:

• Correction of the contact category seems currently possible because selecting another category is an option. However, when another category is selected it jumps back to the initial category upon saving since the type of contact was not adjusted.
  • We could either not make the category editable and base it purely on the types but this might not be good due to changing mappings of such fields.
  • Otherwise we could allow editing the category in any way desired, with the initial pre-selection serving as kind of a direction.

@Marko-ilmkreis I think that it's generally a nice idea. It would then be possible to set contacts to "not yet classified" by default as seen for the case classification or outcome for example. The user would then also have the option to specifically say "no contact category" for returning travelers

[bernardsilenou]

@kwa20 @JaquM You have some valid points here.

• The contact category initially was just a variable derived from the contact type, so users were not suppose to select it in the first place. Since followup and monitoring prioritization is based on the contact category, users requested to be able to override the contact category based on reasons such as premedical condition, vaccination, etc
• So the current contact category is a combination contact type + health condition of the contact person.
• The part that it jumps back is a bug.
• The idea of making contact category mandatory may stress workers in the health departments, I think encouraging workers to always provide complete data is better than making the variable required. This applies to all other variables also.
• Maybe we add this point in a future meeting for discussion?

[kwa20]

@bernardsilenou I think additional points are up for discussion but what is urgent now is the correct mapping because those types in combination with categories are determined by higher health authorities.

[bernardsilenou]

After the prio meeting today, I realised that we need to discuss and refine this ticket. Please schedule a call. We would split in two tickets: one for the mapping and the another for multiple selection options.

[JaquM-HZI]

Then I open a new ticket for multiple selection and take it out. So "only" a new mapping has to be done and the wording has to be changed.

[JaquM-HZI]

Up to changes in type of contact classicication because of new recommendations of RKI, description and classification has to be changed. This recommendations are german only.

Use following mapping instead of current mapping for:

Type of contact	Classification
At least 15 minutes of cumulative facial ("face-to-face") contact without proper wearing of a MNS/MNB by both	K1
At least 15 minutes of cumulative facial ("face-to-face") contact with proper wearing of a MNS/MNB by both	K2
Persons with direct contact with secretions and body fluids e.g. by kissing, coughing on, sneezing on, contact with vomit, mouth-to-mouth ventilation, etc.	K1
Persons who have been exposed to infectious aerosols in the room (e.g., partying, singing together, or playing sports indoors without adequate ventilation). Independent of wearing a MNS/MNB.	K1
Medical personnel at high risk of exposure e.g. unprotected exposure to secretions, exposure to aerosols from covid cases	K1A
Medical personnel with limited exposure risk e.g. contact under 2m to Covid-19 cases without protective equipment, ≥15 min face-to-face contact (without exposure to secretions).	K1B
Persons who were in the same room as a confirmed case with adequate ventilation	K2
Medical personnel who were in the same room as the confirmed case without using adequate protective clothing	K2
Medical personnel at a safe distance (>2m, <30min) or when adequate protective clothing has been worn	K3
Medical personnel with contact >2m without direct contact with secretions or excretions of the patient and without exposure to aerosols	K3

Conclusion:

• The part "Face-to-face contact of less than 15 minues" would be removed, cause it is not neccessary and german translation is not technically founded. There are no changes to the contact category, as it remains the same even without the type of contact.

• replace mapping

[bernardsilenou]

@JaquM @kwa20 I think we need to come up with a mapping table for contact types.

• Some of the types are new,
• some old and need to be renamed , thus mapping table needed or we use translation and keep old names
• some old and need to be removed, thus migration also needed

When we get this right, we can then redefine the classifications.

[JaquM-HZI]

Summary for implementation

Required action	Sormas value	Type of contact	Classification
rename	FACE_TO_FACE_LONG	At least 15 minutes of cumulative facial ("face-to-face") contact without proper wearing of a MNS/MNB by both	K1
add, map	-	At least 15 minutes of cumulative facial ("face-to-face") contact with proper wearing of a MNS/MNB by both	K2
rename	TOUCHED_FLUID	Persons with direct contact with secretions and body fluids e.g. by kissing, coughing on, sneezing on, contact with vomit, mouth-to-mouth ventilation, etc.	K1
rename	AEROSOL	Persons who have been exposed to infectious aerosols in the room, independent of wearing a MNS/MNB.	K1
keep	MEDICAL_UNSAFE	Medical personnel at high risk of exposure e.g. unprotected exposure to secretions, exposure to aerosols from covid cases	K1A
rename	MEDICAL_LIMITED	Medical personnel with limited exposure risk e.g. contact under 2m to Covid-19 cases without protective equipment, ≥15 min face-to-face contact (without exposure to secretions).	K1B
rename	SAME_ROOM	Persons who were in the same room as a confirmed case with adequate ventilation	K2
remove, migrate*	FACE_TO_FACE_SHORT	Face-to-face contact of less than 15 minutes	K2
keep	MEDICAL_SAME_ROOM	Medical personnel who were in the same room as the confirmed case without using adequate protective clothing	K2
rename	MEDICAL_SAFE	Medical personnel at a safe distance (>2m, <30min) or when adequate protective clothing has been worn	K3
keep	MEDICAL_DISTANT	Medical personnel with contact >2m without direct contact with secretions or excretions of the patient and without exposure to aerosols	K3

*migrate to "Persons who were in the same room as the confirmed case with adequate ventilation"

[bernardsilenou]

@MateStrysewske I hope we only rename enums not db values, because the network diagram may be affected. The risk types are hard coded.

[MateStrysewske]

@bernardsilenou Renaming enums also requires renaming DB values.

[bernardsilenou]

@MateStrysewske Then I have to look in the code if any change is needed in the sprint that this issue would be planned.

[kwa20]

@markusmann-vg Is the summary for the implementation fine with you?

[maxiheyner]

Issue tracker comment

[JaquM-HZI]

We need to stop this, the RKI classification has totaly changed. I will open a new one which will replace this one in the prioritization.

[bernardsilenou]

The RKI categories keeps changing over time, thus the new implementation module can be done in a configurable way for DE, similarly to the disease variant where each instance can update at any time without needing to go through a release and implementation process. We need a dynamic solution to a dynamic problem, not to keep revisiting the same issue all the time.