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.

Apa yang Lily sediakan, dan apa yang anda sediakan
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 sediakan overrideReasons supaya 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 (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • 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 subjectLabel pada context-menu atau dropdown-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-dialog yang 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-deceased untuk 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-group berlabel 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 sebagai data-interpretation untuk 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-view tidak pernah membuat inferens, jadi keputusan dengan julat dan tanpa interpretation tidak memaparkan tanda.
  • Keputusan di luar skala ialah had alat dengan pembanding ("> 33.3 mmol/L": formatQuantity dengan ">") 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-chart dengan 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.comparator FHIR 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.DateTimeFormat dengan month: "short").
  • Pilih jam dengan sengaja: berikan hourCycle secara 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-field precision="month" atau "year", simpan 2019-03 atau 2019, dan tuliskan dengan formatPartialDate(). Jangan sekali-kali mereka hari.
  • Tempoh masa ialah duration-view, <time datetime="P3DT4H"> yang memuatkan perkataan anda, daripada durationParts() dan Intl.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-list yang itemnya membawa tarikh tamat (review-date) dan status tamat dalam perkataan, dengan data-due; peraturan yang menghasilkannya ialah milik anda.

Borang

  • Soalan yang dijawab "ya", "tidak" atau "tidak ditanya" ialah radio-group tiga jawapan, tiada yang dipilih pada mulanya, bukan sekali-kali kotak semak: kotak semak tidak dapat membezakan "dinafikan" daripada "tidak pernah ditanya". Semakan sistem ialah satu fieldset bagi 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.NumberFormat dan, di mana type="number" tidak menerima koma, terima dalam medan teks dengan inputmode="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-setsize dan aria-posinset pada 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-list dan timeline-list coverageLabel, dan pembantu data-grid miliknya coverageLabel. 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-item atau timeline-list-item entryState dan entryStateLabel. 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-source dan perkataan yang kelihatan, supaya teks yang disalin atau dijana tidak pernah dianggap sebagai pemeriksaan hari ini.
  • Bahagian yang tidak dapat dimuatkan ialah unavailable dalam 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 dan komponen Lily untuknya
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"
Kod FHIR dan nilai Lily untuknya
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:

Jenis data dan kod openEHR, serta nilai Lily untuknya
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": switch ARIA tidak mempunyai keadaan ketiga, jadi ia tiga butang radio.

Kajian, sumber dan keputusan di sebalik panduan ini terdapat dalam spec/healthcare-ui.