医療向けユーザーインターフェース

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.0 mg ではなく 5 mg、.5 mg ではなく 0.5 mg 数値、単位、ロケール
患者バナーの構成 すべてのラベルと値、および臨床情報を閲覧できる人

規制。スコア、成長パーセンタイル、用量、薬物相互作用を計算するソフトウェアは、通常は医療機器にあたります。Lily はこれらを意図的に一切計算しません。製品が規制対象である場合、そのユーザビリティエンジニアリングファイル(IEC 62366-1、FDA のヒューマンファクターガイダンス、EU MDR)は利用者の責任です。Lily のテスト、自己評価によるアクセシビリティ適合レポート、スクリーンリーダーのマトリクスは、そのファイルの証拠になり得ますが、いずれも適合の主張ではなく、マトリクスにはまだ結果がありません。

アラート: 割り込むのは重大なものだけ

アラート疲れは安全上の問題です。すべてのアラートが割り込むと、人はすべてを閉じてしまいます。AHRQ の指針は、アラートを重大度で階層化し、重大なものだけを割り込みにすることです。

  • 情報(indicator="info"): 作業の横にインラインで表示する、ページ内の意思決定支援カード。
  • 警告(indicator="warning"): 操作を妨げずに見える状態で表示する、目立つよう装飾した同じカード。モーダルにはしない。
  • 重大(indicator="critical"): カードをアラートダイアログの中に入れ、overrideReasons を用意して、閉じるときに理由を尋ねる。
  • 意思決定支援カードそのものがライブリージョンになることは決してありません。新しい重大なカードは、aria-live ではなく、ダイアログ内へフォーカスを移して知らせます。
  • カードが対応したイベントが再び起きたらカードを削除し、各結果(承認、または理由付きの上書き)を記録します。

患者取り違えエラー: 識別させる。制限はしない

  • 患者のデータが表示されるすべての場所で、2 つの識別子を表示します。氏名と生年月日、そして国民識別番号をその view コンポーネントで表示します(The Joint Commission, Quick Safety 45)。
  • 1 人の患者の記録に対して操作を行うすべての画面で患者バナーを使い、常に見える状態に保ちます。
  • バナーに表示されている記録とは別の記録に対して操作を行う前に、氏名、生年月日、識別子で確認します。
  • 患者以外の人についての項目(親の病歴、胎児、提供者)は、まず誰のものかを言葉で示します。記録の項目に subjectLabel (「母」)を設定し、親族の診断が患者のものとして読まれないようにします(openEHR PARTY_RELATED、FHIR FamilyMemberHistory).
  • 臨床医が開ける記録の数を制限しないでください。臨床医 3,356 人によるランダム化試験(JAMA、2019 年)では、制限しても患者取り違えの指示は減らず、人は制限を回避することが分かりました。
  • 1 つの記録に対する操作メニューは、まずその記録を名指しします。 subjectLabel を context-menu または dropdown-menu に使います(「Ada Lovelace、血圧 11月3日」)。操作できない最初の部分で、メニューのアクセシブルな名前でもあります。
  • 各操作を何をするかで段階に分け、実行前にその段階が見えるようにします。 通常 (表示、印刷)はすぐに実行します。 記録型 は記録に何を書き込むかを示します(「受診にメモを追加します」)。 臨床型 (中止、オーダーの取り消し)はもう一度確認します。 alert-dialog を使い、確認ボタンは動詞(「中止する」)にし、「OK」や「はい」にはしません。 開示型 (緊急アクセス、ケアチーム外への共有)はまず理由を求め、それを記録します。
  • 複数の記録を開いているとき(タブ、ウィンドウ、分割ペイン)、各タブの表示テキストとアクセシブルな名前には患者名と 2 つ目の識別子を含め、アクティブなペインはバナーを繰り返し表示し、どの操作もそのペインの患者以外には適用しません。
  • 記録が帰属する場所(サインイン時に選んだ病棟、外来、施設)をページヘッダーにテキストで表示し、変更は明示的な操作にします。
  • バナーに現在の来院、または「現在の来院なし」を表示します。来院が必要なフォームはそのことを伝え、保存時に失敗するのではなく来院の開始を提案します。

患者バナー

この構成は medical-banner に記載されています。SvelteKit のサンプルアプリには /patient-banner に動作するページがあります。

  • 2 つの識別子と、生年月日の横の年齢。
  • アレルギーは allergy list で表示し、「アレルギーなし」「未記録」「利用不可」が決して同じに見えないようにする。
  • 欠損値は言葉(「不明」)で示し、疑問符、ダッシュ、空のセルにはしない。
  • 死亡した患者: テーマ用の data-deceased と、目に見える文章。色だけで示してはならない。
  • どの幅でも、フィールドを切り詰めたり、切り取ったり、隠したりしない。折り返して表示する。
  • 患者フラグ(「通訳が必要」「感染リスク」)は、言葉からなるラベル付きの tag-group にし、アイコンや色だけにはせず、バナーが折り返しても見えるようにします。

