OpenMRS is an open source medical records system actively developed by volunteers worldwide to support healthcare delivery in developing nations.
The Concept Proposal Module is intended to be used by local administrators who have created new concepts they wish to propose for inclusion in the central dictionary database. There are 2 parts to this module: The proposal and the review.
To find out more information, visit our wiki
We are looking for volunteers to help! Please contact us via the mailing list or through the meetup based in Melbourne, Australia.
If you're new to web or Java development, or are just curious to see what we're working with, have a look at the summary of technologies used.
Contributors submit contributions in the form of pull requests in order for a member of our team to review the code appropriately, as any commits to master are picked up by our continuous deployment server.
Follow the instructions in readme.txt on https://github.com/rdoh/cpm-go
As of now, you will need to come to the meetup in order to have access to the USB keys referenced in that document.
The notes on setting up a dev environment and the list of gotchas may also be useful.
Java development is best done with an IDE:
We recommend using IntelliJ IDE IDEA (Please download the free edition) for this project
To start developing and contributing to this project (this is assuming that you have completed all the instructions in the openmrs-vagrant page. If you haven't, please do that before continuing):
Download and install IntelliJ: http://www.jetbrains.com/idea/download/
-
Once installed, go to Import Project, go to the openmrs-cpm folder, find the build.gradle file and press Ok (please refer to the images below for further information).
- Import Project (image 1): http://i.imgur.com/AckdgLd.png
- Import Project (image 2): http://i.imgur.com/KKui4Y8.png
- Import Project (image 3): https://i.imgur.com/u8Bf09h.png
Allow a few minutes for IntelliJ to import the project
-
Once the project has been successfully imported, go to Files and click Settings. Once you're in the Settings page, go to Plugins and click the Browse Repositories button.
- Plugins (image): http://i.imgur.com/2xe8JQ7.png
-
Once you're in the Browse Repositories page, search for and install these plugins
- Gherkin http://i.imgur.com/Jamr3tF.png
- Cucumber for Java http://i.imgur.com/drtccbg.png
Congratulations! You can now start coding and contribute to this project!!
git checkout -b 92-github-move
while not done:
hack
run(tests)
refactor
run(tests)
git add .
git commit -m 'Somthing meaningful'
git push origin 92-github-move
open https://github.com/<your-username>/openmrs-cpm
Click the Pull Request button
Verify your changes
Send pull request
When the pull request has been submitted, somebody will review your changes and either approve the pull request or request modifications. The first thing that the reviewer will do is to run the following commands:
$ ./go
$ grunt
If either of these commands fail, the PR will be sent back without further review. Point being - you should run these commands yourself and resolve any issues before issuing the PR.
If your changes are approved, the pull request will be merged into the OpenMRS-cpm master, which will trigger a build. If changes are requested, discuss the changes with the reviewer, and then make modifications on the feature branch on your fork (which will cause them to appear in the pull request).
Once your pull request has been accepted, be sure to update your fork as described under "Staying updated": https://www.openshift.com/wiki/github-workflow-for-submitting-pull-requests.
- Manage Go server: sudo /etc/init.d/go-server
- Setup Go Agent: sudo /etc/init.d/go-agent
Mailing list: http://groups.google.com/d/forum/openmrs-australia
Meetup: http://www.meetup.com/melbourne-hack-nights
OpenMRS core source: https://github.com/openmrs/openmrs-core
Concept Proposal Module Documentation: http://wiki.openmrs.org/display/projects/Concept+Proposal+Module+Documentation
CI server: http://ec2-50-112-42-202.us-west-2.compute.amazonaws.com:8153/go/
Card wall (Trello): https://trello.com/b/9OlGMLQm/openmrs-melb
Mingle [deprecated]: https://minglehosting.thoughtworks.com/unicef/profile/login?project_id=openmrs_oz
CI environment (admin, OpenMRS1): http://ec2-54-245-143-28.us-west-2.compute.amazonaws.com:8080/openmrs
QA environment (admin, OpenMRS1): http://ec2-54-245-1-154.us-west-2.compute.amazonaws.com:8080/openmrs