GithubHelp home page GithubHelp logo

gematik / spec-isik-basismodul Goto Github PK

View Code? Open in Web Editor NEW
7.0 6.0 1.0 28.41 MB

The Information Technology Systems in Hospitals (ISiK – Informationstechnische Systeme in Krankenhäusern) "Basic Module" enables use-case-independent functionalities for the communication and validation of data within hospital environments, by providing FHIR resources, examples and an implementation guide.

License: Other

GLSL 96.63% HTML 0.51% CSS 0.45% Python 1.86% Dockerfile 0.55%
fhir isik specification

spec-isik-basismodul's Introduction


ISiK-Basis

Table of Contents
  1. About The Project
  2. License
  3. Contact

About The Project

For full information and details, see Simplifier Project Page for ISiK Basis Stufe 3

Overview Versions

For overview on preceding versions , see ISiK.

Release Notes

See ReleaseNotes.md for all information regarding the (newest) releases.

License

Copyright 2024 gematik GmbH

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

See the APACHE_LICENSE.md for the specific language governing permissions and limitations under the License.

Unless required by applicable law the software is provided "as is" without warranty of any kind, either express or implied, including, but not limited to, the warranties of fitness for a particular purpose, merchantability, and/or non-infringement. The authors or copyright holders shall not be liable in any manner whatsoever for any damages or other claims arising from, out of or in connection with the software or the use or other dealings with the software, whether in an action of contract, tort, or otherwise.

The software is the result of research and development activities, therefore not necessarily quality assured and without the character of a liable product. For this reason, gematik does not provide any support or other user assistance (unless otherwise stated in individual cases and without justification of a legal obligation). Furthermore, there is no claim to further development and adaptation of the results to a more current state of the art.

Gematik may remove published results temporarily or permanently from the place of publication at any time without prior notice or justification.

Contact

Team Data – ISiK and ISiP

For issues and requests please refer to: https://service.gematik.de/servicedesk/customer/portal/16

spec-isik-basismodul's People

Contributors

alexey-tschudnowsky avatar alexzautke avatar apricotlace avatar f-peverali avatar maxmtheilig avatar me-at-gematik avatar patrick-werner avatar patrickwladowska avatar simoneonfhir avatar ylboerner avatar

Stargazers

avatar avatar avatar avatar avatar avatar

Watchers

avatar avatar avatar avatar avatar avatar

Forkers

apricotlace

spec-isik-basismodul's Issues

Canonical von ValueSets

Einige Canonicals von ValueSets haben Typos (groß- und kleinschreibung) und das führt zu Errors beim CI Ablauf. Z.B.:
error: Code '5-470' from system 'http://fhir.de/CodeSystem/bfarm/ops' does not exist in valueset 'http://fhir.de/ValueSet/bfarm/ops' warning: Terminology service failed while validating code '80146002' (system 'http://snomed.info/sct'): Cannot retrieve valueset 'https://gematik.de/fhir/IsiK/ValueSet/ProzedurenCodes-SCT' warning: Cannot resolve reference Encounter/patient Result: INVALID

Sollte ggf. mit nächster TC gefixed werden.
FYI @alexzautke , @simoneOnFhir , @patrickwladowska

Practitioner - Binding qualification

Hallo zusammen,
beid der Implementierung von ISiK 1.0 als auch in ISiK 2.0 sind Probleme mit dem Binding zum Practitioner augefallen.
Im Profil wird heute auf das ValueSet https://fhir.kbv.de/ValueSet/KBV_VS_Base_Practitioner_Speciality verwiesen (preferred).
Daraus ergeben sich folgende Probleme:

  • Eine Abbildung der Profession Arzt ist nicht korrekt möglich. Es wird im VS https://fhir.kbv.de/ValueSet/KBV_VS_Base_Practitioner_SNOMED nur das Konzept Practitioner inkludiert. Somit werden aber Chirugen exludiert. Hier müsste m.E. ein VS mit den Konzept 158965000 |Medical practitioner (occupation)| und relevanten Kind-Konzepten sein um alle Ärzte in Snomed zu erfassen.
  • Fur Abbildung von Pflegekräften fehlt die Nutzung des Snomed CT Konzepts. Es empfiehlt sich hier mit 106292003 |Professional nurse (occupation)| zu arbeiten. Statt mit dem KBV CS und Konzept PF.

Kardinalität für composition.section.code

zu Prüfen: Kardinalität für composition.section.code überall auf 1..1 setzen, damit das empfangende System die Referenz einordnen kann.
Vergleiche dazu: die Composition der MIO42 zum DiGA-MI

CapabilityStatement Stufe 2 anpassen

Diese beinhaltet keine Angabe über die Composition in der Stufe 2.

Folgende Zeilen sollten hinzugefügt werden:

Technical Correction für Package ID Stufe 1 / Stufe 2

