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

Primary mentor

@Wikum Weerakutti 

Backup mentor

@Daniel Kayiwa 

Assigned to

@Manoj Rathnapriya


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


175 hours


  • 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


Blog Post

week 0

week 01

week 02

week 03

week 04

week 05


week 06


week 07


week 08


week 09


week 10


week 11


week 12



Project Repos

Meeting Notes

meeting 01: 16 May 2024

participants : @Wikum Weerakutti @dkayiwa

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