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.
| 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èhanaoverrideReasonssupaya 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelingcontext-menuutawadropdown-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-dialogsing 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-deceasedkanggo 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-groupkanthi 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 minangkadata-interpretationkanggo 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-viewora tau nyimpulake, dadi asil kanthi kisaran lan tanpainterpretationora nampilake tandha. -
Asil ing njaba skala yaiku wates piranti kanthi pambanding ("> 33,3 mmol/L":
formatQuantitykanthi">") 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-chartkanthi 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.comparatorsaka 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.DateTimeFormatkaromonth: "short"). - Pilihen jam kanthi sengaja: wènèhana
hourCyclekanthi 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-fieldprecision="month"utawa"year", simpen2019-03utawa2019, lan tulis nganggoformatPartialDate(). Aja nate nggawe-nggawe dina. -
Suwene wektu yaiku
duration-view,<time datetime="P3DT4H">sing ngemot tembung panjenengan, sakadurationParts()lanIntl.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-listsing item-iteme nggawa tanggal tempo (review-date) lan kahanan tempo nganggo tembung, kanthidata-due; aturan sing nggawe iku kagungane panjenengan.
Formulir
-
Pitakon sing dijawab "ya", "ora" utawa "ora ditakokake" yaiku
radio-grouptelung wangsulan, ora ana sing dipilih ing wiwitan, ora tau kothak centhang: kothak centhang ora bisa mbedakake "dibantah" saka "ora tau ditakokake". Tinjauan sistem yaiku sijifieldsetsaben 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.NumberFormatlan, ing panggonantype="number"ora nampa koma, tampa ing kolom teks kanthiinputmode="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-setsizelanaria-posinseting 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-listlantimeline-listcoverageLabel, lan pambiyantudata-gridduwèkecoverageLabel. 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-itemutawatimeline-list-itementryStatelanentryStateLabel. 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-sourcelan tembung sing katon, supaya teks salinan utawa gawean mesin ora tau dianggep pamriksan dina iki. -
Bagean sing ora bisa dimuat yaiku
unavailablenganggo 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 | 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" |
| 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:
| 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":
switchARIA ora duwe kahanan katelu, mula iku telung tombol radio.
Riset, sumber lan keputusan ing mburine pandhuan iki ana ing spec/healthcare-ui.