dde_client 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7996106a9df34e06acb594f8531a53c40d1e014fca7add081c4c4d545aea11e0
+  data.tar.gz: b5d3af559aa340dda33bd32266fc45e67fa7fc6d10dde5b841f8881b11782ad3
+SHA512:
+  metadata.gz: 1f147e53a332201bbae823f6c2114002054932a743ed6c5b0415272f76934ededfc6824401b1158e34e8fc0f27fb2f706a24b7f89572521ea4ad86d9f6ae95ac
+  data.tar.gz: '009b7ef7c3ac8327563b2f09b460fe946f5170295e030b921970ac14cc3262d7e860e7a3aee6467e8aa14acb3e0531948f92bd3f94dc5c54f5e4bd192c1ed53d'

data/README.md

@@ -0,0 +1,37 @@
+# DdeClient
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/dde_client`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+TODO: Delete this and the text above, and describe your gem
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+    $ bundle add dde_client
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+    $ gem install dde_client
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/dde_client. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/dde_client/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the DdeClient project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/dde_client/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/app/assets/config/dde_client_manifest.js

@@ -0,0 +1 @@
+//= link_directory ../stylesheets/dde .css

data/app/assets/stylesheets/dde_client/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/controllers/dde_client/api/v1/dde_controller.rb

@@ -0,0 +1,92 @@
+class DdeClient::Api::V1::DdeController < ApplicationController
+  # GET /dde/patients
+  def find_patients_by_npid
+    npid = params.require(:npid)
+    render json: service.find_patients_by_npid(npid)
+  end
+
+  def find_patients_by_name_and_gender
+    given_name, family_name, gender = params.require(%i[given_name family_name gender])
+    render json: service.find_patients_by_name_and_gender(given_name, family_name, gender)
+  end
+
+  def import_patients_by_npid
+    npid = params.require(:npid)
+    render json: service.import_patients_by_npid(npid)
+  end
+
+  def import_patients_by_doc_id
+    doc_id = params.require(:doc_id)
+    render json: service.import_patients_by_doc_id(doc_id)
+  end
+
+  def remaining_npids
+    render json: service.remaining_npids
+  end
+
+  # GET /api/v1/dde/match
+  #
+  # Returns Dde patients matching demographics passed
+  def match_patients_by_demographics
+    render json: service.match_patients_by_demographics(
+      given_name: match_params[:given_name],
+      family_name: match_params[:family_name],
+      gender: match_params[:gender],
+      birthdate: match_params[:birthdate],
+      home_traditional_authority: match_params[:home_traditional_authority],
+      home_district: match_params[:home_district],
+      home_village: match_params[:home_village]
+    )
+  end
+
+  def reassign_patient_npid
+    patient_ids = params.permit(:doc_id, :patient_id)
+    render json: service.reassign_patient_npid(patient_ids)
+  end
+
+  def merge_patients
+    primary_patient_ids = params.require(:primary)
+    secondary_patient_ids_list = params.require(:secondary)
+
+    render json: service.merge_patients(primary_patient_ids, secondary_patient_ids_list)
+  end
+
+  def patient_diff
+    patient_id = params.require(:patient_id)
+    diff = service.find_patient_updates(patient_id)
+
+    render json: { diff: diff }
+  end
+
+  ##
+  # Updates local patient with demographics in Dde.
+  def refresh_patient
+    patient_id = params.require(:patient_id)
+    update_npid = params[:update_npid]&.casecmp?('true') || false
+
+    patient = service.update_local_patient(Patient.find(patient_id), update_npid: update_npid)
+
+    render json: patient
+  end
+
+  private
+
+  MATCH_PARAMS = %i[given_name family_name gender birthdate home_village
+                    home_traditional_authority home_district].freeze
+
+  def match_params
+    MATCH_PARAMS.each_with_object({}) do |param, params_hash|
+      raise "param #{param} is required" if params[param].blank?
+
+      params_hash[param] = params[param]
+    end
+  end
+
+  def service
+    DdeClient::DdeService.new(visit_type: visit_type)
+  end
+
+  def visit_type
+    Program.find(params.require(:visit_type_id))
+  end
+end

data/app/controllers/dde_client/api/v1/rollback_controller.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# controller for managing merge rollback
+class Api::V1::RollbackController < ApplicationController
+  def merge_history
+    identifier = params.require(:identifier)
+    render json: merge_service.get_patient_audit(identifier), status: :ok
+  end
+
+  def rollback_patient
+    patient_id = params.require(:patient_id)
+    visit_type_id = params.require(:visit_type_id)
+    render json: rollback_service.rollback_merged_patient(patient_id, visit_type_id), status: :ok
+  end
+
+  private
+
+  def merge_service
+    MergeAuditService.new
+  end
+
+  def rollback_service
+    RollbackService.new
+  end
+end

data/app/controllers/dde_client/application_controller.rb

@@ -0,0 +1,4 @@
+module Dde
+  class ApplicationController < ActionController::API
+  end
+end

data/app/helpers/dde/application_helper.rb

@@ -0,0 +1,4 @@
+module Dde
+  module ApplicationHelper
+  end
+end

data/app/jobs/dde/application_job.rb

@@ -0,0 +1,4 @@
+module Dde
+  class ApplicationJob < ActiveJob::Base
+  end
+end

data/app/mailers/dde/application_mailer.rb

@@ -0,0 +1,6 @@
+module Dde
+  class ApplicationMailer < ActionMailer::Base
+    default from: "from@example.com"
+    layout "mailer"
+  end
+end

data/app/models/dde/application_record.rb

@@ -0,0 +1,5 @@
+module Dde
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/services/dde_client/dde_client.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require 'logger'
+require 'restclient'
+
+class DdeClient::DdeClient
+  def initialize
+    @auto_login = true # If logged out, automatically login on next request
+    @base_url = nil
+    @connection = nil
+  end
+
+  # Connect to Dde Web Service using either a configuration file
+  # or an old Connection.
+  #
+  # @return A Connection object that can be used to re-connect to Dde
+  def connect(url:, username:, password:)
+    @connection = establish_connection(url: url, username: username, password: password)
+  end
+
+  # Reconnect to Dde using previous connection
+  #
+  # @see: DdeClient#connect
+  def restore_connection(connection)
+    @connection = reload_connection(connection)
+  end
+
+  def get(resource)
+    exec_request resource do |url, headers|
+      RestClient.get url, headers
+    end
+  end
+
+  def post(resource, data)
+    exec_request resource do |url, headers|
+      RestClient.post url, data.to_json, headers
+    end
+  end
+
+  def put(resource, data)
+    exec_request resource do |url, headers|
+      RestClient.put url, data.to_json, headers
+    end
+  end
+
+  def delete(resource)
+    exec_request resource do |url, headers|
+      RestClient.delete url, headers
+    end
+  end
+
+  private
+
+  JSON_CONTENT_TYPE = 'application/json'
+  LOGGER = Logger.new(STDOUT)
+  Dde_API_KEY_VALIDITY_PERIOD = 3600 * 12
+  Dde_VERSION = 'v1'
+
+  # Reload old connection to Dde
+  def reload_connection(connection)
+    LOGGER.debug 'Loading Dde connection'
+    if connection[:expires] < Time.now
+      LOGGER.debug 'Dde connection expired'
+      establish_connection(connection[:config])
+    else
+      @base_url = connection[:config][:url]
+      connection
+    end
+  end
+
+  # Establish a connection to Dde
+  #
+  # NOTE: This simply involves logging into Dde
+  def establish_connection(url:, username:, password:)
+    LOGGER.debug 'Establishing new connection to Dde from configuration'
+
+    # Block any automatic logins when processing request to avoid infinite loop
+    # in request execution below... Under normal circumstances request execution
+    # will attempt a login if 401 is met. Not pretty, I know but it does the job
+    # for now!!!
+    @auto_login = false
+
+    # HACK: Globally save base_url as a connection object may not currently
+    # be available to the build_url method right now
+    @base_url = url
+
+    response, status = post('login', username: username, password: password)
+
+    @auto_login = true
+
+    if status != 200
+      raise StandardError, "Unable to establish connection to Dde: #{response}"
+    end
+
+    LOGGER.info('Connection to Dde established :)')
+    @connection = {
+      key: response['access_token'],
+      expires: Time.now + Dde_API_KEY_VALIDITY_PERIOD,
+      config: { url: url, username: username, password: password }
+    }
+  end
+
+  # Returns a URI object with API host attached
+  def build_uri(resource)
+    "#{@base_url}/#{Dde_VERSION}/#{resource}"
+  end
+
+  def headers
+    {
+      'Content-type' => JSON_CONTENT_TYPE,
+      'Authorization' => @connection ? @connection[:key] : nil
+    }
+  end
+
+  def exec_request(resource)
+    LOGGER.debug "Executing Dde request (#{resource})"
+    response = yield build_uri(resource), headers
+    LOGGER.debug "Handling Dde response:\n\tStatus - #{response.code}\n\tBody - #{response.body}"
+    handle_response response
+  rescue RestClient::Unauthorized => e
+    LOGGER.error "DdeClient suppressed exception: #{e}"
+    return handle_response e.response unless @auto_login
+
+    LOGGER.debug 'Auto-logging into Dde...'
+    establish_connection(@connection[:config])
+    LOGGER.debug "Reset connection: #{@connection}"
+    retry # Retry last request...
+  rescue RestClient::BadRequest => e
+    LOGGER.error "DdeClient suppressed exception: #{e}"
+    handle_response e.response
+  rescue RestClient::UnprocessableEntity => e
+    LOGGER.error "DdeClient suppressed exception: #{e}"
+    handle_response e.response
+  rescue RestClient::NotFound => e
+    LOGGER.error "DdeClient suppressed exception: #{e}"
+    handle_response e.response
+  rescue RestClient::InternalServerError => e
+    LOGGER.error "DdeClient suppressed exceptionnnn: #{e}"
+    handle_response e.response
+  end
+
+  def handle_response(response)
+    # 204 is no content response, no further processing required.
+    return nil, 204 if response.code.to_i == 204
+
+    # NOTE: Following is commented out as Dde at the moment is quite liberal
+    # in how it responds to various requests. It seems to know no difference
+    # between 'application/json' and 'text/plain'.
+    #
+    # unless response["content-type"].include? JSON_CONTENT_TYPE
+    #   puts "Invalid response from API: content-type: " + response["content-type"]
+    #   return nil, 0
+    # end
+
+    # Dde is somewhat undecided on how it reports back its status code.
+    # Sometimes we get a proper HTTP status code and sometimes it is within
+    # the response body.
+    # response_status = response.code || response.body['status']
+    response_status = response.code
+    [JSON.parse(response.body), response_status&.to_i]
+  end
+end