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ı ve sizin sağlamanız gerekenler
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 ve overrideReasons sunun; 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-live ile 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 (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • 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ğini context-menu veya dropdown-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-dialog iç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-deceased ve 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-group olur, 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çin data-interpretation olarak 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-view asla bir yorum çıkarmaz, bu yüzden aralığı olan ama interpretation olmayan 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": formatQuantity ile ">") 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-chart olur: 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ı nameSegments içinde işaretleyin; Lily bunları asla tahmin etmez.
  • Gücü formatQuantity ile 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'in Quantity.comparator değ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.DateTimeFormat ile month: "short").
  • Saati bilinçli seçin: hourCycle değ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-field precision="month" veya "year"ile isteyin, 2019-03 veya 2019olarak saklayın ve formatPartialDate()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() ve Intl.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-list olup öğ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-group olur, asla bir onay kutusu değil: onay kutusu "reddediyor" ile "hiç sorulmadı"yı ayıramaz. Sistem sorgulaması her vücut sistemi için bir fieldset olur 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.NumberFormat ile gösterin ve type="number" virgülü kabul etmediği yerde bir metin alanında inputmode="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-setsize ve aria-posinset ayarlar 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-list ve timeline-list bir coverageLabelverin, ve data-grid yardımcısına kendi coverageLabeldeğ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-item veya timeline-list-item öğesine bir entryState ve bir entryStateLabelverin. İ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-source ve 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 unavailable olur 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ümleri ve bunlar için Lily bileşenleri
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 kodları ve bunlar için Lily değerleri
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 veri türleri ve kodları ile bunlara karşılık gelen Lily değerleri
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.display değerini gösterin; yoksa CodeableConcept.text; ikisi de yoksa system|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-summary sayfası 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.