Antarmuka pengguna layanan kesehatan

Panduan bagi tim yang membangun perangkat lunak klinis dengan Lily: portal klinis, hasil dan pelaporan, peresepan dan pemberian obat, dukungan keputusan, dan dasbor rumah sakit.

Terjemahan halaman ini adalah draf mesin yang belum ditinjau. Halaman bahasa Inggris adalah versi yang otoritatif.

Apa yang dilakukan Lily, dan apa yang tidak

Lily menyediakan kontrak tampilan: markup semantik, ARIA, perilaku papan ketik, dan class hook untuk hal-hal yang berulang di layar klinis. Lily tidak menyediakan logika klinis, konten klinis, atau klaim regulasi.

Apa yang disediakan Lily, dan apa yang Anda sediakan
Lily menyediakan Anda menyediakan
observation-view: nilai, satuan, penanda dalam kata-kata, rentang, dan status data yang hilang Nilai, keputusan penanda, rentang rujukan
allergy-record-list dan allergy-record-list-item: status yang tidak pernah kosong Catatan alergi dan terminologinya
medication-view: nama, kekuatan, bentuk, rute, dan frekuensi, tanpa ada yang dipotong Data obat, segmen tall man, kekuatan yang sudah diformat
decision-support-card: bentuk kartu CDS Hooks Aturan, tindakan saran, pencatatan hasil
early-warning-score-view: skor, pita, dan eskalasi, ditampilkan Sistem penilaian dan perhitungannya yang tervalidasi
age-view dan ageParts(): usia dalam satuan yang sesuai Kata-kata untuk satuan (Intl.DurationFormat atau label Anda sendiri)
formatQuantity(): 5 mg, bukan 5,0 mg; 0,5 mg, bukan ,5 mg Angka, satuan, dan lokal
Komposisi spanduk pasien Setiap label dan nilai, serta siapa yang boleh melihat informasi klinis

Regulasi. Perangkat lunak yang menghitung skor, persentil, dosis, atau interaksi obat biasanya merupakan alat kesehatan. Lily tidak menghitung satu pun dari itu, dengan sengaja. Jika produk Anda diatur, berkas rekayasa kegunaannya adalah tanggung jawab Anda (IEC 62366-1, panduan faktor manusia FDA, EU MDR). Pengujian Lily, laporan kesesuaian aksesibilitas yang dinilai sendiri, dan matriks pembaca layarnya dapat menjadi bukti dalam berkas itu; tidak satu pun dari itu adalah klaim kesesuaian, dan matriksnya belum memiliki hasil.

Peringatan: interupsi hanya untuk yang kritis

Kelelahan peringatan adalah masalah keselamatan: ketika setiap peringatan menginterupsi, orang menutup semuanya. Panduan AHRQ adalah menjenjangkan peringatan menurut tingkat keparahan dan hanya menjadikan yang parah bersifat interupsi.

  • Informasi (indicator="info"): sebaris, di samping tugas, kartu dukungan keputusan di halaman.
  • Peringatan (indicator="warning"): terlihat tanpa memblokir, kartu yang sama, bergaya mencolok; tanpa modal.
  • Kritis (indicator="critical"): letakkan kartu di dalam dialog peringatan, dan tawarkan overrideReasons agar menutupnya meminta alasan.
  • Kartu dukungan keputusan tidak pernah menjadi live region dengan sendirinya. Umumkan kartu kritis baru dengan memindahkan fokus ke dalam dialog, bukan dengan aria-live.
  • Hapus kartu ketika peristiwa yang dijawabnya terjadi lagi, dan catat setiap hasil (diterima, atau ditimpa beserta alasannya).

