Notendaviðmót í heilbrigðisþjónustu
Leiðarvísir fyrir teymi sem smíða klínískan hugbúnað með Lily: klínískar gáttir, niðurstöður og skýrslugerð, ávísun og gjöf lyfja, ákvörðunarstuðningur og mælaborð sjúkrahúsa.
Þýðingar þessarar síðu eru óyfirfarin vélræn drög. Enska síðan er hin gildandi útgáfa.
Hvað Lily gerir og hvað hún gerir ekki
Lily veitir birtingarsamninga: merkingarbært markup, ARIA, lyklaborðshegðun og klasafestur fyrir það sem klínískir skjáir endurtaka. Hún veitir ekki klíníska rökvísi, klínískt efni eða reglugerðarfullyrðingu.
| Lily býður | Þú býður |
|---|---|
| observation-view: gildi, eining, merki í orðum, bil og ástand þegar gögn vantar | Gildið, ákvörðun um merkið, viðmiðunarbilið |
| allergy-record-list og allergy-record-list-item: staða sem er aldrei auð | Ofnæmisskráningin og hugtakanotkun hennar |
| medication-view: heiti, styrkur, lyfjaform, íkomuleið og tíðni, ekkert stytt | Lyfjagögnin, tall man hlutarnir, sniðinn styrkur |
| decision-support-card: lögun CDS Hooks spjaldsins | Reglurnar, tillöguaðgerðirnar, skráning niðurstöðunnar |
| early-warning-score-view: stig, band og stigmögnun, birt | Stigakerfið og staðfestur útreikningur þess |
age-view og ageParts(): aldur í einingum sem henta honum |
Orðin fyrir einingarnar (Intl.DurationFormat eða þín eigin merki) |
formatQuantity(): 5 mg, aldrei 5,0 mg; 0,5 mg, aldrei ,5 mg |
Talan, einingin og svæðisstillingin |
| Samsetning sjúklingaborðans | Hvert merki og hvert gildi, og hver má sjá klínískar upplýsingar |
Reglugerð. Hugbúnaður sem reiknar stig, hundraðshlutamark, skammt eða lyfjamilliverkun er yfirleitt lækningatæki. Lily reiknar ekkert af þessu, af ásettu ráði. Ef varan þín fellur undir reglugerð átt þú notendaviðmótsverkfræðiskjalið (IEC 62366-1, leiðbeiningar FDA um mannlega þætti, EU MDR). Prófanir Lily, sjálfsmetin skýrsla hennar um samræmi við aðgengi og skjálesaramatrixa hennar geta verið gögn í því skjali; ekkert af því er samræmisfullyrðing og matrixan hefur engar niðurstöður enn.
Viðvaranir: truflaðu aðeins vegna þess sem er alvarlegt
Viðvörunarþreyta er öryggisvandamál: þegar allar viðvaranir trufla afgreiða menn þær allar burt. Leiðbeining AHRQ er að stigskipta viðvörunum eftir alvarleika og láta aðeins þær alvarlegu trufla.
- Upplýsingar (
indicator="info"): í línu, við hlið verkefnisins, ákvörðunarstuðningsspjald á síðunni. - Aðvörun (
indicator="warning"): sýnileg án þess að loka, sama spjald, stílað þannig að það skeri sig úr; enginn modal-gluggi. - Alvarlegt (
indicator="critical"): settu spjaldið inn í viðvörunarglugga og bjódduoverrideReasonssvo að það krefjist ástæðu að hafna því. - Ákvörðunarstuðningsspjald er aldrei lifandi svæði eitt og sér. Tilkynntu nýtt alvarlegt spjald með því að færa fókus inn í gluggann, ekki með
aria-live. - Fjarlægðu spjald þegar atburðurinn sem það svaraði gerist aftur og skráðu hverja niðurstöðu (samþykkt, eða hafnað með ástæðu).
Rangar sjúklingaskráningar: auðkenndu, ekki takmarka
- Sýndu tvö auðkenni hvar sem gögn sjúklings birtast: nafnið með fæðingardegi og landsauðkennið með view-íhlut þess (The Joint Commission, Quick Safety 45).
- Notaðu sjúklingaborðann á hverjum skjá sem framkvæmir aðgerð á skrá eins sjúklings og hafðu hann sýnilegan.
- Áður en aðgerð er gerð á skrá sem er ekki sú í borðanum skaltu staðfesta hana með nafni, fæðingardegi og auðkenni.
-
Færsla um einhvern annan en sjúklinginn (sjúkrasaga foreldris, fóstur, gjafi) segir fyrst með orðum hverjum hún tilheyrir: gefið færslum skrárinnar
subjectLabel(„Móðir“), svo að greining ættingja sé aldrei lesin sem greining sjúklingsins (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Ekki takmarka hve margar skrár læknir má opna: slembiröðuð rannsókn á 3.356 læknum (JAMA, 2019) sýndi að það fækkaði ekki pöntunum fyrir rangan sjúkling og fólk fer í kringum það.
-
Valmynd aðgerða á einni skrá nefnir fyrst þá skrá, með
subjectLabelácontext-menueðadropdown-menu(„Ada Lovelace, blóðþrýstingur 3. nóv.“): ógagnvirkur fyrsti hluti sem er líka aðgengilegt heiti valmyndarinnar. -
Flokkið hverja aðgerð eftir því hvað hún gerir og gerið flokkinn sýnilegan áður en hún keyrir. Venjubundin (skoða, prenta) keyrir strax. Skráð segir hvað hún mun skrifa í skrána („Bætir athugasemd við komuna“).
Klínísk (hætta, afturkalla fyrirmæli) spyr í annað sinn, í
alert-dialogþar sem staðfestingarhnappurinn er sögnin („Hætta“), aldrei „Í lagi“ eða „Já“. Upplýsandi (neyðaraðgangur, deiling utan meðferðarteymis) biður fyrst um ástæðu og skráir hana. - Þegar nokkrar skrár eru opnar (flipar, gluggar, skipt svæði) inniheldur sýnilegur texti og aðgengilegt heiti hvers flipa nafn sjúklingsins og annað auðkenni, virka svæðið endurtekur borðann og engin aðgerð á við annan sjúkling en sjúkling svæðisins.
- Sýnið staðinn sem færslur verða kenndar við (deildina, göngudeildina eða stofnunina sem valin var við innskráningu) sem texta í síðuhaus og gerið það að sérstakri aðgerð að breyta honum.
- Sýnið virka komu, eða „Engin virk koma“, í borðanum. Eyðublað sem þarf komu segir það og býðst til að hefja hana, í stað þess að mistakast þegar það er vistað.
Sjúklingaborðinn
Samsetningin er skjalfest með medical-banner, með virkri síðu á /patient-banner í SvelteKit dæmaforritinu:
- tvö auðkenni, og aldurinn við hlið fæðingardags;
- ofnæmi í gegnum ofnæmislista, svo að „engin þekkt ofnæmi“, „ekki skráð“ og „ekki tiltækt“ líti aldrei eins út;
- gildi sem vantar eru orð („Ekki vitað“), aldrei spurningarmerki, strik eða tómur reitur;
- látinn sjúklingur:
data-deceasedfyrir þemað og sýnileg textalína, aldrei litur einn; - enginn reitur er styttur, klipptur eða falinn á neinni breidd; textinn brotnar um.
-
merkingar sjúklings („Þarf túlk“, „Smithætta“) eru merktur
tag-grouporða, aldrei tákn eða litur einn og sér, og haldast sýnilegar þegar borðinn brotnar.
Niðurstöður
- Ein birting fyrir niðurstöðu, úr hvaða kerfi sem hún kemur: observation view.
- Merkið er orð úr þinni þýðingu (
flagLabel), með FHIR túlkunarkóðanum semdata-interpretationfyrir þemað. - Aðgreindu nýjar niðurstöður frá eldri og sýndu leitni (sparkline, eða línurit með gagnatöflu þess): læknar leita að marktækri breytingu, ekki aðeins bilinu.
- Niðurstaða sem aldrei var skráð og niðurstaða sem er ekki tiltæk eru ólíkar stöður, með ólíkum orðum.
-
Óþekkt er ekki eðlilegt. Niðurstaða sem vantar viðmiðunarbil, er enn að hlaðast eða er ólæsileg hefur enga túlkun og segir það;
observation-viewályktar aldrei túlkun, svo niðurstaða með bili og áninterpretationsýnir enga merkingu. -
Niðurstaða utan kvarða er mörk tækisins með samanburðarvirkja („> 33,3 mmol/L“:
formatQuantitymeð">") og bráðamerkingu ykkar, aldrei bert tal. Áætlað gildi heldur ≈ sínu ("~"). - Gefið frekari nefnd bil („Bráð: undir 2,5“) sem
ranges, hvert sem sinn hluta. -
Leiðrétt eða breytt niðurstaða heldur gildinu sem hún leysti af hólmi, í
<del>, með ykkar orðum um hvenær það breyttist (previousValue,previousLabel), svo að læknir sem las gamla gildið viti að það breyttist. -
Bilmæling segir lengd sína og fall („Meðaltal, 24 klst.“), og ástand og aðferð mælingar („Sitjandi, stór belgur“) eru sýnilegur texti við hliðina, aldrei aðeins ábending (openEHR
INTERVAL_EVENT,state,protocol). - Þróun þarf sambærilega punkta: dragið enga línu undir lágmarki ykkar, rjúfið línuna þar sem aðferð eða mæling breyttist og segið stefnu og merkingu með orðum („lækkandi, batnandi“).
-
Lífsmörk færð í einu einingakerfi geta sýnt hitt við hliðina sem ykkar texta („70 kg (154 lb)“); Lily umreiknar ekkert, svo tilgreinið námundun ykkar. Færið inn magn með
quantity-input-div, þar sem talan fylgir mörkum hverrar einingar. -
Vaxtarrit er
line-chartmeð hundraðshlutalínur ykkar sem raðir, punkta barnsins og gagnatöflu þess yfir aldur og gildi; Lily reiknar engan hundraðshluta og afhendir engin vaxtarviðmið.
Lyf
- Samheiti með litlum stöfum, nema tall man stafi af listum FDA og ISMP eða lands þíns (Ástralía og Kanada gefa út sína eigin). Merktu þá í
nameSegments; Lily giskar aldrei á þá. - Skrifaðu styrkinn með
formatQuantity: engin lokanúlla, upphafsnúlla og óbrjótanlegt bil á undan einingunni. - Haltu samanburðartákni niðurstöðu:
formatQuantity(5, "mmol/L", locale, "<")skrifar „<5 mmol/L“.Quantity.comparatorí FHIR er skrifað <, ≤, ≥ eða >; ef því er sleppt verður „minna en 5“ að „5“. - Skrifaðu mL, aldrei cc, og forðastu allar skammstafanir á lista ISMP yfir villuhættulegar skammstafanir.
- Styttu aldrei heiti lyfs eða skammt.
Dagsetningar og tímar
- Skrifaðu mánuðinn sem texta svo að ekki sé hægt að lesa dagsetningu á tvo vegu (
Intl.DateTimeFormatmeðmonth: "short"). - Veldu klukkuna af ásettu ráði: sendu
hourCycleskýrt. NHS biður um 24 stunda klukku; það er bresk regla, ekki heimsregla, svo Lily velur hana aldrei fyrir þig. - Aldur fylgir böndum Common User Interface í gegnum
ageParts(); þjónusta með aðra venju sendir sín eigin orð. -
Dagsetning sem aðeins er þekkt upp á mánuð eða ár helst þannig: biðjið um hana með
date-fieldprecision="month"eða"year", geymið2019-03eða2019og skrifið hana meðformatPartialDate(). Búið aldrei til dag. -
Tímalengd er
duration-view,<time datetime="P3DT4H">sem geymir ykkar orð, úrdurationParts()ogIntl.DurationFormat.
Mælaborð
- Deildartafla eða skjár stjórnstöðvar uppfærist oft. Tilkynntu aldrei hverja breytingu: hafðu eitt kurteist samantektarsvæði („3 rúm laus, 2 útskriftir væntanlegar“) og leyfðu fólki að lesa töfluna.
- Hvert ástand á töflu (rúm hreint, upptekið, lokað) er texti eða
data-*ástand með orðum, aldrei litur einn. -
Ekkert blikkar (WCAG 2.2.2, 2.3.1), og tafla sem uppfærist á tímamæli hefur hlé-stýringu eða uppfærist aðeins þegar beðið er um það; uppfærslur færa aldrei fókus. Færsla sem er komin fram yfir segir það með orðum („Hefur beðið í yfir 20 mínútur“) með
data-overdue. - Fjöldi eða hlutfall sýnir nefnara sinn („12 af 68“) og tengir á listann að baki.
- Listi eða tímalína segir hvað hann sýnir: hvað hann sýnir, röð hans og tímabil, hvað er falið og hvers vegna og hvaða heimildir svöruðu ekki. Tómur listi frá heimild sem svaraði ekki sannar ekki að ekkert sé til.
-
Áminningarlisti er
record-listþar sem atriðin bera gjalddaga (review-date) og gjaldstöðu með orðum, meðdata-due; reglan sem bjó hann til er ykkar.
Eyðublöð
-
Spurning sem svarað er „já“, „nei“ eða „ekki spurt“ er
radio-groupþriggja svara, ekkert valið í upphafi, aldrei gátreitur: gátreitur getur ekki greint „neitað“ frá „aldrei spurt“. Kerfayfirferð er eittfieldsetfyrir hvert líffærakerfi, og hnappurinn „öll önnur fjarverandi“ stillir aðeins þau sem ekki er svarað. -
Spurning með lista svara (lyf, heimilisföng) er
repeatable-fieldset: atriði er bætt við eða fjarlægt, fókus fylgir og hver fjarlægingarhnappur er nefndur eftir sínu atriði. -
Tala með tugakommu: sýnið hana með
Intl.NumberFormatog, þar semtype="number"tekur ekki við kommunni, takið við henni í textareit meðinputmode="decimal"og þáttið hana í kóðanum ykkar. Breytið aldrei gildi sem manneskjan skrifaði, ekki einu sinni til að halda því innan bils: gildi utan bils er villa sem hún getur séð. -
Langur listi sem birtir aðeins hluta valkosta sinna í einu stillir
aria-setsizeogaria-posinsetá hvern valkost og hefur í huga að leit á síðu sér ekki afganginn.
Skrár, athugasemdir og uppruni þeirra
-
Segið hvað listi eða tafla sýnir, á undan línunum: tímabil og röð, hvað er sleppt og hvers vegna og hvaða heimildir svöruðu ekki („Síðustu 12 mánuðir, nýjast fyrst. Skrá heimilislæknis svaraði ekki.“). Gefið
record-listogtimeline-listcoverageLabel, og hjálparhlutanumdata-gridsittcoverageLabel. Tómur listi frá heimild sem svaraði ekki segir það með orðum, svo hann sé aldrei lesinn sem „ekkert skráð“. -
Segið hvaðan færsla kom og hvort hún sé endanleg með
record-provenance-view: undirrituð, bíður undirskriftar, breytt, vistuð á þessu tæki og ekki enn send. Óundirrituð drög mega aldrei líta út fyrir að vera undirrituð. - Færsla um einhvern annan (foreldri, fóstur, gjafa) segir fyrst hverjum hún tilheyrir, með
subjectLabel. -
Afturhaldin færsla helst í listanum með ykkar orðum („Takmarkað: ekki aðgengilegt þér“), og færsla gerð í ógáti helst yfirstrikuð með „Fært inn fyrir mistök“: gefið
record-list-itemeðatimeline-list-itementryStateogentryStateLabel. Fjarlægið aldrei hvorugt í hljóði, því að gat er lesið sem „ekkert gerðist“. -
Í klínískri athugasemd skal merkja uppruna hvers kafla (vélritað, lesið inn, sniðmát, afritað áfram, myndað) með
data-sourceog sýnilegum orðum, svo að afritaður eða myndaður texti sé aldrei tekinn sem skoðun dagsins. -
Hluti sem getur ekki hlaðist er
unavailablemeð ykkar orðum, með hnappi til að reyna aftur; tæknikóði, ef hann er sýndur yfirhöfuð, er á bak við útfellingu. Bilun sem orsakast af aðgerð manneskju er tilkynnt, með gildinu sem skráin hefur nú; bilun við hleðslu síðu er það ekki. -
Saga fyrirmæla er
timeline-list, eitt atriði fyrir hvert skref (áætlað, tímasett, virkt, frestað, lokið, afturkallað) með tíma og ástæðu, og núverandi staða einnig á atriðinu.
Frá FHIR til Lily
Lily les ekki FHIR-tilföng; kóðinn þinn varpar þeim á props Lily. Þessar töflur varpa HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Kóðavörpunin er tillaga: klínískt öryggismat þitt ræður henni og orðin fyrir hverja stöðu eru þín eigin.
| IPS-kafli | Lily |
|---|---|
Ofnæmi og óþol (48765-2) |
allergy-record-list og færslur hans |
Lyfjayfirlit (10160-0) |
medication-record-list, þar sem hver færsla geymir medication-view |
Vandamálalisti (11450-4) |
problem-record-list og færslur hans |
Bólusetningar (11369-6) |
immunization-record-list og færslur hans |
Niðurstöður (30954-2) |
observation-view, í gagnatöflu eða yfirlitslista |
Saga aðgerða (47519-4) |
procedure-record-list og færslur hans |
Lækningatæki (46264-8) |
device-record-list og færslur hans |
Viðvaranir (104605-1) |
Viðvörunartexti eða viðvörun, aldrei á bak við samanbrotinn stýrihlut |
| Hver annar kafli | record-list og færslur hans |
| Skyldukafli sem skjalið sleppir | Listi kaflans með status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
Listinn með status="none-known" |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", með orðum sem segja hvor |
IPS-kóðarnir no-known-allergies, no-known-medications og þess háttar |
status="none-known" |
IPS-kóðarnir no-allergy-info, no-medication-info og þess háttar |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, aðskilið frá viðbragðs severity |
clinicalStatus, verificationStatus |
Sömu props á ofnæmis- og vandamálafærslum, með sömu kóðum |
MedicationStatement.status |
Lyfjafærslan: status |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view status, með sömu kóðum |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (einnig á skráarlistunum) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Varpaðu færslu með stöðuna entered-in-error á stöðuna entered-in-error, með orðum í stað þess að sleppa henni þegjandi: hvort hún er sýnd yfirleitt er ákvörðun þjónustu þinnar.
Frá openEHR til Lily
Lily les heldur ekki openEHR-samsetningar. Vörpunin fyrir gagnategundir og kóða viðmiðunarlíkans openEHR, sem tillaga sem klínísk öryggisrýni ykkar ákveður:
| openEHR | Lily |
|---|---|
DV_QUANTITY (innsláttur) |
quantity-input-div; einingar sem UCUM-kóðar með ykkar orðum |
DV_QUANTITY (birting), magnitude_status |
observation-view með formatQuantity(value, unit, locale, comparator) (~ er ≈) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges með meaning |
observation-view ranges |
DV_DATE að hluta (ár, ár og mánuður) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view með durationParts() |
DV_PROPORTION |
formatProportion() innan observation-view |
DV_ORDINAL, DV_SCALE |
radio-group þar sem merkin bera töluna og orð hennar |
DV_CODED_TEXT |
mynstur kóðaðra gilda hér fyrir neðan |
DV_BOOLEAN |
checkbox-input, aðeins þegar „ekki spurt“ getur ekki gerst |
ELEMENT.null_flavour 253 óþekkt, 271 engar upplýsingar |
status="not-recorded" eða "unavailable", með orðum sem segja hvor |
null_flavour 272 hulið |
observation-view status="masked" |
null_flavour 273 á ekki við |
status="not-applicable" |
PARTY_RELATED viðfang |
subjectLabel á færslum skrárinnar |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Skref í Instruction State Machine | timeline-list skrefa, með núverandi stöðu á atriðinu |
atriði frumgerðar með tíðni 0..* |
repeatable-fieldset |
Kóðuð gildi
- Sýndu
Coding.display; ef hann er enginn,CodeableConcept.text; ef hvorugt er til,system|code. Aldrei tómur reitur. - Bjóddu stýringu sem sýnir kóðakerfið og kóðann við hlið hvers gildis, til dæmis rofahnapp sem segir „Sýna kóða“. Faldir kóðar eru utan lestraraðar þar til þeir eru sýndir.
- Merktu klínískan texta með tungumáli skjalsins (
lang), sem getur verið annað en tungumál viðmótsins. Þýddu viðmótið; þýddu aldrei klínískt efni. - Lily fylgir engin hugtakaskrá: engar uppflettingar í SNOMED CT, LOINC, ATC eða UCUM. Skrifaðu það sem skjalið segir. SvelteKit-dæmið, síðan
/patient-summarysýnir mynstrið.
Hvað Lily gerir ekki
- Reikna snemmviðvörunarstig, vaxtarhundraðshlutamark, skammt eða viðmiðunarbil.
- Afhenda lyfjagagnagrunn, tall man lista, eða SNOMED CT, ICD, LOINC eða UCUM kóða.
- Endurskapa leyfisskylt mælitæki (Wong-Baker FACES) eða hönnun annars aðila (NEWS2 töfluna).
- Takmarka fjölda skráa sem eru opnar í einu.
- Álykta túlkun út frá bili, umreikna einingu eða þátta afstæða dagsetningu („næsta þriðjudag“).
- Nota rofa fyrir „já, nei eða óþekkt“: ARIA
switchhefur ekkert þriðja ástand, svo það eru þrír valhnappar.
Rannsóknirnar, heimildirnar og ákvarðanirnar að baki þessum leiðarvísi eru í spec/healthcare-ui.