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.
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.
- Install or update Git
- Install or update JAVA SDK
- Install or update Docker Compose (version ≥ 2.29)
Clone the repository locally
git clone https://github.com/MadiroGlobalHealth/UVL-EMR.gitOpen the cloned folder
cd UVL-EMRAdd 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 packageRun UVL EMR (Mugamba polyclinic)
cd sites/mugamba/target/ozone-uvl-mugamba-1.0.0-SNAPSHOT/run/docker/scripts
./start-demo.shOpen 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/adminNote that default admin user is admin and password is Admin123.
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>── pom.xml - Aggredator / Orchestrator
└── /distro/pom.xml - UVL-wide Config
└── /countries - Country-specific Config
└── /burundi/pom.xl
└── /sites - Site-specific Config
└── /mugamba/pom.xl
Contributions are welcome! If you have any suggestions, improvements, or bug fixes, please feel free to open an issue or submit a pull request.
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.
Join the conversation
Slack, Calls, Forum, Conferences, JIRA, Wiki
Learn more
OpenMRS Academy, Youtube channel
Code
Official Github repositories for OpenMRS
Prerequisites
Demo to checkout and run locally here
Slack Channel for all participants to discuss the project
JIRA project to pick up and accomplish tasks
For any questions, please contact Michael Bontyes or reach out on the OpenMRS Slack.
Enrollment are open until September 1st, 2024:
https://forms.gle/R1gTWSYYw1WWAErm7
This project is licensed under the MIT License. See the LICENSE file for more information.