Kesalahan pasien: identifikasi, jangan batasi

  • Tampilkan dua pengenal di mana pun data pasien muncul: nama beserta tanggal lahir, dan pengenal nasional dengan komponen view-nya (The Joint Commission, Quick Safety 45).
  • Gunakan spanduk pasien di setiap layar yang bertindak pada rekam satu pasien, dan jaga agar tetap terlihat.
  • Sebelum bertindak pada rekam selain yang ada di spanduk, konfirmasikan dengan nama, tanggal lahir, dan pengenal.
  • Entri tentang orang lain selain pasien (riwayat orang tua, janin, donor) lebih dulu menyebutkan dengan kata-kata milik siapa entri itu: beri item rekam medis subjectLabel ("Ibu"), agar diagnosis kerabat tidak pernah dibaca sebagai diagnosis pasien (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Jangan batasi berapa banyak rekam yang boleh dibuka seorang klinisi: uji acak terhadap 3.356 klinisi (JAMA, 2019) menemukan bahwa hal itu tidak mengurangi pesanan untuk pasien yang salah, dan orang mencari jalan pintas.
  • Menu tindakan pada satu rekam medis lebih dulu menyebut rekam medis itu, dengan subjectLabel pada context-menu atau dropdown-menu ("Ada Lovelace, tekanan darah 3 Nov"): bagian pertama yang tidak interaktif dan sekaligus nama aksesibel menu.
  • Kelompokkan setiap tindakan menurut apa yang dilakukannya, dan tampilkan tingkatnya sebelum dijalankan. Rutin (lihat, cetak) langsung dijalankan. Terdokumentasi menyebutkan apa yang akan ditulis ke rekam medis ("Menambahkan catatan ke kunjungan"). Klinis (hentikan, batalkan order) meminta konfirmasi kedua, dalam alert-dialog yang tombol konfirmasinya adalah kata kerja ("Hentikan"), tidak pernah "OK" atau "Ya". Mengungkap (akses darurat, berbagi di luar tim perawatan) lebih dulu meminta alasan dan mencatatnya.
  • Saat beberapa rekam medis terbuka (tab, jendela, panel terbagi), teks terlihat dan nama aksesibel setiap tab memuat nama pasien dan identitas kedua, panel aktif mengulang banner, dan tidak ada tindakan yang berlaku untuk pasien selain pasien panelnya.
  • Tampilkan lokasi tempat rekam medis akan diatribusikan (bangsal, klinik, atau fasilitas yang dipilih saat masuk) sebagai teks di kepala halaman, dan jadikan penggantiannya tindakan yang eksplisit.
  • Tampilkan kunjungan aktif, atau "Tidak ada kunjungan aktif", di banner. Formulir yang memerlukan kunjungan menyatakannya dan menawarkan untuk memulainya, alih-alih gagal saat disimpan.

Spanduk pasien

Komposisinya didokumentasikan dengan medical-banner, dengan halaman kerja di /patient-banner pada aplikasi contoh SvelteKit:

  • dua pengenal, dan usia di samping tanggal lahir;
  • alergi melalui daftar alergi, sehingga “tidak ada alergi yang diketahui”, “tidak dicatat”, dan “tidak tersedia” tidak pernah terlihat sama;
  • nilai yang hilang berupa kata-kata (“Tidak diketahui”), tidak pernah tanda tanya, tanda hubung, atau sel kosong;
  • pasien yang meninggal: data-deceased untuk tema, dan satu baris teks yang terlihat, tidak pernah hanya warna;
  • tidak ada bidang yang dipotong, terpangkas, atau disembunyikan pada lebar apa pun; teks dibungkus.
  • penanda pasien ("Butuh juru bahasa", "Risiko infeksi") adalah tag-group berlabel berisi kata-kata, tidak pernah ikon atau warna saja, dan tetap terlihat saat banner terlipat.

Hasil

  • Satu tampilan untuk sebuah hasil, dari sistem mana pun asalnya: tampilan observasi.
  • Penanda berupa kata-kata dari terjemahan Anda (flagLabel), dengan kode interpretasi FHIR sebagai data-interpretation untuk tema.
  • Pisahkan hasil baru dari yang lebih awal, dan tunjukkan tren (sparkline, atau grafik garis dengan tabel datanya): klinisi mencari perubahan yang signifikan, bukan hanya rentangnya.
  • Hasil yang tidak pernah dicatat dan hasil yang tidak tersedia adalah dua keadaan berbeda, dengan kata-kata yang berbeda.
  • Tidak diketahui bukan berarti normal. Hasil yang rentang rujukannya tidak ada, masih dimuat, atau tidak terbaca tidak memiliki interpretasi dan menyatakannya; observation-view tidak pernah menyimpulkannya, jadi hasil dengan rentang dan tanpa interpretation tidak menampilkan penanda.
  • Hasil di luar skala adalah batas alat dengan pembanding ("> 33,3 mmol/L": formatQuantity dengan ">") dan penanda kritis Anda, tidak pernah angka telanjang. Nilai perkiraan mempertahankan ≈-nya ("~").
  • Berikan rentang bernama tambahan ("Kritis: di bawah 2,5") sebagai ranges, masing-masing sebagai bagian tersendiri.
  • Hasil yang dikoreksi atau diubah menyimpan nilai yang digantikannya, dalam <del>, dengan kata-kata Anda tentang kapan nilai itu berubah (previousValue, previousLabel), agar klinisi yang membaca nilai lama tahu bahwa nilainya berubah.
  • Pengukuran interval menyebutkan lebar dan fungsinya ("Rerata, 24 jam"), dan keadaan serta metode pengukuran ("Duduk, manset besar") berupa teks terlihat di sampingnya, tidak pernah hanya tooltip (openEHR INTERVAL_EVENT, state, protocol).
  • Tren memerlukan titik yang sebanding: jangan gambar garis di bawah nilai minimum Anda, putuskan garis di tempat metode atau pemeriksaan berubah, dan nyatakan arah dan maknanya dengan kata-kata ("menurun, membaik").
  • Tanda vital yang dimasukkan dalam satu sistem satuan dapat menampilkan satuan lain di sampingnya sebagai teks Anda ("70 kg (154 lb)"); Lily tidak mengonversi apa pun, jadi nyatakan pembulatan Anda. Masukkan kuantitas dengan quantity-input-div, yang angkanya mengikuti batas setiap satuan.
  • Kurva pertumbuhan adalah line-chart dengan garis persentil Anda sebagai seri, titik-titik anak, dan tabel data usia serta nilainya; Lily tidak menghitung persentil dan tidak menyertakan acuan pertumbuhan.

Obat

  • Nama generik dalam huruf kecil, kecuali huruf tall man dari daftar FDA dan ISMP atau daftar negara Anda (Australia dan Kanada menerbitkan daftar sendiri). Tandai di nameSegments; Lily tidak pernah menebaknya.
  • Tulis kekuatan dengan formatQuantity: tanpa nol di belakang, dengan nol di depan, dan spasi tanpa jeda sebelum satuan.
  • Pertahankan pembanding hasil: formatQuantity(5, "mmol/L", locale, "<") menulis “<5 mmol/L”. Quantity.comparator milik FHIR ditulis <, ≤, ≥ atau >; jika dihilangkan, “kurang dari 5” menjadi “5”.
  • Tulis mL, bukan cc, dan hindari setiap singkatan dalam daftar singkatan rawan kesalahan ISMP.
  • Jangan pernah memotong nama atau dosis obat.

Tanggal dan waktu

  • Tulis bulan sebagai teks agar tanggal tidak dapat dibaca dua cara (Intl.DateTimeFormat dengan month: "short").
  • Pilih jam dengan sengaja: berikan hourCycle secara eksplisit. NHS meminta jam 24 jam; itu aturan Inggris, bukan aturan dunia, jadi Lily tidak pernah memilihkannya untuk Anda.
  • Usia mengikuti pita Common User Interface melalui ageParts(); layanan dengan konvensi lain memberikan kata-katanya sendiri.
  • Tanggal yang hanya diketahui sampai bulan atau tahun tetap demikian: tanyakan dengan date-field precision="month" atau "year", simpan 2019-03 atau 2019, dan tulis dengan formatPartialDate(). Jangan pernah mengarang hari.
  • Lama waktu adalah duration-view, <time datetime="P3DT4H"> berisi kata-kata Anda, dari durationParts() dan Intl.DurationFormat.

Dasbor

  • Papan bangsal atau layar pusat komando sering diperbarui. Jangan pernah mengumumkan setiap perubahan: pertahankan satu wilayah ringkasan polite (“3 tempat tidur kosong, 2 pemulangan dijadwalkan”) dan biarkan orang membaca papannya.
  • Setiap status pada papan (tempat tidur bersih, terisi, diblokir) berupa teks atau status data-* dengan kata-kata, tidak pernah hanya warna.
  • Tidak ada yang berkedip (WCAG 2.2.2, 2.3.1), dan papan yang diperbarui dengan pewaktu memiliki kontrol jeda atau hanya diperbarui saat diminta; pembaruan tidak pernah memindahkan fokus. Entri yang terlambat menyatakannya dengan kata-kata ("Menunggu lebih dari 20 menit") dengan data-overdue.
  • Jumlah atau angka menampilkan penyebutnya ("12 dari 68") dan menaut ke daftar di baliknya.
  • Daftar atau linimasa menyatakan tampilan dari apa dirinya: apa yang ditampilkan, urutan dan rentang waktunya, apa yang disembunyikan dan mengapa, serta sumber mana yang tidak menjawab. Daftar kosong dari sumber yang tidak menjawab bukan bukti bahwa tidak ada apa pun.
  • Daftar pengingat adalah record-list yang itemnya memuat tanggal jatuh tempo (review-date) dan status jatuh tempo dalam kata-kata, dengan data-due; aturan yang menghasilkannya adalah milik Anda.

Formulir

  • Pertanyaan yang dijawab "ya", "tidak", atau "tidak ditanyakan" adalah radio-group dengan tiga jawaban, tidak ada yang terpilih di awal, tidak pernah kotak centang: kotak centang tidak dapat membedakan "menyangkal" dari "tidak pernah ditanyakan". Tinjauan sistem adalah satu fieldset per sistem tubuh, dan tombol "semua lainnya tidak ada" hanya mengisi yang belum dijawab.
  • Pertanyaan dengan daftar jawaban (obat, alamat) adalah repeatable-fieldset: item ditambahkan atau dihapus, fokus mengikutinya, dan setiap tombol hapus dinamai menurut itemnya.
  • Angka dengan koma desimal: tampilkan dengan Intl.NumberFormat dan, di tempat type="number" tidak menerima koma, terima di kolom teks dengan inputmode="decimal" lalu urai dalam kode Anda. Jangan pernah mengubah nilai yang diketik orang, bahkan untuk membatasinya ke suatu rentang: nilai di luar rentang adalah galat yang dapat mereka lihat.
  • Daftar panjang yang hanya merender sebagian opsinya sekaligus menetapkan aria-setsize dan aria-posinset pada setiap opsi, dan mengingat bahwa pencarian di halaman tidak dapat melihat sisanya.

Rekam medis, catatan, dan asal-usulnya

  • Nyatakan daftar atau kisi itu tampilan dari apa, sebelum barisnya: rentang waktu dan urutannya, apa yang dikecualikan dan mengapa, serta sumber mana yang tidak menjawab ("12 bulan terakhir, terbaru lebih dulu. Rekam medis dokter keluarga tidak menjawab."). Beri record-list dan timeline-list coverageLabel, serta pembantu data-grid miliknya coverageLabel. Daftar kosong dari sumber yang tidak menjawab menyatakannya dengan kata-kata, agar tidak pernah dibaca sebagai "tidak ada yang dicatat".
  • Nyatakan dari mana rekam medis berasal dan apakah sudah final dengan record-provenance-view: ditandatangani, menunggu tanda tangan, diubah, disimpan di perangkat ini dan belum dikirim. Draf yang belum ditandatangani tidak boleh tampak sudah ditandatangani.
  • Entri tentang orang lain (orang tua, janin, donor) lebih dulu menyebutkan milik siapa, dengan subjectLabel.
  • Entri yang ditahan tetap di daftar dengan kata-kata Anda ("Dibatasi: tidak tersedia untuk Anda"), dan entri yang dibuat karena kekeliruan tetap dicoret dengan "Dimasukkan karena kekeliruan": beri record-list-item atau timeline-list-item entryState dan entryStateLabel. Jangan pernah menghapus keduanya diam-diam, karena celah dibaca sebagai "tidak terjadi apa-apa".
  • Dalam catatan klinis, tandai sumber setiap bagian (diketik, didiktekan, templat, disalin dari catatan sebelumnya, dihasilkan) dengan data-source dan kata-kata yang terlihat, agar teks salinan atau hasil buatan tidak pernah dianggap sebagai pemeriksaan hari ini.
  • Bagian yang tidak dapat dimuat berstatus unavailable dalam kata-kata Anda, dengan tombol coba lagi; kode teknis, jika ditampilkan, berada di balik pengungkapan. Kegagalan akibat tindakan seseorang diumumkan, beserta nilai yang kini dimiliki rekam medis; kegagalan saat halaman dimuat tidak.
  • Riwayat order adalah timeline-list, satu item per langkah (direncanakan, dijadwalkan, aktif, ditangguhkan, selesai, dibatalkan) dengan waktu dan alasannya, dan status saat ini juga pada item.

Dari FHIR ke Lily

Lily tidak membaca resource FHIR; kode Anda memetakannya ke props Lily. Tabel-tabel ini memetakan HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Pemetaan kode adalah saran: tinjauan keselamatan klinis Anda yang memutuskannya, dan kata-kata untuk setiap keadaan adalah milik Anda sendiri.

Bagian IPS dan komponen Lily untuknya
Bagian IPS Lily
Alergi dan intoleransi (48765-2) allergy-record-list dan itemnya
Ringkasan obat (10160-0) medication-record-list, setiap item memuat sebuah medication-view
Daftar masalah (11450-4) problem-record-list dan itemnya
Imunisasi (11369-6) immunization-record-list dan itemnya
Hasil (30954-2) observation-view, dalam tabel data atau daftar ringkasan
Riwayat prosedur (47519-4) procedure-record-list dan itemnya
Alat medis (46264-8) device-record-list dan itemnya
Peringatan (104605-1) Teks peringatan atau sebuah peringatan, tidak pernah di balik kontrol yang diciutkan
Bagian lain mana pun record-list dan itemnya
Bagian wajib yang dihilangkan dokumen Daftar bagian itu dengan status="omitted"
Kode FHIR dan nilai Lily untuknya
FHIR Lily
emptyReason nilknown Daftar dengan status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", dengan kata-kata yang menyatakan mana
Kode IPS no-known-allergies, no-known-medications dan sejenisnya status="none-known"
Kode IPS no-allergy-info, no-medication-info dan sejenisnya status="not-recorded"
AllergyIntolerance.criticality criticality, terpisah dari reaksi severity
clinicalStatus, verificationStatus Props yang sama pada item alergi dan masalah, dengan kode yang sama
MedicationStatement.status Item obat: status
Dosage.text medication-view dosageText
Observation.status observation-view status, dengan kode yang sama
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (juga pada daftar rekam medis)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Petakan rekam dengan status entered-in-error ke status entered-in-error, dengan kata-kata, alih-alih menghilangkannya diam-diam: apakah akan menampilkannya sama sekali adalah keputusan layanan Anda.

Dari openEHR ke Lily

Lily juga tidak membaca komposisi openEHR. Pemetaan untuk tipe data dan kode Model Referensi openEHR, sebagai saran yang diputuskan oleh tinjauan keselamatan klinis Anda:

Tipe data dan kode openEHR, serta nilai Lily untuknya
openEHR Lily
DV_QUANTITY (entri) quantity-input-div; satuan sebagai kode UCUM dengan kata-kata Anda
DV_QUANTITY (tampilan), magnitude_status observation-view dengan formatQuantity(value, unit, locale, comparator) (~ adalah ≈)
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 parsial (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 memuat angka dan kata-katanya
DV_CODED_TEXT pola nilai berkode di bawah
DV_BOOLEAN checkbox-input, hanya bila "tidak ditanyakan" tidak mungkin terjadi
ELEMENT.null_flavour 253 tidak diketahui, 271 tidak ada informasi status="not-recorded" atau "unavailable", dengan kata-kata yang menyatakan mana
null_flavour 272 disamarkan observation-view status="masked"
null_flavour 273 tidak berlaku status="not-applicable"
PARTY_RELATED subjek subjectLabel pada item rekam medis
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Langkah Instruction State Machine timeline-list berisi langkah-langkah, dengan status saat ini pada item
item arketipe dengan kemunculan 0..* repeatable-fieldset

Nilai berkode

  • Tampilkan Coding.display; jika tidak ada, CodeableConcept.text; jika keduanya tidak ada, system|code. Tidak pernah sel kosong.
  • Sediakan kontrol yang menampilkan sistem kode dan kode di samping setiap nilai, misalnya tombol sakelar bertuliskan “Tampilkan kode”. Kode yang disembunyikan tetap di luar urutan baca sampai ditampilkan.
  • Tandai teks klinis dengan bahasa dokumen (lang), yang dapat berbeda dari bahasa antarmuka. Terjemahkan antarmuka; jangan pernah menerjemahkan isi klinis.
  • Lily tidak menyertakan terminologi: tidak ada pencarian SNOMED CT, LOINC, ATC, atau UCUM. Tulislah apa yang dikatakan dokumen. Halaman /patient-summary pada contoh SvelteKit menunjukkan polanya.

Apa yang tidak akan dilakukan Lily

  • Menghitung skor peringatan dini, persentil pertumbuhan, dosis, atau rentang rujukan.
  • Menyertakan basis data obat, daftar tall man, atau kode SNOMED CT, ICD, LOINC atau UCUM.
  • Mereproduksi instrumen berlisensi (Wong-Baker FACES) atau desain lembaga lain (bagan NEWS2).
  • Membatasi jumlah rekam yang terbuka sekaligus.
  • Menyimpulkan interpretasi dari rentang, mengonversi satuan, atau mengurai tanggal relatif ("Selasa depan").
  • Memakai sakelar untuk "ya, tidak, atau tidak diketahui": switch milik ARIA tidak punya keadaan ketiga, jadi itu tiga tombol radio.

Riset, sumber, dan keputusan di balik panduan ini ada di spec/healthcare-ui.