Veselības aprūpes lietotāja saskarnes

Ceļvedis komandām, kas veido klīnisko programmatūru ar Lily: klīniskie portāli, rezultāti un pārskati, zāļu izrakstīšana un ievadīšana, lēmumu atbalsts un slimnīcu informācijas paneļi.

Šīs lapas tulkojumi ir nepārbaudīti mašīntulkojuma melnraksti. Angļu valodas lapa ir autoritatīvā versija.

Ko Lily dara un ko nedara

Lily nodrošina attēlošanas līgumus: semantisko iezīmējumu, ARIA, tastatūras uzvedību un klašu āķus tam, ko klīniskie ekrāni atkārto. Tā nenodrošina klīnisko loģiku, klīnisko saturu vai regulatīvu apgalvojumu.

Ko nodrošina Lily un ko nodrošināt jums
Lily nodrošina Jūs nodrošināt
observation-view: vērtība, mērvienība, karodziņš vārdos, diapazons un trūkstošo datu stāvokļi Vērtība, lēmums par karodziņu, references diapazons
allergy-record-list un allergy-record-list-item: statuss, kas nekad nav tukšs Alerģijas ieraksts un tā terminoloģija
medication-view: nosaukums, stiprums, forma, ievadīšanas veids un biežums, nekas nav saīsināts Zāļu dati, tall man segmenti, formatētais stiprums
decision-support-card: CDS Hooks kartītes forma Noteikumi, ieteikuma darbības, iznākuma ierakstīšana
early-warning-score-view: rādītājs, josla un eskalācija, attēloti Vērtēšanas sistēma un tās validētais aprēķins
age-view un ageParts(): vecums tam piemērotās vienībās Vārdi vienībām (Intl.DurationFormat vai jūsu pašu etiķetes)
formatQuantity(): 5 mg, nekad 5,0 mg; 0,5 mg, nekad ,5 mg Skaitlis, mērvienība un lokalizācija
Pacienta joslas kompozīcija Katra etiķete un vērtība un tas, kas drīkst redzēt klīnisko informāciju

Regulējums. Programmatūra, kas aprēķina rādītāju, centili, devu vai zāļu mijiedarbību, parasti ir medicīnas ierīce. Lily neaprēķina nevienu no tiem, apzināti. Ja jūsu produkts ir regulēts, tā lietojamības inženierijas lieta ir jūsu atbildība (IEC 62366-1, FDA cilvēkfaktoru norādījumi, EU MDR). Lily testi, tās pašnovērtētais pieejamības atbilstības ziņojums un ekrāna lasītāju matrica var būt pierādījumi šajā lietā; neviens no tiem nav atbilstības apgalvojums, un matricā vēl nav rezultātu.

Brīdinājumi: pārtrauciet tikai kritiskā gadījumā

Brīdinājumu nogurums ir drošības problēma: kad katrs brīdinājums pārtrauc darbu, cilvēki noraida tos visus. AHRQ norādījums ir līmeņot brīdinājumus pēc smaguma un pārtraucošus padarīt tikai smagos.

  • Informācija (indicator="info"): rindā, blakus uzdevumam, lēmumu atbalsta kartīte lapā.
  • Brīdinājums (indicator="warning"): redzams, nebloķējot, tā pati kartīte, stilizēta, lai izceltos; bez modāla loga.
  • Kritisks (indicator="critical"): ievietojiet kartīti brīdinājuma dialogā un piedāvājiet overrideReasons, lai tās noraidīšanai tiktu prasīts iemesls.
  • Lēmumu atbalsta kartīte pati par sevi nekad nav dzīvs reģions. Jaunu kritisku kartīti paziņojiet, pārvietojot fokusu dialogā, nevis ar aria-live.
  • Noņemiet kartīti, kad notikums, uz kuru tā atbildēja, notiek atkal, un ierakstiet katru iznākumu (pieņemts vai atcelts ar iemeslu).

