Sveikatos priežiūros naudotojo sąsajos
Vadovas komandoms, kurios kuria klinikinę programinę įrangą su „Lily“: klinikiniai portalai, rezultatai ir ataskaitos, vaistų skyrimas ir davimas, sprendimų parama ir ligoninių skydeliai.
Šio puslapio vertimai yra nepatikrinti mašininiai juodraščiai. Anglų kalbos puslapis yra autoritetinga versija.
Ką „Lily“ daro ir ko nedaro
„Lily“ pateikia rodymo sutartis: semantinį žymėjimą, ARIA, klaviatūros elgseną ir klasių kabliukus tam, kas klinikiniuose ekranuose kartojasi. Ji nepateikia klinikinės logikos, klinikinio turinio ar reguliacinio teiginio.
| „Lily“ pateikia | Jūs pateikiate |
|---|---|
| observation-view: reikšmė, vienetas, žyma žodžiais, intervalas ir trūkstamų duomenų būsenos | Reikšmė, sprendimas dėl žymos, atskaitos intervalas |
| allergy-record-list ir allergy-record-list-item: būsena, kuri niekada nėra tuščia | Alergijos įrašas ir jo terminija |
| medication-view: pavadinimas, stiprumas, forma, vartojimo būdas ir dažnis, niekas nesutrumpinta | Vaisto duomenys, tall man segmentai, suformatuotas stiprumas |
| decision-support-card: CDS Hooks kortelės forma | Taisyklės, siūlymo veiksmai, rezultato užfiksavimas |
| early-warning-score-view: balas, juosta ir eskalavimas, parodyti | Vertinimo sistema ir jos patvirtintas skaičiavimas |
age-view ir ageParts(): amžius jam tinkamais vienetais |
Vienetų žodžiai (Intl.DurationFormat arba jūsų pačių etiketės) |
formatQuantity(): 5 mg, niekada 5,0 mg; 0,5 mg, niekada ,5 mg |
Skaičius, vienetas ir lokalė |
| Paciento juostos kompozicija | Kiekviena etiketė ir reikšmė bei tai, kas gali matyti klinikinę informaciją |
Reguliavimas. Programinė įranga, skaičiuojanti balą, centilį, dozę ar vaistų sąveiką, paprastai yra medicinos priemonė. „Lily“ tyčia neskaičiuoja nė vieno iš jų. Jei jūsų produktas reguliuojamas, jo tinkamumo naudoti inžinerijos bylą tvarkote jūs (IEC 62366-1, FDA žmogiškųjų veiksnių gairės, EU MDR). „Lily“ testai, jos pačios įvertinta prieinamumo atitikties ataskaita ir ekrano skaitytuvų matrica gali būti įrodymai toje byloje; nė vienas iš jų nėra atitikties teiginys, o matricoje dar nėra rezultatų.
Įspėjimai: pertraukite tik dėl kritinių
Įspėjimų nuovargis yra saugos problema: kai kiekvienas įspėjimas pertraukia, žmonės atmeta juos visus. AHRQ rekomendacija – skirstyti įspėjimus pagal sunkumą ir pertraukiančiais padaryti tik sunkiuosius.
- Informacija (
indicator="info"): eilutėje, šalia užduoties, sprendimų paramos kortelė puslapyje. - Įspėjimas (
indicator="warning"): matomas neblokuojant, ta pati kortelė, išsiskiriantis stiliumi; be modalinio lango. - Kritinis (
indicator="critical"): įdėkite kortelę į įspėjimo dialogą ir pasiūlykiteoverrideReasons, kad jį atmetant būtų prašoma priežasties. - Sprendimų paramos kortelė pati niekada nėra gyvoji sritis. Naują kritinę kortelę paskelbkite perkeldami fokusą į dialogą, o ne per
aria-live. - Pašalinkite kortelę, kai įvykis, į kurį ji atsakė, įvyksta dar kartą, ir užfiksuokite kiekvieną rezultatą (priimta arba pakeista nurodžius priežastį).
Paciento supainiojimo klaidos: atpažinkite, neribokite
- Rodykite du identifikatorius visur, kur rodomi paciento duomenys: vardą su gimimo data ir nacionalinį identifikatorių su jo view komponentu (The Joint Commission, Quick Safety 45).
- Naudokite paciento juostą kiekviename ekrane, veikiančiame vieno paciento įrašą, ir laikykite ją matomą.
- Prieš veiksmą su kitu įrašu nei juostoje, patvirtinkite jį vardu, gimimo data ir identifikatoriumi.
-
Įrašas apie kitą asmenį nei pacientas (tėvų ligos istorija, vaisius, donoras) pirmiausia žodžiais pasako, kam jis priklauso: suteikite įrašo elementams
subjectLabel(„Motina“), kad giminaičio diagnozė niekada nebūtų perskaityta kaip paciento (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Neribokite, kiek įrašų gali atidaryti gydytojas: atsitiktinių imčių tyrimas su 3 356 gydytojais (JAMA, 2019) parodė, kad tai nesumažino užsakymų ne tam pacientui, o žmonės tai apeina.
-
Vieno įrašo veiksmų meniu pirmiausia įvardija tą įrašą, naudojant
subjectLabelkomponentecontext-menuarbadropdown-menu(„Ada Lovelace, kraujospūdis lapkr. 3“): neinteraktyvi pirmoji dalis, kuri kartu yra prieinamas meniu pavadinimas. -
Kiekvieną veiksmą priskirkite lygiui pagal tai, ką jis daro, ir parodykite lygį prieš jį vykdant. Įprastas (peržiūrėti, spausdinti) vykdomas iškart. Dokumentuojamas pasako, ką įrašys į įrašą („Prideda pastabą prie apsilankymo“).
Klinikinis (nutraukti, atšaukti paskyrimą) klausia antrą kartą, komponente
alert-dialog, kurio patvirtinimo mygtukas yra veiksmažodis („Nutraukti“), niekada „Gerai“ ar „Taip“. Atskleidžiantis (skubi prieiga, dalijimasis už gydymo komandos ribų) pirmiausia paprašo priežasties ir ją užregistruoja. - Kai atidaryta keletas įrašų (skirtukai, langai, padalyti skydeliai), kiekvieno skirtuko matomas tekstas ir prieinamas pavadinimas apima paciento vardą ir antrą identifikatorių, aktyvus skydelis pakartoja juostą, ir joks veiksmas netaikomas kitam pacientui nei jo skydelio.
- Parodykite vietą, kuriai bus priskirti įrašai (prisijungiant pasirinktą skyrių, kabinetą ar įstaigą), kaip tekstą puslapio antraštėje, ir jos keitimą padarykite aiškiu veiksmu.
- Juostoje parodykite aktyvų vizitą arba „Aktyvaus vizito nėra“. Forma, kuriai reikia vizito, tai pasako ir pasiūlo jį pradėti, užuot nepavykusi išsaugant.
Paciento juosta
Kompozicija aprašyta su medical-banner, veikiantis puslapis yra /patient-banner SvelteKit pavyzdinėje programoje:
- du identifikatoriai ir amžius šalia gimimo datos;
- alergijos per alergijų sąrašą, kad „žinomų alergijų nėra“, „neužfiksuota“ ir „nepasiekiama“ niekada neatrodytų vienodai;
- trūkstama reikšmė yra žodžiai („Nežinoma“), niekada klaustukas, brūkšnys ar tuščias langelis;
- miręs pacientas:
data-deceasedtemai ir matoma teksto eilutė, niekada vien spalva; - joks laukas nėra sutrumpintas, nukirptas ar paslėptas jokiu plotu; tekstas laužomas.
-
paciento žymės („Reikia vertėjo“, „Infekcijos rizika“) yra pažymėta žodžių
tag-group, niekada vien piktogramos ar spalva, ir lieka matomos, kai juosta persikelia į kitą eilutę.
Rezultatai
- Vienas rezultato rodinys, iš kad ir kokios sistemos jis būtų: stebėjimo rodinys (observation view).
- Žyma yra žodžiai iš jūsų vertimo (
flagLabel), o FHIR interpretavimo kodas yradata-interpretationtemai. - Atskirkite naujus rezultatus nuo ankstesnių ir parodykite tendenciją (sparkline arba linijinę diagramą su duomenų lentele): gydytojai ieško reikšmingo pokyčio, o ne tik intervalo.
- Rezultatas, kuris niekada nebuvo užfiksuotas, ir nepasiekiamas rezultatas yra skirtingos būsenos, su skirtingais žodžiais.
-
Nežinoma nėra normalu. Rezultatas, kurio referencinio intervalo trūksta, jis dar įkeliamas ar neįskaitomas, neturi interpretacijos ir tai pasako;
observation-viewniekada jos neišveda, todėl rezultatas su intervalu, bet beinterpretation, nerodo jokios žymės. -
Už skalės ribų esantis rezultatas yra prietaiso riba su palyginimo ženklu („> 33,3 mmol/L“:
formatQuantitysu">") ir jūsų kritine žyme, niekada vien skaičius. Apytikslė reikšmė išlaiko savo ≈ ("~"). - Kitus pavadintus intervalus („Kritinis: mažiau nei 2,5“) pateikite kaip
ranges, kiekvieną kaip atskirą dalį. -
Pataisytas ar pakeistas rezultatas išlaiko pakeistą reikšmę elemente
<del>, su jūsų žodžiais apie tai, kada ji pasikeitė (previousValue,previousLabel), kad senąją reikšmę perskaitęs gydytojas žinotų, jog ji pasikeitė. -
Intervalo matavimas nurodo savo trukmę ir funkciją („Vidurkis, 24 valandos“), o matavimo būsena ir metodas („Sėdint, didelė manžetė“) yra matomas tekstas šalia, niekada vien patarimas (openEHR
INTERVAL_EVENT,state,protocol). - Tendencijai reikia palyginamų taškų: nebrėžkite linijos žemiau savo minimumo, nutraukite liniją ten, kur pasikeitė metodas ar tyrimas, ir žodžiais pasakykite kryptį ir prasmę („mažėja, gerėja“).
-
Gyvybiniai rodikliai, įvesti viena vienetų sistema, šalia gali rodyti kitą kaip jūsų tekstą („70 kg (154 lb)“); Lily nieko nekonvertuoja, todėl nurodykite apvalinimą. Kiekį įveskite komponentu
quantity-input-div, kurio skaičius laikosi kiekvieno vieneto ribų. -
Augimo kreivė yra
line-chartsu jūsų procentilių linijomis kaip serijomis, vaiko taškais ir amžiaus bei reikšmės duomenų lentele; Lily neskaičiuoja procentilių ir neteikia augimo standartų.
Vaistai
- Generiniai pavadinimai mažosiomis raidėmis, išskyrus tall man raides iš FDA ir ISMP arba jūsų šalies sąrašų (Australija ir Kanada skelbia savo). Pažymėkite jas
nameSegments; „Lily“ jų niekada neatspėja. - Stiprumą rašykite su
formatQuantity: be galinio nulio, su pradiniu nuliu ir nelūžtančiu tarpu prieš vienetą. - Išsaugokite rezultato palyginimo ženklą:
formatQuantity(5, "mmol/L", locale, "<")užrašo „<5 mmol/L“. FHIRQuantity.comparatorrašoma <, ≤, ≥ arba >; jį praleidus, „mažiau nei 5“ virsta „5“. - Rašykite mL, niekada cc, ir venkite visų santrumpų iš ISMP klaidų rizikos santrumpų sąrašo.
- Niekada nesutrumpinkite vaisto pavadinimo ar dozės.
Datos ir laikas
- Mėnesį rašykite tekstu, kad datos nebūtų galima perskaityti dviem būdais (
Intl.DateTimeFormatsumonth: "short"). - Laikrodį pasirinkite sąmoningai: aiškiai perduokite
hourCycle. NHS prašo 24 valandų laikrodžio; tai Jungtinės Karalystės taisyklė, ne pasaulinė, todėl „Lily“ jo niekada nepasirenka už jus. - Amžius seka Common User Interface juostas per
ageParts(); paslauga su kita konvencija perduoda savo žodžius. -
Data, žinoma tik mėnesio ar metų tikslumu, tokia ir lieka: klauskite jos komponentu
date-fieldprecision="month"arba"year", saugokite2019-03arba2019ir rašykite funkcijaformatPartialDate(). Niekada neišgalvokite dienos. -
Laiko trukmė yra
duration-view,<time datetime="P3DT4H">, talpinantis jūsų žodžius, išdurationParts()irIntl.DurationFormat.
Skydeliai
- Skyriaus lenta ar valdymo centro ekranas atnaujinamas dažnai. Niekada neskelbkite kiekvieno pakeitimo: laikykite vieną mandagią santraukos sritį („3 laisvos lovos, 2 numatyti išrašymai“) ir leiskite žmonėms skaityti lentą.
- Kiekviena lentos būsena (lova švari, užimta, užblokuota) yra tekstas arba
data-*būsena su žodžiais, niekada vien spalva. -
Niekas nemirksi (WCAG 2.2.2, 2.3.1), o laikmačiu atsinaujinanti lenta turi pauzės valdiklį arba atsinaujina tik paprašius; atnaujinimai niekada neperkelia fokuso. Vėluojantis įrašas tai pasako žodžiais („Laukia daugiau nei 20 minučių“) su
data-overdue. - Skaičius ar dažnis rodo savo vardiklį („12 iš 68“) ir nukreipia į už jo esantį sąrašą.
- Sąrašas ar laiko juosta pasako, ko vaizdas tai yra: ką rodo, kokia tvarka ir laikotarpiu, kas paslėpta ir kodėl, ir kurie šaltiniai neatsakė. Tuščias sąrašas iš neatsakiusio šaltinio neįrodo, kad nieko nėra.
-
Priminimų sąrašas yra
record-list, kurio elementai turi terminą (review-date) ir termino būseną žodžiais, sudata-due; jį sukūrusi taisyklė yra jūsų.
Formos
-
Klausimas, į kurį atsakoma „taip“, „ne“ arba „neklausta“, yra
radio-groupiš trijų atsakymų, iš pradžių nė vieno nepasirinkus, niekada žymimasis langelis: langelis negali atskirti „paneigta“ nuo „niekada neklausta“. Sistemų apžvalga yra vienasfieldsetkiekvienai organizmo sistemai, o mygtukas „visų kitų nėra“ nustato tik neatsakytus. -
Klausimas su atsakymų sąrašu (vaistai, adresai) yra
repeatable-fieldset: elementas pridedamas ar pašalinamas, fokusas seka, o kiekvienas šalinimo mygtukas pavadintas pagal savo elementą. -
Skaičius su dešimtainiu kableliu: rodykite jį su
Intl.NumberFormatir, kurtype="number"nepriima kablelio, priimkite jį teksto lauke suinputmode="decimal"ir apdorokite savo kode. Niekada nekeiskite asmens įvestos reikšmės, net norėdami ją apriboti intervalu: reikšmė už intervalo ribų yra klaida, kurią jis gali matyti. -
Ilgas sąrašas, rodantis tik dalį parinkčių vienu metu, nustato
aria-setsizeiraria-posinsetkiekvienai parinkčiai ir atsimena, kad paieška puslapyje nemato likusių.
Įrašai, pastabos ir jų kilmė
-
Prieš eilutes pasakykite, ko vaizdas yra sąrašas ar tinklelis: laikotarpis ir tvarka, ką praleidžia ir kodėl, ir kurie šaltiniai neatsakė („Paskutiniai 12 mėnesių, naujausi pirmiausia. Šeimos gydytojo įrašas neatsakė.“). Suteikite
record-listirtimeline-listcoverageLabel, o pagalbiniam komponentuidata-gridjocoverageLabel. Tuščias sąrašas iš neatsakiusio šaltinio tai pasako žodžiais, kad niekada nebūtų perskaitytas kaip „nieko neužregistruota“. -
Komponentu
record-provenance-viewpasakykite, iš kur atėjo įrašas ir ar jis galutinis: pasirašytas, laukia parašo, pakeistas, išsaugotas šiame įrenginyje ir dar neišsiųstas. Nepasirašytas juodraštis niekada neturi atrodyti pasirašytas. - Įrašas apie kitą asmenį (tėvą ar motiną, vaisių, donorą) pirmiausia pasako, kam jis priklauso, įrašo elementų savybe
subjectLabel. -
Sulaikytas įrašas lieka sąraše su jūsų žodžiais („Apribota: jums neprieinama“), o per klaidą padarytas įrašas lieka perbrauktas su „Įvesta per klaidą“: suteikite
record-list-itemarbatimeline-list-itementryStateirentryStateLabel. Niekada nepašalinkite nė vieno tyliai, nes spraga skaitoma kaip „nieko neįvyko“. -
Klinikinėje pastaboje pažymėkite kiekvienos ištraukos šaltinį (įvesta, padiktuota, šablonas, nukopijuota, sugeneruota) atributu
data-sourceir matomais žodžiais, kad nukopijuotas ar sugeneruotas tekstas niekada nebūtų palaikytas šiandienine apžiūra. -
Skiltis, kurios nepavyksta įkelti, yra
unavailablejūsų žodžiais, su mygtuku bandyti dar kartą; techninis kodas, jei apskritai rodomas, yra už išskleidžiamos dalies. Klaida, kurią sukėlė asmens veiksmas, paskelbiama kartu su reikšme, kurią įrašas dabar turi; klaida įkeliant puslapį – ne. -
Paskyrimo istorija yra
timeline-list, po vieną elementą kiekvienam žingsniui (suplanuotas, numatytas, aktyvus, sustabdytas, užbaigtas, atšauktas) su laiku ir priežastimi, o dabartinė būsena taip pat elemente.
Nuo FHIR prie Lily
„Lily“ neskaito FHIR išteklių; jūsų kodas susieja juos su „Lily“ props. Šios lentelės susieja HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Kodų susiejimas yra pasiūlymas: dėl jo sprendžia jūsų klinikinis saugos vertinimas, o kiekvienos būsenos žodžiai yra jūsų pačių.
| IPS skyrius | Lily |
|---|---|
Alergijos ir netoleravimas (48765-2) |
allergy-record-list ir jo elementai |
Vaistų santrauka (10160-0) |
medication-record-list, kiekvienas elementas turi medication-view |
Problemų sąrašas (11450-4) |
problem-record-list ir jo elementai |
Skiepai (11369-6) |
immunization-record-list ir jo elementai |
Rezultatai (30954-2) |
observation-view, duomenų lentelėje arba suvestinės sąraše |
Procedūrų istorija (47519-4) |
procedure-record-list ir jo elementai |
Medicinos priemonės (46264-8) |
device-record-list ir jo elementai |
Įspėjimai (104605-1) |
Įspėjimo tekstas arba įspėjimas, niekada už suskleisto valdiklio |
| Bet kuris kitas skyrius | record-list ir jo elementai |
| Privalomas skyrius, kurio dokumentas nepateikia | Skyriaus sąrašas su status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
Sąrašo status="none-known" |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", su žodžiais, nurodančiais, kuri |
IPS kodai no-known-allergies, no-known-medications ir panašūs |
status="none-known" |
IPS kodai no-allergy-info, no-medication-info ir panašūs |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, atskirai nuo reakcijos severity |
clinicalStatus, verificationStatus |
Tos pačios savybės (props) alergijos ir problemos elementuose, su tais pačiais kodais |
MedicationStatement.status |
Vaisto elemento status |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view status, su tais pačiais kodais |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (taip pat įrašų sąrašuose) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Įrašą su būsena entered-in-error susiekite su būsena entered-in-error, pateikdami žodžius, užuot jį tyliai pašalinę: ar jį apskritai rodyti, sprendžia jūsų paslauga.
Nuo openEHR iki Lily
Lily neskaito ir openEHR kompozicijų. Atitiktis openEHR referencinio modelio duomenų tipams ir kodams, kaip pasiūlymas, dėl kurio sprendžia jūsų klinikinės saugos peržiūra:
| openEHR | Lily |
|---|---|
DV_QUANTITY (įvestis) |
quantity-input-div; vienetai kaip UCUM kodai su jūsų žodžiais |
DV_QUANTITY (rodymas), magnitude_status |
observation-view su formatQuantity(value, unit, locale, comparator) (~ yra ≈) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges su meaning |
observation-view ranges |
DV_DATE dalinė (metai, metai ir mėnuo) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view su durationParts() |
DV_PROPORTION |
formatProportion() viduje observation-view |
DV_ORDINAL, DV_SCALE |
radio-group , kurio etiketės turi skaičių ir jo žodžius |
DV_CODED_TEXT |
koduotų reikšmių šablonas žemiau |
DV_BOOLEAN |
checkbox-input, tik kai „neklausta“ negali pasitaikyti |
ELEMENT.null_flavour 253 nežinoma, 271 informacijos nėra |
status="not-recorded" arba "unavailable", su žodžiais, nurodančiais, kuri |
null_flavour 272 paslėpta |
observation-view status="masked" |
null_flavour 273 netaikoma |
status="not-applicable" |
PARTY_RELATED subjektas |
subjectLabel įrašo elementuose |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Instruction State Machine žingsniai | timeline-list iš žingsnių, dabartinė būsena elemente |
archetipo elementas su pasikartojimais 0..* |
repeatable-fieldset |
Koduotos reikšmės
- Rodykite
Coding.display; jei jo nėra,CodeableConcept.text; jei nėra nė vieno,system|code. Niekada tuščias langelis. - Pasiūlykite valdiklį, kuris prie kiekvienos reikšmės parodo kodų sistemą ir kodą, pavyzdžiui, perjungimo mygtuką su tekstu „Rodyti kodus“. Paslėpti kodai lieka už skaitymo tvarkos, kol parodomi.
- Klinikinį tekstą pažymėkite dokumento kalba (
lang), kuri gali skirtis nuo sąsajos kalbos. Sąsają išverskite; klinikinio turinio niekada neverskite. - „Lily“ nepateikia terminologijos: jokių SNOMED CT, LOINC, ATC ar UCUM paieškų. Rašykite tai, ką sako dokumentas. SvelteKit pavyzdžio puslapis
/patient-summaryrodo šabloną.
Ko „Lily“ nedarys
- Skaičiuoti ankstyvojo perspėjimo balo, augimo centilio, dozės ar atskaitos intervalo.
- Pateikti vaistų duomenų bazės, tall man sąrašo ar SNOMED CT, TLK, LOINC ar UCUM kodų.
- Atkartoti licencijuoto instrumento (Wong-Baker FACES) ar kitos institucijos dizaino (NEWS2 diagramos).
- Riboti vienu metu atidarytų įrašų skaičiaus.
- Išvesti interpretaciją iš intervalo, konvertuoti vienetą ar apdoroti santykinę datą („kitą antradienį“).
- Naudoti jungiklį atsakymui „taip, ne arba nežinoma“: ARIA
switchneturi trečios būsenos, todėl tai trys akutės.
Šio vadovo tyrimai, šaltiniai ir sprendimai pateikti spec/healthcare-ui.