The project is under active development and will gradually be supplemented.

Today common HMS applications store patients’ data in a local or a cloud DB which creates significant security, reliability and operational risks. Centralized storage and access rights administration of sensitive medical data creates additional challenges:

• Administrative overheard due to the rights provisioning on per patients/per record level.
• Patients lack control and visibility over who has access to their data which goes against natural data subject rights announced in GDPR (General Data Protection Regulation, chapter 3).
• Super user access for DB and LDAP (access rights catalogue) create additional security risks.
• In case of a data breach full registry will be compromised.

The IPEHR (InterPlanetary EHR) project is held to propose an alternative way of storing the data registry. Patients’ data will be stored in Filecoin network and will be accessed directly by stakeholders in case they have proper rights. Access rights and documents’ indexes will be stored on a blockchain in a smart-contract. Every data subject will have full unalienable control over his data and manage access rights on a personal level.

• all data is stored in a decentralized storage;
• data encryption;
• self management of user’s access rights;
• data integrity and authenticity is guaranteed by a smart contract.

This work is being done under the FileCoin development grant program RFP. See our proposal here

The solution is being developed with 7 milestones:

• Development of MH-ORM and structure of storage of medical data - we are here
• The functionality of encryption and saving/reading personal data to/from Filecoin
• Access rights management on a blockchain
• BsnGateway. Implementation of OpenEHR API, integration with MH-ORM
• Public data publishing features using the Chainlink network
• Application to manage your own medical data and access
• Testing, documentation and deployment

On Milestone 1 we develop the IPEHR-gateway to provide benefits of decentralized architecture to common HMS solutions using standard APIs.

• generates user’s cryptographic keys;
• exchanges medical data with HMS in openEHR format;
• provides filtering and search functions by indexing received openEHR documents;
• encrypts openEHR docs and indexes;
• stores encrypted openEHR documents in the FileCoin decentralized network;
• stores encrypted documents’ indexes in a smart contract on a blockchain;
• sends decrypted documents back to HMS;
• supports AQL queries without decrypting data.

Please follow installation instructions provided here.

git clone https://github.com/bsn-si/IPEHR-gateway

cd ./src
go test -v ./...

cd ./src
go build -o ../bin/ipehr-gateway cmd/ipehrgw/main.go

./bin/ipehr-gateway -config=./config.json

Swagger UI API docs

The following methods are based on the standard specification of OpenEHR

The following workflow is showing how to create, update and find EHR information using swagger

Precondition: go to Swagger

1. Click POST /ehr Create EHR method
2. Click Try it out
3. Put necessary information (e.g ...)
4. Click Execute Result: in the response, you see a created EHR with structured data in JSON format. Also here is data (e.g fields like id, summary by id, that help you work with EHR in the future.

1. Click /GET ehr
2. Click Try it out
3. Put subject id from previously created EHR
4. Click Execute Result: in the response, you see created before EHR with only requested id

1. Click /GET ehr/{ehr_id}
2. Click Try it out
3. Put id from previously created EHR
4. Click Execute Result: in the response, you see created before EHR with requested ID

1. Click /GET ehr/{ehr_id}/ehr_status
2. Click Try it out
3. Put id from previously created EHR
4. Click Execute Result: in the response, you see created before EHR status version by time

1. Click /PUT ehr/{ehr_id}/ehr_status
2. Click Try it out
3. Put id from previously created EHR
4. Put a new status
5. Click Execute Result: in the response, you see an updated EHR

1. Click /PUT ehr/{ehr_id}
2. Click Try it out
3. Put a new ID
4. Click Execute Result: in the response, you see updated EHR

You can start a project in Docker

Before building the image, you need to create config.json (take config.json.example as a basis)

The repository contains a Dockerfile At the root of the project run the command

docker build -t ipehr:gtw .

After building the image, start the container

docker run -d --restart always -p 8080:8080 --name ipehr-gateway ipehr:gtw