医療向けユーザーインターフェース
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.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(「母」)を設定し、親族の診断が患者のものとして読まれないようにします(openEHRPARTY_RELATED、FHIRFamilyMemberHistory). - 臨床医が開ける記録の数を制限しないでください。臨床医 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-fieldprecision="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 |
|---|---|
アレルギーおよび不耐症(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 |
アレルギーと問題の項目にある同じ 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 |
|---|---|
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 にあります。