Die Version 1.0.4 wurde nur mit der Package ID "de.gematik.isik-basismodul-stufe1" veröffentlicht. Alle vorherigen Versionen unter "de.gematik.isik-basismodul". Die Technical Correction v1.0.5 sollte unter dem Namen "de.gematik.isik-basismodul" veröffentlicht werden.

Modulübergreifendes Versehen - canonical URL 

    Sieht tatsächlich so aus, als wäre das ein Modulübergreifendes Versehen gewesen, das bisher noch niemandem aufgefallen ist. Ursache vermutlich: Die Canonical der IG Ressource ist die einzige, die nicht von SUSHI automatisch gesetzt und über die Sushi-config.yaml gesteuert werden kann. Wir haben wohl irgendwann entschieden, die Base-Canoncials der Module zu ändern und es versäumt, die Canonicals der IG-Ressourcen manuell anzupassen. Sollte in den anderen Modulen in einer der nächsten TCs oder spätestens in V3 angeglichen werden.

Originally posted by @simoneOnFhir in gematik/spec-ISiK-Dokumentenaustausch#108 (comment)

markdown anpassen: auf Teile der Spezifkation verweisen können

siehe https://chat.fhir.org/#narrow/stream/287581-german.2Fisik/topic/Links.20auf.20Abschnitte.20in.20der.20Spezifikation :
Marco Wedekind6:00 PM
Hallo gematik, (@ansgar Hoeper , @patrick Wladowska ),
ich möchte gern auf Teile der Spezifkation verweisen können, bspw. darauf, dass im Rahmen der Terminvereinbarung ein KIS die Anlage einer Patientenressource unterstützen muss. Es wäre super, wenn ihr die Abschnitte in der Doku verlinkbar macht. firely meint dazu:

To add to this, you can use https://ecotrust-canada.github.io/markdown-toc/ to generated MD index tables. That will also provide you with the links to the different headers, please be aware that this does not always work when there are special characters in the title name.

In the future we would like to add a feature like {{index:md-page}} so this works out of the box, but there is no timeline for that yet.```

Tasks
Beta Give feedback

Mangel in Regex-Anagbe

spec-ISiK-Basismodul/Resources/input/fsh/ISiKBerichtSubSysteme.fsh

Line 89 in 3a4a3ca

Expression: "matches('[A-Z]{2}[0-9]{6}')"

Das ist nur ein Beispiel
Die ISiK Profile sollten auf Vorhandensein von "matches" überprüft werden. Es sollte auf genaue Angabe der Full-Match geachtet werden - also nicht Substring.

TODO for:

Hintergrund: Ohne "^[...]$" (Dollarzeichen werden regex als Substring-Suche ausgewertet.
Siehe auch für Beispiel :https://simplifier.net/basisprofil-de-r4/identifieriknr Beispiel .value : ik-1:Eine IK muss eine numerische 9-stellige Zeichenkette (mit Prüfziffer) sein matches('^[0-9]{9}$')

invariante in Patient-Datei

spec-ISiK-Basismodul/Resources/input/fsh/invariants.fsh

Line 1 in d3ee83f

Invariant: address-cnt-2or3-char

Diese Invariante wird ausschließlich zur Constraint-Bildung beim Patienten verwendet.

(1) Ich würde diese Invariante in der entsprechende Datei definieren und die DAtei "invariants.fsh" selbst entfernen.

(2) Ggf. macht die (Wieder)einführung einer Datei "Invariants.fsh" Sinn (wie in Stufe 1), sobald Constraints Profilübergreifend genutzt werden. Oder?

Was sagt ihr? @alexzautke @patrickwladowska

User Stories für Beispiel-Instanzen

Zu diskutieren:
Die Beispiel-Instanzen sollten eine User Story folgen (analog zu #57 ) - ggf. auch in IG die User Story hinterlgen.
Für TC ab Dezember

Tasks
Beta Give feedback

Alte Beispiele XML

Hier sind noch Beispiele in XML hinterlegt, die u.a. in der Validierung Fehler werfen.
Wirkt auf mich veraltet und obsolet. Kann das weg? Oder werden die noch in IG referenziert? Wenn ja, dann auch Überarbeitung notwendig m.E.

Encounter Änderungen

  • Encounter.type:Kontaktebene -> Pattern "Fachabteilungskontakt"
  • Encounter.account.identifier -> MS + Constraint: Account.reference.reference exists() implies Account.reference.identifier.exists
  • Encounter.partOf -> Kein MS

Fehlende Architekturskizze von ISiK

Hallo ISiK Team,

wie auf der HL7 Jahrestagung besprochen fehlt aktuell eine eindeutige Aussage bzw. ein klares Bild der von euch vorgesehenen IT Infrastruktur bzw. System-Architektur.

Hintergrund ist, dass es teilweise Verwirrung darüber gibt wer den Server bereit stellt. Teilweise haben Subsytemhersteller nun FHIR Server, da sehe ich große Schwierigkeiten (Server to Server oder Server Sync etc. das will ja keiner)

Die Skizze sollte folgende Fragen klären und sollte am besten sehr zentral abrufbar sein, z.B. auf der Leitseite von ISiK.

Wer stellt den FHIR Server?
Wer ist Server, wer ist Client?
Wer greift auf den Server zu?
Ist mehr als nur ein FHIR Server vorgesehen?

Detailfragen, die darüber hinaus zu klären sind:
Was ist, wenn eine Klinik einen anderen FHIR Server, als den des Herstellers nutzen möchte?
Das System muss ISiK können, aber wann wird ISiK Verbindlich in den Krankenhäusern eingeführt?

Weiter so! und bei Fragen meldet euch gerne!

VG
Mathias

Tasks
Beta Give feedback

rendering defekt:

Command 'xml' could not render: File was not found for Profilierung/fsh-generated/resources/DocumentReference-dok-beispiel.json
Command 'json' could not render: File was not found for Profilierung/fsh-generated/resources/DocumentReference-dok-beispiel.json

Invariants: Descriptions und Expressions

Bei folgenden Invariants erscheinen die Descriptions Redundant bzw. die Expression falsch spezifiziert:

Invariant: sct-ops-1
Description: "Falls die Prozedur kodiert vorliegt, SOLL mindestens ein OPS oder SNOMED-CT Code angegeben werden. Liegt die Prozedur nicht kodiert vor SOLL Freitext angegeben werden."
Severity: #error
Expression: "(coding.exists() implies coding.where(system = 'http://snomed.info/sct').exists() or coding.where(system = 'http://fhir.de/CodeSystem/bfarm/ops').exists()) or (text.exists() and coding.exists().not())"

Invariant: proc-ISiK-3
Description: "Entweder MUSS eine kodierte Prozedur vorliegen oder eine textuelle Beschreibung. Stattdessen nur Extensions hinzuzufügen (vgl. https://www.hl7.org/fhir/element.html - ele-1), ist explizit nicht erlaubt."
Severity: #error
Expression: "coding.exists().not() implies text.exists()"

(1) Eine Frage zur Prüf-Semantik

bei sct-ops-1 :
(text.exists() and coding.exists().not()) -> dieser ausdrcuk wird immer als falsch ausgewertet, sobald ein Coding existiert, daher kann hiermit kein Vorhandensein des textes geprüft werden.
Für mich sieht die gesamte sct-ops-1 expression (und Descritpzion) probleamtisch aus, bzw. schlimmstenfalls führt sie dazu, dass die expression immer zu True auswertet.

(2) Eine Frage zur syntax:
Ist es tatsächlich erlaubt das "code" (z.B. für code.coding.exists() zu vernachlässigen?

(3) Der folgende Satz (Anforderung) aus sct-ops1 wird durch Expression proc-ISIK-3 abgedeckt : "Liegt die Prozedur nicht kodiert vor SOLL Freitext angegeben werden." -> d.h. redundant. Meines Erachtens sollte der Satz raus, auch weil man hier eigentlich 2 Anforderungen über eine Expression abzudecken versucht. D.h. auch, dass die Expression für sct-ops-1 dann lauten kann:
coding.exists() implies coding.where(system = 'http://snomed.info/sct').exists() or coding.where(system = 'http://fhir.de/CodeSystem/bfarm/ops').exists()) [hier noch die syntax fraglich]

@alexzautke Könntest Du hierzu bitte ein Feedback geben?

FYI @patrickwladowska

merker : (code.coding.exists() implies code.coding.where(system = 'http://snomed.info/sct').exists().exists()) or code.coding.where(system = 'http://fhir.de/CodeSystem/bfarm/ops').exists().exists()) or code.text.exists() and code.coding.exists().not())

Informationsmodell für den 'Fall'

Aus dem WorkShop-Dokumentenaustausch:

Als Primärsystemhersteller möchte ich wissen, wie ein Fall/Encounter zu klassifizieren ist, wenn in bestimmten ISiK-Schnittstellen ein Fallbezug herzustellen ist.

AC:

  • Ein Informationsmodell für den Encounter wurde erzeugt (Administrativer Fall, klinischer Fall, medizinischer Fall, abrechnungstechnischer Fall etc.)
  • Es muss für ein PS möglich sein, doppelte Fallbezüge aufzulösen
  • Es müssen Szenarien mit Risiken abgebildet werden

Composite SearchParameter für Encounter (Stufe 3!)

Derzeit existiert Unklarheit im Bezug auf repeated search parameters in der Suche mittels date. Zum Beispiel wird ein Encounter mit Suchanfrage Encounter?date=ge2021-02-12&date=le2021-02-14 von HAPI FHIR und Firely Server und folgender Period unterschiedlich aufgelöst:

"period": {
    "start": "2021-02-12",
    "end": "2021-02-14"
}

Da die Spezifikation hier unklar ist, sollten wir einen Composite SearchParameter für date-Searches auf Encounter definieren. Dieser sollte verlangen, dass die oben genannte Suchanfrage als ein logisches UND verstanden wird und AUSCHLIEßLICH Suchergebnisse enthält, für die beide Parameter wahr sind.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.