omahoito/rfc

Request for Comments and Change process for ODA Application Interfaces

rfc's Issues

Oireiden tallennus FHIR resurssina

Selvitetään kuinka mallinnetaan oirearviovastaukset, joita ei voida FinnishPHR Observation profiilin mukaisina Observation resursseina tallentaa. FinnishPHR rajoittaa Observationeiden käytön vain fysiologisiin mittauksiin ja koodistona on LOINC.

Laitteen tunniste

Tarvitaan:
malli
käyttöjärjestelmä
laitemalli
laitetunniste IMEI/IMSI
tuotteen nimi
tuotekoodi

Kooditussysteemien formaatti ODA1-ODA2 FHIR-kommunikaatiossa

Kun validoin palauttamiamme ActivityDefinitioneita selvisi, että code-kentässä olevien system-arvot (eli kooditussysteemit) eivät olleet standardin mukaisia. Tähän asti ollaan palautettu vain raaka OID-arvo, esim 1.2.246.537.6.49, mutta FHIR haluaa URI:n.

Validointia voi läpäistä quick and dirty laittamalla urn:oid: sen koodin eteen, mutta jos halutaan olla oikeaoppisia niin pitäisi noudattaa tätä algoritmia:

1. If the code system is found in https://www.hl7.org/fhir/terminologies-systems.html use the URL provided there.
2. If the publisher of the code system has defined a specific URL to use with FHIR, use that.
3. If the code system can be found in http://registry.fhir.org/NamingSystem and its status is active, use that.
4. If an OID is registered at http://hl7.org/oid use the form 'urn:oid:[oid]' where [oid] is the original OID.
5. If all else fails, come up with your own unique URL.

Tässä gistissä olen yrittänyt mäpätä OID:t ylläolevan algoritmin mukaisesti. Kaikkia systeemejä ei välttämättä käytetä MVP:ssä tai edes ODA:ssa, mutta ainakin kotimaan koodisysteemit olisi hyvä määrittää hyvin. Juuri nyt esim. FinLOINC ja KL käyttävät keksittyä URL:ää, ja Suomen versio ICD-10:stä on varmaan syytä huomioida erikseen, nyt laitettu FHIR:in oma ICD10-url sinne.

Tiedoston lopussa on meidän custom-koodit, eli pieniä sisäisiä koodistoja jotka tulevat tarpeen FHIR-viesteissä. Niiden nimiä voi vielä viilata jos haluaa.

Pyydän siis inputtia sekä Duodecimin sisällöntuottajilta että ODA:n puolelta, kommentoikaa tähän issueen tai suoraan Gistiin. Tässä linkki vielä kerran: https://gist.github.com/vlindhol/09290d2386946e06ad21919f6c28bb86

Oirearvioihin metatiedot kategoriointia varten

Oirearvioiden kategoriointiin tarvitaan oda2:ssa metatietoja.
Olisiko oda1:ssä mahdollisuus lisätä oirearvioihin alla esitetyt metatiedot?

"meta": {
	"profile": [
		"http://phr.kanta.fi/StructureDefinition/fiphr-questionnaire-stu3"
	],
	"tag": [{
			"system": "http://oda.fi/Questionnaire",
			"code": "symptom"
		},
                {
			"system": "http://oda.fi/cds",
			"code": "oda1"
		}
	]
} 

Templateista pohjaesitys.

Message

ODAssa ammattilainen ja potilas viestii push-viesteinä kommentteina tapahtumiin.

Person, Message, ref to Event in CarePlan or another Message, timestamp, read (y/n)
Person, Notification, ref to Event in CarePlan and Message, timestamp, read (y/n)

Terveystarkastus 153: palauterajapinta heittää poikkeuksen

Unknown error: TypeError: Cannot read property '0' of undefined

Terveystarkastus_153_filled_teksti .txt

Valmennukset ODA1-ODA2 rajapinnassa

Tee kuvaus ODA1-ODA2 välisestä rajapinnasta valmennusten osalta. Alla 4.5.17 käydyn keskustelun tiivistelmä.

• mikä on ODA1:n rooli valmennuksissa
  • ODA1 tuottaa sisältöä ja ODA2 näyttää sen käyttöliittymässä kansalaiselle
  • ODA2 huolehtii valmennustietojen näyttämisestä ammattilaiselle, jos tarpeen
