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.
| 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 eskainioverrideReasons, 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-livebidez. - 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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-menuedodropdown-menuosagaian («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-dialogbatean, 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-deceasedgaiarentzat, 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-groupetiketatu 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-kodeadata-interpretationgisa 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-viewez du inoiz interpretaziorik ondorioztatzen, beraz tartea izan bainainterpretationez duen emaitzak ez du markarik erakusten. -
Eskalaz kanpoko emaitza tresnaren muga da konparatzaile batekin («> 33,3 mmol/L»:
formatQuantityeta">") 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-chartbat 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. FHIRenQuantity.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.DateTimeFormatmonth: "short"-ekin). - Aukeratu erlojua nahita: pasatu
hourCycleesplizituki. 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-fieldprecision="month"edo"year"bidez, gorde2019-03edo2019gisa, eta idatziformatPartialDate()bidez. Ez asmatu inoiz egunik. -
Iraupen bat
duration-viewda,<time datetime="P3DT4H">bat zure hitzekin, hauetatik:durationParts()etaIntl.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-listbat 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-groupbat 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 bakoitzekofieldsetbat 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.NumberFormatbidez eta,type="number"komak onartzen ez duen lekuan, hartu testu-eremu bateaninputmode="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-setsizeetaaria-posinsetezartzen 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-listetatimeline-listosagaieicoverageLabel, etadata-gridlaguntzaileari berecoverageLabel. 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-itemedotimeline-list-itemosagaiarientryStateetaentryStateLabel. 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-sourceeta hitz ikusgaien bidez, kopiatutako edo sortutako testua gaurko azterketatzat inoiz har ez dadin. -
Kargatu ezin den atal bat
unavailableda 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 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 | 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 | 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-summaryorriak 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
switchez du hirugarren egoerarik, beraz hiru aukera-botoi dira.
Gida honen atzean dauden ikerketa, iturri eta erabakiak spec/healthcare-ui-n daude.