Пользовательские интерфейсы в здравоохранении

Руководство для команд, создающих клиническое программное обеспечение на 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.