Інтерфейси користувача в охороні здоров'я
Посібник для команд, що створюють клінічне програмне забезпечення на 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, щоб під час закриття запитувалася причина. - Картка підтримки прийняття рішень сама по собі ніколи не є live-регіоном. Оголошуйте нову критичну картку, переносячи фокус у діалог, а не через
aria-live. - Видаляйте картку, коли подія, на яку вона відповідала, трапляється знову, і записуйте кожен результат (прийнято або відхилено із зазначенням причини).
Помилки щодо ідентифікації пацієнта: розпізнавайте, а не обмежуйте
- Показуйте два ідентифікатори всюди, де з'являються дані пацієнта: ім'я з датою народження та національний ідентифікатор з його компонентом відображення (The Joint Commission, Quick Safety 45).
- Використовуйте банер пацієнта на кожному екрані, що працює із записом одного пацієнта, і тримайте його видимим.
- Перед дією із записом, відмінним від того, що в банері, підтвердьте її за іменем, датою народження та ідентифікатором.
-
Запис про когось, окрім пацієнта (анамнез батька чи матері, плід, донор), спершу словами каже, кого він стосується: задайте елементам запису
subjectLabel(«Мати»), щоб діагноз родича ніколи не читався як діагноз пацієнта (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Не обмежуйте кількість записів, які може відкрити лікар: рандомізоване дослідження за участю 3 356 лікарів (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 ммоль/л»:
formatQuantityз">") і вашою критичною позначкою, ніколи не саме число. Наближене значення зберігає свій ≈ ("~"). - Задавайте додаткові іменовані інтервали («Критичний: нижче 2,5») як
ranges, кожен окремою частиною. -
Виправлений чи змінений результат зберігає замінене значення в
<del>, з вашими словами про те, коли воно змінилося (previousValue,previousLabel), щоб лікар, який прочитав старе значення, знав, що воно змінилося. -
Інтервальне вимірювання вказує свою тривалість і функцію («Середнє, 24 години»), а стан і метод вимірювання («Сидячи, велика манжета») — видимий текст поруч, ніколи не лише підказка (openEHR
INTERVAL_EVENT,state,protocol). - Тренду потрібні порівнянні точки: не малюйте лінію нижче свого мінімуму, розривайте лінію там, де змінився метод чи аналіз, і називайте напрямок і зміст словами («знижується, покращення»).
-
Показники, введені в одній системі одиниць, можуть показувати іншу поруч вашим текстом («70 кг (154 фунти)»); 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; ваш код зіставляє їх із властивостями Lily. Ці таблиці зіставляють міжнародний підсумок про пацієнта HL7 FHIR (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 |
Ті самі властивості в елементів алергій і проблем, з тими самими кодами |
MedicationStatement.status |
status елемента ліків |
Dosage.text |
medication-view dosageText |
Observation.status |
status у observation-view, з тими самими кодами |
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.