Skip to content

OpenMRS 3 repository for Ubuntu Village of Life in Burundi - Madiro's HealthTech Challenge 2024

Notifications You must be signed in to change notification settings

MadiroGlobalHealth/UVL-EMR

Repository files navigation

Build all configurations and deploy

Screenshot 2024-08-06 at 4 22 22 PM

This project is part of Madiro's HealthTech Challenge 2024 connecting passionate people willing to engage in Global Goods for Digital Health with real-life needs and impactful opportunities.

This repository contains a distribution of OpenMRS 3 that will support UVL in its digitalization of clinical operations (patient registration, consultations, laboratory, pharmacy, reporting, billing, etc.). Implementing a Digital Public Good such as OpenMRS in a rural hospital in Burundi is key for improving patient care through better record-keeping and streamlined medical data management such as laboratory test results or drug prescriptions, ensuring that healthcare providers have accurate and up-to-date information.

Additionally, it facilitates efficient tracking of public health trends and resource allocation, which is essential for addressing the unique healthcare challenges in rural settings. For example, the financial support from the government for child care and maternal care is conditional to digitalization - contributing to the long-term viability and independence of the hospital.

Users and teams

Screenshot 2024-08-06 at 4 44 07 PM

Quick Start using GitPod

You can run the project and contribute to it using GitPod in your browser or VSCode. This will allow you to easily run the project without installing dependencies on your local machine like Java SDK, Docker, etc.

Open in Gitpod

Quick Start on localhost

Prerequisites

  1. Install or update Git
  2. Install or update JAVA SDK
  3. Install or update Docker Compose (version ≥ 2.29)

Clone and Install

Clone the repository locally

git clone https://github.com/MadiroGlobalHealth/UVL-EMR.git

Open the cloned folder

cd UVL-EMR

Add your GitHub credentials to ~/.m2/settings.xml settings file. See how to create a git github token

<servers>
  <server>
    <id>madiro-global-health-github-uvl-emr</id>
    <username>your_github_username</username>
    <password>your_github_token</password>
  </server>
</servers>

Build UVL distro/version of OpenMRS 3

./scripts/mvnw clean package

Run and Open

Run UVL EMR (Mugamba polyclinic)

cd sites/mugamba/target/ozone-uvl-mugamba-1.0.0-SNAPSHOT/run/docker/scripts
./start-demo.sh

Open UVL EMR for end-users (OpenMRS 3) in your browser (the installation can take a few minutes)

open http://localhost/

Open the administration of UVL EMR in your browser

open http://localhost/openmrs/admin

Note that the default admin user is admin and the password is Admin123.

Maven configuration

Sometimes, you might need to customize your Maven configuration file to build the project.

On Mac, you can edit those settings using: vi ~/.m2/settings.xml

Add the Maven Server config and API key in your Maven settings on your laptop:

  <servers>
    <server>
      <id>madiroglobalhealth-github-uvl-emr</id>
      <username>YOUR_GITHUB_USERNAME</username>
      <password>YOU_GITHUB_PASSWORD</password>
    </server>
  </servers>

Configuration hierarchy and inheritance

Hierarchy overview

── pom.xml - Aggregator / Orchestrator
      └── /distro/pom.xml - UVL-wide Config
      └── /countries - Country-specific Config
            └── /burundi/pom.xl
      └── /sites - Site-specific Config
            └── /mugamba/pom.xl

Contributing

Contributions are welcome! If you have any suggestions, improvements, or bug fixes, please feel free to open an issue or submit a pull request.

Acknowledgments

This project is made possible thanks to OpenMRS, OzoneHIS, and OpenConceptLab communities. Special thanks to the contributors who have contributed to the development of these tools.

                         

Resources

OpenMRS resources

Join the conversation

Slack, Calls, Forum, Conferences, JIRA, Wiki

Learn more

OpenMRS Academy, Youtube channel

Code

Official Github repositories for OpenMRS

Prerequisites

Git, Docker Compose, Maven

Demo to checkout and run locally here

UVL Burundi Challenge resources

Slack Channel for all participants to discuss the project

JIRA project to pick up and accomplish tasks

Contact

For any questions, please contact Michael Bontyes or reach out on the OpenMRS Slack.

Sign up for the challenge

Enrollment are open until September 1st, 2024:
https://forms.gle/R1gTWSYYw1WWAErm7

Sprint Check-in

📅 Every Monday and Thursday 3:30 PM TO 4:00 PM EAT | 7:30 AM TO 8:00 AM UTC

🏆 Key Achievements and Contributors

We extend our heartfelt thanks to everyone who contributed to making these milestones possible! Below are the key goals achieved, along with the contributors who made them happen:

🎯 Goal Date Contributors Relevant Links
🎯Add the status badge 08/15/2024 @sherrif10 PR
🎯Configure Locations 08/20/2024 @michaelbontyes Issue 6
🎯Display "Billing" in the sidebar 08/30/2024 @dancinoman Issue 14
🎯Cloud Architecture Overview 09/01/2024 @tendomart Issue 17
🎯Modify the Patient ID generator 09/04/2024 @sherrif10 Issue 25
🎯Add guide on how to add uvl repository to maven setting 09/10/2024 @jnsereko PR 27
🎯Fix Error with FHIR Backend module 09/25/2024 @wodpachua Issue 15
🎯Test Initializer to add billable services in billing module 09/25/2024 @wodpachua Issue 12
🎯Table to show achievements 09/27/2024 @suubi-joshua PR 33
- - - -

License

This project is licensed under the MIT License. See the LICENSE file for more information.

About

OpenMRS 3 repository for Ubuntu Village of Life in Burundi - Madiro's HealthTech Challenge 2024

Topics

Resources

Stars

Watchers

Forks