SGP Uputnica

SGP uputnica služi za upućivanje pacijenata na specijalno gensko profiliranje. Životni ciklus uputnice prikazan je na sljedećoj slici:

Slika 1 - Model stanja SGP uputnice

Pri registraciji nove uputnice, uputnica se registrira u stanju ST01. Ovisno o dostupnim medicinskim podacima uputnica može biti

  • Odobrena - uputnica tada prelazi u stanje ST02
  • Poništena - uputnica tada prelazi u stanje ST05
  • Zatražena dopuna - u slučaju kada ne postoji dovoljno podataka da se donese odluka o odobravanju ili poništavanju uputnice medicinski djelatnik će poslati poruku u kojoj će zatražiti dopunu medicinskih podataka. Uputnica tada prelazi u stanje ST03

Kada se uputnica nalazi u stanju ST03 moguće su sljedeće aktivnosti:

  • Uputnica može biti poništena pri čemu prelazi u stanje ST05.
  • Uputnica može biti dopunjena pri čemu prelazi u stanje ST04.

Uputnica koja se nalazi u stanju ST04 može biti:

  • Odobrena - uputnica tada prelazi u stanje ST02
  • Poništena - uputnica tada prelazi u stanje ST05
  • Zatražena dopuna - u slučaju kada ne postoji dovoljno podataka da se donese odluka o odobravanju ili poništavanju uputnice medicinski djelatnik će poslati poruku u kojoj će zatražiti dopunu medicinskih podataka. Uputnica tada prelazi u stanje ST03

Uputnica koja se nalazi u stanju ST02 može biti:

  • Dopunjena CONom - uputnica tada prelazi u stanje ST06
  • Poništena - uputnica tada prelazi u stanje ST05

Slučajevi uporabe pri upravljanju životnim ciklusom specijalističke uputnice prikazani su na slici 2.

Slika 2 - Slučajevi uporabe SGP uputnice

Kao što je vidljivo na slici 2 dostupni su sljedeći slučajevi uporabe:

Sigurnost

Za korištenje usluge SGP uputnice potrebno je koristiti slijedeće sigurnosne mehanizme:

  • Sigurnost na transportnom sloju
  • Autentikacija i autorizacija krajnjeg korisnika
  • Digitalni potpis svih FHIR poruka

Za pristup usluzi krajnji korisnik mora imati jednu od slijedečih uloga:

  • sgp_administrator - dohvat i pretraživanje, odobravanje, poništavanje
  • sgp_laboratory_technician - pretraživanje i dohvat
  • specialist - kreiranje, poništavanje, pretraživanje i dohvat
  • specialistic_nurse - pretraživanje i dohvat
  • specialistic_technician - pretraživanje i dohvat

Ostali zahtjevi

Maksimalna veličina poruke koja se može poslati je 5MB.

Registracija uputnice

Ovaj slučaj uporabe opisuje interakcije (poruke zahtjeva i odgovora) koje se koriste za registraciju nove SGP uputnice. Nakon registracije uputnice, uputnici se dodjeljuje jedinstveni identifikator koji se koristi u svim ostalim servisima i kliničkim dokumentima kako bi se definiralo da određeni podatci ili poruke pripadaju toj uputnici.

Kako bi se mogla registrirati uputnica potrebno je prije toga registrirati posjetu korištenjem Usluge za upravljanje posjetama. Usluga vraća jedinstveni identifikator posjete kojeg korisnik mora navesti u uputnici.

Za slanje uputnice koristi se FHIR resurs ServiceRequest. Profil uputnice se nalazi ovdje.

Uz uputnicu moguće je priložiti i razne dokumente (slike, scanove, PDF dokumente, etc.). Za slanje priloženih dokumenata koriste se DocumentReference resursi koji se u poruci zahtjeva (message request) šalju kao dodatni entry-ji u message bundle poruci. U poruci odgovora dokumenti će biti vraćeni kao contained resursi unutar ServiceRequest poruke (https://www.hl7.org/fhir/references.html#contained).

Uputnica se šalje kao FHIR poruka (FHIR message) u skladu sa FHIR messaging specifikacijom (https://www.hl7.org/fhir/messaging.html).

Specifikacija podataka poruke zahtjeva za registraciju nove uputnice se nalazi ovdje.

Specifikacija podataka poruke odgovora na zahtjev se nalazi ovdje.

Sigurnost

Za kreiranje uputnice krajnji korisnik mora imati jednu od slijedećih uloga:

  • specialist

Odobravanje uputnice

Ovaj slučaj uporabe opisuje interakcije (poruke zahtjeva i odgovora) koje se koriste za odobravanje SGP uputnice. Nakon registracije uputnice, uputnici se dodjeljuje jedinstveni identifikator koji se koristi u svim ostalim servisima i kliničkim dokumentima kako bi se definiralo da određeni podatci ili poruke pripadaju toj uputnici.

Kako bi se mogla registrirati uputnica potrebno je prije toga registrirati posjetu korištenjem Usluge za upravljanje posjetama. Usluga vraća jedinstveni identifikator posjete kojeg korisnik mora navesti u uputnici.

Za slanje uputnice koristi se FHIR resurs ServiceRequest. Profil uputnice se nalazi ovdje.

Uz uputnicu moguće je priložiti i razne dokumente (slike, scanove, PDF dokumente, etc.). Za slanje priloženih dokumenata koriste se DocumentReference resursi koji se u poruci zahtjeva (message request) šalju kao dodatni entry-ji u message bundle poruci. U poruci odgovora dokumenti će biti vraćeni kao contained resursi unutar ServiceRequest poruke (https://www.hl7.org/fhir/references.html#contained).

Uputnica se šalje kao FHIR poruka (FHIR message) u skladu sa FHIR messaging specifikacijom (https://www.hl7.org/fhir/messaging.html).

Specifikacija podataka poruke zahtjeva za odobravanje uputnice se nalazi ovdje.

Specifikacija podataka poruke odgovora na zahtjev se nalazi ovdje.

Sigurnost

Za kreiranje uputnice krajnji korisnik mora imati jednu od slijedećih uloga:

  • specialist