Sağlık hizmetleri kullanıcı arayüzleri
Lily ile klinik yazılım geliştiren ekipler için bir rehber: klinik portallar, sonuçlar ve raporlama, ilaç yazımı ve uygulaması, karar desteği ve hastane panoları.
Bu sayfanın çevirileri gözden geçirilmemiş makine taslaklarıdır. İngilizce sayfa geçerli sürümdür.
Lily ne yapar, ne yapmaz
Lily size görüntüleme sözleşmeleri sunar: klinik ekranlarda tekrarlanan öğeler için anlamsal işaretleme, ARIA, klavye davranışı ve sınıf kancaları. Size klinik mantık, klinik içerik veya bir mevzuat beyanı sunmaz.
| Lily'nin sağladıkları | Sizin sağlayacaklarınız |
|---|---|
| observation-view: bir değer, birim, sözcüklerle işaret, aralık ve eksik durumları | Değer, işaret kararı, referans aralığı |
| allergy-record-list ve allergy-record-list-item: asla boş olmayan bir durum | Alerji kaydı ve terminolojisi |
| medication-view: ad, güç, form, yol ve sıklık, hiçbiri kesilmeden | İlaç verisi, tall man bölümleri, biçimlendirilmiş güç |
| decision-support-card: CDS Hooks kartının biçimi | Kurallar, öneri eylemleri, sonucun kaydedilmesi |
| early-warning-score-view: bir puan, bant ve yükseltme, görüntülenmiş olarak | Puanlama sistemi ve doğrulanmış hesaplaması |
age-view ve ageParts(): yaşa uygun birimlerle bir yaş |
Birimler için sözcükler (Intl.DurationFormat veya kendi etiketleriniz) |
formatQuantity(): 5 mg, asla 5,0 mg değil; 0,5 mg, asla ,5 mg değil |
Sayı, birim ve yerel ayar |
| Hasta başlığı kompozisyonu | Her etiket ve değer ile klinik bilgiyi kimin görebileceği |
Mevzuat. Bir puanı, persentili, dozu veya ilaç etkileşimini hesaplayan yazılım genellikle bir tıbbi cihazdır. Lily bunların hiçbirini bilerek hesaplamaz. Ürününüz düzenlemeye tabiyse, kullanılabilirlik mühendisliği dosyası sizin sorumluluğunuzdadır (IEC 62366-1, FDA'nın insan faktörleri kılavuzu, EU MDR). Lily'nin testleri, kendi kendine değerlendirilmiş erişilebilirlik uygunluk raporu ve ekran okuyucu matrisi bu dosyada kanıt olabilir; hiçbiri bir uygunluk beyanı değildir ve matrisin henüz sonucu yoktur.
Uyarılar: yalnızca kritik olan için kesintiye uğratın
Uyarı yorgunluğu bir güvenlik sorunudur: her uyarı kesintiye neden olduğunda insanlar hepsini kapatır. AHRQ'nun rehberi, uyarıları ciddiyete göre kademelendirmek ve yalnızca ciddi olanları kesintiye neden olacak şekilde yapmaktır.
- Bilgi (
indicator="info"): satır içi, görevin yanında, sayfada bir karar destek kartı. - Uyarı (
indicator="warning"): engellemeden görünür, aynı kart, öne çıkacak şekilde biçimlendirilmiş; modal yok. - Kritik (
indicator="critical"): kartı bir uyarı iletişim kutusunun içine koyun veoverrideReasonssunun; böylece kapatılırken bir neden istenir. - Bir karar destek kartı kendi başına asla bir canlı bölge değildir. Yeni bir kritik kartı
aria-liveile değil, odağı iletişim kutusuna taşıyarak duyurun. - Kartın yanıt verdiği olay yeniden gerçekleştiğinde kartı kaldırın ve her sonucu kaydedin (kabul edildi veya nedeniyle geçersiz kılındı).
Yanlış hasta hataları: tanımlayın, kısıtlamayın
- Hasta verisinin göründüğü her yerde iki tanımlayıcı gösterin: ad ile doğum tarihi ve ulusal tanımlayıcı ile görüntüleme bileşeni (The Joint Commission, Quick Safety 45).
- Bir hastanın kaydı üzerinde işlem yapan her ekranda hasta başlığını kullanın ve görünür tutun.
- Başlıktaki dışındaki bir kayıt üzerinde işlem yapmadan önce, adı, doğum tarihi ve tanımlayıcıyla onaylayın.
-
Hasta dışında birine ilişkin bir kayıt (bir ebeveynin öyküsü, bir fetüs, bir donör) önce kime ait olduğunu sözcüklerle söyler: kayıt öğelerine bir
subjectLabel("Anne") verin, böylece bir akrabanın tanısı hiçbir zaman hastanınki olarak okunmaz (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Bir klinisyenin kaç kayıt açabileceğini sınırlamayın: 3.356 klinisyenle yapılan randomize bir çalışma (JAMA, 2019) bunun yanlış hasta istemlerini azaltmadığını buldu ve insanlar bunu aşmanın yolunu buluyor.
-
Tek bir kayıt üzerindeki eylemler menüsü önce o kaydı adlandırır;
subjectLabelözelliğinicontext-menuveyadropdown-menu("Ada Lovelace, kan basıncı 3 Kas") üzerinde kullanın: menünün erişilebilir adı da olan etkileşimsiz bir ilk bölüm. -
Her eylemi ne yaptığına göre bir düzeye ayırın ve düzeyi eylem çalışmadan önce görünür kılın. Rutin (görüntüle, yazdır) hemen çalışır. Belgelenen kayda ne yazacağını söyler ("Görüşmeye not ekler").
Klinik (kes, bir istemi iptal et) ikinci kez sorar, bir
alert-dialogiçinde; onay düğmesi fiildir ("Kes"), asla "Tamam" ya da "Evet" değildir. İfşa edici (acil erişim, bakım ekibi dışında paylaşım) önce bir gerekçe ister ve kaydeder. - Birden çok kayıt açık olduğunda (sekmeler, pencereler, bölünmüş paneller), her sekmenin görünür metni ve erişilebilir adı hastanın adını ve ikinci bir tanımlayıcıyı içerir, etkin panel bandı yineler ve hiçbir eylem kendi panelindeki hasta dışında bir hastaya uygulanmaz.
- Kayıtların atanacağı yeri (oturum açarken seçilen servis, poliklinik veya kurum) sayfa başlığında metin olarak gösterin ve değiştirilmesini açık bir eylem yapın.
- Bantta etkin vizitı veya "Etkin vizit yok" bilgisini gösterin. Vizit gerektiren bir form bunu söyler ve kaydedilirken başarısız olmak yerine bir vizit başlatmayı önerir.
Hasta başlığı
Kompozisyon medical-banner ile belgelenmiştir; SvelteKit örnek uygulamasında /patient-banner adresinde çalışan bir sayfa vardır:
- iki tanımlayıcı ve doğum tarihinin yanında yaş;
- alerjiler bir alerji listesi aracılığıyla, böylece “bilinen alerji yok”, “kaydedilmedi” ve “kullanılamıyor” asla birbirine benzemez;
- eksik bir değer sözcüklerle ifade edilir (“Bilinmiyor”), asla soru işareti, tire veya boş hücre olmaz;
- vefat etmiş bir hasta: tema için
data-deceasedve görünür bir metin satırı, asla yalnızca renk değil; - hiçbir alan, hiçbir genişlikte kesilmez, kırpılmaz veya gizlenmez; alt satıra sarılır.
-
hasta uyarıları ("Tercüman gerekiyor", "Enfeksiyon riski") sözcüklerden oluşan etiketli bir
tag-groupolur, asla yalnızca simge veya renk değildir ve bant satır kaydırdığında görünür kalır.
Sonuçlar
- Hangi sistemden gelirse gelsin bir sonuç için tek bir görüntü: gözlem görünümü.
- İşaret, çevirinizden gelen sözcüklerdir (
flagLabel); FHIR yorum kodu tema içindata-interpretationolarak verilir. - Yeni sonuçları öncekilerden ayırın ve bir eğilim gösterin (bir sparkline veya veri tablosuyla bir çizgi grafik): klinisyenler yalnızca aralığı değil, anlamlı bir değişikliği arar.
- Hiç kaydedilmemiş bir sonuç ile kullanılamayan bir sonuç farklı durumlardır ve farklı sözcüklerle gösterilir.
-
Bilinmeyen normal değildir. Referans aralığı eksik, hâlâ yüklenen veya okunamayan bir sonucun yorumu yoktur ve bunu söyler;
observation-viewasla bir yorum çıkarmaz, bu yüzden aralığı olan amainterpretationolmayan bir sonuç işaret göstermez. -
Ölçek dışı bir sonuç, cihazın sınırının bir karşılaştırma işaretiyle ("> 33,3 mmol/L":
formatQuantityile">") ve sizin kritik işaretinizle verilmesidir, asla çıplak bir sayı değil. Yaklaşık bir değer ≈ işaretini korur ("~"). - Ek adlandırılmış aralıkları ("Kritik: 2,5'in altında")
rangesolarak verin, her biri kendi bölümü olarak. -
Düzeltilmiş veya değiştirilmiş bir sonuç, yerine geçtiği değeri bir
<del>içinde korur; ne zaman değiştiğini kendi sözcüklerinizle (previousValue,previousLabel) belirtin, böylece eski değeri okuyan klinisyen değiştiğini bilir. -
Bir aralık ölçümü genişliğini ve işlevini söyler ("Ortalama, 24 saat"), bir ölçümün durumu ve yöntemi ("Oturarak, büyük manşet") yanında görünür metindir, asla yalnızca bir araç ipucu değildir (openEHR
INTERVAL_EVENT,state,protocol). - Bir eğilim karşılaştırılabilir noktalar gerektirir: en düşük değerinizin altında çizgi çizmeyin, yöntemin veya testin değiştiği yerde çizgiyi kesin ve yönü ve anlamı sözcüklerle söyleyin ("düşüyor, düzeliyor").
-
Bir birim sisteminde girilen yaşam bulguları diğerini yanında sizin metniniz olarak gösterebilir ("70 kg (154 lb)"); Lily hiçbir şeyi dönüştürmez, bu yüzden yuvarlamanızı belirtin. Bir miktarı
quantity-input-divile girin; sayısı her birimin sınırlarını alır. -
Bir büyüme eğrisi bir
line-chartolur: seriler olarak persentil çizgileriniz, çocuğun noktaları ve yaş ile değer veri tablosu; Lily persentil hesaplamaz ve büyüme referansı sunmaz.
İlaçlar
- Jenerik adlar küçük harfle, FDA ve ISMP listelerindeki veya ülkenizin listesindeki tall man harfleri hariç (Avustralya ve Kanada kendi listelerini yayımlar). Bunları
nameSegmentsiçinde işaretleyin; Lily bunları asla tahmin etmez. - Gücü
formatQuantityile yazın: sondaki sıfır yok, baştaki sıfır var, birimden önce bölünmeyen boşluk. - Bir sonucun karşılaştırıcısını koruyun:
formatQuantity(5, "mmol/L", locale, "<"), “<5 mmol/L” yazar. FHIR'inQuantity.comparatordeğeri <, ≤, ≥ veya > olarak yazılır; bunu atlamak “5'ten az” ifadesini “5”e çevirir. - mL yazın, asla cc yazmayın ve ISMP'nin hataya açık kısaltmalar listesindeki her kısaltmadan kaçının.
- Bir ilacın adını veya dozunu asla kesmeyin.
Tarihler ve saatler
- Bir tarihin iki şekilde okunamaması için ayı metin olarak yazın (
Intl.DateTimeFormatilemonth: "short"). - Saati bilinçli seçin:
hourCycledeğerini açıkça geçin. NHS 24 saatlik saati ister; bu bir Birleşik Krallık kuralıdır, dünya geneli bir kural değildir; bu yüzden Lily bunu sizin yerinize asla seçmez. - Yaşlar,
ageParts()aracılığıyla Common User Interface bantlarını izler; başka bir kurala sahip bir hizmet kendi sözcüklerini geçer. -
Yalnızca ay veya yıl düzeyinde bilinen bir tarih öyle kalır: onu
date-fieldprecision="month"veya"year"ile isteyin,2019-03veya2019olarak saklayın veformatPartialDate()ile yazın. Asla bir gün uydurmayın. -
Bir zaman uzunluğu
duration-view, yani<time datetime="P3DT4H">içinde sizin sözcüklerinizle,durationParts()veIntl.DurationFormat.
Panolar
- Bir servis panosu veya komuta merkezi ekranı sık güncellenir. Her değişikliği asla duyurmayın: tek bir nazik özet bölgesi tutun (“3 yatak boş, 2 taburculuk bekleniyor”) ve insanların panoyu okumasına izin verin.
- Bir panodaki her durum (yatak temiz, dolu, engelli) metindir veya sözcükler içeren bir
data-*durumudur; asla yalnızca renk değildir. -
Hiçbir şey yanıp sönmez (WCAG 2.2.2, 2.3.1); bir zamanlayıcıyla güncellenen panonun bir duraklatma denetimi vardır veya yalnızca istendiğinde güncellenir; güncellemeler odağı asla taşımaz. Geciken bir kayıt bunu sözcüklerle söyler ("20 dakikadan fazla bekliyor") ve
data-overdue. - Bir sayı veya oran paydasını gösterir ("68'de 12") ve arkasındaki listeye bağlantı verir.
- Bir liste veya zaman çizelgesi neyin görünümü olduğunu söyler: ne gösterdiğini, sırasını ve zaman penceresini, neyin gizlendiğini ve nedenini, hangi kaynakların yanıt vermediğini. Yanıt vermeyen bir kaynaktan gelen boş liste hiçbir şeyin olmadığının kanıtı değildir.
-
Bir hatırlatma listesi bir
record-listolup öğeleri bir son tarih (review-date) ve sözcüklerle bir vade durumu taşır,data-dueile birlikte; onu üreten kural sizindir.
Formlar
-
"Evet", "hayır" veya "sorulmadı" diye yanıtlanan bir soru, başta hiçbiri seçili olmayan üç yanıtlı bir
radio-groupolur, asla bir onay kutusu değil: onay kutusu "reddediyor" ile "hiç sorulmadı"yı ayıramaz. Sistem sorgulaması her vücut sistemi için birfieldsetolur ve "diğerlerinin hepsi yok" düğmesi yalnızca yanıtlanmamışları ayarlar. -
Yanıt listesi olan bir soru (ilaçlar, adresler) bir
repeatable-fieldsetolur: bir öğe eklenir veya kaldırılır, odak izler ve her kaldırma düğmesi kendi öğesinin adını taşır. -
Ondalık virgüllü bir sayı: onu
Intl.NumberFormatile gösterin vetype="number"virgülü kabul etmediği yerde bir metin alanındainputmode="decimal"ile alın ve kodunuzda ayrıştırın. Kişinin yazdığı bir değeri, bir aralığa sıkıştırmak için bile asla değiştirmeyin: aralık dışı bir değer, kişinin görebileceği bir hatadır. -
Seçeneklerinin yalnızca bir kısmını bir seferde gösteren uzun bir liste her seçenekte
aria-setsizevearia-posinsetayarlar ve sayfada bulmanın gerisini göremediğini unutmaz.
Kayıtlar, notlar ve kökenleri
-
Bir liste veya ızgaranın neyin görünümü olduğunu satırlarından önce söyleyin: zaman penceresi ve sırası, neyi dışarıda bıraktığı ve nedeni, hangi kaynakların yanıt vermediği ("Son 12 ay, en yeni önce. Aile hekimi kaydı yanıt vermedi."). Şunlara
record-listvetimeline-listbircoverageLabelverin, vedata-gridyardımcısına kendicoverageLabeldeğerini. Yanıt vermeyen bir kaynaktan gelen boş liste bunu sözcüklerle söyler, böylece asla "hiçbir şey kaydedilmedi" olarak okunmaz. -
Bir kaydın nereden geldiğini ve kesin olup olmadığını
record-provenance-viewile söyleyin: imzalı, imza bekliyor, değiştirilmiş, bu cihaza kaydedilmiş ve henüz gönderilmemiş. İmzasız bir taslak asla imzalı görünmemelidir. - Başka birine (bir ebeveyn, bir fetüs, bir donör) ilişkin bir kayıt, önce kime ait olduğunu kayıt öğelerinin
subjectLabelözelliğiyle söyler. -
Alıkonulan bir kayıt sizin sözcüklerinizle listede kalır ("Kısıtlı: size açık değil") ve yanlışlıkla yapılan bir kayıt "Yanlışlıkla girildi" ile üstü çizili kalır:
record-list-itemveyatimeline-list-itemöğesine birentryStateve birentryStateLabelverin. İkisinden hiçbirini sessizce kaldırmayın, çünkü bir boşluk "hiçbir şey olmadı" diye okunur. -
Bir klinik notta her bölümün kaynağını (yazılmış, dikte edilmiş, şablon, ileri kopyalanmış, üretilmiş)
data-sourceve görünür sözcüklerle işaretleyin, böylece kopyalanmış veya üretilmiş metin asla bugünkü muayene sanılmaz. -
Yüklenemeyen bir bölüm sizin sözcüklerinizle
unavailableolur ve bir yeniden dene düğmesi vardır; teknik bir kod gösterilecekse açılır bir öğenin arkasında durur. Bir kişinin eyleminden kaynaklanan hata, kaydın şu anda tuttuğu değerle birlikte duyurulur; sayfa yüklenirken oluşan hata duyurulmaz. -
Bir istemin geçmişi bir
timeline-listolur; her adım için bir öğe (planlandı, zamanlandı, etkin, askıya alındı, tamamlandı, iptal edildi), zamanı ve gerekçesiyle, ve güncel durum öğenin üzerinde de.
FHIR'den Lily'ye
Lily FHIR kaynaklarını okumaz; kodunuz bunları Lily'nin özelliklerine eşler. Bu tablolar HL7 FHIR Uluslararası Hasta Özeti'ni (IPS 2.0.1, FHIR R4) eşler. Kod eşlemesi bir öneridir: kararı klinik güvenlik değerlendirmeniz verir ve her durum için kullanılacak sözcükler sizindir.
| IPS bölümü | Lily |
|---|---|
Alerjiler ve intoleranslar (48765-2) |
allergy-record-list ve öğeleri |
İlaç özeti (10160-0) |
medication-record-list; her öğe bir medication-view içerir |
Sorun listesi (11450-4) |
problem-record-list ve öğeleri |
Bağışıklamalar (11369-6) |
immunization-record-list ve öğeleri |
Sonuçlar (30954-2) |
observation-view, bir veri tablosunda veya özet listesinde |
İşlem geçmişi (47519-4) |
procedure-record-list ve öğeleri |
Tıbbi cihazlar (46264-8) |
device-record-list ve öğeleri |
Uyarılar (104605-1) |
Uyarı metni veya bir uyarı; asla daraltılmış bir denetimin arkasında değil |
| Diğer herhangi bir bölüm | record-list ve öğeleri |
| Belgenin dışarıda bıraktığı zorunlu bir bölüm | Bölümün status="omitted" olan listesi |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
Listenin status="none-known" değeri |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", hangisi olduğunu söyleyen sözcüklerle |
no-known-allergies, no-known-medications ve benzeri IPS kodları |
status="none-known" |
no-allergy-info, no-medication-info ve benzeri IPS kodları |
status="not-recorded" |
AllergyIntolerance.criticality |
Bir reaksiyonun severity değerinden ayrı olarak criticality |
clinicalStatus, verificationStatus |
Alerji ve sorun öğelerinde aynı özellikler, aynı kodlarla |
MedicationStatement.status |
İlaç öğesinin status değeri |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view bileşeninin status değeri, aynı kodlarla |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (kayıt listelerinde de) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Bir entered-in-error kaydını sessizce atmak yerine, sözcüklerle, entered-in-error durumuna eşleyin: gösterilip gösterilmeyeceği hizmetinizin kararıdır.
openEHR'den Lily'ye
Lily openEHR kompozisyonlarını da okumaz. openEHR Referans Modeli veri türleri ve kodları için eşleme, klinik güvenlik incelemenizin karar vereceği bir öneri olarak:
| openEHR | Lily |
|---|---|
DV_QUANTITY (giriş) |
quantity-input-div; sizin sözcüklerinizle UCUM kodları olarak birimler |
DV_QUANTITY (görüntüleme), magnitude_status |
observation-view ile formatQuantity(value, unit, locale, comparator) (~ ≈ demektir) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges bir meaning |
observation-view ranges |
DV_DATE kısmi (yıl, yıl ve ay) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view ile durationParts() |
DV_PROPORTION |
formatProportion() içinde observation-view |
DV_ORDINAL, DV_SCALE |
bir radio-group ; etiketleri sayıyı ve sözcüklerini taşır |
DV_CODED_TEXT |
aşağıdaki kodlanmış değerler deseni |
DV_BOOLEAN |
checkbox-input, yalnızca "sorulmadı" olamayacaksa |
ELEMENT.null_flavour 253 bilinmiyor, 271 bilgi yok |
status="not-recorded" veya "unavailable", hangisi olduğunu söyleyen sözcüklerle |
null_flavour 272 maskelenmiş |
observation-view status="masked" |
null_flavour 273 uygulanamaz |
status="not-applicable" |
PARTY_RELATED özne |
subjectLabel kayıt öğelerinde |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Instruction State Machine adımları | adımlardan oluşan bir timeline-list , güncel durum öğenin üzerinde |
tekrarlanma sayısı şu olan bir arketip öğesi: 0..* |
repeatable-fieldset |
Kodlanmış değerler
Coding.displaydeğerini gösterin; yoksaCodeableConcept.text; ikisi de yoksasystem|code. Asla boş bir hücre olmaz.- Her değerin yanında kod sistemini ve kodu gösteren bir denetim sunun; örneğin “Kodları göster” yazan bir geçiş düğmesi. Gizli kodlar gösterilene kadar okuma sırasının dışında kalır.
- Klinik metni belgenin diliyle (
lang) işaretleyin; bu, arayüzün dilinden farklı olabilir. Arayüzü çevirin; klinik içeriği asla çevirmeyin. - Lily terminoloji sunmaz: SNOMED CT, LOINC, ATC veya UCUM aramaları yoktur. Belgenin söylediğini yazın. Örüntüyü SvelteKit örneğinin
/patient-summarysayfası gösterir.
Lily'nin yapmayacakları
- Bir erken uyarı puanını, büyüme persentilini, dozu veya referans aralığını hesaplamak.
- Bir ilaç veritabanı, tall man listesi veya SNOMED CT, ICD, LOINC ya da UCUM kodları sunmak.
- Lisanslı bir aracı (Wong-Baker FACES) veya başka bir kurumun tasarımını (NEWS2 çizelgesi) yeniden üretmek.
- Aynı anda açık kayıt sayısını sınırlamak.
- Bir aralıktan yorum çıkarmak, bir birimi dönüştürmek veya göreli bir tarihi ("gelecek salı") ayrıştırmak.
- "Evet, hayır veya bilinmiyor" için anahtar kullanmak: ARIA'nın
switchöğesinin üçüncü durumu yoktur, bu yüzden üç radyo düğmesidir.
Bu rehberin arkasındaki araştırma, kaynaklar ve kararlar spec/healthcare-ui içindedir.