検査結果

  • どのシステム由来の結果でも、表示は 1 つです。observation view を使います。
  • フラグは翻訳した言葉(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 はパーセンタイルを計算せず、成長基準も同梱しません。

医薬品

  • 一般名は小文字で書きます。ただし、FDA と ISMP のリスト、または自国のリスト(オーストラリアとカナダは独自のものを公表しています)にある tall man の大文字は除きます。それらは nameSegments に指定します。Lily が推測することは決してありません。
  • 規格は formatQuantity で書きます。末尾のゼロなし、先頭のゼロあり、単位の前にノーブレークスペース。
  • 結果の比較演算子を残します。formatQuantity(5, "mmol/L", locale, "<") は「<5 mmol/L」と書きます。FHIR の Quantity.comparator は <、≤、≥、> のいずれかで書かれ、これを落とすと「5 未満」が「5」になってしまいます。
  • cc ではなく mL と書き、ISMP の誤りやすい略語のリストにある略語はすべて避けます。
  • 医薬品の名称や用量を切り詰めてはいけません。

日付と時刻

  • 日付が 2 通りに読めないよう、月は文字で書きます(Intl.DateTimeFormat と month: "short")。
  • 時計の方式は意図して選びます。hourCycle を明示的に渡してください。NHS は 24 時間表記を求めていますが、これは英国の規則であって世界共通ではないため、Lily が代わりに選ぶことは決してありません。
  • 年齢は ageParts() を通じて Common User Interface の区分に従います。別の慣習を持つサービスは、独自の言葉を渡します。
  • 月や年までしか分からない日付はそのままにします。 date-field precision="month" または "year"で尋ね、 2019-03 または 2019として保存し、 formatPartialDate()で書きます。日を作り出してはいけません。
  • 期間は duration-view、つまり <time datetime="P3DT4H"> にあなたの言葉を入れたもので、 durationParts() と Intl.DurationFormat.

ダッシュボード

  • 病棟ボードやコマンドセンターの画面は頻繁に更新されます。変更のたびに知らせてはいけません。丁寧な(polite)要約リージョンを 1 つ保ち(「空床 3、退院予定 2」)、ボードは人が読むに任せます。
  • ボード上のすべての状態(ベッド清掃済み、使用中、使用不可)は、テキスト、または言葉を伴う data-* の状態で示し、色だけで示してはいけません。
  • 点滅させません(WCAG 2.2.2、2.3.1)。タイマーで更新するボードには一時停止の操作を設けるか、要求時にのみ更新します。更新でフォーカスを動かしてはいけません。期限切れの項目は言葉で伝え(「20 分以上待機中」)、 data-overdue.
  • 件数や割合は分母を示し(「68 件中 12 件」)、その背後のリストにリンクします。
  • リストやタイムラインは、それが何のビューかを示します。何を表示しているか、順序と期間、何をなぜ隠しているか、どの情報源が応答しなかったか。応答しなかった情報源からの空のリストは、何もないことの証明ではありません。
  • リマインダーのリストは record-list で、各項目に期限日(review-date)と言葉による期限の状態を持たせ、 data-dueを設定します。それを生んだ規則はあなたのものです。

フォーム

  • 「はい」「いいえ」「未確認」で答える質問は、 radio-group に 3 つの答えを置き、最初はどれも選ばず、チェックボックスにはしません。チェックボックスでは「否定」と「未確認」を区別できません。系統的レビューは身体系統ごとに 1 つの 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で、手順ごとに 1 項目(計画済み、予定済み、実施中、保留中、完了、取り消し)を時刻と理由付きで並べ、現在の状態も項目に示します。

FHIR から Lily へ

Lily は FHIR リソースを読み取りません。コードがそれらを Lily の props に対応付けます。この 2 つの表は HL7 FHIR International Patient Summary(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 アレルギーと問題の項目にある同じ 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 の値
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 の検索はありません。文書に書かれていることをそのまま書きます。SvelteKit の例の /patient-summary ページがそのパターンを示しています。

Lily が行わないこと

  • 早期警告スコア、成長パーセンタイル、用量、基準範囲を計算すること。
  • 薬剤データベース、tall man リスト、または SNOMED CT、ICD、LOINC、UCUM のコードを同梱すること。
  • ライセンスされた評価尺度(Wong-Baker FACES)や、他機関のデザイン(NEWS2 のチャート)を複製すること。
  • 同時に開くレコード数を制限すること。
  • 範囲から解釈を推定すること、単位を換算すること、相対日付(「来週の火曜日」)を解析すること。
  • 「はい・いいえ・不明」にスイッチを使うこと。ARIA の switch には第 3 の状態がないため、3 つのラジオボタンにします。

この指針の背景にある調査、出典、決定事項は spec/healthcare-ui にあります。