Updated RFC-2119 docs

medizininformatik-initiative · Dec 16, 2024 · 8ac9673 · 8ac9673
1 parent 116acae
commit 8ac9673
Show file tree

Hide file tree

Showing 5 changed files with 25 additions and 9 deletions.
diff --git a/...v2025/MIIIGModulMedikation/TechnischeImplementierung/FHIR-Profile/Index.page.md b/...v2025/MIIIGModulMedikation/TechnischeImplementierung/FHIR-Profile/Index.page.md
@@ -1,12 +1,28 @@
 ---
-parent: 
+topic: FHIRProfile
 ---
-## FHIR-Profile
+### FHIR Profile
 
-Die Arbeiten der Kerndatensatzspezifikationen basieren, wo möglich, auf internationalen Standards und Terminologien. Insbesondere sei hier die [International Patient Summary](http://hl7.org/fhir/uv/ips/history.html) hervorgehoben. Eine Anpassung an die allgemeinen Gegebenheiten des deutschen Gesundheitswesens erfolgt durch die Verwendung der [Deutschen Basisprofile](https://simplifier.net/basisprofil-de-r4) von HL7 Deutschland.
+Die Arbeiten der Kerndatensatzspezifikationen basieren, wo möglich, auf internationalen Standards und Terminologien. Insbesondere sei hier die [ International Patient Summary](http://hl7.org/fhir/uv/ips/STU1/) hervorgehoben. Eine Anpassung an die allgemeinen Gegebenheiten des deutschen Gesundheitswesens erfolgt durch die Verwendung der [Deutschen Basisprofile](https://ig.fhir.de/basisprofile-de/1.5.0/Home.html) von HL7 Deutschland. Außerdem wird Kompatibilität zu den FHIR-Spezifikationen der [Kassenärztlichen Bundesvereinigung (KBV)](https://simplifier.net/organization/kassenrztlichebundesvereinigungkbv) und der [gematik](https://simplifier.net/organization/gematik) angestrebt. 
 
-Alle Elemente des Kerndatensatzes, angepasst an die Details und Anforderungen für die Use Cases der Medizininformatik-Initative, werden nachfolgend in Form von FHIR StructureDefinitions beschrieben. Die Notwendigkeit der Anpassung der FHIR-Profile wird in textueller Form unterhalb der jeweiligen Profile erläutert.
+Alle Elemente des Kerndatensatzes, angepasst an die Details und Anforderungen für die Use Cases der Medizininformatik-Initative, werden nachfolgend in Form von FHIR StructureDefinitions beschrieben. Die Notwendigkeit der Anpassung der FHIR-Profile wird in textueller Form unterhalb des Profils erläutert.
+
+### Anforderungsdokumentation
+
+Anforderungen in dieser Spezifikation werden durch folgende in Großbuchstaben geschriebenen Schlüsselworte basierend auf [RFC-2119](https://datatracker.ietf.org/doc/html/rfc2119) gekennzeichnet:
+
+| Deutsch                      	| Englisch    	       |
+|------------------------------	|--------------------- |
+| MUSS / MÜSSEN                	| MUST / SHALL         |
+| DARF NICHT / DÜRFEN NICHT    	| MUST NOT / SHALL NOT |
+| VERPFLICHTEND                	| REQUIRED    	       |
+| SOLLTE / SOLLTEN             	| SHOULD      	       |
+| SOLLTE NICHT / SOLLTEN NICHT 	| SHOULD NOT  	       |
+| EMPFOHLEN                    	| RECOMMENDED 	       |
+| KANN / OPTIONAL               | MAY                  |
+
+### Verpflichtende / must-support Elemente
 
 | Hinweis | Verpflichtende / must-support Elemente |
 |---------|---------------------|
-| {{render:implementation-guides/ImplementationGuide-Common/images/Warning.jpg}} | Für verpflichtende oder als must-support markierten Elemente sei an dieser Stelle auf die entsprechenden [Regeln der IPS](http://hl7.org/fhir/uv/ips/STU1/design.html#must-support) verwiesen, die auch für diesen ImplementationGuide gelten. |
+| {{render:implementation-guides/ImplementationGuide-Common/images/Warning.jpg}}  | Für verpflichtende oder als must-support markierten Elemente sei an dieser Stelle auf die entsprechenden [Regeln der IPS](http://hl7.org/fhir/uv/ips/STU1/design.html#must-support) verwiesen, die auch für diesen ImplementationGuide gelten. |
diff --git a/...scheImplementierung/FHIR-Profile/Medication/Extension-Wirkstoffrelation.page.md b/...scheImplementierung/FHIR-Profile/Medication/Extension-Wirkstoffrelation.page.md
@@ -13,7 +13,7 @@ expand: 1
 
 **Beschreibung**
 
-Die Extension Wirkstoffrelation erlaubt es, Referenzen zwischen den Wirkstoffen abzubilden. Somit kann ein Wirkstoff, der als "genauer" Wirkstoff klassifiziert ist, eindeutig einem "allgemeinen" Wirkstoff zugeordnet werden. Dies erlaubt bspw. die Umrechnung, dass "10mg Bisoprolol hemifumarat" "8,49mg Bisoprolol" entsprechen.
+Die Extension Wirkstoffrelation erlaubt es, Referenzen zwischen den Wirkstoffen abzubilden. Somit KANN ein Wirkstoff, der als "genauer" Wirkstoff klassifiziert ist, eindeutig einem "allgemeinen" Wirkstoff zugeordnet werden. Dies erlaubt bspw. die Umrechnung, dass "10mg Bisoprolol hemifumarat" "8,49mg Bisoprolol" entsprechen.
 
 @```
 from 

diff --git a/...echnischeImplementierung/FHIR-Profile/Medication/Extension-Wirkstofftyp.page.md b/...echnischeImplementierung/FHIR-Profile/Medication/Extension-Wirkstofftyp.page.md
@@ -13,7 +13,7 @@ expand: 1
 
 **Beschreibung**
 
-Für Wirkstoffe soll die Möglichkeit gegeben werden, bei der Berechnung der Dosisangaben zwischen dem genauen Wirkstoff (der ein Salz, Ester etc. sein kann) und dem reinen Wirkstoff zu unterscheiden, und anzugeben, ob die Berechnung auf dem Derivat (seltener) oder der reinen/"allgemeinen" Substanz (meist) beruht. Aus diesem Grund wurde eine Extension definiert, welche zusätzlich zur Wirkstoffcodierung angegeben werden kann. Diese Extension verweist auf ein ValueSet mit Codes für: 
+Durch die Extension KANN bei der Berechnung der Dosisangaben zwischen dem genauen Wirkstoff (der ein Salz, Ester etc. sein kann) und dem reinen Wirkstoff unterschieden werden, um anzugeben, ob die Berechnung auf dem Derivat (seltener) oder der reinen/"allgemeinen" Substanz (meist) beruht. Aus diesem Grund wurde eine Extension definiert, welche zusätzlich zur Wirkstoffcodierung angegeben werden KANN. Diese Extension verweist auf ein ValueSet mit Codes für: 
 * `IN` (ingredient - allgemeiner Wirkstoff), 
 * `PIN` (precise ingredient - genauer Wirkstoff), 
 * oder `MIN` (multiple ingredients - Kombinationscode für mehrere Wirkstoffe).

diff --git a/...ModulMedikation/TechnischeImplementierung/FHIR-Profile/Medication/Index.page.md b/...ModulMedikation/TechnischeImplementierung/FHIR-Profile/Medication/Index.page.md
@@ -6,7 +6,7 @@ subject: https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/
 
 ## Medication
 
-Die Medikation, die angesetzt, geplant oder verabreicht wird. Es kann sich um ein Fertigarzneimittel oder eine Rezeptur handeln. Auch die Angabe nur des Wirkstoffes ist möglich. Die Angabe mindestens eines Wirkstoffes wird verlangt.
+Die Medikation, die angesetzt, geplant oder verabreicht wird. Es kann sich um ein Fertigarzneimittel oder eine Rezeptur handeln. Auch die Angabe nur des Wirkstoffes ist möglich. Mindestens ein Wirkstoff MUSS angegeben werden.
 
 @```
 from 

diff --git a/...ulMedikation/TechnischeImplementierung/FHIR-Profile/MedicationStatement.page.md b/...ulMedikation/TechnischeImplementierung/FHIR-Profile/MedicationStatement.page.md
@@ -6,7 +6,7 @@ subject: https://www.medizininformatik-initiative.de/fhir/core/modul-medikation/
 
 ## MedicationStatement
 
-Das MedicationStatement dokumentiert die Verordnung eines Arzneimittels oder den Konsum durch einen Patienten. MedicationStatement kann anzeigen, dass der Patient ein Medikament zur Zeit einnimmt, in der Vergangenheit genommen hat oder in Zukunft einnehmen wird. Dabei kann es sich sowohl um verschreibungspflichtige Medikamente handeln, wie auch um OTC-Präparate, welche ein Patient in Eigenverantwortung einnimmt.
+Das MedicationStatement dokumentiert die Verordnung eines Arzneimittels oder den Konsum durch einen Patienten. MedicationStatement KANN anzeigen, dass der Patient ein Medikament zur Zeit einnimmt, in der Vergangenheit genommen hat oder in Zukunft einnehmen wird. Dabei KANN es sich sowohl um verschreibungspflichtige Medikamente handeln, wie auch um OTC-Präparate, welche ein Patient in Eigenverantwortung einnimmt.
 
 Der Hauptunterschied zwischen der konkreten Verabreichung einer Medikation (MedicationAdministration) und dem MedicationStatement besteht darin, dass die Medikamentenverabreichung über vollständige Verabreichungsinformationen verfügt und auf den tatsächlichen Informationen der Person basiert, die das Medikament verabreicht hat. MedicationStatement hat im Vergleich eher den Charakter z.B. eines Medikationsplans. Es ist nicht klar, ob der Patient diese Arzneimittel tatsächlich eingenommen hat oder diese verabreicht wurden.
-Original file line number
+Diff line change
@@ Expand Up / @@ -13,7 +13,7 @@ expand: 1 @@
     **Beschreibung**
-    Die Extension Wirkstoffrelation erlaubt es, Referenzen zwischen den Wirkstoffen abzubilden. Somit kann ein Wirkstoff, der als "genauer" Wirkstoff klassifiziert ist, eindeutig einem "allgemeinen" Wirkstoff zugeordnet werden. Dies erlaubt bspw. die Umrechnung, dass "10mg Bisoprolol hemifumarat" "8,49mg Bisoprolol" entsprechen.
+    Die Extension Wirkstoffrelation erlaubt es, Referenzen zwischen den Wirkstoffen abzubilden. Somit KANN ein Wirkstoff, der als "genauer" Wirkstoff klassifiziert ist, eindeutig einem "allgemeinen" Wirkstoff zugeordnet werden. Dies erlaubt bspw. die Umrechnung, dass "10mg Bisoprolol hemifumarat" "8,49mg Bisoprolol" entsprechen.
     @```
     from
@@ Expand Down @@