Validating and re-working (updating) the OpenMRS PatientFlags module

Abstract

The OpenMRS openmrs-module-patientflags module provides functionality for creating warning flags in the Patient Dashboard, but it currently faces a few challenges.

• This module only works with the legacy UI.

• Users have reported performance issues associated with this module.

• Because of these issues, we cannot integrate this into the O3 RefApp.

The main goal of this project is to revamp the OpenMRS PatientFlags module and fix these issues.

Required Skills

• Excellent proficiency in Java programming.

• Strong understanding of optimization techniques.

• Familiarity and experience with working on OpenMRS modules

Project Rating and Length

Medium

175 hours

Objectives

• Address and resolve compatibility issues with both O2 and O3 UI in OpenMRS.

• Identify and optimize areas of the module that contribute to performance issues.

• Add support for Java 17 but without dropping support for Java 8.

• Introduce a new functionality to facilitate the translation of patient flags between the Flag - FHIR v5.0.0 Resource and the OMRS Flag model

Weekly Blog Posts

Resources

• https://talk.openmrs.org/t/scaling-patient-flags-2-x-module-gsoc-2023-project-moving-forward-with-patient-flags-in-refapp-3-x/38594

• https://github.com/openmrs/openmrs-esm-patient-chart/pull/926#issuecomment-1419165955

• Proposal : https://docs.google.com/document/d/1O5N9eNAlSTbDbDQwkZ3brCmWYnSi_2MD-dvk-kBEqKo/edit#heading=h.3tq62aycf5sk

• Jira Epic : https://openmrs.atlassian.net/jira/software/c/projects/FLAG/list?selectedIssue=FLAG-72

• Project update thread : GSOC 24 : Validating and re-writing openmrs patient flag module - project updates

Project Repos

• GitHub - openmrs/openmrs-module-patientflags: Provides a mechanism for marking patient records with important messages within OpenMRS

• https://github.com/openmrs/openmrs-module-fhir2

Meeting Notes

meeting 01: 16 May 2024

participants : @Wikum Weerakutti @Org Administrator

key notes :

• Discussed the initial plans of the project

• Discussed about the performance evaluation of the current module and refactor version

  • Suggest to use easiest way ( JMeter, Java profiler and JMH )

• How to add testing data to local openmrs development server ?

  • suggested Import omrs demo data or create some records manually for testing

meeting 02 : 21 June 2024

participants : @Wikum Weerakutti

key notes :

• Discussed about the flag evaluation implementation, unit test issue and PR reviewing

• Addressed some point on FHIR flag resource mapping

meeting 03 : 28 June 2024

participants : @Wikum Weerakutti

meeting 04 : 08 July 2024

participants : @Org Administrator @Wikum Weerakutti

meeting 05 : 15 July 2024

participants : @Wikum Weerakutti

key notes:

• Addressed some issues on FHIR flag resource mapping

  • system URL generation

  • how to map the openmrs flag criteria and priority

meeting 06 : 22 July 2024

participants : @Org Administrator @Wikum Weerakutti

key notes:

• Discussed about the remaining tasks

• Attempt to fix the error in FHIR sub module

meeting 07 : 29 July 2024

participants : @Org Administrator @Wikum Weerakutti

key notes:

• Discussed about the exception in all flag evaluation