UVL-EMR: A Shell repository from Agaba-derrick

This project is part of Madiro's HealthTech Challenge 2024 connecting passionated 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

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.

Quick Start on localhost

Prerequisites

Install or update Git
Install or update JAVA SDK
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 default admin user is admin and password is Admin123.

Maven configuration

In some cases, 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 - Aggredator / 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

Join Us

📅 Every Monday and Thursday 3:30PM TO 4:00 PM EAT | 7:30AM 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.

Agaba-derrick/UVL-EMR