Table of Contents
Goal
- Make simplified DSL
- Move from layered arch to only document structure
- Make it a sugar for SDC Questionnaire
- Convertible <-> FHIR Q/QR
- Store in DB as meta resource
Decisions
How to name property that holds form elements
LateVisitForm
{:type aidbox.sdc/form
:items [...]}How to store and identify questions
LateVisitDocument
{:type aidbox.sdc/form
:items [{:label "Super basic question"
:id :basic-question}]}Field type
Question Grouping
Display When
-
As additional key in lisp
VitalsForm {:type aidbox.sdc/form :fields [{:name "label" :display-when (= (get-in [:patient :name]) "")}]}- hard to store in DB
-
As additinal key in fhirpath
VitalsForm {:type aidbox.sdc/form :fields [{:name "label" :display-when "patient.name = '123'"}]}- familiar to fhir community
Enable When
-
As additional key:
PHQ2PHQ9 {:type aidbox.sdc/form :fields [{:name "PHQ9 Score" :id "phq-score" :enable-when "false" ;; always disabled (readonly) } {:name "Do you have depression?" :type "checkbox" :id "phq2-depression" :enable-when "this.feeling-tired = null"}]}
Calculated fields
-
Additional field with rule on top level:
VitalsForm {:type aidbox.sdc/form :rules {:bmi (+ (get :weight) (get :height)) :fields [{:label "BMI" :name "bmi"}]}This is current approach:
- all rules in one place
- not scalable, can't state the rule for nested fields and grouped items
-
Rule on the same level as field:
VitalsForm {:type aidbox.sdc/form :fields [{:name "BMI" :rule (+ (get :weight) (get :height))}]} -
Under :value key
VitalsForm {:type aidbox.sdc/form :fields [{:name "patient name" :value (get-in [:patinet :name])}]}
Default (initial) values
-
Allocated field for default value:
VitalsDocument {:type aidbox.sdc/form :fields [{:name "Gender" :initial-value {:display "Not selected"} :options [{:display "Male"} {:display "Female"}]}]} -
Under :value key
VitalsDocument {:type aidbox.sdc/form :fields [{:name "Gender" :value {:dispaly "Not selected"}]}?: How to distingiush this fields from calculated fields
Repeated questions
-
With type group we can only add additional flag about repeating:
VitalsForm {:type aidbox.sdc/form :fields [{:name "patient"} {:name "blood pressure" :type "group" :repetablae true :fields [{:name "systolic" :type "number"}]} -
Every field can be repeatable
VitalsDocument {:fields [{:name "temperature" :repeats true :minItems 1 :type "quantity" :unit "C"}]}
Constraints
-
each question type knows its constraints
VitalsForm {:type aidbox.sdc/form :fields [{:name "weight" :min 123} {:name "blood pressure" :repeats true :minItems 1}]}
Extraction
-
Template based
Covers only Observation cases
VitalsDocument {:type aidbox.sdc/form :fields [{:id "temperature" :type "quantity" :extraction "observation" :coding [{:system "loinc" :code "112312"}] }]}- where to get other fields for observation (subject, effectiveDate)
- how to infer value type (or composite)
-
Inline template
VitalsDocument
VitalsDocument {:type aidbox.sdc/form :fields [{:id "temp" :type "quantity" :extraction {:resourceType "Observation" :valueQuantity {:unit "123" :value "this"} :code {:system "loinc" :code "123123"}}} ]}- boilerplate
Layout
Prefill
-
Use prefill key:
VitalsDocument {:type aidbox.sdc/form :fields [{:name "Weight" :id "weight" :prefill "Patient.observation(code='weight').valueQuantity.value"}]}
Form Pieces Reuse (subforms)
Default form fields
Current implementation has several always-presented fields: `author`, `patient`, `encounter`
How to store in DB
- Stored form should be the same as DSL?
- Should we store meta data (as in QuestionnaireResponse: question text, code)?
Form examples applying this rules
Vitals
VitalsDocument
{:type aidbox.sdc/form
:fields [{:name "Temperature"
:id "temp"
:repeats true
:unit "F"
:type "number"
:min 86
:max 105}
{:name "Blood Pressure"
:id "blood-pressure"
:repeats true
:fields [{:name "BP Sys" :id "systolic"
:unit "mmHg"
:min 40
:max 300}
{:name "BP dias"
:id "diastolic"
:unit "mmHg"
:min 20
:max 220}
{:name "Arm"
:id "arm"
:options [{:display "Biceps left"
:code "LA11158-5"}
{:display "Biceps Right"
:code "LA11159-3"}]}
{:name "Position"
:id "position"
:options [{:display "Sitting"
:code "LA11868-9"}
{:display "Lying"
:code "LA11868-9"}
{:display "Standing"
:code "LA11868-9"}]}]}
{:name "Respiratory rate"
:id "bpm"
:repeats true
:unit "bpm"
:min 6 :max 60}
{:name "Saturation"
:id "saturation"
:unit "SaO2 % PulseOx"
:repeats true
:min 60 :max 100}
{:name "Heart Rate"
:id "heart-rate"
:unit "bpm"
:repeats true
:min 30 :max 250}
{:name "BMI"
:id "bmi"
:type "number"
:enable "false"
:value "globalThis.weight.value / globalThis.height.value"}
{:name "Weight"
:id "weight"
:unit "kg"}
{:name "Height"
:id "height"
:unit "cm"}]}PHQ2/PHQ9
LL358-3
{:type aidbox.sdc/template
:id "replace this"
:name "replace this"
:options [{:display "Not at all" :code "LA6568-5" :score 0}
{:display "Several days" :code "LA6569-3" :score 1}
{:display "More than half the days" :code "LA6570-1" :score 2}
{:display "Nearly every day" :code "LA6571-9" :score 3}]}
PHQ2PHQ9
{:type "aidbox.sdc/form"
:fields [{:type "label"
:label "Over the past 2 weeks, how often have you been bothered by:"}
{:template LL358-3
:name "Feeling down, depressed or hopeless"
:id "feeling-down"}
{:template LL358-3
:name "Little interest or pleasure in doing things"
:id "little-interest"}
{:type "group"
:id "phq9-questions"
:enable "this.little-interest + this.feeling-down >= 3"
:fields [{:template LL358-3
:name "Feeling bad about yourself"
:id "feeling-bad"}
{:template LL358-3
:name "Thoughts that you would be better off dead"
:id "thoughts"}
{:template LL358-3
:name "Poor appetite or overeating"
:id "poor-appetite"}
{:template LL358-3
:name "Trouble concentrating on things"
:id "trouble-concentrating"}
{:template LL358-3
:name "Trouble falling or staying asleep"
:id "trouble-sleep"}
{:template LL358-3
:name "Feeling tired or having little energy"
:id "feeling-tired"}
{:template LL358-3
:name "Moving or speaking so slowly"
:id "moving-slowly"}]}
{:id "total-score"
:name "PHQ2/9 Total Score"
:value "this.feeling-down.score + this.little-interest.score + this.feeling-bad.score"}
{:id "score-interp"
:name "Score Interpretation"
:value "if(this.feeling-down.score) some value"}
]}