From 84d010a78ceec039df63b13880d379bc5e96c760 Mon Sep 17 00:00:00 2001
From: Reinier Zwitserloot <reinier@zwitserloot.com>
Date: Wed, 25 Jun 2025 14:46:13 +0200
Subject: [PATCH] [qoc] Added 'focus' property of indicators

---
 paths/qoc_checkupList_{setKey}.yaml | 8 ++++++++
 schemas/Indicator.yaml              | 6 ++++++
 schemas/IndicatorDetail.yaml        | 9 ++++-----
 schemas/IndicatorParticipants.yaml  | 2 ++
 4 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/paths/qoc_checkupList_{setKey}.yaml b/paths/qoc_checkupList_{setKey}.yaml
index 92e4f4c..be9f8ae 100644
--- a/paths/qoc_checkupList_{setKey}.yaml
+++ b/paths/qoc_checkupList_{setKey}.yaml
@@ -138,8 +138,16 @@ get:
                         If present, this indicator is optional, and the value contains dutch human readable text explaining why.
                       type: string
                       example: Volgens HKN protocol is BMI meten optioneel bij Astma patiënten; echter stelt het protocol wel een relatie tussen overgewicht en de mate van klachten.
+                    focus:
+                      description: |-
+                        Caregroups can choose key performance indicators; such indicators are considered 'focus' indicators.
+                        Focus indicators tend to be temporary; most caregroups adjust them yearly or every other year.
+                      type: boolean
+                      example: false
                   required:
                     - title
+                    - key
+                    - focus
               patients:
                 type: array
                 items:
diff --git a/schemas/Indicator.yaml b/schemas/Indicator.yaml
index 1136f93..d809027 100644
--- a/schemas/Indicator.yaml
+++ b/schemas/Indicator.yaml
@@ -20,6 +20,12 @@ properties:
     description: Short, in dutch, plain text.
     type: string
     example: Prevalentie Diabetes
+  focus:
+    description: |-
+      Caregroups can choose key performance indicators; such indicators are considered 'focus' indicators.
+      Focus indicators tend to be temporary; most caregroups adjust them yearly or every other year.
+    type: boolean
+    example: false
   htmlDescription:
     description: In dutch, HTML formatted; if present, contains details on how this value is measured (in more readable, less technical terms than `htmlDetail`.
     type: string
diff --git a/schemas/IndicatorDetail.yaml b/schemas/IndicatorDetail.yaml
index d660aec..10956c8 100644
--- a/schemas/IndicatorDetail.yaml
+++ b/schemas/IndicatorDetail.yaml
@@ -15,12 +15,11 @@ properties:
   refDate:
     $ref: 'IndicatorSet.yaml#/properties/refDate'
   htmlDescription:
-    description: A more detailed description of what this indicator calculates. *HTML*
-    type: string
+    $ref: 'Indicator.yaml#/properties/htmlDescription'
   htmlDescriptionDetail:
-    description: |-
-      *OPTIONAL* A description of which exact formulas and codes are checked to calculate this indicator. *HTML*.
-    type: string
+    $ref: 'Indicator.yaml#/properties/htmlDetail'
+  focus:
+    $ref: 'Indicator.yaml#/properties/focus'
   blocks:
     description: |-
       A block describes one particular outcome (such as 'patients with conflicting registration').
diff --git a/schemas/IndicatorParticipants.yaml b/schemas/IndicatorParticipants.yaml
index 4162af6..0f820f3 100644
--- a/schemas/IndicatorParticipants.yaml
+++ b/schemas/IndicatorParticipants.yaml
@@ -18,6 +18,8 @@ properties:
     $ref: 'IndicatorDetail.yaml#/properties/htmlDescription'
   htmlDescriptionDetail:
     $ref: 'IndicatorDetail.yaml#/properties/htmlDescriptionDetail'
+  focus:
+    $ref: 'Indicator.yaml#/properties/focus'
   xMin:
     $ref: 'Indicator.yaml#/properties/xMin'
   xMax: