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