Übertrag Doku IG-> FSH für Obserations

Resources/input/fsh/ISiKAllergieUnvertraeglichkeit.fsh

@@ -17,9 +17,21 @@ Für das Profil ISiKAllergieUnvertraeglichkeit wird eine Kompatibilität mit fol
 * [das Profil EMDAF_PR_AllergyIntolerance der GEVKO](https://fhir.gevko.de/StructureDefinition/EMDAF_PR_AllergyIntolerance)
 * [das Profil AllergyIntolerance-uv-ips der International Patient Summary](http://hl7.org/fhir/uv/ips/StructureDefinition/AllergyIntolerance-uv-ips)
 
-Hinweise zu Inkompatibilitäten können über die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden.
-"
+Hinweise zu Inkompatibilitäten können über die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden."
+
 * insert Meta
+
+/* 
+hier sollte genauer spezifiziert werden, welche Statuswerte  für clincial- und verificationStatus implementiert werden müssen, z.B. durch Hinzufügen folgenden Kommentars:    
+  **WICHTIGER Hinweis für Implementierer:**    
+  * Alle server-seitigen Implementierungen MÜSSEN in der Lage sein, 
+  die systemintern möglichen Statuswerte korrekt in FHIR abzubilden, mindestens jedoch <t.b.d>.
+  * Alle client-seitigen Implementierungen MÜSSEN in der Lage sein, sämtliche Status-Codes zu interpretieren und dem Anwender in angemessener Form darstellen zu können, 
+  beispielsweise durch Ausblenden/Durchstreichen von Ressourcen mit dem status `entered-in-error` und Ausgrauen von Ressourcen, die einen Plan- oder Entwurfs-Status haben.
+
+Alternativ: hier einen Sermon analog zu Condition.clincalStatus einfügen.
+Bitte auch beachten, dass verificationStatus bei Condition derzeit KEIN MS-Flag hat!
+*/
 * clinicalStatus MS
   * ^short = "klinischer Status"
   * coding 1..1 MS

Resources/input/fsh/ISiKLebenszustandOberservations.fsh

@@ -2,11 +2,43 @@ Profile: ISiKLebensZustand
 Parent: Observation
 Id: ISiKLebensZustand
 Title: "ISiKLebensZustand"
-Description: "Basisprofil für ISiKLebensZustand Observation"
+Description: "Basisprofil für ISiKLebensZustand Observation 
+
+### Motivation
+
+Viele medizinischen Entscheidungen benötigen Informationen zu den Lebensumständen eines Patienten. Hierzu gehören eine aktuelle Schwangerschaft, Raucherstatus sowie der Alkoholabususstatus.
+Motivierender Use-Case zur Einführung dieser Profile ist die [Arzneitmitteltherapiesicherheit im Krankenhaus - AMTS](https://simplifier.net/guide/isik-medikation-v4/ImplementationGuide-markdown-UebergreifendeUseCases-AMTS).
+
+In FHIR werden Untersuchungen, bzw. Beobachtungen als [`Observation`](https://hl7.org/fhir/R4/observation.html)-Ressource repräsentiert.
+
+Die folgenden Profile vom Typ Observation sind spezifische Profile im oben genannten Sinn. 
+Eine generische, ISiK-spezifische Observation wir beschrieben unter {{pagelink:Observation-Profil}}.
+
+### Kompatibilität
+
+Für Schwangerschaftsstatus & Erwarteter Geburtstermin wird eine Kompatibilität mit folgenden **IPS** Profilen angestrebt:
+* [IPS Resource Profile: Observation - Pregnancy: EDD](https://hl7.org/fhir/uv/ips/STU1.1/StructureDefinition-Observation-pregnancy-edd-uv-ips.html). 
+* [IPS Resource Profile: Observation - Pregnancy: status](https://hl7.org/fhir/uv/ips/STU1.1/StructureDefinition-Observation-pregnancy-status-uv-ips.html)
+
+Hinweise zu Inkompatibilitäten können über die [Portalseite](https://service.gematik.de/servicedesk/customer/portal/16) gemeldet werden."
+
 * insert Meta
+
 * status MS
+  * ^short = "Status"
+  * ^comment = "Bedeutung: Der Status MUSS insbesondere zur Differenzierung von abgeschlossenen, 
+  vorläufigen oder korrigierten Beobachtungen angegeben werden.   
+  **WICHTIGER Hinweis für Implementierer:**    
+  * Alle server-seitigen Implementierungen MÜSSEN in der Lage sein, 
+  die systemintern möglichen Statuswerte korrekt in FHIR abzubilden, mindestens jedoch 'final'.
+  * Alle client-seitigen Implementierungen MÜSSEN in der Lage sein, sämtliche Status-Codes zu interpretieren und dem Anwender in angemessener Form darstellen zu können, 
+  beispielsweise durch Ausblenden/Durchstreichen von Ressourcen mit dem status `entered-in-error` und Ausgrauen von Ressourcen, die einen Plan- oder Entwurfs-Status haben."
 * category MS
+  * ^short = "Kategorie"
+  * ^comment = "Bedeutung: Kategorie-Code, der die Untersuchung kategorisiert."
 * code MS
+  * ^short = "Code"
+  * ^comment = "Bedeutung: Code, der die Untersuchung repräsentiert und kodiert."
   * coding 1.. MS
     * ^slicing.discriminator.type = #pattern
     * ^slicing.discriminator.path = "system"
@@ -30,9 +62,19 @@ Description: "Basisprofil für ISiKLebensZustand Observation"
     * ^comment = "Die Verlinkung auf eine Encounter-Ressource dient der technischen Zuordnung der Dokumentation zu einem Aufenthalt 
     und ermöglicht wichtige API-Funktionen wie verkettete Suche, (Reverse-)Include etc."
 * effective[x] 1..1 MS
+  * ^short = "Zeitpunkt/-raum der Beobachtung"
+  * ^comment = "Bedeutung: Klinisch relevanter Zeitpunkt/Zeitspanne für die Observation."
 * effective[x] only dateTime or Period
 * value[x] 1.. MS
-  * ^comment = "Motivation: Ein Lebenszustand benötigt immer einen Wert"
+  * ^short = "Wert der Beobachtung"
+  * ^comment = "Bedeutung: Erfasster Wert der Observation."
+//folgende Elemente hatten bislang kein MS-Flag, aber  im IG gab es  Anmerkungen dazu:   
+* component
+  //TODO:  * ^short = ""
+  * ^comment = "Bedeutung: Bei Vitalparametern, die aus mehreren Einzelnen Messpunkten bestehen (Blutdruck, EKG, GCS), werden die gemessenen Einzelwerte jeweils mit einem separaten LOINC-Code in Observation.component.code versehen und der entsprechende Messwert in Observation.component.value erfasst." 
+* hasMember
+  //TODO:  * ^short = ""
+  * ^comment = "Bedeutung: Weitere Observation, die mit dieser Observation gemeinsam zu betrachten ist."