renalware-core 2.0.147 → 2.0.153

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"
 
@@ -20,6 +22,11 @@ import SnippetsController from "./controllers/snippets_controller"
 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)
@@ -29,5 +36,10 @@ application.register("snippets", SnippetsController)
 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/accesses/assessment.rb

@@ -14,7 +14,11 @@ module Renalware
       belongs_to :type, class_name: "Type"
 
       has_document class_name: "Renalware::Accesses::AssessmentDocument"
-      has_paper_trail class_name: "Renalware::Accesses::Version", on: [:create, :update, :destroy]
+
+      has_paper_trail(
+        versions: { class_name: "Renalware::Accesses::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       scope :ordered, -> { order(performed_on: :desc) }
 

data/app/models/renalware/accesses/procedure.rb

@@ -12,7 +12,10 @@ module Renalware
       belongs_to :type, class_name: "Type"
       belongs_to :pd_catheter_insertion_technique, class_name: "CatheterInsertionTechnique"
 
-      has_paper_trail class_name: "Renalware::Accesses::Version", on: [:create, :update, :destroy]
+      has_paper_trail(
+        versions: { class_name: "Renalware::Accesses::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       scope :ordered, -> { order(performed_on: :desc) }
 

data/app/models/renalware/accesses/profile.rb

@@ -11,7 +11,10 @@ module Renalware
       belongs_to :patient, touch: true
       belongs_to :type, class_name: "Type"
 
-      has_paper_trail class_name: "Renalware::Accesses::Version", on: [:create, :update, :destroy]
+      has_paper_trail(
+        versions: { class_name: "Renalware::Accesses::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       scope :ordered, -> { order(formed_on: :desc) }
       scope :current, lambda {

data/app/models/renalware/clinical/body_composition.rb

@@ -19,7 +19,10 @@ module Renalware
       belongs_to :assessor, class_name: "User", foreign_key: "assessor_id"
       belongs_to :modality_description, class_name: "Modalities::Description"
 
-      has_paper_trail class_name: "Renalware::Clinical::Version", on: [:create, :update, :destroy]
+      has_paper_trail(
+        versions: { class_name: "Renalware::Clinical::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       scope :ordered, -> { order(assessed_on: :desc, created_at: :desc) }
 

data/app/models/renalware/clinical/dry_weight.rb

@@ -12,7 +12,10 @@ module Renalware
       belongs_to :patient, class_name: "Renalware::Clinical::Patient", touch: true
       belongs_to :assessor, class_name: "User", foreign_key: "assessor_id"
 
-      has_paper_trail class_name: "Renalware::Clinical::Version", on: [:create, :update, :destroy]
+      has_paper_trail(
+        versions: { class_name: "Renalware::Clinical::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       scope :ordered, -> { order(assessed_on: :desc, created_at: :desc) }
 

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

@@ -7,7 +7,11 @@ module Renalware
   module Clinics
     class ClinicVisit < ApplicationRecord
       self.table_name = :clinic_visits
-      has_paper_trail class_name: "Renalware::Clinics::Version", on: [:create, :update, :destroy]
+
+      has_paper_trail(
+        versions: { class_name: "Renalware::Clinics::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       include Accountable
       include PatientScope
@@ -15,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
@@ -31,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
@@ -68,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/preference_set.rb

@@ -12,7 +12,10 @@ module Renalware
       belongs_to :hospital_unit, class_name: "Hospitals::Unit"
       belongs_to :schedule_definition, foreign_key: "schedule_definition_id"
 
-      has_paper_trail class_name: "Renalware::HD::Version", on: [:create, :update, :destroy]
+      has_paper_trail(
+        versions: { class_name: "Renalware::HD::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       validates :patient, presence: true
       validates :entered_on, timeliness: { type: :date, allow_blank: true }

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/profile.rb

@@ -18,9 +18,12 @@ module Renalware
       belongs_to :named_nurse, class_name: "User", foreign_key: "named_nurse_id"
       belongs_to :transport_decider, class_name: "User", foreign_key: "transport_decider_id"
       belongs_to :schedule_definition, foreign_key: "schedule_definition_id"
-
       has_document class_name: "Renalware::HD::ProfileDocument"
-      has_paper_trail class_name: "Renalware::HD::Version", on: [:create, :update, :destroy]
+
+      has_paper_trail(
+        versions: { class_name: "Renalware::HD::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       validates :patient, presence: true
       validates :prescriber, presence: true

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

@@ -32,7 +32,10 @@ module Renalware
                dependent: :destroy
       accepts_nested_attributes_for :prescription_administrations
 
-      has_paper_trail class_name: "Renalware::HD::Version", on: [:create, :update, :destroy]
+      has_paper_trail(
+        versions: { class_name: "Renalware::HD::Version" },
+        on: [:create, :update, :destroy]
+      )
 
       before_create :assign_modality
       before_save :compute_duration

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"