openimis-be-claim-ai_py

openIMIS Backend Claim AI reference module

This repository holds the files of the openIMIS Backend Claim AI reference module. It is dedicated to be deployed as a module of openimis-be_py.

ORM mapping:

None

Docker Setup:

For setting up dockerized instance .env file have to be added to openimis-be-claim_ai_py.

• env file must provide following variables:

  CHANNELS_HOST=<rabbitmq host used by channels layer>
  ASGI_PORT=<Port on which the application is available>
  

  • If local instance of rabbitmq is used then amqp://guest:guest@127.0.0.1/ can be used as CHANNELS HOST.

In openimis-be-claim_ai_py directory files regarding model evaluation - Scaler, Encoder and Model have to be added. By default, expected file names are:

• Scaler.obj
• Encoder.obj
• joblib_Voting_Model.pkl

Used files can be changed by adjusting variables in module_config.json. For the default files a hot reload is applied. If files other than defaults are used, hot reload can be added by adjusting volume paths in claim-ai service in docker-compose.

Listened Django Signals

None

Services

ClaimConsumer, websocket service responsible for AI evaluation

Websocket connection is available at claim_ai/ws/Claim/<process_id>/. It accepts bytes which payloads which after decoding utf-8 decoding are in format:

{
  'type': <type>,
  'content': <payload_content>
}

Payload types:

• 'claim.bundle.payload'

  Request:

  {
    'type': 'claim.bundle.payload',
    'content': <FHIR Claim Bundle>,
    'bundle_id': <bundle_id> // Optional argument with bundle id used for bundle distinction
  }
  

  Response:

  {
    'type': 'claim.bundle.payload',
    'content': <FHIR ClaimResponse Bundle>,
    'index': <bundle_id> // bundle_id if it was given in request, subsequent numbers otherwise
  }
  

  Used for claim evaluation, request payload have to contain claim bundle in FHIR format, after request was accepted 'claim.bundle.acceptance' is sent. After evaluation proper 'claim.bundle.payload' response with evaluation result is sent.

• 'claim.bundle.acceptance'

  Request:

  {
    'type': 'claim.bundle.acceptance',
    'content': <bundle_id> // index receieved from claim.bundle.payload
  }
  

  Response:

  {
     'type': 'claim.bundle.acceptance', 
     'content': 'Accepted', 
     'index': <bundle_id> // bundle_id if it was given in request, subsequent numbers otherwise
  }
  

  Request is expected to be receieved from client after FHIR claim repsonse bundle was correctly receieved. Response is sent after claim.bundle.payload was receieved from the server.

• 'claim.bundle.authentication_exception'

  Response:

  {
    'type': 'claim.bundle.authentication_exception',
    'content': 'Invalid authentication token'
  }
  

  If token authentication is used and invalid token was provided by client this payload is sent and connection is closed immediately.

• 'claim.bundle.authentication_exception'

  Response:

  {
    'type': 'claim.bundle.evaluation_exception', 
    'content': <error_message>, 
    'index': <bundle_id>
  }
  

  If any exceptions occurred during the evaluation exception message is returned to client.

Reports (template can be overloaded via report.ReportDefinition)

None

GraphQL Queries

None

GraphQL Mutations - each mutation emits default signals and return standard error lists (cfr. openimis-be-core_py)

None

Configuration options (can be changed via core.ModuleConfiguration)

• authentication: list of allowed tokens, when new connection is established client have to send token in auth-token header, if authentication is empty list then all connection request are allowed. Empty by default.
• claim_response_url: url used in FHIR response as resource 'fullUrl' prefix,
• claim_response_organization: organization used in FHIR response, by default 'openIMIS-Claim-AI',
• date_format: date format used in FHIR response, by default YYYY-mm-dd

openIMIS Modules Dependencies

The module is independent of the others.