renalware-core 2.0.149 → 2.0.151

data/app/javascript/renalware/controllers/session_controller.js

@@ -218,6 +218,6 @@ export default class extends Controller {
   // If you add data-session-debug=1 then logging will be enabled
   // This is evaluated each time we can add debugging into a running page
   get debug() {
-    return this.data.get("debug")
+    return this.data.get("debug") === "true"
   }
 }

data/app/javascript/renalware/controllers/simple_toggle_controller.js

@@ -0,0 +1,17 @@
+import { Controller } from "stimulus"
+
+export default class extends Controller {
+  static targets = ["toggleable"]
+
+  connect() {
+    this.toggleClass = this.data.get("class") || "hidden"
+  }
+
+  toggle(event) {
+    event.preventDefault()
+
+    this.toggleableTargets.forEach(target => {
+      target.classList.toggle(this.toggleClass)
+    })
+  }
+}

data/app/javascript/renalware/controllers/tabs_controller.js

@@ -0,0 +1,43 @@
+//
+// Adapted from https://github.com/excid3/tailwindcss-stimulus-components#tabs
+//
+import { Controller } from "stimulus"
+
+export default class extends Controller {
+  static targets = ["tab", "panel"]
+  connect() {
+  }
+
+  initialize() {
+    this.activeTabClasses = (this.data.get("activeTab") || "active").split(" ")
+    this.showTab()
+  }
+
+  change(event) {
+    event.preventDefault()
+    this.index = this.tabTargets.indexOf(event.currentTarget)
+  }
+
+  showTab() {
+    this.tabTargets.forEach((tab, index) => {
+      const panel = this.panelTargets[index]
+
+      if (index === this.index) {
+        panel.classList.remove("hidden")
+        tab.classList.add(...this.activeTabClasses)
+      } else {
+        panel.classList.add("hidden")
+        tab.classList.remove(...this.activeTabClasses)
+      }
+    })
+  }
+
+  get index() {
+    return parseInt(this.data.get("index") || 0)
+  }
+
+  set index(value) {
+    this.data.set("index", value)
+    this.showTab()
+  }
+}

data/app/javascript/renalware/controllers/toggle_controller.js

@@ -15,7 +15,7 @@ export default class extends Controller {
     const tbody = event.target.closest("tbody")
     tbody.classList.toggle("toggleable--open")
     // Update masonry - TODO: move to a module
-    $(".grid > .row").masonry("layout")
+    $(".mgrid > .row").masonry("layout")
   }
 
   // Toggle the last tr in each tbody in the current table.
@@ -31,6 +31,6 @@ export default class extends Controller {
     thead.classList.toggle("toggleable--open")
     tbodies.forEach(function(tbody) { tbody.classList.toggle("toggleable--open", !hide) })
     // Update masonry - TODO: move to a module
-    $(".grid > .row").masonry("layout")
+    $(".mgrid > .row").masonry("layout")
   }
 }

data/app/javascript/renalware/index.js

@@ -1,3 +1,5 @@
+import "../../assets/stylesheets/tailwind/tailwind.css"
+
 import "@stimulus/polyfills" // required for IE11 support
 import { Application } from "stimulus"
 
@@ -21,6 +23,10 @@ import LettersFormController from "./controllers/letters/form_controller"
 import PrescriptionsController from "./controllers/medications/prescriptions_controller"
 import ChartsController from "./controllers/charts_controller"
 import SessionController from "./controllers/session_controller"
+import SimpleToggleController from "./controllers/simple_toggle_controller"
+import TabsController from "./controllers/tabs_controller"
+import PDPetChartsController from "./controllers/pd/pet_charts_controller"
+import PathologySparklinesController from "./controllers/pathology/sparklines_controller"
 
 const application = Application.start()
 application.register("toggle", ToggleController)
@@ -31,5 +37,9 @@ application.register("letters-form", LettersFormController)
 application.register("prescriptions", PrescriptionsController)
 application.register("charts", ChartsController)
 application.register("session", SessionController)
+application.register("simple-toggle", SimpleToggleController)
+application.register("tabs", TabsController)
+application.register("pd-pet-chart", PDPetChartsController)
+application.register("pathology-sparklines", PathologySparklinesController)
 
 window.Chartkick.use(window.Highcharts)

data/app/models/concerns/renalware/patients_ransack_helper.rb

@@ -6,7 +6,9 @@ module Renalware
   module PatientsRansackHelper
     extend ActiveSupport::Concern
 
+    # rubocop:disable Layout/LineLength
     UUID_REGEXP = /[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}/.freeze
+    # rubocop:enable Layout/LineLength
 
     included do
       class_eval do

