Потребителски интерфейси в здравеопазването

Ръководство за екипи, които изграждат клиничен софтуер с Lily: клинични портали, резултати и отчети, предписване и приложение на лекарства, подкрепа на решенията и болнични табла.

Преводите на тази страница са непроверени машинни чернови. Английската страница е авторитетната версия.

Какво прави Lily и какво не прави

Lily ви дава договори за показване: семантична разметка, ARIA, поведение на клавиатурата и класове за стилизиране на неща, които клиничните екрани повтарят. Не ви дава клинична логика, клинично съдържание или регулаторно твърдение.

Какво предоставя Lily и какво предоставяте вие
Lily предоставя Вие предоставяте
observation-view: стойност, единица, флаг с думи, диапазон и състояния при липсваща стойност Стойността, решението за флага, референтния диапазон
allergy-record-list и allergy-record-list-item: статус, който никога не е празен Записът за алергията и нейната терминология
medication-view: име, сила, форма, път на въвеждане и честота, нищо не е съкратено Данните за лекарството, сегментите tall man, форматираната сила
decision-support-card: формата на картата на CDS Hooks Правилата, действията по предложението, записването на изхода
early-warning-score-view: резултат, категория и ескалация, показани Системата за оценка и валидираното изчисление
age-view и ageParts(): възраст в подходящи за нея единици Думите за единиците (Intl.DurationFormat или вашите собствени етикети)
formatQuantity(): 5 mg, никога 5,0 mg; 0,5 mg, никога ,5 mg Числото, единицата и локалът
Композицията на банера на пациента Всеки етикет и стойност и кой може да вижда клиничната информация

Регулация. Софтуер, който изчислява оценка, центил, доза или лекарствено взаимодействие, обикновено е медицинско изделие. Lily не изчислява нищо от това, нарочно. Ако вашият продукт е регулиран, вие отговаряте за досието по инженеринг на използваемостта (IEC 62366-1, указанията на FDA за човешките фактори, EU MDR). Тестовете на Lily, самооценката на доклада за съответствие по достъпност и матрицата за екранни четци могат да бъдат доказателство в това досие; нито едно от тях не е твърдение за съответствие, а матрицата все още няма резултати.

Предупреждения: прекъсвайте само за критичното

Умората от предупреждения е проблем на безопасността: когато всяко предупреждение прекъсва, хората ги отхвърлят всичките. Насоките на AHRQ са предупрежденията да се степенуват по тежест и само тежките да прекъсват.

  • Информация (indicator="info"): във вграден вид, до задачата, карта за подкрепа на решенията в страницата.
  • Предупреждение (indicator="warning"): видимо, без да блокира, същата карта, стилизирана да се откроява; без модален прозорец.
  • Критично (indicator="critical"): поставете картата в диалог за тревога и предложете overrideReasons, така че отхвърлянето ѝ да изисква причина.
  • Картата за подкрепа на решенията никога сама по себе си не е жива област. Известете за нова критична карта, като преместите фокуса в диалога, а не чрез aria-live.
  • Премахнете картата, когато събитието, на което е отговорила, се случи отново, и записвайте всеки изход (приет или отхвърлен с причината).

