Інтерфейси користувача в охороні здоров'я

Посібник для команд, що створюють клінічне програмне забезпечення на 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, щоб під час закриття запитувалася причина.
  • Картка підтримки прийняття рішень сама по собі ніколи не є live-регіоном. Оголошуйте нову критичну картку, переносячи фокус у діалог, а не через aria-live.
  • Видаляйте картку, коли подія, на яку вона відповідала, трапляється знову, і записуйте кожен результат (прийнято або відхилено із зазначенням причини).

Помилки щодо ідентифікації пацієнта: розпізнавайте, а не обмежуйте

  • Показуйте два ідентифікатори всюди, де з'являються дані пацієнта: ім'я з датою народження та національний ідентифікатор з його компонентом відображення (The Joint Commission, Quick Safety 45).
  • Використовуйте банер пацієнта на кожному екрані, що працює із записом одного пацієнта, і тримайте його видимим.
  • Перед дією із записом, відмінним від того, що в банері, підтвердьте її за іменем, датою народження та ідентифікатором.
  • Запис про когось, окрім пацієнта (анамнез батька чи матері, плід, донор), спершу словами каже, кого він стосується: задайте елементам запису subjectLabel («Мати»), щоб діагноз родича ніколи не читався як діагноз пацієнта (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Не обмежуйте кількість записів, які може відкрити лікар: рандомізоване дослідження за участю 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-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; ваш код зіставляє їх із властивостями Lily. Ці таблиці зіставляють міжнародний підсумок про пацієнта HL7 FHIR (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 Ті самі властивості в елементів алергій і проблем, з тими самими кодами
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
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.