data/app/models/renalware/clinics/body_surface_area.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_dependency "renalware/clinics"
+
+# The body surface area (BSA) of a patient calculated using DuBois/DuBois
+# BSA = 0.007184 * Height^0.725 * Weight^0.425
+# Resources:
+# - Calculators
+#   - https://www.msdmanuals.com/en-gb/medical-calculators/BodySurfaceArea.htm
+#   - http://www.medcalc.com/body.html
+module Renalware
+  module Clinics
+    class BodySurfaceArea
+      pattr_initialize [:weight!, :height!]
+
+      def self.calculate(weight:, height:, dp: 2)
+        new(weight: weight, height: height).calculate(dp: dp)
+      end
+
+      def calculate(dp: 2)
+        return if height_cm.zero?
+        return if weight_kg.zero?
+
+        # NB ** is ruby syntax for power of (^)
+        result = 0.007184 * (weight_kg**0.425) * (height_cm**0.725)
+        result.round(dp)
+      end
+
+      private
+
+      def height_cm
+        height.to_f * 100
+      end
+
+      def weight_kg
+        weight.to_f
+      end
+    end
+  end
+end

data/app/models/renalware/clinics/clinic_visit.rb

@@ -19,7 +19,7 @@ module Renalware
 
       belongs_to :patient, touch: true
       belongs_to :clinic
-      has_many :clinic_letters
+      has_many :clinic_letters # TODO: remove as possibly redundant
 
       validates :date, presence: true
       validates :clinic, presence: true
@@ -35,6 +35,10 @@ module Renalware
 
       scope :ordered, -> { order(date: :desc, created_at: :desc) }
       scope :most_recent_for_patient, ->(patient) { for_patient(patient).ordered.limit(1) }
+      scope :where_weight_was_measured, -> { where("weight > 0") }
+
+      before_save :calculate_body_surface_area
+      before_save :calculate_total_body_water
 
       def bmi
         BMI.new(weight: weight, height: height).to_f
@@ -72,6 +76,22 @@ module Renalware
       def datetime_from_date_and_time
         DateTime.new(date.year, date.month, date.day, time.hour, time.min, 0, time.zone)
       end
+
+      def calculate_body_surface_area
+        self.body_surface_area = BodySurfaceArea.calculate(
+          height: height,
+          weight: weight
+        )
+      end
+
+      def calculate_total_body_water
+        self.total_body_water = TotalBodyWater.calculate(
+          height: height,
+          weight: weight,
+          age: patient.age,
+          sex: patient.sex
+        )
+      end
     end
   end
 end

data/app/models/renalware/clinics/total_body_water.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require_dependency "renalware/clinics"
+
+# Total Body Water (TBW) calcuated using WATSON
+# References:
+# - https://qxmd.com/calculate/calculator_344/total-body-water-watson-formula
+#
+# Total Body Water
+#   TBW = 2.447 - 0.09156 X age + 0.1074 X height + 0.3362 X weight
+#   (females) TBW = -2.097 + 0.1069 X height + 0.2466 X weight
+#
+# Water in Litres
+# Age in years
+# Height in cm
+# Weight in kg
+module Renalware
+  module Clinics
+    class TotalBodyWater
+      pattr_initialize [:height!, :weight!, :age, :sex]
+
+      NOTHING = nil
+      SEX_PROC_MAP = {
+        M: ->(age:, height:, weight:) { 2.447 - 0.09156 * age + 0.1074 * height + 0.3362 * weight },
+        F: ->(height:, weight:, **) { -2.097 + 0.1069 * height + 0.2466 * weight }
+      }.freeze
+      NOOP = ->(**) { NullObject.instance }
+
+      def self.calculate(dp: 2, **args)
+        new(**args).calculate(dp: dp)
+      end
+
+      def calculate(dp: 2)
+        return NOTHING if height_cm.zero?
+        return NOTHING if weight_kg.zero?
+        return NOTHING if age.to_i.zero?
+
+        proc_for_sex = SEX_PROC_MAP.fetch(sex_sym, NOOP)
+
+        proc_for_sex.call(
+          age: age,
+          height: height_cm,
+          weight: weight_kg
+        ).round(dp)
+      end
+
+      private
+
+      # Note sex can be nil but here that would evaluate to :""
+      def sex_sym
+        sex.to_s&.to_sym
+      end
+
+      def height_cm
+        height.to_f * 100
+      end
+
+      def weight_kg
+        weight.to_f
+      end
+    end
+  end
+end

data/app/models/renalware/events/advanced_care_plan.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_dependency "renalware/events"
+require "document/base"
+require "document/embedded"
+require "document/enum"
+
+module Renalware
+  module Events
+    class AdvancedCarePlan < Events::Event
+      include Document::Base
+
+      class Document < Document::Embedded
+        attribute :state, ::Document::Enum # See i18n for options
+        validates :state, presence: true
+      end
+      has_document
+
+      def partial_for(partial_type)
+        File.join("renalware/events/advanced_care_plans", partial_type)
+      end
+    end
+  end
+end