Грешки с грешен пациент: идентифицирайте, не ограничавайте

  • Показвайте два идентификатора навсякъде, където се появяват данни на пациент: името с датата на раждане и националния идентификатор с неговия компонент за показване (The Joint Commission, Quick Safety 45).
  • Използвайте банера на пациента на всеки екран, който действа върху записа на един пациент, и го дръжте видим.
  • Преди действие върху запис, различен от този в банера, го потвърдете с името, датата на раждане и идентификатора.
  • Запис за някого, различен от пациента (анамнеза на родител, плод, донор), първо казва с думи за кого се отнася: дайте на елементите на записа subjectLabel („Майка“), за да не се чете никога диагнозата на роднина като диагноза на пациента (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Не ограничавайте колко записа може да отвори клиницистът: рандомизирано проучване с 3356 клиницисти (JAMA, 2019) установи, че това не намалява поръчките за грешен пациент, а хората го заобикалят.
  • Меню с действия върху един запис първо назовава този запис, чрез subjectLabel на context-menu или dropdown-menu („Ада Лъвлейс, кръвно налягане 3 ноем.“): неинтерактивна първа част, която е и достъпното име на менюто.
  • Разпределете всяко действие по ниво според това какво прави и покажете нивото, преди да се изпълни. Рутинно (преглед, печат) се изпълнява веднага. Документирано казва какво ще запише в записа („Добавя бележка към посещението“). Клинично (спиране, отмяна на назначение) пита втори път, в alert-dialog , чийто бутон за потвърждение е глаголът („Спри“), никога „OK“ или „Да“. Разкриващо (спешен достъп, споделяне извън лекуващия екип) първо иска причина и я записва.
  • Когато са отворени няколко записа (раздели, прозорци, разделени панели), видимият текст и достъпното име на всеки раздел съдържат името на пациента и втори идентификатор, активният панел повтаря банера и нито едно действие не се отнася за пациент, различен от този на панела му.
  • Показвайте мястото, към което ще се отнасят записите (отделението, кабинета или заведението, избрани при влизане), като текст в заглавката на страницата и направете смяната му изрично действие.
  • Показвайте в банера активното посещение или „Няма активно посещение“. Формуляр, който се нуждае от посещение, го казва и предлага да започне такова, вместо да се провали при запазване.

Банерът на пациента

Композицията е документирана с medical-banner, с работеща страница на /patient-banner в примерното приложение със SvelteKit:

  • два идентификатора и възрастта до датата на раждане;
  • алергиите чрез списък с алергии, така че „няма известни алергии“, „не е записано“ и „недостъпно“ никога да не изглеждат еднакво;
  • липсваща стойност се изписва с думи („Неизвестно“), никога с въпросителен знак, тире или празна клетка;
  • починал пациент: data-deceased за темата и видим ред текст, никога само цвят;
  • никое поле не е съкратено, отрязано или скрито при каквато и да е ширина; текстът се пренася.
  • отметките за пациента („Нуждае се от преводач“, „Риск от инфекция“) са надписана tag-group от думи, никога само икони или цвят, и остават видими, когато банерът се пренесе.

Резултати

  • Един изглед за резултат, от която и да е система да идва: изгледът на наблюдение.
  • Флагът е с думи от вашия превод (flagLabel), а кодът за интерпретация на FHIR е data-interpretation за темата.
  • Отделяйте новите резултати от по-ранните и показвайте тенденция (спарклайн или линейна диаграма с таблицата ѝ с данни): клиницистите търсят значима промяна, а не само диапазона.
  • Резултат, който никога не е записван, и резултат, който е недостъпен, са различни състояния с различни думи.
  • Неизвестното не е нормално. Резултат, чийто референтен интервал липсва, още се зарежда или е нечетим, няма интерпретация и го казва; observation-view никога не я извежда, затова резултат с интервал и без interpretation не показва отметка.
  • Резултат извън скалата е границата на уреда със знак за сравнение („> 33,3 mmol/L“: formatQuantity с ">") и вашата критична отметка, никога голо число. Приблизителната стойност запазва своето ≈ ("~").
  • Задайте допълнителни именувани интервали („Критично: под 2,5“) като ranges, всеки като отделна част.
  • Коригиран или изменен резултат запазва заменената стойност в <del>, с вашите думи кога се е променила (previousValue, previousLabel), за да знае клиницистът, прочел старата стойност, че тя се е променила.
  • Интервално измерване посочва своята продължителност и функция („Средно, 24 часа“), а състоянието и методът на измерване („Седнал, голям маншет“) са видим текст до него, никога само подсказка (openEHR INTERVAL_EVENT, state, protocol).
  • Тенденцията изисква сравними точки: не чертайте линия под своя минимум, прекъсвайте линията там, където методът или изследването са се сменили, и казвайте посоката и смисъла с думи („спада, подобрение“).
  • Жизнени показатели, въведени в една система единици, могат да показват другата до тях като ваш текст („70 kg (154 lb)“); Lily нищо не преобразува, затова посочете закръглянето си. Въвеждайте количество с quantity-input-div, чието число следва границите на всяка единица.
  • Растежната крива е line-chart с вашите центилни линии като серии, точките на детето и таблицата с данни за възраст и стойност; Lily не изчислява центили и не доставя растежни референции.

Лекарства

  • Генеричните имена с малки букви, освен буквите tall man от списъците на FDA и ISMP или от списъка на вашата страна (Австралия и Канада публикуват свои). Отбелязвайте ги в nameSegments; Lily никога не ги налучква.
  • Пишете силата с formatQuantity: без нула в края, с водеща нула, с неразделящ интервал преди единицата.
  • Запазвайте оператора за сравнение на резултата: formatQuantity(5, "mmol/L", locale, "<") записва „<5 mmol/L“. Quantity.comparator във FHIR се записва като <, ≤, ≥ или >; ако се пропусне, „по-малко от 5“ става „5“.
  • Пишете mL, никога cc, и избягвайте всяко съкращение от списъка на ISMP с податливите на грешка.
  • Никога не съкращавайте името или дозата на лекарство.

Дати и часове

  • Пишете месеца с текст, за да не може датата да се прочете по два начина (Intl.DateTimeFormat с month: "short").
  • Изберете часовника съзнателно: подайте изрично hourCycle. NHS изисква 24-часов часовник; това е британско правило, не световно, затова Lily никога не го избира вместо вас.
  • Възрастите следват границите на Common User Interface чрез ageParts(); услуга с друга конвенция подава свои думи.
  • Дата, известна само до месеца или годината, остава такава: питайте за нея с date-field precision="month" или "year", съхранявайте 2019-03 или 2019и я записвайте с formatPartialDate(). Никога не измисляйте ден.
  • Продължителността е duration-view, <time datetime="P3DT4H"> с вашите думи, от durationParts() и Intl.DurationFormat.

Табла

  • Табло на отделение или екран на команден център се обновява често. Никога не обявявайте всяка промяна: дръжте една учтива област с обобщение („3 свободни легла, 2 предстоящи изписвания“) и оставете хората да четат таблото.
  • Всяко състояние на таблото (леглото е чисто, заето, блокирано) е текст или състояние data-* с думи, никога само цвят.
  • Нищо не мига (WCAG 2.2.2, 2.3.1), а табло, което се обновява по таймер, има бутон за пауза или се обновява само при поискване; обновяванията никога не местят фокуса. Просрочен запис казва това с думи („Чака повече от 20 минути“) с data-overdue.
  • Брой или дял показва своя знаменател („12 от 68“) и води към списъка зад него.
  • Списък или времева линия казва какъв изглед е: какво показва, реда и периода си, какво е скрито и защо и кои източници не са отговорили. Празен списък от източник, който не е отговорил, не доказва, че нищо не съществува.
  • Списъкът с напомняния е record-list , чиито елементи носят срок (review-date) и състояние на срока с думи, с data-due; правилото, което го е създало, е ваше.

Формуляри

  • Въпрос с отговори „да“, „не“ или „не е питано“ е radio-group от три отговора, нито един избран предварително, никога отметка: отметката не отличава „отрича“ от „никога не е питано“. Прегледът по системи е един fieldset на система органи, а бутонът „всички останали отсъстват“ задава само неотговорените.
  • Въпрос със списък от отговори (лекарства, адреси) е repeatable-fieldset: елемент се добавя или премахва, фокусът следва, а всеки бутон за премахване е наречен по своя елемент.
  • Число с десетична запетая: показвайте го с Intl.NumberFormat и, където type="number" не приема запетаята, го приемайте в текстово поле с inputmode="decimal" и го анализирайте в кода си. Никога не променяйте стойност, въведена от човека, дори за да я ограничите в интервал: стойност извън интервала е грешка, която той може да види.
  • Дълъг списък, който показва само част от опциите си наведнъж, задава aria-setsize и aria-posinset на всяка опция и помни, че търсенето в страницата не вижда останалите.

Записи, бележки и техният произход

  • Преди редовете кажете какъв изглед е списъкът или мрежата: период и ред, какво пропуска и защо и кои източници не са отговорили („Последните 12 месеца, най-новите първо. Записът на личния лекар не отговори.“). Дайте на record-list и на timeline-list coverageLabel, а на помощника data-grid неговия coverageLabel. Празен списък от източник, който не е отговорил, го казва с думи, за да не се чете никога като „нищо не е записано“.
  • Кажете откъде идва записът и дали е окончателен, с record-provenance-view: подписан, очаква подпис, изменен, запазен на това устройство и още неизпратен. Неподписана чернова никога не трябва да изглежда подписана.
  • Запис за някого другиго (родител, плод, донор) първо казва за кого се отнася, с subjectLabel.
  • Задържан запис остава в списъка с вашите думи („Ограничено: недостъпно за вас“), а запис, въведен по грешка, остава зачеркнат с „Въведено по грешка“: дайте на record-list-item или timeline-list-item entryState и entryStateLabel. Никога не премахвайте нито един от тях тихо, защото празнината се чете като „нищо не се е случило“.
  • В клинична бележка отбелязвайте източника на всеки откъс (набран, диктуван, шаблон, пренесен, генериран) с data-source и видими думи, за да не се приеме никога пренесен или генериран текст за днешния преглед.
  • Раздел, който не може да се зареди, е unavailable с вашите думи, с бутон за повторен опит; технически код, ако изобщо се показва, стои зад разгъване. Повреда, причинена от действие на човек, се обявява заедно със стойността, която записът вече съдържа; повреда при зареждане на страницата — не.
  • Историята на назначение е timeline-list, по един елемент на стъпка (планирано, насрочено, активно, спряно, завършено, отменено) с час и причина, а текущото състояние и на елемента.

От FHIR към Lily

Lily не чете ресурси на FHIR; вашият код ги съпоставя към props на Lily. Тези таблици съпоставят HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Съпоставянето на кодовете е предложение: решава го вашата клинична проверка за безопасност, а думите за всяко състояние са ваши.

Секции на IPS и съответните компоненти на Lily
Секция на IPS Lily
Алергии и непоносимости (48765-2) allergy-record-list и неговите елементи
Обобщение на лекарствата (10160-0) medication-record-list, като всеки елемент съдържа medication-view
Списък с проблеми (11450-4) problem-record-list и неговите елементи
Имунизации (11369-6) immunization-record-list и неговите елементи
Резултати (30954-2) observation-view, в таблица с данни или обобщаващ списък
История на процедурите (47519-4) procedure-record-list и неговите елементи
Медицински изделия (46264-8) device-record-list и неговите елементи
Предупреждения (104605-1) Предупредителен текст или сигнал, никога зад свит контрол
Всяка друга секция record-list и неговите елементи
Задължителна секция, която документът пропуска Списъкът на секцията с status="omitted"
Кодове на FHIR и съответните стойности на Lily
FHIR Lily
emptyReason nilknown status="none-known" на списъка
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", с думи, които казват кое е то
Кодовете на IPS no-known-allergies, no-known-medications и подобни status="none-known"
Кодовете на IPS no-allergy-info, no-medication-info и подобни status="not-recorded"
AllergyIntolerance.criticality criticality, отделно от severity на реакцията
clinicalStatus, verificationStatus Същите props при елементите за алергия и за проблем, със същите кодове
MedicationStatement.status status на елемента за лекарство
Dosage.text medication-view dosageText
Observation.status observation-view status, със същите кодове
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (също и в списъците със записи)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Съпоставяйте запис entered-in-error към неговото състояние entered-in-error, с думи, вместо да го пропускате мълчаливо: дали да се показва изобщо, е решение на вашата услуга.

От openEHR към Lily

Lily не чете и композиции на openEHR. Съответствието за типовете данни и кодовете на референтния модел на openEHR като предложение, по което решава вашият преглед на клиничната безопасност:

Типове данни и кодове на openEHR и съответните им стойности в Lily
openEHR Lily
DV_QUANTITY (въвеждане) quantity-input-div; единици като кодове UCUM с вашите думи
DV_QUANTITY (показване), magnitude_status observation-view с formatQuantity(value, unit, locale, comparator) (~ е ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges с meaning observation-view ranges
DV_DATE частична (година, година и месец) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view с durationParts()
DV_PROPORTION formatProportion() в observation-view
DV_ORDINAL, DV_SCALE radio-group , чиито етикети носят числото и думите му
DV_CODED_TEXT моделът за кодирани стойности по-долу
DV_BOOLEAN checkbox-input, само когато „не е питано“ не може да се случи
ELEMENT.null_flavour 253 неизвестно, 271 няма информация status="not-recorded" или "unavailable", с думи, които казват кое е то
null_flavour 272 маскирано observation-view status="masked"
null_flavour 273 неприложимо status="not-applicable"
PARTY_RELATED субект subjectLabel на елементите на записа
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Стъпки на машината на състоянията на инструкциите timeline-list от стъпки, с текущото състояние на елемента
елемент от архетип с кратност 0..* repeatable-fieldset

Кодирани стойности

  • Показвайте Coding.display; ако няма, CodeableConcept.text; ако няма нито едно, system|code. Никога празна клетка.
  • Предложете контрол, който разкрива кодовата система и кода до всяка стойност, например превключващ бутон с надпис „Покажи кодовете“. Скритите кодове остават извън реда на четене, докато не бъдат показани.
  • Отбелязвайте клиничния текст с езика на документа (lang), който може да се различава от този на интерфейса. Превеждайте интерфейса; никога не превеждайте клиничното съдържание.
  • Lily не доставя терминология: без търсене в SNOMED CT, LOINC, ATC или UCUM. Пишете това, което казва документът. Страницата /patient-summary на примера със SvelteKit показва шаблона.

Какво Lily няма да прави

  • Да изчислява ранна предупредителна оценка, растежен центил, доза или референтен диапазон.
  • Да доставя база данни с лекарства, списък tall man или кодове SNOMED CT, МКБ, LOINC или UCUM.
  • Да възпроизвежда лицензиран инструмент (Wong-Baker FACES) или дизайн на друг орган (таблицата NEWS2).
  • Да ограничава броя на едновременно отворените записи.
  • Да се извежда интерпретация от интервал, да се преобразува единица или да се анализира относителна дата („следващия вторник“).
  • Да се използва превключвател за „да, не или неизвестно“: switch в ARIA няма трето състояние, затова това са три радиобутона.

Изследването, източниците и решенията зад това ръководство са в spec/healthcare-ui.