The uvl-emr from caitlinmac

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

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

License

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

caitlinmac / uvl-emr Goto Github PK

uvl-emr's Introduction