Antarmuka pangguna kesehatan

Pandhuan kanggo tim sing nggawe piranti lunak klinis nganggo Lily: portal klinis, asil lan laporan, nulis resep lan pengelolaan obat, pendhukung keputusan lan dasbor rumah sakit.

Terjemahan kaca iki minangka draf mesin sing durung ditinjau. Kaca basa Inggris minangka versi sing sah.

Apa sing ditindakake Lily, lan apa sing ora

Lily maringi kontrak tampilan: markup semantik, ARIA, prilaku keyboard lan class hook kanggo bab-bab sing bola-bali ing layar klinis. Lily ora maringi logika klinis, isi klinis utawa klaim regulasi.

Apa sing diwenehake Lily, lan apa sing sampeyan wenehi
Lily nyedhiyakake Sampeyan nyedhiyakake
observation-view: nilai, satuan, tandha mawa tembung, rentang, lan kahanan kosong Nilai, putusan tandha, rentang rujukan
allergy-record-list lan allergy-record-list-item: status sing ora tau kosong Cathetan alergi lan terminologine
medication-view: jeneng, kekuwatan, wujud, rute lan frekuensi, ora ana sing dipotong Data obat, segmen tall man, kekuwatan sing wis diformat
decision-support-card: wangun kertu CDS Hooks Aturan, tumindak saran, nyathet asil
early-warning-score-view: skor, pita lan eskalasi, ditampilake Sistem skoring lan itungan sing wis divalidasi
age-view lan ageParts(): umur ing satuan sing cocog Tembung kanggo satuan (Intl.DurationFormat utawa label dhewe)
formatQuantity(): 5 mg, aja 5,0 mg; 0,5 mg, aja ,5 mg Angka, satuan lan locale
Komposisi banner pasien Saben label lan nilai, lan sapa sing oleh ndeleng informasi klinis

Regulasi. Piranti lunak sing ngitung skor, centile, dosis utawa interaksi obat biasane minangka piranti medis. Lily ora ngitung salah siji saka iki, kanthi sengaja. Yen produk sampeyan diatur, sampeyan sing nanggung berkas rekayasa kegunaane (IEC 62366-1, pandhuan faktor manungsa FDA, EU MDR). Tes Lily, laporan kesesuaian aksesibilitas sing dinilai dhewe lan matriks screen reader bisa dadi bukti ing berkas kuwi; ora ana sing minangka klaim kesesuaian, lan matriks durung ana asile.

Weca: ngganggu mung kanggo sing kritis

Kesel weca iku masalah keamanan: yen saben weca ngganggu, wong bakal nolak kabeh. Pandhuan AHRQ yaiku nggawe tingkatan weca miturut tingkat keparahan lan mung sing abot sing ngganggu.

  • Informasi (indicator="info"): sebaris, ing jejere tugas, kertu pendhukung keputusan ing kaca.
  • Pènget (indicator="warning"): katon tanpa ngalangi, kertu sing padha, digawe katon mencolok; ora nganggo modal.
  • Kritis (indicator="critical"): selehna kertu ing jero dialog weca, lan wènèhana overrideReasons supaya nolak kertu kuwi njaluk alasan.
  • Kertu pendhukung keputusan ora tau dadi wilayah live dhewe. Umumna kertu kritis anyar kanthi mindhah fokus menyang dialog, dudu nganggo aria-live.
  • Busaken kertu nalika kedadean sing dijawab kertu kuwi kedadean maneh, lan catheta saben asil (ditampa, utawa ditolak mawa alasane).