• Yksinkertainen malli
  • ODA2:ssa kansalainen valitsee käyttöönsä jonkin valmennuksen
  • ODA2 lähettää tiedon ODA1:lle, mikä valmennus valittu
  • ODA1 lähettää valmennuksen sisällön ODA2:lle
    • Kansalaiselle näytetään aina vain viikko kerrallaan
    • Toteutus avoinna, kumpi määrittää näyttämisen rytmityksen
    • Tarvitsee versionhallinnan, jotta käyttäjällä ei voi mennä sekaisin uusi ja vanha versio
  • Keskeyttämistoiminnallisuuden tarve ja toteutus?
  • Seurantatietojen kommentointi ja palautteen anto kansalaiselle?
• tietomalli ja rajapinta
  • Valmennusviesti voisi olla samankaltainen kuin oirearvioiden palaute ja osa kyselyiden sisällöstä
    • itse valmennusviesti on tekstiä, kuvia ja linkkejä
    • Lisäksi tehtävät annetaan rakenteisessa muodossa, jotta ODA2 voi niitä viedä käyttöliittymään kansalaisen seurattavaksi
• Jatko
  • Rajapinnat
    • ensimmäisenä listaus käytössä olevat valmennukset
    • viestien saanti ODA2:lle
    • ehdotus rajapinnoista ja tietomalleista Githubiin, jonka kautta kommentointi

Oirearviot antaa "Failsafe" ilmoituksen jos vastaa vain haluavansa itsehoitoa

Valitset näin:

Saat vastauksen:

Eikö tässä kuuluisi kytkeä palautteeksi itsehoito-ohje?

Palvelutuote osana toimintasuositusta (palvelukoodi + kiireellisyys)

Oirearvion antama toimintasuositus sisältää ehdotetun palvelun koodin sekä lääketieteellisesti arvioiden kiireellisyyden. Nämä on ilmaistu erillisillä koodeilla, jolloin niiden hallinnointi ODA2:ssa on hankalaa. Tarvitaan ehdotus, miten palvelun luokka ja kiireellisyys saadaan muodostamaan palvelutuote, johon palveluntuottajat voivat reagoida tarjoamalla oikeanlaisia palveluita.

Terveystarkastus 153: sisällölliset huomiot

Muutamia "käyttäjän" huomioita sisällöstä:

• Voiko kysymystä "Kuinka pitkä olet?" tarkentaa esim. "Kuinka pitkä olet (cm)?" tai lisätä esimerkin vastausmuodosta. Onko vastausmuodolla merkitystä? 175 vs 1.75 vs 1,75
• Muissakin kiloja tai senttejä koskevissa kysymyksissä voisi esimerkki tai tarkennus kirjaamismuodosta
• Onko mahdollista lisätä "En tiedä" vaihtoehto? Mikä on angina pectoris? Kaikki eivät välttämättä osaa vastata näihin ja vastauksen pakollisuus estää lomakkeen lähetyksen :
  

CDS hooks proto

käyttökontekstikatalogi
kontekstissa tietotarve

http://cds-hooks.org/#calling-a-cds-service
https://fhir-test.ebmedscloud.org/
http://wiki.hl7.org/index.php?title=201701_CDS_Hooks

Kela PHR -historiatietojen käyttö jatkokehityksenä

rajapinnan versionhallinta

Miten hallitaan tilanteet, joissa julkaistaan uusi lomakeversio, mutta se esim. jostain syystä ei mene validoinnista läpi ja ODA2 käyttää edelleen vanhaa versiota. Toteutuksessa huomioitava Omatietovaranto, miten päivitykset siirtyvät sinnekin.

SELVITÄ miten lomakkeet julkaistaan riittävällä SLA:lla ja kapasiteetilla?

Oirearvio 22: Kysymykset eivät näy

Kysymysten enableWhen ehto viittaa kysymykseen 584, jota ei ole olemassa. Tämä estää kysymysten näyttämisen.

REST komennot.

Jukka ja Tommi tekee pohjaehdotuksen.

Katselmoidaan mihin Swaggeria voisi käyttää.

Oirearvio 124: Kuva ei näy

