Welcome to the OpenMRS Concept Proposal Module!

Intro

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

How to Contribute

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.

Quickstart

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.

Developing Tools & Project Setup Instructions

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
1. Gherkin http://i.imgur.com/Jamr3tF.png
2. Cucumber for Java http://i.imgur.com/drtccbg.png

Congratulations! You can now start coding and contribute to this project!!

Sample workflow

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.