Потребителски интерфейси в здравеопазването
Ръководство за екипи, които изграждат клиничен софтуер с Lily: клинични портали, резултати и отчети, предписване и приложение на лекарства, подкрепа на решенията и болнични табла.
Преводите на тази страница са непроверени машинни чернови. Английската страница е авторитетната версия.
Какво прави Lily и какво не прави
Lily ви дава договори за показване: семантична разметка, ARIA, поведение на клавиатурата и класове за стилизиране на неща, които клиничните екрани повтарят. Не ви дава клинична логика, клинично съдържание или регулаторно твърдение.
| 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(„Майка“), за да не се чете никога диагнозата на роднина като диагноза на пациента (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Не ограничавайте колко записа може да отвори клиницистът: рандомизирано проучване с 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-fieldprecision="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-listcoverageLabel, а на помощникаdata-gridнеговияcoverageLabel. Празен списък от източник, който не е отговорил, го казва с думи, за да не се чете никога като „нищо не е записано“. -
Кажете откъде идва записът и дали е окончателен, с
record-provenance-view: подписан, очаква подпис, изменен, запазен на това устройство и още неизпратен. Неподписана чернова никога не трябва да изглежда подписана. - Запис за някого другиго (родител, плод, донор) първо казва за кого се отнася, с
subjectLabel. -
Задържан запис остава в списъка с вашите думи („Ограничено: недостъпно за вас“), а запис, въведен по грешка, остава зачеркнат с „Въведено по грешка“: дайте на
record-list-itemилиtimeline-list-itementryStateи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 |
|---|---|
Алергии и непоносимости (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 |
|---|---|
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 |
|---|---|
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.