Pacienta sajaukšanas kļūdas: identificējiet, neierobežojiet

  • Rādiet divus identifikatorus visur, kur parādās pacienta dati: vārdu ar dzimšanas datumu un valsts identifikatoru ar tā view komponentu (The Joint Commission, Quick Safety 45).
  • Izmantojiet pacienta joslu katrā ekrānā, kas darbojas ar viena pacienta ierakstu, un turiet to redzamu.
  • Pirms darbības ar citu ierakstu, nevis to, kas ir joslā, apstipriniet to ar vārdu, dzimšanas datumu un identifikatoru.
  • Ieraksts par kādu citu, nevis pacientu (vecāka slimības vēsture, auglis, donors), vispirms vārdiem pasaka, kam tas pieder: piešķiriet ieraksta elementiem subjectLabel (“Māte”), lai radinieka diagnozi nekad nenolasītu kā pacienta (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Neierobežojiet, cik ierakstu ārsts drīkst atvērt: randomizēts pētījums ar 3 356 ārstiem (JAMA, 2019) atklāja, ka tas nesamazināja pasūtījumus nepareizam pacientam, un cilvēki to apiet.
  • Darbību izvēlne vienam ierakstam vispirms nosauc šo ierakstu, izmantojot subjectLabel komponentā context-menu vai dropdown-menu (“Ada Lovelace, asinsspiediens 3. nov.”): neinteraktīva pirmā daļa, kas ir arī izvēlnes pieejamais nosaukums.
  • Katru darbību iedaliet līmenī pēc tā, ko tā dara, un padariet līmeni redzamu pirms izpildes. Ikdienas (skatīt, drukāt) izpildās uzreiz. Dokumentējama pasaka, ko tā ierakstīs dokumentācijā (“Pievieno piezīmi apmeklējumam”). Klīniska (pārtraukt, atcelt nozīmējumu) jautā otrreiz, komponentā alert-dialog , kura apstiprinājuma poga ir darbības vārds (“Pārtraukt”), nekad “Labi” vai “Jā”. Izpaužoša (ārkārtas piekļuve, kopīgošana ārpus aprūpes komandas) vispirms prasa iemeslu un to reģistrē.
  • Ja atvērti vairāki ieraksti (cilnes, logi, sadalīti paneļi), katras cilnes redzamais teksts un pieejamais nosaukums ietver pacienta vārdu un otru identifikatoru, aktīvais panelis atkārto reklāmjoslu, un neviena darbība neattiecas uz citu pacientu kā tikai uz sava paneļa pacientu.
  • Rādiet vietu, kurai tiks piesaistīti ieraksti (pieslēdzoties izvēlēto nodaļu, ambulatoro kabinetu vai iestādi), kā tekstu lapas galvenē, un tās maiņu padariet par skaidru darbību.
  • Joslā rādiet aktīvo vizīti vai “Nav aktīvas vizītes”. Veidlapa, kurai vajag vizīti, to pasaka un piedāvā to sākt, nevis neizdodas saglabājot.

Pacienta josla

Kompozīcija ir dokumentēta ar medical-banner, ar darbojošos lapu /patient-banner SvelteKit piemēra lietotnē:

  • divi identifikatori un vecums blakus dzimšanas datumam;
  • alerģijas caur alerģiju sarakstu, lai „zināmu alerģiju nav”, „nav ierakstīts” un „nav pieejams” nekad neizskatītos vienādi;
  • trūkstoša vērtība ir vārdi („Nav zināms”), nekad jautājuma zīme, domuzīme vai tukša šūna;
  • miris pacients: data-deceased tēmai un redzama teksta rinda, nekad tikai krāsa;
  • neviens lauks nav saīsināts, apgriezts vai paslēpts nevienā platumā; teksts tiek pārlauzts.
  • pacienta atzīmes (“Vajag tulku”, “Infekcijas risks”) ir marķēta vārdu tag-group , nekad tikai ikonas vai krāsa, un paliek redzamas, kad josla pārlūzt.

Rezultāti

  • Viens rezultāta skats, no jebkuras sistēmas, no kuras tas nācis: novērojuma skats (observation view).
  • Karodziņš ir vārdi no jūsu tulkojuma (flagLabel), ar FHIR interpretācijas kodu kā data-interpretation tēmai.
  • Nošķiriet jaunus rezultātus no agrākiem un parādiet tendenci (sparkline vai līniju diagrammu ar tās datu tabulu): ārsti meklē būtisku izmaiņu, ne tikai diapazonu.
  • Rezultāts, kas nekad nav ierakstīts, un rezultāts, kas nav pieejams, ir dažādi stāvokļi, ar dažādiem vārdiem.
  • Nezināms nav normāls. Rezultātam, kura atsauces diapazons trūkst, vēl ielādējas vai nav nolasāms, nav interpretācijas, un tas to pasaka; observation-view nekad to neizsecina, tāpēc rezultāts ar diapazonu un bez interpretation nerāda nekādu atzīmi.
  • Rezultāts ārpus skalas ir instrumenta robeža ar salīdzinājuma zīmi (“> 33,3 mmol/L”: formatQuantity ar ">") un jūsu kritisko atzīmi, nekad tikai skaitlis. Aptuvena vērtība saglabā savu ≈ ("~").
  • Citus nosauktus diapazonus (“Kritisks: zem 2,5”) norādiet kā ranges, katru kā atsevišķu daļu.
  • Labots vai grozīts rezultāts saglabā aizstāto vērtību elementā <del>, ar jūsu vārdiem par to, kad tā mainījās (previousValue, previousLabel), lai klīnicists, kurš izlasīja veco vērtību, zinātu, ka tā mainījās.
  • Intervāla mērījums norāda savu ilgumu un funkciju (“Vidējais, 24 stundas”), un mērījuma stāvoklis un metode (“Sēžot, liela manšete”) ir redzams teksts blakus, nekad tikai rīka padoms (openEHR INTERVAL_EVENT, state, protocol).
  • Tendencei vajag salīdzināmus punktus: nezīmējiet līniju zem sava minimuma, pārtrauciet līniju, kur mainījās metode vai analīze, un vārdiem pasakiet virzienu un nozīmi (“samazinās, uzlabojas”).
  • Dzīvības rādītāji, kas ievadīti vienā mērvienību sistēmā, blakus var rādīt otru kā jūsu tekstu (“70 kg (154 lb)”); Lily neko nepārveido, tāpēc norādiet noapaļošanu. Daudzumu ievadiet ar quantity-input-div, kura skaitlis ievēro katras mērvienības robežas.
  • Augšanas līkne ir line-chart ar jūsu procentiļu līnijām kā sērijām, bērna punktiem un vecuma un vērtības datu tabulu; Lily neaprēķina procentiles un nepiegādā augšanas standartus.

Zāles

  • Vispārīgie nosaukumi ar mazajiem burtiem, izņemot tall man burtus no FDA un ISMP vai jūsu valsts sarakstiem (Austrālija un Kanāda publicē savus). Atzīmējiet tos nameSegments; Lily nekad tos neuzmin.
  • Stiprumu rakstiet ar formatQuantity: bez noslēdzošās nulles, ar sākuma nulli un nedalāmu atstarpi pirms vienības.
  • Saglabājiet rezultāta salīdzināšanas zīmi: formatQuantity(5, "mmol/L", locale, "<") raksta „<5 mmol/L”. FHIR Quantity.comparator raksta kā <, ≤, ≥ vai >; ja to izlaiž, „mazāk nekā 5” kļūst par „5”.
  • Rakstiet mL, nekad cc, un izvairieties no katra saīsinājuma ISMP kļūdu riska saīsinājumu sarakstā.
  • Nekad nesaīsiniet zāļu nosaukumu vai devu.

Datumi un laiki

  • Mēnesi rakstiet kā tekstu, lai datumu nevarētu nolasīt divējādi (Intl.DateTimeFormat ar month: "short").
  • Pulksteni izvēlieties apzināti: skaidri nododiet hourCycle. NHS prasa 24 stundu pulksteni; tas ir Apvienotās Karalistes noteikums, nevis pasaules, tāpēc Lily nekad to neizvēlas jūsu vietā.
  • Vecumi seko Common User Interface joslām caur ageParts(); pakalpojums ar citu konvenciju nodod savus vārdus.
  • Datums, kas zināms tikai līdz mēnesim vai gadam, tāds arī paliek: jautājiet to ar date-field precision="month" vai "year", saglabājiet 2019-03 vai 2019un rakstiet ar formatPartialDate(). Nekad neizdomājiet dienu.
  • Laika ilgums ir duration-view, <time datetime="P3DT4H"> , kas satur jūsu vārdus, no durationParts() un Intl.DurationFormat.

Informācijas paneļi

  • Nodaļas tāfele vai vadības centra ekrāns tiek atjaunināts bieži. Nekad nepaziņojiet katru izmaiņu: turiet vienu pieklājīgu kopsavilkuma reģionu („3 brīvas gultas, 2 plānotas izrakstīšanas”) un ļaujiet cilvēkiem lasīt tāfeli.
  • Katrs stāvoklis tāfelē (gulta tīra, aizņemta, bloķēta) ir teksts vai data-* stāvoklis ar vārdiem, nekad tikai krāsa.
  • Nekas nemirgo (WCAG 2.2.2, 2.3.1), un dēlim, kas atjaunojas pēc taimera, ir pauzes vadīkla, vai tas atjaunojas tikai pēc pieprasījuma; atjauninājumi nekad nepārvieto fokusu. Nokavēts ieraksts to pasaka vārdiem (“Gaida ilgāk par 20 minūtēm”) ar data-overdue.
  • Skaits vai likme rāda savu saucēju (“12 no 68”) un saista uz sarakstu aiz tā.
  • Saraksts vai laika josla pasaka, kā skats tas ir: ko tas rāda, kārtību un laika logu, kas ir paslēpts un kāpēc, un kuri avoti neatbildēja. Tukšs saraksts no avota, kas neatbildēja, nepierāda, ka nekā nav.
  • Atgādinājumu saraksts ir record-list , kura elementiem ir termiņš (review-date) un termiņa stāvoklis vārdiem, ar data-due; noteikums, kas to izveidoja, ir jūsu.

Veidlapas

  • Jautājums, uz kuru atbild “jā”, “nē” vai “nav jautāts”, ir radio-group ar trim atbildēm, sākumā neviena nav izvēlēta, nekad izvēles rūtiņa: rūtiņa nevar atšķirt “noliegts” no “nekad nav jautāts”. Sistēmu apskats ir viens fieldset katrai ķermeņa sistēmai, un poga “visi pārējie nav” iestata tikai neatbildētos.
  • Jautājums ar atbilžu sarakstu (zāles, adreses) ir repeatable-fieldset: elements tiek pievienots vai noņemts, fokuss seko, un katra noņemšanas poga ir nosaukta pēc sava elementa.
  • Skaitlis ar decimālkomatu: rādiet to ar Intl.NumberFormat un, kur type="number" nepieņem komatu, saņemiet to teksta laukā ar inputmode="decimal" un parsējiet savā kodā. Nekad nemainiet personas ievadītu vērtību, pat lai to ierobežotu diapazonā: vērtība ārpus diapazona ir kļūda, ko viņi var redzēt.
  • Garš saraksts, kas vienlaikus rāda tikai daļu iespēju, iestata aria-setsize un aria-posinset katrai iespējai un atceras, ka meklēšana lapā neredz pārējo.

Ieraksti, piezīmes un to izcelsme

  • Pirms rindām pasakiet, kā skats ir saraksts vai režģis: laika logs un kārtība, ko tas izlaiž un kāpēc, un kuri avoti neatbildēja (“Pēdējie 12 mēneši, jaunākie vispirms. Ģimenes ārsta ieraksts neatbildēja.”). Piešķiriet record-list un timeline-list coverageLabel, un palīgkomponentam data-grid tā coverageLabel. Tukšs saraksts no avota, kas neatbildēja, to pasaka vārdiem, lai to nekad nenolasītu kā “nekas nav reģistrēts”.
  • Ar record-provenance-viewpasakiet, no kurienes ieraksts nāk un vai tas ir galīgs: parakstīts, gaida parakstu, grozīts, saglabāts šajā ierīcē un vēl nav nosūtīts. Neparakstīts melnraksts nekad nedrīkst izskatīties parakstīts.
  • Ieraksts par kādu citu (vecāku, augli, donoru) vispirms pasaka, kam tas pieder, ar ieraksta elementu subjectLabel.
  • Aizturēts ieraksts paliek sarakstā ar jūsu vārdiem (“Ierobežots: jums nav pieejams”), un kļūdaini veikts ieraksts paliek pārsvītrots ar “Ievadīts kļūdaini”: piešķiriet record-list-item vai timeline-list-item entryState un entryStateLabel. Nekad nenoņemiet nevienu no tiem klusi, jo robu nolasa kā “nekas nenotika”.
  • Klīniskā piezīmē atzīmējiet katra fragmenta avotu (rakstīts, diktēts, veidne, nokopēts uz priekšu, ģenerēts) ar data-source un redzamiem vārdiem, lai nokopētu vai ģenerētu tekstu nekad neuzskatītu par šodienas izmeklējumu.
  • Sadaļa, ko nevar ielādēt, ir unavailable jūsu vārdiem, ar pogu mēģināt vēlreiz; tehniskais kods, ja vispār rādīts, atrodas aiz izvēršamas daļas. Kļūme, ko izraisīja personas darbība, tiek paziņota kopā ar vērtību, kas ierakstam tagad ir; kļūme lapas ielādē – nē.
  • Nozīmējuma vēsture ir timeline-list, viens elements katram solim (plānots, ieplānots, aktīvs, apturēts, pabeigts, atcelts) ar laiku un iemeslu, un pašreizējais stāvoklis arī elementā.

No FHIR uz Lily

Lily nelasa FHIR resursus; jūsu kods tos kartē uz Lily props. Šīs tabulas kartē HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Kodu kartējums ir ieteikums: to nosaka jūsu klīniskās drošības pārskats, un vārdi katram stāvoklim ir jūsu pašu.

IPS sadaļas un tām atbilstošie Lily komponenti
IPS sadaļa Lily
Alerģijas un nepanesība (48765-2) allergy-record-list un tā vienumi
Zāļu kopsavilkums (10160-0) medication-record-list, katrs vienums satur medication-view
Problēmu saraksts (11450-4) problem-record-list un tā vienumi
Vakcinācijas (11369-6) immunization-record-list un tā vienumi
Rezultāti (30954-2) observation-view, datu tabulā vai kopsavilkuma sarakstā
Procedūru vēsture (47519-4) procedure-record-list un tā vienumi
Medicīniskās ierīces (46264-8) device-record-list un tā vienumi
Brīdinājumi (104605-1) Brīdinājuma teksts vai brīdinājums, nekad aiz sakļautas vadīklas
Jebkura cita sadaļa record-list un tā vienumi
Obligāta sadaļa, ko dokuments izlaiž Sadaļas saraksts ar status="omitted"
FHIR kodi un tiem atbilstošās Lily vērtības
FHIR Lily
emptyReason nilknown Saraksta status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", ar vārdiem, kas norāda, kurš
IPS kodi no-known-allergies, no-known-medications un tamlīdzīgi status="none-known"
IPS kodi no-allergy-info, no-medication-info un tamlīdzīgi status="not-recorded"
AllergyIntolerance.criticality criticality, atsevišķi no reakcijas severity
clinicalStatus, verificationStatus Tie paši props uz alerģijas un problēmas vienumiem, ar tiem pašiem kodiem
MedicationStatement.status Zāļu vienuma status
Dosage.text medication-view dosageText
Observation.status observation-view status, ar tiem pašiem kodiem
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (arī ierakstu sarakstos)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Ierakstu ar statusu entered-in-error kartējiet uz statusu entered-in-error, ar vārdiem, nevis klusībā to izlaižot: vai to vispār rādīt, ir jūsu pakalpojuma lēmums.

No openEHR uz Lily

Lily nelasa arī openEHR kompozīcijas. Atbilstība openEHR atsauces modeļa datu tipiem un kodiem kā ieteikums, par kuru lemj jūsu klīniskās drošības pārskats:

openEHR datu tipi un kodi un tiem atbilstošās Lily vērtības
openEHR Lily
DV_QUANTITY (ievade) quantity-input-div; mērvienības kā UCUM kodi ar jūsu vārdiem
DV_QUANTITY (attēlošana), magnitude_status observation-view ar formatQuantity(value, unit, locale, comparator) (~ ir ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges ar meaning observation-view ranges
DV_DATE daļējs (gads, gads un mēnesis) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view ar durationParts()
DV_PROPORTION formatProportion() iekšā observation-view
DV_ORDINAL, DV_SCALE radio-group , kura etiķetēs ir skaitlis un tā vārdi
DV_CODED_TEXT kodēto vērtību modelis zemāk
DV_BOOLEAN checkbox-input, tikai tad, ja “nav jautāts” nevar notikt
ELEMENT.null_flavour 253 nezināms, 271 nav informācijas status="not-recorded" vai "unavailable", ar vārdiem, kas norāda, kurš
null_flavour 272 maskēts observation-view status="masked"
null_flavour 273 neattiecas status="not-applicable"
PARTY_RELATED subjekts subjectLabel ieraksta elementos
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Instruction State Machine soļi timeline-list no soļiem, ar pašreizējo stāvokli elementā
arhetipa elements ar sastopamību 0..* repeatable-fieldset

Kodētas vērtības

  • Rādiet Coding.display; ja tā nav, CodeableConcept.text; ja nav neviena, system|code. Nekad tukša šūna.
  • Piedāvājiet vadīklu, kas blakus katrai vērtībai parāda kodu sistēmu un kodu, piemēram, pārslēgšanas pogu ar tekstu „Rādīt kodus”. Paslēptie kodi paliek ārpus lasīšanas secības, līdz tie tiek parādīti.
  • Klīnisko tekstu atzīmējiet ar dokumenta valodu (lang), kas var atšķirties no saskarnes valodas. Tulkojiet saskarni; klīnisko saturu nekad netulkojiet.
  • Lily nepiegādā terminoloģiju: nekādu SNOMED CT, LOINC, ATC vai UCUM meklēšanu. Rakstiet to, ko saka dokuments. SvelteKit piemēra lapa /patient-summary rāda paraugu.

Ko Lily nedarīs

  • Aprēķināt agrīnās brīdināšanas rādītāju, augšanas centili, devu vai references diapazonu.
  • Piegādāt zāļu datubāzi, tall man sarakstu vai SNOMED CT, SSK, LOINC vai UCUM kodus.
  • Atveidot licencētu instrumentu (Wong-Baker FACES) vai citas iestādes dizainu (NEWS2 diagrammu).
  • Ierobežot vienlaikus atvērto ierakstu skaitu.
  • Izsecināt interpretāciju no diapazona, pārveidot mērvienību vai parsēt relatīvu datumu (“nākamajā otrdienā”).
  • Lietot slēdzi atbildei “jā, nē vai nezināms”: ARIA switch nav trešā stāvokļa, tāpēc tās ir trīs radiopogas.

Šī ceļveža pētījumi, avoti un lēmumi ir spec/healthcare-ui.