Antara muka pengguna penjagaan kesihatan
Panduan untuk pasukan yang membina perisian klinikal dengan Lily: portal klinikal, keputusan dan pelaporan, preskripsi dan pentadbiran ubat, sokongan keputusan dan papan pemuka hospital.
Terjemahan halaman ini ialah draf mesin yang belum disemak. Halaman bahasa Inggeris ialah versi yang sah.
Apa yang Lily lakukan, dan apa yang tidak
Lily memberi anda kontrak paparan: markup semantik, ARIA, tingkah laku papan kekunci dan cangkuk kelas untuk perkara yang berulang pada skrin klinikal. Lily tidak memberi logik klinikal, kandungan klinikal atau tuntutan kawal selia.
| Lily menyediakan | Anda menyediakan |
|---|---|
| observation-view: nilai, unit, bendera dalam perkataan, julat, dan keadaan tiada | Nilai, keputusan bendera, julat rujukan |
| allergy-record-list dan allergy-record-list-item: status yang tidak pernah kosong | Rekod alahan dan terminologinya |
| medication-view: nama, kekuatan, bentuk, laluan dan kekerapan, tiada yang dipotong | Data ubat, segmen tall man, kekuatan yang diformatkan |
| decision-support-card: bentuk kad CDS Hooks | Peraturan, tindakan cadangan, merekod hasil |
| early-warning-score-view: skor, jalur dan peningkatan, dipaparkan | Sistem pemarkahan dan pengiraannya yang telah disahkan |
age-view dan ageParts(): umur dalam unit yang sesuai |
Perkataan untuk unit (Intl.DurationFormat atau label anda sendiri) |
formatQuantity(): 5 mg, jangan 5.0 mg; 0.5 mg, jangan .5 mg |
Nombor, unit dan locale |
| Komposisi sepanduk pesakit | Setiap label dan nilai, dan siapa yang boleh melihat maklumat klinikal |
Peraturan. Perisian yang mengira skor, sentil, dos atau interaksi ubat biasanya ialah peranti perubatan. Lily tidak mengira satu pun daripada ini, dengan sengaja. Jika produk anda dikawal selia, anda memiliki fail kejuruteraan kebolehgunaannya (IEC 62366-1, panduan faktor manusia FDA, EU MDR). Ujian Lily, laporan pematuhan kebolehcapaian yang dinilai sendiri dan matriks pembaca skrinnya boleh menjadi bukti dalam fail itu; tiada satu pun ialah tuntutan pematuhan, dan matriks itu belum mempunyai keputusan.
Amaran: ganggu hanya untuk yang kritikal
Keletihan amaran ialah masalah keselamatan: apabila setiap amaran mengganggu, orang menolak semuanya. Panduan AHRQ ialah mengelaskan amaran mengikut tahap keterukan dan menjadikan hanya yang teruk bersifat mengganggu.
- Maklumat (
indicator="info"): sebaris, di sebelah tugas, kad sokongan keputusan dalam halaman. - Amaran (
indicator="warning"): kelihatan tanpa menghalang, kad yang sama, digayakan supaya menonjol; tiada modal. - Kritikal (
indicator="critical"): letakkan kad di dalam dialog amaran, dan sediakanoverrideReasonssupaya menolaknya meminta sebab. - Kad sokongan keputusan tidak pernah menjadi kawasan hidup dengan sendirinya. Umumkan kad kritikal baharu dengan memindahkan fokus ke dalam dialog, bukan melalui
aria-live. - Alihkan kad apabila peristiwa yang dijawabnya berlaku sekali lagi, dan rekodkan setiap hasil (diterima, atau ditolak berserta sebabnya).
Ralat pesakit yang salah: kenal pasti, jangan hadkan
- Tunjukkan dua pengenal di mana-mana data pesakit muncul: nama dengan tarikh lahir, dan pengenal kebangsaan dengan komponen paparannya (The Joint Commission, Quick Safety 45).
- Gunakan sepanduk pesakit pada setiap skrin yang bertindak ke atas rekod seorang pesakit, dan pastikan ia kelihatan.
- Sebelum bertindak ke atas rekod selain yang ada dalam sepanduk, sahkannya dengan nama, tarikh lahir dan pengenal.
-
Catatan tentang orang lain selain pesakit (sejarah ibu atau bapa, janin, penderma) terlebih dahulu menyatakan dengan perkataan milik siapa catatan itu: berikan item rekod
subjectLabel("Ibu"), supaya diagnosis saudara tidak pernah dibaca sebagai diagnosis pesakit (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Jangan hadkan bilangan rekod yang boleh dibuka oleh doktor: percubaan rawak ke atas 3,356 doktor (JAMA, 2019) mendapati ia tidak mengurangkan pesanan pesakit yang salah, dan orang mencari jalan mengelaknya.
-
Menu tindakan pada satu rekod terlebih dahulu menamakan rekod itu, dengan
subjectLabelpadacontext-menuataudropdown-menu("Ada Lovelace, tekanan darah 3 Nov"): bahagian pertama yang tidak interaktif dan juga nama boleh capai menu. -
Kelaskan setiap tindakan mengikut apa yang dilakukannya, dan paparkan tahapnya sebelum ia dijalankan. Rutin (lihat, cetak) dijalankan serta-merta. Didokumenkan menyatakan apa yang akan ditulis ke rekod ("Menambah nota pada lawatan").
Klinikal (hentikan, batalkan arahan) bertanya kali kedua, dalam
alert-dialogyang butang pengesahannya ialah kata kerja ("Hentikan"), bukan sekali-kali "OK" atau "Ya". Mendedahkan (akses kecemasan, berkongsi di luar pasukan rawatan) meminta sebab dahulu dan merekodkannya. - Apabila beberapa rekod dibuka (tab, tetingkap, anak tetingkap terbahagi), teks yang kelihatan dan nama boleh capai setiap tab termasuk nama pesakit dan pengecam kedua, anak tetingkap aktif mengulangi sepanduk, dan tiada tindakan terpakai kepada pesakit selain pesakit anak tetingkapnya.
- Paparkan lokasi yang rekod akan dikaitkan dengannya (wad, klinik atau kemudahan yang dipilih semasa log masuk) sebagai teks dalam pengepala halaman, dan jadikan penukarannya tindakan yang jelas.
- Paparkan lawatan aktif, atau "Tiada lawatan aktif", dalam sepanduk. Borang yang memerlukan lawatan menyatakannya dan menawarkan untuk memulakan satu, dan bukannya gagal semasa disimpan.
Sepanduk pesakit
Komposisi ini didokumenkan dengan medical-banner, dengan halaman yang berfungsi di /patient-banner dalam aplikasi contoh SvelteKit:
- dua pengenal, dan umur di sebelah tarikh lahir;
- alahan melalui senarai alahan, supaya "tiada alahan diketahui", "tidak direkodkan" dan "tidak tersedia" tidak pernah kelihatan serupa;
- nilai yang tiada ialah perkataan ("Tidak diketahui"), bukan tanda soal, sempang atau sel kosong;
- pesakit yang telah meninggal:
data-deceaseduntuk tema, dan satu baris teks yang kelihatan, bukan warna sahaja; - tiada medan dipotong, dipangkas atau disembunyikan pada sebarang lebar; ia dibalut.
-
tanda pesakit ("Perlu jurubahasa", "Risiko jangkitan") ialah
tag-groupberlabel yang terdiri daripada perkataan, bukan sekali-kali ikon atau warna sahaja, dan kekal kelihatan apabila sepanduk berbalut.
Keputusan
- Satu paparan untuk keputusan, daripada sistem mana pun ia datang: paparan pemerhatian (observation view).
- Bendera ialah perkataan daripada terjemahan anda (
flagLabel), dengan kod tafsiran FHIR sebagaidata-interpretationuntuk tema. - Asingkan keputusan baharu daripada yang terdahulu, dan tunjukkan aliran (garis percikan, atau carta garis dengan jadual datanya): doktor mencari perubahan ketara, bukan julat sahaja.
- Keputusan yang tidak pernah direkodkan dan yang tidak tersedia ialah keadaan berbeza, dengan perkataan berbeza.
-
Tidak diketahui bukan normal. Keputusan yang julat rujukannya tiada, masih dimuatkan atau tidak dapat dibaca tidak mempunyai tafsiran dan menyatakannya;
observation-viewtidak pernah membuat inferens, jadi keputusan dengan julat dan tanpainterpretationtidak memaparkan tanda. -
Keputusan di luar skala ialah had alat dengan pembanding ("> 33.3 mmol/L":
formatQuantitydengan">") dan tanda kritikal anda, bukan sekali-kali nombor kosong. Nilai anggaran mengekalkan ≈ nya ("~"). - Berikan julat bernama tambahan ("Kritikal: di bawah 2.5") sebagai
ranges, setiap satu sebagai bahagian tersendiri. -
Keputusan yang diperbetulkan atau dipinda mengekalkan nilai yang digantikannya, dalam
<del>, dengan perkataan anda tentang bila ia berubah (previousValue,previousLabel), supaya klinisian yang membaca nilai lama tahu ia telah berubah. -
Bacaan selang menyatakan lebar dan fungsinya ("Min, 24 jam"), dan keadaan serta kaedah bacaan ("Duduk, kaf besar") ialah teks kelihatan di sebelahnya, bukan sekali-kali tip alat sahaja (openEHR
INTERVAL_EVENT,state,protocol). - Trend memerlukan titik yang setanding: jangan lukis garisan di bawah minimum anda, putuskan garisan di tempat kaedah atau ujian berubah, dan nyatakan arah dan maknanya dengan perkataan ("menurun, bertambah baik").
-
Tanda vital yang dimasukkan dalam satu sistem unit boleh memaparkan sistem lain di sebelahnya sebagai teks anda ("70 kg (154 lb)"); Lily tidak menukar apa-apa, jadi nyatakan pembundaran anda. Masukkan kuantiti dengan
quantity-input-div, yang nombornya mengikut had setiap unit. -
Carta pertumbuhan ialah
line-chartdengan garisan persentil anda sebagai siri, titik kanak-kanak dan jadual data umur serta nilai; Lily tidak mengira persentil dan tidak menyertakan rujukan pertumbuhan.
Ubat
- Nama generik dalam huruf kecil, kecuali huruf tall man daripada senarai FDA dan ISMP atau senarai negara anda (Australia dan Kanada menerbitkan senarai sendiri). Tandakannya dalam
nameSegments; Lily tidak pernah meneka. - Tulis kekuatan dengan
formatQuantity: tiada sifar hujung, ada sifar permulaan, dan ruang tanpa pemisah sebelum unit. - Kekalkan pembanding keputusan:
formatQuantity(5, "mmol/L", locale, "<")menulis "<5 mmol/L".Quantity.comparatorFHIR ditulis <, ≤, ≥ atau >; menggugurkannya menjadikan "kurang daripada 5" sebagai "5". - Tulis mL, jangan cc, dan elakkan setiap singkatan dalam senarai ISMP yang terdedah kepada ralat.
- Jangan sekali-kali memotong nama atau dos ubat.
Tarikh dan masa
- Tulis bulan sebagai teks supaya tarikh tidak boleh dibaca dua cara (
Intl.DateTimeFormatdenganmonth: "short"). - Pilih jam dengan sengaja: berikan
hourCyclesecara jelas. NHS meminta jam 24 jam; itu peraturan UK, bukan peraturan sedunia, jadi Lily tidak pernah memilihnya untuk anda. - Umur mengikut jalur Common User Interface melalui
ageParts(); perkhidmatan dengan konvensyen lain memberikan perkataannya sendiri. -
Tarikh yang hanya diketahui hingga bulan atau tahun kekal begitu: mintanya dengan
date-fieldprecision="month"atau"year", simpan2019-03atau2019, dan tuliskan denganformatPartialDate(). Jangan sekali-kali mereka hari. -
Tempoh masa ialah
duration-view,<time datetime="P3DT4H">yang memuatkan perkataan anda, daripadadurationParts()danIntl.DurationFormat.
Papan pemuka
- Papan wad atau skrin pusat arahan dikemas kini kerap. Jangan umumkan setiap perubahan: kekalkan satu kawasan ringkasan sopan ("3 katil kosong, 2 discaj dijangka") dan biarkan orang membaca papan itu.
- Setiap keadaan pada papan (katil bersih, diduduki, disekat) ialah teks atau keadaan
data-*dengan perkataan, bukan warna sahaja. -
Tiada apa-apa berkelip (WCAG 2.2.2, 2.3.1), dan papan yang dikemas kini mengikut pemasa mempunyai kawalan jeda atau hanya dikemas kini apabila diminta; kemas kini tidak pernah mengalihkan fokus. Catatan lewat menyatakannya dengan perkataan ("Menunggu lebih 20 minit") dengan
data-overdue. - Kiraan atau kadar memaparkan penyebutnya ("12 daripada 68") dan memaut ke senarai di belakangnya.
- Senarai atau garis masa menyatakan ia paparan bagi apa: apa yang dipaparkan, susunan dan tempohnya, apa yang disembunyikan dan mengapa, dan sumber mana yang tidak menjawab. Senarai kosong daripada sumber yang tidak menjawab bukan bukti bahawa tiada apa-apa wujud.
-
Senarai peringatan ialah
record-listyang itemnya membawa tarikh tamat (review-date) dan status tamat dalam perkataan, dengandata-due; peraturan yang menghasilkannya ialah milik anda.
Borang
-
Soalan yang dijawab "ya", "tidak" atau "tidak ditanya" ialah
radio-grouptiga jawapan, tiada yang dipilih pada mulanya, bukan sekali-kali kotak semak: kotak semak tidak dapat membezakan "dinafikan" daripada "tidak pernah ditanya". Semakan sistem ialah satufieldsetbagi setiap sistem badan, dan butang "semua yang lain tiada" hanya menetapkan yang belum dijawab. -
Soalan dengan senarai jawapan (ubat, alamat) ialah
repeatable-fieldset: item ditambah atau dibuang, fokus mengikut, dan setiap butang buang dinamakan sempena itemnya. -
Nombor dengan koma perpuluhan: paparkannya dengan
Intl.NumberFormatdan, di manatype="number"tidak menerima koma, terima dalam medan teks denganinputmode="decimal"dan huraikan dalam kod anda. Jangan sekali-kali menukar nilai yang ditaip oleh seseorang, walaupun untuk mengehadkannya kepada julat: nilai di luar julat ialah ralat yang boleh dilihatnya. -
Senarai panjang yang hanya memaparkan sebahagian pilihannya pada satu masa menetapkan
aria-setsizedanaria-posinsetpada setiap pilihan, dan ingat bahawa carian dalam halaman tidak dapat melihat bakinya.
Rekod, nota dan asal-usulnya
-
Nyatakan senarai atau grid itu paparan bagi apa, sebelum barisnya: tempoh dan susunannya, apa yang ditinggalkan dan mengapa, dan sumber mana yang tidak menjawab ("12 bulan lalu, terbaharu dahulu. Rekod doktor keluarga tidak menjawab."). Berikan
record-listdantimeline-listcoverageLabel, dan pembantudata-gridmiliknyacoverageLabel. Senarai kosong daripada sumber yang tidak menjawab menyatakannya dengan perkataan, supaya ia tidak pernah dibaca sebagai "tiada apa-apa direkodkan". -
Nyatakan dari mana rekod datang dan sama ada ia muktamad dengan
record-provenance-view: ditandatangani, menunggu tandatangan, dipinda, disimpan pada peranti ini dan belum dihantar. Draf yang belum ditandatangani tidak boleh kelihatan ditandatangani. - Catatan tentang orang lain (ibu atau bapa, janin, penderma) terlebih dahulu menyatakan milik siapa, dengan
subjectLabel. -
Catatan yang ditahan kekal dalam senarai dengan perkataan anda ("Terhad: tidak tersedia untuk anda"), dan catatan yang dibuat secara silap kekal dipangkah dengan "Dimasukkan secara silap": berikan
record-list-itematautimeline-list-itementryStatedanentryStateLabel. Jangan sekali-kali membuang mana-mana satu secara senyap, kerana jurang dibaca sebagai "tiada apa-apa berlaku". -
Dalam nota klinikal, tandakan sumber setiap petikan (ditaip, didiktekan, templat, disalin ke hadapan, dijana) dengan
data-sourcedan perkataan yang kelihatan, supaya teks yang disalin atau dijana tidak pernah dianggap sebagai pemeriksaan hari ini. -
Bahagian yang tidak dapat dimuatkan ialah
unavailabledalam perkataan anda, dengan butang cuba semula; kod teknikal, jika dipaparkan, berada di sebalik pendedahan. Kegagalan yang disebabkan oleh tindakan seseorang diumumkan, bersama nilai yang kini dipegang rekod; kegagalan semasa halaman dimuatkan tidak. -
Sejarah arahan ialah
timeline-list, satu item bagi setiap langkah (dirancang, dijadualkan, aktif, digantung, selesai, dibatalkan) dengan masa dan sebabnya, dan keadaan semasa juga pada item.
Daripada FHIR kepada Lily
Lily tidak membaca sumber FHIR; kod anda memetakannya kepada props Lily. Jadual ini memetakan HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Pemetaan kod ialah cadangan: semakan keselamatan klinikal anda yang menentukannya, dan perkataan bagi setiap keadaan ialah perkataan anda sendiri.
| Bahagian IPS | Lily |
|---|---|
Alahan dan intoleransi (48765-2) |
allergy-record-list dan item-itemnya |
Ringkasan ubat (10160-0) |
medication-record-list, setiap item memegang medication-view |
Senarai masalah (11450-4) |
problem-record-list dan item-itemnya |
Imunisasi (11369-6) |
immunization-record-list dan item-itemnya |
Keputusan (30954-2) |
observation-view, dalam jadual data atau senarai ringkasan |
Sejarah prosedur (47519-4) |
procedure-record-list dan item-itemnya |
Peranti perubatan (46264-8) |
device-record-list dan item-itemnya |
Amaran (104605-1) |
Teks amaran atau makluman, tidak sekali-kali di sebalik kawalan yang dilipat |
| Mana-mana bahagian lain | record-list dan item-itemnya |
| Bahagian yang diperlukan yang ditinggalkan oleh dokumen | Senarai bahagian itu dengan status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
status="none-known" senarai |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", dengan perkataan yang menyatakan yang mana |
Kod IPS no-known-allergies, no-known-medications dan seumpamanya |
status="none-known" |
Kod IPS no-allergy-info, no-medication-info dan seumpamanya |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, selain severity sesuatu reaksi |
clinicalStatus, verificationStatus |
Props yang sama pada item alahan dan masalah, dengan kod yang sama |
MedicationStatement.status |
status item ubat |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view status, dengan kod yang sama |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (juga pada senarai rekod) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Petakan rekod entered-in-error kepada status entered-in-errornya, dengan perkataan, dan bukan menggugurkannya secara senyap: sama ada hendak menunjukkannya atau tidak ialah keputusan perkhidmatan anda.
Daripada openEHR kepada Lily
Lily juga tidak membaca komposisi openEHR. Pemetaan bagi jenis data dan kod Model Rujukan openEHR, sebagai cadangan yang diputuskan oleh semakan keselamatan klinikal anda:
| openEHR | Lily |
|---|---|
DV_QUANTITY (kemasukan) |
quantity-input-div; unit sebagai kod UCUM dengan perkataan anda |
DV_QUANTITY (paparan), magnitude_status |
observation-view dengan formatQuantity(value, unit, locale, comparator) (~ ialah ≈) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges dengan meaning |
observation-view ranges |
DV_DATE separa (tahun, tahun dan bulan) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view dengan durationParts() |
DV_PROPORTION |
formatProportion() di dalam observation-view |
DV_ORDINAL, DV_SCALE |
radio-group yang labelnya membawa nombor dan perkataannya |
DV_CODED_TEXT |
corak nilai berkod di bawah |
DV_BOOLEAN |
checkbox-input, hanya apabila "tidak ditanya" tidak boleh berlaku |
ELEMENT.null_flavour 253 tidak diketahui, 271 tiada maklumat |
status="not-recorded" atau "unavailable", dengan perkataan yang menyatakan yang mana |
null_flavour 272 disembunyikan |
observation-view status="masked" |
null_flavour 273 tidak berkenaan |
status="not-applicable" |
PARTY_RELATED subjek |
subjectLabel pada item rekod |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Langkah Instruction State Machine | timeline-list langkah, dengan keadaan semasa pada item |
item arketaip dengan kejadian 0..* |
repeatable-fieldset |
Nilai berkod
- Tunjukkan
Coding.display; jika tiada,CodeableConcept.text; jika kedua-duanya tiada,system|code. Jangan sekali-kali sel kosong. - Sediakan kawalan yang mendedahkan sistem kod dan kod di sebelah setiap nilai, seperti butang togol yang berbunyi "Tunjukkan kod". Kod tersembunyi kekal di luar tertib bacaan sehingga ditunjukkan.
- Tandakan teks klinikal dengan bahasa dokumen (
lang), yang mungkin berbeza daripada bahasa antara muka. Terjemahkan antara muka; jangan sekali-kali menterjemah kandungan klinikal. - Lily tidak menyediakan terminologi: tiada carian SNOMED CT, LOINC, ATC atau UCUM. Tulis apa yang dokumen katakan. Contoh SvelteKit menunjukkan coraknya pada halaman
/patient-summary.
Apa yang Lily tidak akan lakukan
- Mengira skor amaran awal, sentil pertumbuhan, dos atau julat rujukan.
- Menyediakan pangkalan data ubat, senarai tall man, atau kod SNOMED CT, ICD, LOINC atau UCUM.
- Menghasilkan semula instrumen berlesen (Wong-Baker FACES) atau reka bentuk badan lain (carta NEWS2).
- Mengehadkan bilangan rekod yang dibuka serentak.
- Membuat inferens tafsiran daripada julat, menukar unit, atau menghurai tarikh relatif ("Selasa depan").
- Menggunakan suis untuk "ya, tidak atau tidak diketahui":
switchARIA tidak mempunyai keadaan ketiga, jadi ia tiga butang radio.
Kajian, sumber dan keputusan di sebalik panduan ini terdapat dalam spec/healthcare-ui.