CHT configuration project for Jamaica mHealth
This is a repository for the Jamaica mHealth CHT application project. To learn more about CHT check out this resource.
To run the jamaica mHealth CHT application you need to have CHT running locally you need to have the required resources available on your machine.
Install the Core Framework by checking out to the cloned cht-core respository to your local machine and then open your terminal and navigate to the cht-core directory, where you should see the docker-compose.yml file,run the docker-compose up
. Once the command is done running, navigate to https://localhost
with the Google Chrome browser and login with the default username medic and default password password. You will get an error “Your connection is not private” (see screenshot). Click “Advanced” and then click “Proceed to localhost”. More information on this here
Install cht-conf as guided here
More details on this here
More information about CHT Local Environment Setup here
Read about how to use a valid TSL/SSL certiifcate for the server here
After following the steps above, you now have a running CHT instance on which to deploy the application.To deploy and load jamaica mHealth clinical app forms on the running CHT instance clone mydhi-cht-config app,navigate to the config folder and run
$ cht --url=https://<username>:<password>@<domain-name> convert-app-forms upload-app-forms -- <app-form-name>
The current clinical app forms include:
app-form-name
of care
forexample
cht --url=https://<username>:<password>@<domain-name> convert-app-forms upload-app-forms -- care
app-form-name
of treatment
forexample
cht --url=https://<username>:<password>@<domain-name> convert-app-forms upload-app-forms -- treatment
app-form-name
of srq
forexample
cht --url=https://<username>:<password>@<domain-name> convert-app-forms upload-app-forms -- srq
Note 1:Be sure to replace the value "app-form-name" with the name of the clinical form you are uploading in CHT forexample "care" for Level of care Assessment form, "treatment" for Treatment Readiness Assessment form and "srq" for SRQ form
Note 2:Also be sure to replace the values "username" and "password" with the actual username and password of your test instance.
Each user is assigned one of the defined roles which can be defined using the App Management app, which is represented by the roles object of the app-settings.json
file
Permissions are defined by the permissions object in the app_settings.json
or base_settings.json
file. Permissions can also be configured using the App Management app and permission is defined as an array of user role identifiers that have the permission granted.
When new roles titles are added in the app via the app_settings.json file with their respective tranlations in the the properties files use the format messages-{language-code}.properties run
$cht --url=https://<username>:<password>@<domain-name> upload-custom-translation
after navigating in the config folder.
Then run
$cht --url=https://<username>:<password>@<domain-name> upload-app-settings
to up-load the new roles and permission in your app_settings.json
file
You can read more about the roles and permissions in CHT here and here respectively