How to setup Bahmni-ABDM Features

Pre-requisites

1. ABDM Sandbox client ID and Secrete

2. HIU/HIP services and Bridges defined.

Github Repositories

https://github.com/Bahmni-Covid19

Repositories:

1. NDHM-React
   This repository contains the frontend code for ABHA verification pop-up.
   Tech stack- ReactJs

2. HIP Service
This repository contains code to interact with ABDM gateway APIs and Database.
HIP- Health information Provider refers to clinical establishments which generate or store customer data in digital form. These include hospitals, primary or secondary health care centres, nursing homes, diagnostic centres, clinics, medical device companies and other such entities as may be identified by regulatory authorities from time to time

Tech stack- C#

3. HIP Service Backend
This module is supporting the HIP service with all necessary openmrs/bahmni-core endpoints exposed that are required by the HIP service
Tech stack- Java

4. HIU UI

This Module consist of all the UI code for HIU ( Health Information User)

5. HIU Backend

This module has the backend code for HIU which interacts with the ABDM gateway and Database.
Tech stack- Java

6. bahmniapps and default config
These modules are bahmni frontend modules which contains the extension point changes for ABDM.
Tech stack- angularJs

Setup Steps

Currently Bahmni doesn’t have an installer for ABDM capabilities. The following steps can be followed to setup ABDM features on top of existing Bahmni installation:

1. Build and deploy ndhm-react module at /var/www/ndhm

2. Build and deploy hip backend omod at /opt/openmrs/modules/ 

   1. Hip omod requires Jackson-core-2.10.0.jar (To be placed in /opt/openmrs/openmrs/WEB-INF/lib/)

   2. Jackson-annotations-2.10.0.jar  To be placed in /opt/openmrs/openmrs/WEB-INF/lib/

   3. Jackson-databind-2.10.0.jar  To be placed in /opt/openmrs/openmrs/WEB-INF/lib/

   4. fhir2-omod-1.0.0-SNAPSHOT.omod (To be placed in /opt/openmrs/modules/)

   5. Development steps can be found: https://github.com/Bahmni-Covid19/openmrs-module-hip/blob/master/omod/docs/dev-setup.md

3. Pull down hip-service image (bahmnicovid19/health-information-provider:latest), hiu-backend(bahmnicovid19/health-information-user:latest), hiu ui( bahmnicovid19/hiu-ui:latest) from docker hub

4. Use the following docker-compose.yml to start up the containers:

5. Build and deploy bahmniapps ( branch stream1/master) and default config ( branch stream1/master)

6. Update /etc/httpd/conf.d/ssl.conf file to have the following:

Alias /ndhm /var/www/ndhm

Development steps can be found in the read me of all the repositories.

Reference Material:

1. ABDM Sandbox (for testing purposes)

2. ABDM Ecosystem

3. ABDM Checklist for certified products like Bahmni

4. ABDM HIP use-cases

5. ABDM HIU use-cases