Osasun-arloko erabiltzaile-interfazeak

Lily-rekin software klinikoa eraikitzen duten taldeentzako gida: atari klinikoak, emaitzak eta txostenak, sendagaien preskripzioa eta administrazioa, erabakiak hartzeko laguntza eta ospitaleetako aginte-panelak.

Orri honen itzulpenak berrikusi gabeko makina-zirriborroak dira. Ingelesezko orria da erreferentziazko bertsioa.

Zer egiten duen Lily-k eta zer ez

Lily-k bistaratze-kontratuak ematen dizkizu: markaketa semantikoa, ARIA, teklatuaren portaera eta pantaila klinikoetan errepikatzen diren gauzetarako klase-gakoak. Ez dizu ematen logika klinikorik, eduki klinikorik edo erregulazio-aldarrikapenik.

Zer eskaintzen duen Lily-k eta zer eskaintzen duzun zuk
Lily-k eskaintzen du Zuk eskaintzen duzu
observation-view: balioa, unitatea, hitzez adierazitako bandera, barrutia eta balio falta denaren egoerak Balioa, banderari buruzko erabakia, erreferentzia-barrutia
allergy-record-list eta allergy-record-list-item: inoiz hutsik ez dagoen egoera Alergiaren erregistroa eta haren terminologia
medication-view: izena, indarra, forma, bidea eta maiztasuna, ezer laburtu gabe Sendagaiaren datuak, tall man segmentuak, formatutako indarra
decision-support-card: CDS Hooks txartelaren forma Arauak, iradokizunen ekintzak, emaitza erregistratzea
early-warning-score-view: puntuazioa, tartea eta eskalatzea, bistaratuta Puntuazio-sistema eta haren kalkulu baliozkotua
age-view eta ageParts(): adin bat egokitzen zaizkion unitateetan Unitateen hitzak (Intl.DurationFormat edo zeure etiketak)
formatQuantity(): 5 mg, inoiz ez 5,0 mg; 0,5 mg, inoiz ez ,5 mg Zenbakia, unitatea eta lokalizazioa
Pazientearen banner-aren osaera Etiketa eta balio guztiak, eta nork ikus dezakeen informazio klinikoa

Erregulazioa. Puntuazio bat, pertzentil bat, dosi bat edo sendagaien elkarrekintza bat kalkulatzen duen softwarea gailu mediko bat izan ohi da. Lily-k ez du horietako bat ere kalkulatzen, nahita. Zure produktua erregulatuta badago, zeuk zaitu haren erabilgarritasun-ingeniaritzaren fitxategiaren arduraduna (IEC 62366-1, FDAren giza faktoreei buruzko gidak, EU MDR). Lily-ren probak, bere buruari egindako irisgarritasun-betetze txostena eta pantaila-irakurgailuen matrizea froga izan daitezke fitxategi horretan; horietako bat ere ez da betetze-aldarrikapena, eta matrizeak ez du oraindik emaitzarik.

Alertak: eten kritikoa denagatik soilik

Alerten nekea segurtasun-arazo bat da: alerta guztiek eteten dutenean, jendeak guztiak baztertzen ditu. AHRQren gidaritza alertak larritasunaren arabera mailakatzea da, eta larriak soilik eten ditzaten egitea.

  • Informazioa (indicator="info"): lerroan txertatua, zereginaren ondoan, orriko erabakiak hartzeko laguntza-txartel bat.
  • Abisua (indicator="warning"): ikusgai blokeatu gabe, txartel bera, nabarmentzeko estilatua; modalik ez.
  • Kritikoa (indicator="critical"): jarri txartela alerta-elkarrizketa batean, eta eskaini overrideReasons, baztertzeak arrazoia eska dezan.
  • Erabakiak hartzeko laguntza-txartel bat ez da inoiz eskualde bizia berez. Iragarri txartel kritiko berri bat fokua elkarrizketara eramanez, ez aria-live bidez.
  • Kendu txartela erantzun zion gertaera berriro gertatzen denean, eta erregistratu emaitza bakoitza (onartua, edo arrazoiarekin gainidatzia).