Kesalahan salah pasien: kenali, aja matesi

  • Tampilna rong pangenal ing ngendi wae data pasien katon: jeneng karo tanggal lahir, lan pangenal nasional karo komponen view-ne (The Joint Commission, Quick Safety 45).
  • Gunakna banner pasien ing saben layar sing tumindak marang rekam medis siji pasien, lan tetepna katon.
  • Sadurunge tumindak ing rekam medis sing dudu ing banner, konfirmasia nganggo jeneng, tanggal lahir lan pangenal.
  • Cathetan bab wong liya saliyane pasien (riwayat wong tuwa, janin, donor) luwih dhisik nyebutake nganggo tembung kagungane sapa: wenehana item rekam medis subjectLabel ("Ibu"), supaya diagnosis sedulur ora tau diwaca minangka diagnosis pasien (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Aja matesi pira rekam medis sing bisa dibukak klinisi: uji acak marang 3.356 klinisi (JAMA, 2019) nemokake yen iku ora nyuda pesenan salah pasien, lan wong golek dalan liya.
  • Menu tumindak ing siji rekam medis luwih dhisik nyebutake rekam medis kasebut, nganggo subjectLabel ing context-menu utawa dropdown-menu ("Ada Lovelace, tekanan getih 3 Nov"): perangan kapisan sing ora interaktif lan uga dadi jeneng aksesibel menu.
  • Golongna saben tumindak miturut apa sing ditindakake, lan tampilake tingkate sadurunge mlaku. Rutin (deleng, cithak) langsung mlaku. Didokumentasikake nyebutake apa sing bakal ditulis menyang rekam medis ("Nambahake cathetan ing kunjungan"). Klinis (mandhegake, mbatalake prentah) takon kaping pindho, ing alert-dialog sing tombol konfirmasine yaiku tembung kriya ("Mandhegake"), ora tau "OK" utawa "Ya". Mbukak (akses darurat, nuduhake ing njaba tim perawatan) luwih dhisik njaluk alesan lan nyathet.
  • Yen sawetara rekam medis kabukak (tab, jendhela, panel kapérang), teks katon lan jeneng aksesibel saben tab ngemot jeneng pasien lan identitas kapindho, panel aktif mbaleni spanduk, lan ora ana tumindak sing ditrapake marang pasien liya saliyane pasien panele.
  • Tampilake lokasi sing bakal dadi papan rekam medis (bangsal, klinik utawa fasilitas sing dipilih nalika mlebu) minangka teks ing sirah kaca, lan gawe gantine dadi tumindak sing cetha.
  • Tampilake kunjungan aktif, utawa "Ora ana kunjungan aktif", ing spanduk. Formulir sing butuh kunjungan nyebutake mangkono lan nawakake miwiti siji, tinimbang gagal nalika disimpen.

Banner pasien

Komposisine didokumentasi karo medical-banner, lan ana kaca sing makarya ing /patient-banner ing app conto SvelteKit:

  • rong pangenal, lan umur ing jejere tanggal lahir;
  • alergi liwat dhaptar alergi, supaya "ora ana alergi sing dikenal", "ora dicathet" lan "ora kasedhiya" ora tau katon padha;
  • nilai sing ora ana yaiku tembung ("Ora dingerteni"), dudu tandha pitakon, garis utawa sel kosong;
  • pasien sing wis seda: data-deceased kanggo tema, lan sebaris teks sing katon, ora mung warna;
  • ora ana kolom sing dipotong, dikliping utawa didhelikake ing lebar apa wae; kolom kuwi mlipet.
  • tandha pasien ("Butuh juru basa", "Risiko infeksi") yaiku tag-group kanthi label saka tembung, ora tau mung ikon utawa warna, lan tetep katon nalika spanduk nekuk.

Asil

  • Siji tampilan kanggo asil, saka sistem apa wae: observation view.
  • Tandha iku tembung saka terjemahan sampeyan (flagLabel), karo kode interpretasi FHIR minangka data-interpretation kanggo tema.
  • Pisahna asil anyar saka sing sadurunge, lan tuduhna tren (sparkline, utawa grafik garis karo tabel datane): klinisi nggoleki owah-owahan sing wigati, ora mung rentange.
  • Asil sing ora tau dicathet lan sing ora kasedhiya iku kahanan sing beda, mawa tembung sing beda.
  • Ora dingerteni dudu normal. Asil sing kisaran rujukané ora ana, isih dimuat, utawa ora bisa diwaca ora duwe tafsiran lan nyebutake mangkono; observation-view ora tau nyimpulake, dadi asil kanthi kisaran lan tanpa interpretation ora nampilake tandha.
  • Asil ing njaba skala yaiku wates piranti kanthi pambanding ("> 33,3 mmol/L": formatQuantity kanthi ">") lan tandha kritis panjenengan, ora tau angka thok. Nilai kira-kira njaga ≈-ne ("~").
  • Wenehana kisaran kanthi jeneng liyane ("Kritis: ing ngisor 2,5") minangka ranges, saben siji dadi perangan dhewe.
  • Asil sing dibenerake utawa diowahi njaga nilai sing digantèni, ing <del>, kanthi tembung panjenengan bab kapan owah (previousValue, previousLabel), supaya klinisi sing maca nilai lawas ngerti yen wis owah.
  • Pangukuran interval nyebutake ambane lan fungsine ("Rata-rata, 24 jam"), lan kahanan lan cara pangukuran ("Lungguh, manset gedhe") minangka teks katon ing sandhinge, ora tau mung tooltip (openEHR INTERVAL_EVENT, state, protocol).
  • Tren butuh titik sing bisa dibandhingake: aja nggambar garis ing ngisor minimum panjenengan, pedhot garis ing panggonan cara utawa pamriksan owah, lan sebutake arah lan maknane nganggo tembung ("mudhun, saya apik").
  • Tandha vital sing dilebokake ing siji sistem satuan bisa nampilake sistem liyane ing sandhinge minangka teks panjenengan ("70 kg (154 lb)"); Lily ora ngowahi apa-apa, mula sebutake pambuleten panjenengan. Lebokake jumlah nganggo quantity-input-div, sing angkane manut wates saben satuan.
  • Kurva tuwuh yaiku line-chart kanthi garis persentil panjenengan minangka seri, titik-titik bocah lan tabel data umur lan nilai; Lily ora ngetung persentil lan ora nyedhiyakake rujukan tuwuh.

Obat

  • Jeneng generik nganggo aksara cilik, kajaba aksara tall man saka dhaptar FDA lan ISMP utawa dhaptar negara sampeyan (Australia lan Kanada nerbitake dhewe). Tandhanana ing nameSegments; Lily ora tau nebak.
  • Tulisen kekuwatan nganggo formatQuantity: ora ana nol buntut, nol ing ngarep, lan spasi tanpa pegat sadurunge satuan.
  • Pertahanna pembanding asil: formatQuantity(5, "mmol/L", locale, "<") nulis "<5 mmol/L". Quantity.comparator saka FHIR ditulis <, ≤, ≥ utawa >; yen dibuwang, "kurang saka 5" dadi "5".
  • Tulisen mL, aja cc, lan singkirana saben singkatan ing dhaptar ISMP sing rawan kesalahan.
  • Aja tau motong jeneng utawa dosis obat.

Tanggal lan wektu

  • Tulisen sasi nganggo teks supaya tanggal ora bisa diwaca rong cara (Intl.DateTimeFormat karo month: "short").
  • Pilihen jam kanthi sengaja: wènèhana hourCycle kanthi cetha. NHS njaluk jam 24; iku aturan Inggris, dudu aturan donya, mulane Lily ora tau milih kanggo sampeyan.
  • Umur manut pita Common User Interface liwat ageParts(); layanan sing nduweni kabiasaan liya maringi tembunge dhewe.
  • Tanggal sing mung dingerteni nganti sasi utawa taun tetep mangkono: takokake nganggo date-field precision="month" utawa "year", simpen 2019-03 utawa 2019, lan tulis nganggo formatPartialDate(). Aja nate nggawe-nggawe dina.
  • Suwene wektu yaiku duration-view, <time datetime="P3DT4H"> sing ngemot tembung panjenengan, saka durationParts() lan Intl.DurationFormat.

Dasbor

  • Papan bangsal utawa layar pusat komando kerep dianyari. Aja ngumumake saben owah-owahan: gawea siji wilayah ringkesan sing sopan ("3 amben kosong, 2 pasien arep mulih") lan wong dikon maca papane dhewe.
  • Saben kahanan ing papan (amben resik, kapakéni, diblokir) iku teks utawa kahanan data-* mawa tembung, ora mung warna.
  • Ora ana sing kelip-kelip (WCAG 2.2.2, 2.3.1), lan papan sing dianyari nganggo pengatur wektu duwe kontrol jeda utawa mung dianyari yen dijaluk; nganyari ora tau mindhah fokus. Cathetan sing telat nyebutake nganggo tembung ("Ngenteni luwih saka 20 menit") kanthi data-overdue.
  • Cacah utawa rasio nampilake penyebute ("12 saka 68") lan nyambung menyang dhaptar ing mburine.
  • Dhaptar utawa garis wektu nyebutake tampilan saka apa: apa sing ditampilake, urutan lan wektune, apa sing didhelikake lan apa sebabe, lan sumber endi sing ora mangsuli. Dhaptar kosong saka sumber sing ora mangsuli dudu bukti yen ora ana apa-apa.
  • Dhaptar pangeling yaiku record-list sing item-iteme nggawa tanggal tempo (review-date) lan kahanan tempo nganggo tembung, kanthi data-due; aturan sing nggawe iku kagungane panjenengan.

Formulir

  • Pitakon sing dijawab "ya", "ora" utawa "ora ditakokake" yaiku radio-group telung wangsulan, ora ana sing dipilih ing wiwitan, ora tau kothak centhang: kothak centhang ora bisa mbedakake "dibantah" saka "ora tau ditakokake". Tinjauan sistem yaiku siji fieldset saben sistem awak, lan tombol "kabeh liyane ora ana" mung nyetel sing durung dijawab.
  • Pitakon kanthi dhaptar wangsulan (obat, alamat) yaiku repeatable-fieldset: item ditambahake utawa dibusak, fokus melu, lan saben tombol busak dijenengi miturut iteme.
  • Angka kanthi koma desimal: tampilake nganggo Intl.NumberFormat lan, ing panggonan type="number" ora nampa koma, tampa ing kolom teks kanthi inputmode="decimal" lan urai ing kode panjenengan. Aja nate ngowahi nilai sing diketik wong, sanajan kanggo mbatesi ing kisaran: nilai ing njaba kisaran yaiku kesalahan sing bisa dideleng.
  • Dhaptar dawa sing mung nampilake sapérangan pilihan ing sawijining wektu nyetel aria-setsize lan aria-posinset ing saben pilihan, lan eling yen golek ing kaca ora bisa ndeleng sisane.

Rekam medis, cathetan lan asal-usule

  • Sebutake dhaptar utawa kisi iku tampilan saka apa, sadurunge barise: wektu lan urutane, apa sing ditinggal lan apa sebabe, lan sumber endi sing ora mangsuli ("12 sasi pungkasan, sing anyar dhisik. Rekam medis dhokter kulawarga ora mangsuli."). Wenehana record-list lan timeline-list coverageLabel, lan pambiyantu data-grid duwèke coverageLabel. Dhaptar kosong saka sumber sing ora mangsuli nyebutake nganggo tembung, supaya ora tau diwaca minangka "ora ana sing dicathet".
  • Sebutake saka ngendi rekam medis asale lan apa wis final nganggo record-provenance-view: ditandatangani, ngenteni tandha tangan, diowahi, disimpen ing piranti iki lan durung dikirim. Draf sing durung ditandatangani ora kena katon wis ditandatangani.
  • Cathetan bab wong liya (wong tuwa, janin, donor) luwih dhisik nyebutake kagungane sapa, nganggo subjectLabel.
  • Cathetan sing ditahan tetep ana ing dhaptar kanthi tembung panjenengan ("Diwatesi: ora kasedhiya kanggo panjenengan"), lan cathetan sing digawe amarga kliru tetep dicoret kanthi "Dilebokake amarga kliru": wenehana record-list-item utawa timeline-list-item entryState lan entryStateLabel. Aja nate mbusak salah sijine kanthi meneng, amarga celah diwaca "ora ana kedadeyan".
  • Ing cathetan klinis, tandhani sumber saben perangan (diketik, didikte, cithakan, disalin saka sadurunge, digawe mesin) nganggo data-source lan tembung sing katon, supaya teks salinan utawa gawean mesin ora tau dianggep pamriksan dina iki.
  • Bagean sing ora bisa dimuat yaiku unavailable nganggo tembung panjenengan, kanthi tombol nyoba maneh; kode teknis, yen ditampilake, ana ing mburi pambukak. Kegagalan amarga tumindak wong diumumake, bebarengan karo nilai sing saiki dicekel rekam medis; kegagalan nalika kaca dimuat ora.
  • Riwayat prentah yaiku timeline-list, siji item saben langkah (direncanakake, dijadwalake, aktif, ditundha, rampung, dibatalake) kanthi wektu lan alesane, lan kahanan saiki uga ing item.

Saka FHIR menyang Lily

Lily ora maca sumber daya FHIR; kodemu mapak menyang props Lily. Tabel-tabel iki mapak HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Pemetaan kode iku saran: tinjauan keamanan klinismu sing nemtokake, lan tembung kanggo saben kahanan iku tembungmu dhewe.

Bagian IPS lan komponen Lily kanggo bagian kasebut
Bagian IPS Lily
Alergi lan intoleransi (48765-2) allergy-record-list lan item-itemé
Ringkesan obat (10160-0) medication-record-list, saben item ngemot medication-view
Dhaptar masalah (11450-4) problem-record-list lan item-itemé
Imunisasi (11369-6) immunization-record-list lan item-itemé
Asil (30954-2) observation-view, ing tabel data utawa dhaptar ringkesan
Riwayat prosedur (47519-4) procedure-record-list lan item-itemé
Piranti medis (46264-8) device-record-list lan item-itemé
Peringatan (104605-1) Teks peringatan utawa waspada, aja nganti ana ing mburi kontrol sing dilipet
Bagian liyane apa wae record-list lan item-itemé
Bagian wajib sing ora kalebu ing dokumen Dhaptar bagian kasebut karo status="omitted"
Kode FHIR lan nilai Lily kanggo kode kasebut
FHIR Lily
emptyReason nilknown status="none-known" saka dhaptar
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", karo tembung sing nerangake endi
Kode IPS no-known-allergies, no-known-medications lan sing padha status="none-known"
Kode IPS no-allergy-info, no-medication-info lan sing padha status="not-recorded"
AllergyIntolerance.criticality criticality, kajaba severity reaksi
clinicalStatus, verificationStatus Props sing padha ing item alergi lan masalah, karo kode sing padha
MedicationStatement.status status item obat
Dosage.text medication-view dosageText
Observation.status observation-view status, karo kode sing padha
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (uga ing dhaptar rekam medis)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Petakna cathetan entered-in-error menyang status entered-in-error, nganggo tembung, aja dibuwang meneng-meneng: arep ditampilake apa ora iku keputusan layananmu.

Saka openEHR menyang Lily

Lily uga ora maca komposisi openEHR. Pemetaan kanggo jinis data lan kode Model Rujukan openEHR, minangka usulan sing diputusake tinjauan keamanan klinis panjenengan:

Jinis data lan kode openEHR, lan nilai Lily kanggo iku
openEHR Lily
DV_QUANTITY (lebon) quantity-input-div; satuan minangka kode UCUM kanthi tembung panjenengan
DV_QUANTITY (tampilan), magnitude_status observation-view kanthi formatQuantity(value, unit, locale, comparator) (~ yaiku ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges kanthi meaning observation-view ranges
DV_DATE sebagian (taun, taun lan sasi) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view kanthi durationParts()
DV_PROPORTION formatProportion() ing njero observation-view
DV_ORDINAL, DV_SCALE radio-group sing labele nggawa angka lan tembunge
DV_CODED_TEXT pola nilai kanthi kode ing ngisor
DV_BOOLEAN checkbox-input, mung yen "ora ditakokake" ora bisa kedadeyan
ELEMENT.null_flavour 253 ora dingerteni, 271 ora ana informasi status="not-recorded" utawa "unavailable", karo tembung sing nerangake endi
null_flavour 272 didhelikake observation-view status="masked"
null_flavour 273 ora ditrapake status="not-applicable"
PARTY_RELATED subjek subjectLabel ing item rekam medis
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Langkah Instruction State Machine timeline-list saka langkah-langkah, kanthi kahanan saiki ing item
item arketipe kanthi kedadeyan 0..* repeatable-fieldset

Nilai sing dikodekake

  • Tampilna Coding.display; yen ora ana, CodeableConcept.text; yen loro-lorone ora ana, system|code. Aja nganti ana sel kosong.
  • Wenehana kontrol sing nuduhake sistem kode lan kode ing sandhinge saben nilai, kayata tombol toggle sing nulis "Tampilake kode". Kode sing didhelikake ora kalebu urutan wacan nganti ditampilake.
  • Tandhanana teks klinis nganggo basa dokumen (lang), sing bisa beda saka basa antarmuka. Terjemahna antarmuka; aja nate nerjemahake isi klinis.
  • Lily ora nyedhiyakake terminologi: ora ana panelusuran SNOMED CT, LOINC, ATC utawa UCUM. Tulisen apa sing dikandhakake dokumen. Conto SvelteKit nuduhake pola kasebut ing kaca /patient-summary.

Apa sing ora bakal ditindakake Lily

  • Ngitung skor weca dini, centile pertumbuhan, dosis utawa rentang rujukan.
  • Nyedhiyakake basis data obat, dhaptar tall man, utawa kode SNOMED CT, ICD, LOINC utawa UCUM.
  • Nyalin instrumen sing nduwe lisensi (Wong-Baker FACES) utawa desain lembaga liya (grafik NEWS2).
  • Matesi cacahe rekam medis sing dibukak bebarengan.
  • Nyimpulake tafsiran saka kisaran, ngowahi satuan, utawa ngurai tanggal relatif ("Selasa ngarep").
  • Nganggo saklar kanggo "ya, ora utawa ora dingerteni": switch ARIA ora duwe kahanan katelu, mula iku telung tombol radio.

Riset, sumber lan keputusan ing mburine pandhuan iki ana ing spec/healthcare-ui.