"Verestävä silmä" ei näy. Ongelma ilmeisesti linkissä. "http://www.terveysportti.fi/xmedia/ima/370.121.jpg"
pitäisi olla "https://www.terveysportti.fi/xmedia/ima/370.121.jpg"

Ajanvaraus

Oirearvio 41: "Kuinka monta kertaa joudut ulostamaan vuorokauden aikana?" hyväksyy vastauksen desimaalin tarkkuudella

Tyyppinä on "decimal". Tulisiko olla "integer"?

Oirearvio 41: null-arvo tekstikentässä

Instructions for tools

Instructions for FHIR editing tools on

• Linux
• PC
• Mac

Oirearvio 21: Lisätietoa on pakko kirjata vaikka kysymystekstin perusteella näin ei ole

Oirearvioihin versionumero

Oirearvioihin tarvitaan mukaan versionumero että tiedetään esim. millä versiolla eri pilotteja on tehty. Versionumero voi olla mahdollisesti suoraan VKT versionumero, joka lisätään Questionnairen "version" attribuutiksi.

Markdown HTML:n sijaan rich text -sisällön esittämiseen

FHIR-speksi viittaa XHTML:n lisäksi markdowniin vaihtoehtona: https://hl7.org/fhir/extension-rendering-markdown.html

Olisiko järkevää siirtyä päätöksentuen ym. rajapinnoissa markdown-sisältöön?

Vrt. #35

Poista syntymäajan ja sukupuolen legacy-vaatimus

Poista syntymäajan ja sukupuolen legacy-vaatimus niin että nämä tiedot kysytään questionnairessa vain silloin kun tarvitaan.

Ehdotus terveystarkastuksen rajapinnasta

Tee ehdotus, miten STAR:n terveystarkastus toimii ODA1-ODA2 välillä. Miten kansalaisen antamat vastaukset välitetään ODA1:lle ja miten tulkinnat ja palautteet välitetään takaisin ODA2:lle.

EHDOTA hoitosuositusten mukana suositeltavat palvelukoodit

Merkitse projektinhallintaan tarvittavat koodit http://koodistopalvelu.kanta.fi/codeserver/pages/publication-view-page.xhtml?distributionKey=8189 pohjalta.

Oirearviot 83 & 107: Kysymys itsehoitoarviosta puuttuu

Muissa arvioissa on tämä kysymys alussa:

Onko tarkoitus että olisi näin kaikissa?

Patient - Citizen

Suomalaisessa näin: https://simplifier.net/FinnishPHR/FinnishPatient

Kansainvälisessä näin http://build.fhir.org/patient.html

Tämä objekti on "SubjectOfCare" eli hoidon kohteeksi tullut henkilö. Mikä on henkilön tietomalli ennen kun on tultu hoidon kohteeksi?

Oirearvioiden validointivirheet

