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.
| 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 tawarkanoverrideReasonsagar 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelpadacontext-menuataudropdown-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-dialogyang 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-deceaseduntuk 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-groupberlabel 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 sebagaidata-interpretationuntuk 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-viewtidak pernah menyimpulkannya, jadi hasil dengan rentang dan tanpainterpretationtidak menampilkan penanda. -
Hasil di luar skala adalah batas alat dengan pembanding ("> 33,3 mmol/L":
formatQuantitydengan">") 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-chartdengan 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.comparatormilik 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.DateTimeFormatdenganmonth: "short"). - Pilih jam dengan sengaja: berikan
hourCyclesecara 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-fieldprecision="month"atau"year", simpan2019-03atau2019, dan tulis denganformatPartialDate(). Jangan pernah mengarang hari. -
Lama waktu adalah
duration-view,<time datetime="P3DT4H">berisi kata-kata Anda, daridurationParts()danIntl.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-listyang itemnya memuat tanggal jatuh tempo (review-date) dan status jatuh tempo dalam kata-kata, dengandata-due; aturan yang menghasilkannya adalah milik Anda.
Formulir
-
Pertanyaan yang dijawab "ya", "tidak", atau "tidak ditanyakan" adalah
radio-groupdengan 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 satufieldsetper 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.NumberFormatdan, di tempattype="number"tidak menerima koma, terima di kolom teks denganinputmode="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-setsizedanaria-posinsetpada 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-listdantimeline-listcoverageLabel, serta pembantudata-gridmiliknyacoverageLabel. 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-itematautimeline-list-itementryStatedanentryStateLabel. 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-sourcedan kata-kata yang terlihat, agar teks salinan atau hasil buatan tidak pernah dianggap sebagai pemeriksaan hari ini. -
Bagian yang tidak dapat dimuat berstatus
unavailabledalam 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 | 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" |
| 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:
| 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-summarypada 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":
switchmilik ARIA tidak punya keadaan ketiga, jadi itu tiga tombol radio.
Riset, sumber, dan keputusan di balik panduan ini ada di spec/healthcare-ui.