Paziente okerraren akatsak: identifikatu, ez mugatu

  • Erakutsi bi identifikatzaile pazientearen datuak agertzen diren leku guztietan: izena jaiotza-datarekin, eta identifikatzaile nazionala bere ikusizko osagaiarekin (The Joint Commission, Quick Safety 45).
  • Erabili pazientearen banner-a paziente baten erregistroan jarduten duen pantaila guztietan, eta eduki ikusgai.
  • Banner-ean dagoena ez den beste erregistro batean ekintza bat egin aurretik, berretsi izenarekin, jaiotza-datarekin eta identifikatzailearekin.
  • Pazientea ez den beste norbaiti buruzko sarrera batek (guraso baten aurrekariak, fetu bat, emaile bat) lehenik hitzez esaten du norena den: eman erregistroko elementuei subjectLabel («Ama»), senide baten diagnostikoa inoiz pazientearena bezala irakur ez dadin (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ez mugatu zenbat erregistro ireki ditzakeen klinikari batek: 3.356 klinikariren zorizko saiakuntza batek (JAMA, 2019) aurkitu zuen horrek ez zuela paziente okerrerako eskaerak murriztu, eta jendeak saihestu egiten duela.
  • Erregistro bakar baten gaineko ekintzen menuak erregistro hori izendatzen du lehenik, honekin: subjectLabel , context-menu edo dropdown-menu osagaian («Ada Lovelace, tentsio arteriala aza. 3»): lehen zati ez-interaktibo bat, menuaren izen irisgarria ere badena.
  • Sailkatu ekintza bakoitza egiten duenaren arabera, eta egin maila ikusgai exekutatu aurretik. Ohikoa (ikusi, inprimatu) berehala exekutatzen da. Dokumentatua erregistroan zer idatziko duen esaten du («Ohar bat gehitzen dio kontsultari»). Klinikoa (eten, agindu bat bertan behera utzi) bigarren aldiz galdetzen du, alert-dialog batean, zeinaren berresteko botoia aditza baita («Eten»), inoiz ez «Ados» edo «Bai». Ezagutarazlea (larrialdiko sarbidea, zaintza-taldetik kanpo partekatzea) lehenik arrazoi bat eskatzen du eta erregistratu egiten du.
  • Hainbat erregistro irekita daudenean (fitxak, leihoak, panel zatituak), fitxa bakoitzaren testu ikusgaiak eta izen irisgarriak pazientearen izena eta bigarren identifikatzaile bat dituzte, panel aktiboak banda errepikatzen du, eta ekintza bat ere ez da aplikatzen bere paneleko pazientea ez den beste bati.
  • Erakutsi erregistroak zein lekuri egotziko zaizkion (saioa hastean aukeratutako unitatea, kontsulta edo zentroa) testu gisa orriaren goiburuan, eta egin aldatzea ekintza esplizitu.
  • Erakutsi bisita aktiboa, edo «Ez dago bisita aktiborik», bandan. Bisita behar duen inprimaki batek hala esaten du eta bat hastea eskaintzen du, gordetzean huts egin beharrean.

Pazientearen banner-a

Osaera medical-banner-ekin dokumentatuta dago, SvelteKit adibide-aplikazioko /patient-banner orri funtzional batekin:

  • bi identifikatzaile, eta adina jaiotza-dataren ondoan;
  • alergiak alergia-zerrenda baten bidez, «alergiarik ez da ezagutzen», «erregistratu gabe» eta «ez dago eskuragarri» inoiz berdin ez ikusteko;
  • falta den balioa hitzez idazten da («Ezezaguna»), inoiz ez galdera-ikur, marratxo edo gelaxka huts bidez;
  • hildako paziente bat: data-deceased gaiarentzat, eta testu-lerro ikusgai bat, inoiz ez kolorea bakarrik;
  • ez da eremurik laburtzen, mozten edo ezkutatzen zabalera batean ere; lerro-jauzia egiten du.
  • pazientearen alertak («Interpretea behar du», «Infekzio-arriskua») hitzezko tag-group etiketatu bat dira, inoiz ez ikonoak edo kolorea soilik, eta ikusgai jarraitzen dute banda lerroz aldatzen denean.

Emaitzak

  • Emaitza baterako bista bakarra, edozein sistematatik etorrita ere: behaketa-bista.
  • Bandera zure itzulpeneko hitzak dira (flagLabel), FHIR interpretazio-kodea data-interpretation gisa gaiarentzat.
  • Bereizi emaitza berriak aurreko emaitzetatik, eta erakutsi joera bat (sparkline bat, edo lerro-grafiko bat bere datu-taularekin): klinikariek aldaketa esanguratsu bat bilatzen dute, ez barrutia bakarrik.
  • Inoiz erregistratu ez zen emaitza bat eta eskuragarri ez dagoen bat egoera desberdinak dira, hitz desberdinekin.
  • Ezezaguna ez da normala. Erreferentzia-tartea falta duen, oraindik kargatzen ari den edo irakurtezina den emaitzak ez du interpretaziorik eta hala esaten du; observation-view ez du inoiz interpretaziorik ondorioztatzen, beraz tartea izan baina interpretation ez duen emaitzak ez du markarik erakusten.
  • Eskalaz kanpoko emaitza tresnaren muga da konparatzaile batekin («> 33,3 mmol/L»: formatQuantity eta ">") eta zure marka kritikoarekin, inoiz ez zenbaki soil bat. Gutxi gorabeherako balioak bere ≈ gordetzen du ("~").
  • Eman izendatutako tarte gehigarriak («Kritikoa: 2,5 azpitik») rangesgisa, bakoitza bere zatian.
  • Zuzendutako edo aldatutako emaitzak ordeztu zuen balioa gordetzen du, <del>batean, noiz aldatu zen zure hitzekin (previousValue, previousLabel), balio zaharra irakurri zuen klinikariak aldatu zela jakin dezan.
  • Tarte-neurketa batek bere zabalera eta funtzioa esaten ditu («Batez bestekoa, 24 ordu»), eta neurketaren egoera eta metodoa («Eserita, eskumutur handia») ondoan dagoen testu ikusgaia dira, inoiz ez argibide bat soilik (openEHR INTERVAL_EVENT, state, protocol).
  • Joera batek puntu konparagarriak behar ditu: ez marraztu lerrorik zure gutxienekoaren azpitik, eten lerroa metodoa edo analisia aldatu zen lekuan, eta esan norabidea eta esanahia hitzez («jaisten, hobetzen»).
  • Unitate-sistema batean sartutako bizi-konstanteek bestea erakuts dezakete ondoan zure testu gisa («70 kg (154 lb)»); Lily-k ez du ezer bihurtzen, beraz adierazi zure biribiltzea. Sartu kantitate bat quantity-input-divbidez; haren zenbakiak unitate bakoitzaren mugak hartzen ditu.
  • Hazkuntza-kurba bat line-chart bat da, zure pertzentil-lerroak serie gisa, haurraren puntuak eta adinaren eta balioaren datu-taula; Lily-k ez du pertzentilik kalkulatzen eta ez du hazkuntza-erreferentziarik ematen.

Sendagaiak

  • Izen generikoak letra xehez, FDA eta ISMP zerrendetako tall man letrak izan ezik, edo zure herrialdekoak (Australiak eta Kanadak beren zerrendak argitaratzen dituzte). Markatu itzazu nameSegments-en; Lily-k ez ditu inoiz asmatzen.
  • Idatzi indarra formatQuantity-rekin: amaierako zerorik gabe, hasierako zeroarekin, unitatearen aurretik tarte hautsezin batekin.
  • Mantendu emaitzaren konparatzailea: formatQuantity(5, "mmol/L", locale, "<")-k «<5 mmol/L» idazten du. FHIRen Quantity.comparator <, ≤, ≥ edo > gisa idazten da; kenduz gero, «5 baino gutxiago» «5» bihurtzen da.
  • Idatzi mL, inoiz ez cc, eta saihestu ISMPren akatsetarako joera duten laburduren zerrendako laburdura guztiak.
  • Ez laburtu inoiz sendagai baten izena edo dosia.

Datak eta orduak

  • Idatzi hilabetea testu gisa, data bat bi eratan irakur ez dadin (Intl.DateTimeFormat month: "short"-ekin).
  • Aukeratu erlojua nahita: pasatu hourCycle esplizituki. NHSk 24 orduko erlojua eskatzen du; hori Erresuma Batuko arau bat da, ez mundukoa, beraz Lily-k ez du inoiz zure ordez hautatzen.
  • Adinak Common User Interface-ren bandak jarraitzen ditu ageParts() bidez; beste konbentzio bat duen zerbitzu batek bere hitzak pasatzen ditu.
  • Hilabetera edo urtera arte bakarrik ezagutzen den data horrela geratzen da: eskatu date-field precision="month" edo "year"bidez, gorde 2019-03 edo 2019gisa, eta idatzi formatPartialDate()bidez. Ez asmatu inoiz egunik.
  • Iraupen bat duration-viewda, <time datetime="P3DT4H"> bat zure hitzekin, hauetatik: durationParts() eta Intl.DurationFormat.

Aginte-panelak

  • Ataleko taula batek edo komando-zentroko pantaila batek maiz eguneratzen dira. Ez iragarri inoiz aldaketa bakoitza: eduki laburpen-eskualde ohiko bat («3 ohe libre, 2 alta espero») eta utzi jendeari taula irakurtzen.
  • Taula bateko egoera guztiak (ohe garbia, okupatua, blokeatua) testua dira edo hitzak dituen data-* egoera, inoiz ez kolorea bakarrik.
  • Ezer ez da keinuka (WCAG 2.2.2, 2.3.1), eta tenporizadore batekin eguneratzen den taulak pausa-kontrol bat du edo eskatzen denean bakarrik eguneratzen da; eguneratzeek ez dute inoiz fokua mugitzen. Atzeratutako sarrera batek hitzez esaten du («20 minutu baino gehiago itxaroten») eta data-overdue.
  • Zenbaketa edo tasa batek bere izendatzailea erakusten du («68tik 12») eta atzean duen zerrendarako esteka ematen du.
  • Zerrenda edo kronologia batek zeren ikuspegia den esaten du: zer erakusten duen, bere ordena eta denbora-tartea, zer dagoen ezkutatuta eta zergatik, eta zein iturrik ez zuten erantzun. Erantzun ez zuen iturri baten zerrenda hutsak ez du frogatzen ezer ez dagoenik.
  • Oroigarri-zerrenda bat record-list bat da, zeinaren elementuek epemuga bat (review-date) eta epe-egoera bat hitzez daramaten, data-duerekin; hura sortu zuen araua zurea da.

Inprimakiak

  • «Bai», «ez» edo «ez da galdetu» erantzuten den galdera bat hiru erantzuneko radio-group bat da, hasieran bat ere aukeratu gabe, inoiz ez kontrol-lauki bat: kontrol-lauki batek ezin du «ukatua» eta «inoiz ez da galdetu» bereizi. Sistemen berrikuspena gorputz-sistema bakoitzeko fieldset bat da, eta «gainerako guztiak ez daude» botoiak erantzun gabekoak bakarrik ezartzen ditu.
  • Erantzun-zerrenda bat duen galdera bat (botikak, helbideak) repeatable-fieldsetbat da: elementu bat gehitzen edo kentzen da, fokuak jarraitzen dio, eta kentzeko botoi bakoitzak bere elementuaren izena darama.
  • Koma hamartarra duen zenbaki bat: erakutsi Intl.NumberFormat bidez eta, type="number" komak onartzen ez duen lekuan, hartu testu-eremu batean inputmode="decimal" erabiliz eta aztertu zure kodean. Ez aldatu inoiz pertsonak idatzitako balio bat, ezta tarte batera mugatzeko ere: tartetik kanpoko balioa ikus dezakeen errore bat da.
  • Aukeren zati bat bakarrik aldi berean erakusten duen zerrenda luze batek aria-setsize eta aria-posinset ezartzen ditu aukera bakoitzean, eta gogoan du orrian bilatzeak ez duela gainerakoa ikusten.

Erregistroak, oharrak eta haien jatorria

  • Esan zerrenda edo sareta bat zeren ikuspegia den, errenkadak baino lehen: denbora-tartea eta ordena, zer uzten duen kanpoan eta zergatik, eta zein iturrik ez zuten erantzun («Azken 12 hilabeteak, berrienak lehenik. Familia-medikuaren erregistroak ez zuen erantzun.»). Eman record-list eta timeline-list osagaiei coverageLabel, eta data-grid laguntzaileari bere coverageLabel. Erantzun ez zuen iturri baten zerrenda hutsak hitzez esaten du, inoiz «ezer ez erregistratua» bezala irakur ez dadin.
  • Esan erregistro bat nondik etorri den eta behin betikoa den record-provenance-viewbidez: sinatua, sinaduraren zain, aldatua, gailu honetan gordea eta oraindik bidali gabea. Sinatu gabeko zirriborro batek ez du inoiz sinatua dirudien.
  • Beste norbaiti buruzko sarrera batek (guraso bat, fetu bat, emaile bat) lehenik norena den esaten du, erregistroko elementuen subjectLabel.
  • Atxikitako sarrera bat zerrendan geratzen da zure hitzekin («Mugatua: ez dago zuretzat eskuragarri»), eta akatsez egindako sarrera bat marratuta geratzen da «Akatsez sartua» testuarekin: eman record-list-item edo timeline-list-item osagaiari entryState eta entryStateLabel. Ez kendu inoiz bietako bat isilean, hutsune bat «ez da ezer gertatu» bezala irakurtzen baita.
  • Ohar kliniko batean, markatu pasarte bakoitzaren iturria (idatzia, diktatua, txantiloia, aurrera kopiatua, sortua) data-source eta hitz ikusgaien bidez, kopiatutako edo sortutako testua gaurko azterketatzat inoiz har ez dadin.
  • Kargatu ezin den atal bat unavailable da zure hitzekin, berriro saiatzeko botoi batekin; kode tekniko bat, erakusten bada, zabaltzeko elementu baten atzean dago. Pertsona baten ekintzak eragindako hutsegitea iragartzen da, erregistroak orain duen balioarekin; orria kargatzean gertatutakoa ez.
  • Agindu baten historia timeline-listbat da, urrats bakoitzeko elementu bat (planifikatua, programatua, aktiboa, etena, osatua, ezeztatua) bere ordu eta arrazoiarekin, eta uneko egoera elementuan ere bai.

FHIRtik Lilyra

Lily-k ez ditu FHIR baliabideak irakurtzen; zure kodeak Lily-ren props-etara mapatzen ditu. Taula hauek HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4) mapatzen dute. Kodeen mapaketa iradokizun bat da: zure segurtasun klinikoaren berrikuspenak erabakitzen du, eta egoera bakoitzerako hitzak zureak dira.

