From ef08bf1adf9830b04527a5451ad63bb533232b9d Mon Sep 17 00:00:00 2001
From: Reinier Zwitserloot <reinier@zwitserloot.com>
Date: Thu, 26 Sep 2024 00:41:28 +0200
Subject: [PATCH] [qoc] add properties 'callup' and 'subName' to list-of-sets

---
 examples/qoc_careprogram.1.json | 44 +++++++++------------------------
 paths/qoc_careprogram.yaml      | 10 ++++++++
 2 files changed, 21 insertions(+), 33 deletions(-)

diff --git a/examples/qoc_careprogram.1.json b/examples/qoc_careprogram.1.json
index dab9d53..6db2cd9 100644
--- a/examples/qoc_careprogram.1.json
+++ b/examples/qoc_careprogram.1.json
@@ -1,8 +1,9 @@
 {
 	"programs": [
 		{
-			"key": "ZOO-dm-poc",
-			"name": "Diabetes Mellitus Oproepen",
+			"key": "ZEL-Odm-1",
+			"name": "Diabetes Mellitus (ZEL)",
+			"subName": "Oproepen",
 			"description": "ZorgOpOrde standaard Diabetes Mellitus ketenzorg voor POHs (oproepen en patiënt populatie gezond houden). Indien er geen specifiek op uw zorggroep aangepaste DM definitie beschikbaar is.",
 			"tags": [
 				"DM",
@@ -12,10 +13,13 @@
 			"defaultShow": false,
 			"favState": "X",
 			"careProgram": "DM",
-			"type": "indicatorset"
-		},{
-			"key": "ZOO-dm-acc",
-			"name": "Diabetes Mellitus Accrediteren",
+			"type": "indicatorset",
+			"callup": true
+		},
+		{
+			"key": "ZEL-Rdm-1",
+			"name": "Diabetes Mellitus (ZEL)",
+			"subName": "Rapportage",
 			"description": "ZorgOpOrde standaard Diabetes Mellitus ketenzorg voor accrediteren, vergelijken met andere zorggroepen, en onderhandelen met de zorgverzekeraars. Indien er geen specifiek op uw zorggroep aangepaste DM definitie beschikbaar is.",
 			"tags": [
 				"DM",
@@ -25,34 +29,8 @@
 			"defaultShow": false,
 			"favState": "X",
 			"careProgram": "DM",
-			"type": "indicatorset"
-		},
-		{
-			"key": "IE22-copd",
-			"name": "InEen 2022 COPD",
-			"description": "InEen '22 invulformat voor COPD ketenzorg"
-			"tags": [
-				"COPD",
-				"InEen2022",
-			],
-			"defaultShow": false,
-			"favState": "T",
-			"type": "link",
-			"link": "/indicators/accreditatie?sets=IE22-copd"
-		},
-		{
-			"key": "ZEL-dm",
-			"name": "Diabetes Mellitus (ZEL) Oproepen",
-			"description": "Zorggroep ZEL (<em>regio NWN/DWO</em>) Diabetes Mellitus ketenzorg voor POHs (oproepen en patiënt populatie gezond houden).",
-			"tags": [
-				"DM",
-				"ZEL",
-				"Oproepen"
-			],
-			"defaultShow": true,
-			"favState": "X",
-			"careProgram": "COPD",
 			"type": "indicatorset",
+			"callup": false
 		},
 		{
 			"key": "ZOO-nierfalen",
diff --git a/paths/qoc_careprogram.yaml b/paths/qoc_careprogram.yaml
index 026d281..dba2844 100644
--- a/paths/qoc_careprogram.yaml
+++ b/paths/qoc_careprogram.yaml
@@ -35,6 +35,12 @@ get:
                       description: Key of the indicator set.
                     name:
                       type: string
+                      description: |-
+                        Something like `DM (Calisota)` – describes the careprogram itself (and not the purpose of this indicatorset - see `subName` for that).
+                    subName:
+                      type: string
+                      description: |-
+                        Something like `Oproepen` or `Rapportage 75+` – describes the purpose of this indicatorset; a number of sets all with the same name but with different subNames can exist, representing different views and protocol approaches to the same care program.
                     description:
                       type: string
                       description: A longer description in dutch describing e.g. the chronic care condition covered by this set.
@@ -54,6 +60,10 @@ get:
                     careprogram:
                       $ref: '../schemas/CareProgram-enum.yaml'
                       description: The kind of chronic care that this care program caters to. Can be omitted in cases where this care program doesn't cover a generally accepted protocolized chronic care condition. That is often the case with new research projects.
+                    callup:
+                      type: boolean
+                      description: |-
+                        If this 'flavour' (as per `subName`) is intended to be used to call up patients and look to the future (this will be `true`) or if this set's intent is reporting and introspection, looking to the past (this will be `false`).
     '401':
       $ref: '../zoo-api.yaml/#/components/responses/NoAuth'
     '403':