Oirearviot 21, 22, 41, 27:
"issue": [ { "severity": "error", "code": "processing", "diagnostics": "Failed to parse request body as JSON resource. Error was: Invalid attribute value "": Attribute values must not be empty ("")" }

Oirearvio 2:
Invalid attribute value "": Attribute values must not be empty ("")

Oirearvio 124:
"diagnostics": "ca.uhn.fhir.parser.DataFormatException: String does not appear to be valid XML/XHTML (error is "Unexpected close tag ; expected
.\r\n at [row,col {unknown-source}]: [1,233]"): <div xmlns="http://www.w3.org/1999/xhtml\">Neuvova itsearviointilomake, joka auttaa potilasta arvioimaan ammattiavun tarvetta ja omahoidon mahdollisuuksia silmäoireiden yhteydessä. Lomake soveltuu vain 15 vuotta täyttäneille.
"

Hengitystieoirearvio Questionnaire

Toteutuksen suunnittelua varten tarvitaan FHIR Questionnaire resurssi hengitystieinfektio-oirearviolomakkeesta

ODA1 kuvaviittaukset https-osoitteiksi

ODA2 tarjoillaan https-yhteydellä, joten ulkoiset salaamattoman yhteyden yli ladattavat kuvat eivät näy.

ölasdkölasdköl

asdasd

Oirearvioiden palautteissa FAILSAFE ym

Oirearvioiden palautteissa on järjestelmällisesti edelleen FAILSAFE merkintä ja ainakin VTI (lomake 21) on muistute "Miehen VTI", joka ei kerro mitään.

Oirearvioiden identifier system on virheellinen

Palautteet vaatii toimiakseen muodon: https://duodecim.fi/fhir/sid/vkt-questionnaire-id Tällä hetkellä useassa airearviossa on: http://duodecim.fi/fhir/sid/vkt-questionnaire-id

Kuvaa päätöksentuen rajapintojen HTML-sisältö

Missä päätöksentuen rajapintojen elementeissä voi palautua HTML-sisältöä? Mitkä ovat sallittuja elementtejä ja niiden sallitut attribuutit?

Jos sisällössä on img-elementtejä, voidaanko linjata että viittaukset ovat HTTPS-osoitteita?

Viitaten #13 #16 ja #19

Kielituki

Miten kielituki toimii käytännössä?

Kielituki? ruotsi, arabia, englanti, venäjä
Resurssissa on kielitieto, miten toistuu tietomallissa?

KIRJOITA sisällönjulkaisusuunnitelma

KIRJOITA .md -tiedosto tähän rfc-repoon, josta ilmenee ODA1 sisällönjulkaisusuunnitelma.

Design guidelinet

Noudatetaanko Master Data -käytäntöjä? Mitä tietomalleja? Mitä transaktiomalleja?

Lisää text QuestionnaireResponse -resurssiin.

Käytetään Snomed CT koodituksen ihmisluettavia nimiä "text" kentässä.

CarePlan

http://build.fhir.org/careplan.html

Terveystarkastus 153: rakennehuomiot

• lomakkeen kategoria puuttuu (onko tarvetta määrittää eri kategoriaan kuin varsinaiset oirearviot? #87)
• validoinnissa virhe: Invalid attribute value "": Attribute values must not be empty ("")
• lomakkeen versio puuttuu
• null tekstit 10kpl
  
  

Jokunen ongelma varmasti korjaantuu "itsestään" uudelleen julkaisulla (?)

Oirearvio 22: "ohjetekstit" näkyy aina kun on vastattu "Arvelen tarvitsevani muuta hoitoa ..."

Seuraavat tekstit ovat aina näkyvissä kun ensimmäiseen kysymykseen vastataan "ARVELEN TARVITSEVANI MUUTA HOITOA JA HALUAN TÄYTTÄÄ OIREKYSELYN" :

• Oireidesi perusteella sinun on aiheellista ottaa välittömästi yhteys päivystykseen. Jos vointisi sallii, voit antaa esitietoja tällä lomakkeella vastaamalla alla oleviin kysymyksiin.
• Jos kuumetta on yli 38,5 astetta, ota yhteyttä päivystykseen välittömästi. Muuten hakeudu päivystysvastaanotolle viimeistään seuraavana aamuna kuumeen edelleen jatkuessa.
• Antamiesi tietojen perusteella yleisvointisi on huonompi kuin yleensä flunssan yhteydessä. Jatka lomakkeen täyttämistä saadaksesi lisäohjeita ja yhteyden ammattilaiseen viimeistään vuorokauden kuluessa.

Oirearvio 3: Kysymykset eivät näy

Kysymysten enableWhen ehto viittaa kysymykseen 12, jota ei ole olemassa. Tämä estää kysymysten näyttämisen.

Oirearvio 22: alle 15-vuotiasta kehoitetaan vastaamaan olemattomiin "alla oleviin kysymyksiin"

Oirearvioiden toimintosuositusten validoinnissa virhe

Oirearvioiden toimintosuositusten validoinnissa virhe:
"issue": [ { "severity": "error", "code": "processing", "diagnostics": "Object must have some content", "location": [ "/ActivityDefinition/timing[x]" ] }, { "severity": "error", "code": "processing", "diagnostics": "This property must be an Object, not a com.google.gson.JsonPrimitive", "location": [ "/ActivityDefinition/participant/role" ] } ]

Pohjaesitys tavasta kommentoida tietomalli.

Oirearvio 21: sama toimintosuositusteksti näkyy useaan kertaan

"Virtsatulehdusoireiden itsearvio 18 - 65 -vuotiaille naisille" palauttaa saman toimintosuositustekstin useaan kertaan tietyillä vastauksilla. Ohessa liitteenä esimerkit zipattuna.

oirearvio21_sample.zip

CareTeam

http://build.fhir.org/careteam.html