IPS atalak eta haien Lily osagaiak
IPS atala Lily
Alergiak eta intolerantziak (48765-2) allergy-record-list eta bere elementuak
Medikazioaren laburpena (10160-0) medication-record-list, elementu bakoitzak medication-view bat duela
Arazo-zerrenda (11450-4) problem-record-list eta bere elementuak
Immunizazioak (11369-6) immunization-record-list eta bere elementuak
Emaitzak (30954-2) observation-view, datu-taula batean edo laburpen-zerrenda batean
Prozeduren historia (47519-4) procedure-record-list eta bere elementuak
Gailu medikoak (46264-8) device-record-list eta bere elementuak
Alertak (104605-1) Ohar-testu bat edo alerta bat, inoiz ez tolestutako kontrol baten atzean
Beste edozein atal record-list eta bere elementuak
Dokumentuak uzten duen derrigorrezko atal bat Atalaren zerrenda, status="omitted" duena
FHIR kodeak eta haien Lily balioak
FHIR Lily
emptyReason nilknown Zerrendaren status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", zein den esaten duten hitzekin
no-known-allergies, no-known-medications eta antzeko IPS kodeak status="none-known"
no-allergy-info, no-medication-info eta antzeko IPS kodeak status="not-recorded"
AllergyIntolerance.criticality criticality, erreakzio baten severity-tik bereizita
clinicalStatus, verificationStatus Props berak alergia- eta arazo-elementuetan, kode berekin
MedicationStatement.status Medikamentu-elementuaren status
Dosage.text medication-view dosageText
Observation.status observation-view status, kode berekin
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (erregistro-zerrendetan ere bai)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Mapatu entered-in-error erregistro bat bere entered-in-error egoerara, hitzekin, isilean baztertu beharrean: erakutsi behar den ala ez zure zerbitzuaren erabakia da.