data/app/models/renalware/events/clinical_frailty_score.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_dependency "renalware/events"
+require "document/base"
+require "document/embedded"
+require "document/enum"
+
+module Renalware
+  module Events
+    class ClinicalFrailtyScore < Events::Event
+      include Document::Base
+
+      class Document < Document::Embedded
+        attribute :score, ::Document::Enum # See i18n for options
+        validates :score, presence: true, numericality: true
+      end
+      has_document
+
+      def partial_for(partial_type)
+        File.join("renalware/events/clinical_frailty_score", partial_type)
+      end
+    end
+  end
+end

data/app/models/renalware/feeds/hl7_message.rb

@@ -67,6 +67,7 @@ module Renalware
 
       class Observation < SimpleDelegator
         attr_reader :cancelled
+
         alias_attribute :date_time, :observation_date
         alias_attribute :value, :observation_value
 

data/app/models/renalware/hd/prescription_last_administration_query.rb

@@ -8,6 +8,10 @@ module Renalware
       pattr_initialize [:prescription!]
       delegate :patient, to: :prescription
 
+      def self.call(prescription:)
+        new(prescription: prescription).call
+      end
+
       def call
         raise ArgumentError if prescription.blank?
         raise ArgumentError if patient.blank?

data/app/models/renalware/hd/session_forms/pdf_renderer.rb

@@ -23,7 +23,7 @@ module Renalware
         def pdf_html
           @pdf_html ||= begin
             # Note we don't actually hit the ProtocolController#index action here.
-            controller.render_to_string(
+            controller.render_to_string_with_wicked_pdf(
               template: "renalware/hd/protocols/index",
               layout: "renalware/layouts/pdf",
               locals: {

data/app/models/renalware/hd/sessions/auditable_session_collection.rb

@@ -146,7 +146,10 @@ module Renalware
           # Any values like "## TEST CANCELLED" etc are thus excluded from the calculation
           def values
             @values ||= begin
-              sessions.map { |session| selector.call(session) }.compact.select { |val| number?(val) }
+              sessions
+                .map { |session| selector.call(session) }
+                .compact
+                .select { |val| number?(val) }
             end
           end
 

data/app/models/renalware/letters/html_renderer.rb

@@ -8,7 +8,7 @@ module Renalware
     class HTMLRenderer
       def call(letter)
         context = LettersController.new
-        context.render_to_string(
+        context.render_to_string_with_wicked_pdf(
           partial: "/renalware/letters/formatted_letters/letter",
           locals: { letter: letter },
           encoding: "UTF-8"

data/app/models/renalware/letters/printing/duplex_interleaved_pdf_renderer.rb

@@ -24,7 +24,7 @@ module Renalware
           # using a hex digest of the interleaved letter but currently would not be.
           # PdfLetterCache.fetch(letter) do
           WickedPdf.new.pdf_from_string(
-            LettersController.new.render_to_string(
+            LettersController.new.render_to_string_with_wicked_pdf(
               template: "/renalware/letters/printable_letters/show",
               locals: { letter: letter, recipients: PrintableRecipients.for(letter) },
               encoding: "UTF-8"

data/app/models/renalware/letters/recipient_address_pdf_renderer.rb

@@ -13,7 +13,7 @@ module Renalware
           recipient = RecipientPresenter::WithCurrentAddress.new(recipient)
         end
         WickedPdf.new.pdf_from_string(
-          LettersController.new.render_to_string(
+          LettersController.new.render_to_string_with_wicked_pdf(
             partial: "/renalware/letters/formatted_letters/recipient_address_cover_sheet",
             locals: { recipient: recipient },
             encoding: "UTF-8"

data/app/models/renalware/pathology/nearest_observations_query.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_dependency "renalware/pathology"
+
+module Renalware
+  module Pathology
+    class NearestObservationsQuery
+      pattr_initialize [:patient!, :date!, :code_group!, look_behind_days!: 2]
+
+      # rubocop:disable Metrics/MethodLength
+      def call
+        pathology_patient
+          .observations
+          .joins(:description)
+          .where(description_id: observation_description_ids)
+          .where("observed_at >= ?", (date - look_behind_days.days).beginning_of_day)
+          .select(
+            :observed_at,
+            :result,
+            :description_id,
+            "pathology_observation_descriptions.code as code"
+          )
+          .map do |row|
+            {
+              code: row.code,
+              observed_on: row.observed_at.to_date,
+              result: row.result
+            }
+          end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      private
+
+      def pathology_patient
+        Pathology.cast_patient(patient)
+      end
+
+      def observation_description_ids
+        @observation_description_ids ||= code_group.memberships.pluck(:observation_description_id)
+      end
+    end
+  end
+end

data/app/models/renalware/pathology/observations_jsonb_serializer.rb

@@ -34,7 +34,7 @@ module Renalware
 
       def observation_hash_or_hash_element_for(code, suffix)
         obs_hash = self[code]
-        return nil if obs_hash.blank? # the patient may not have this code in the set, or it might be {}
+        return nil if obs_hash.blank? # patient may not have this code in the set, or it might be {}
         return obs_hash[:result] if suffix == "_result"
         return Date.parse(obs_hash[:observed_at]) if suffix == "_observed_at"