openEHR-etik Lily-ra

Lily-k ez ditu openEHR konposizioak ere irakurtzen. openEHR Erreferentzia Ereduaren datu-moten eta kodeen mapaketa, zure segurtasun kliniko berrikuspenak erabakitzen duen proposamen gisa:

openEHR datu-motak eta kodeak, eta haiei dagozkien Lily balioak
openEHR Lily
DV_QUANTITY (sarrera) quantity-input-div; unitateak UCUM kode gisa zure hitzekin
DV_QUANTITY (bistaratzea), magnitude_status observation-view eta formatQuantity(value, unit, locale, comparator) (~ ≈ da)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges eta meaning observation-view ranges
DV_DATE partziala (urtea, urtea eta hilabetea) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view eta durationParts()
DV_PROPORTION formatProportion() barruan: observation-view
DV_ORDINAL, DV_SCALE radio-group bat, etiketek zenbakia eta haren hitzak dituztela
DV_CODED_TEXT behean dagoen balio kodetuen eredua
DV_BOOLEAN checkbox-input, «ez da galdetu» gertatu ezin denean bakarrik
ELEMENT.null_flavour 253 ezezaguna, 271 informaziorik ez status="not-recorded" edo "unavailable", zein den esaten duten hitzekin
null_flavour 272 ezkutatua observation-view status="masked"
null_flavour 273 ez dagokio status="not-applicable"
PARTY_RELATED subjektua subjectLabel erregistroko elementuetan
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Instruction State Machine urratsak urratsen timeline-list bat, uneko egoera elementuan
agerraldi hauek dituen arketipo-elementua: 0..* repeatable-fieldset

Kodetutako balioak

  • Erakutsi Coding.display; ez badago, CodeableConcept.text; bat ere ez badago, system|code. Inoiz ez gelaxka huts bat.
  • Eskaini kontrol bat, balio bakoitzaren ondoan kode-sistema eta kodea erakusten dituena, adibidez «Erakutsi kodeak» dioen txandakatze-botoi bat. Ezkutuko kodeak irakurketa-ordenatik kanpo geratzen dira erakutsi arte.
  • Markatu testu klinikoa dokumentuaren hizkuntzarekin (lang), interfazearenarekin ez datorrena izan daitekeena. Itzuli interfazea; ez itzuli inoiz eduki klinikoa.
  • Lily-k ez du terminologiarik ematen: ez SNOMED CT, LOINC, ATC edo UCUM bilaketarik. Idatzi dokumentuak dioena. SvelteKit adibidearen /patient-summary orriak eredua erakusten du.

Zer ez duen egingo Lily-k

  • Ez du kalkulatuko alerta goiztiarraren puntuaziorik, hazkunde-pertzentilik, dosirik edo erreferentzia-barrutirik.
  • Ez du bidaliko sendagai-datu-baserik, tall man zerrendarik, ezta SNOMED CT, CIE, LOINC edo UCUM kodeak.
  • Ez du erreproduzituko lizentziadun tresna bat (Wong-Baker FACES) edo beste erakunde baten diseinua (NEWS2 diagrama).
  • Ez du mugatuko aldi berean irekitako erregistro kopurua.
  • Tarte batetik interpretazio bat ondorioztatu, unitate bat bihurtu edo data erlatibo bat («datorren asteartea») aztertu.
  • «Bai, ez edo ezezaguna»-rako etengailu bat erabili: ARIAren switch ez du hirugarren egoerarik, beraz hiru aukera-botoi dira.

Gida honen atzean dauden ikerketa, iturri eta erabakiak spec/healthcare-ui-n daude.