Efanasow devnydhyer yn yeghes

Hynsa rag ekipow a dhrehevel medhelweyth klinikel gans Lily: porthellow klinikel, sewyansow ha derivadow, ordena ha rydhsans medhegnow, skoodhyans dewisyans ha tavlennow-kenwel yn klavjiti.

Treylyansow a'n folen ma yw drafftow mekanik anwrys. An folen Saesnek yw an versyon awtorys.

An pyth a wra Lily, ha'n pyth na wra

Lily a ros dhywgh kevambosow displetyans: markya semantek, ARIA, jawnsyans an kebmyn ha higow klass rag an taclow a dhegesh war skrynyow klinikel. Ny ros dhywgh logik klinikel, dehwelans klinikel na ensampel reolans.

An pyth a ro Lily, hag an pyth a rewgh why
Lily a ro Why a ro
observation-view: gwerth, unn, baner yn geryow, ystynnans ha stadys gwerth ow ladhes An gwerth, an dhewisyans a'n baner, an ystynnans dheskrifa
allergy-record-list ha allergy-record-list-item: stat na vydh nevra gwag An rekord alergi ha'y dermynologieth
medication-view: hanow, nerth, furv, fordh ha mynsys, travyth ny vydh trenkys Data an medhegneth, an rannow tall man, an nerth furvys
decision-support-card: furv an kerdh CDS Hooks An reolyow, an gweythow profys, notya an sewyans
early-warning-score-view: skor, bagas hag ardhyllyans, displetys An system skorya ha'y gonter gwiryys
age-view ha ageParts(): oos yn unnow gwiw dhodho An geryow rag an unnow (Intl.DurationFormat py y honan lavarow)
formatQuantity(): 5 mg, nevra 5.0 mg; 0.5 mg, nevra .5 mg An niver, an unn ha'n localeth
Kesstrethans baner an glaf Pub lavar ha gwerth, ha piw a yll gweles kedhlow klinikel

Reolans. Medhelweyth a gonta skor, centil, dos py kesoberans medhegnow yw yn kemmyn drefen medhegel. Ny gonta Lily travyth anodho, a-vyn. Mara'th eus reolys dha vroduk, why a'n jeves an dosher a vheynans devnydhyans (IEC 62366-1, hynsa FDA a'n fatlow denyl, EU MDR). Prevyansow Lily, y dherivas a gesrywvos kefrysys a hedhyans a-dro dhe gedhlow tevlus ha'y matrix redyer skrin a yll bos displetyans y'n dosher na; nyns yw travyth anodho dyskwedhyans a gesrywvos, ha nyns eus sewyans y'n matrix hwath.

Gwarnyansow: terri hepken rag an pyth yw kritek

Skwithter gwarnyansow yw kudyn a sawder: pan wra pub gwarnyans terri, tus a dhegh pub unn anodho. Hynsa AHRQ yw derevel gwarnyansow warlergh dhe'ga garowder ha gul hepken an re garow terri.

  • Kedhlow (indicator="info"): y'n linen, ryb an oberen, kerdh skoodhyans dewisyans y'n folen.
  • Gwarnyans (indicator="warning"): gwelys heb lettya, an keth kerdh, furvys rag sevel dhe-ves; heb modal.
  • Kritek (indicator="critical"): gorrewgh an kerdh a-berth yn kesklappya gwarnyans, ha profyewgh overrideReasons may fo govynnys acheson pan y'n degh.
  • Kerdh skoodhyans dewisyans ny vydh nevra rannvro fyw ynno y honan. Derivewgh kerdh kritek nowydh dre dreylya an fok y'n kesklappya, na dre aria-live.
  • Dilehewgh kerdh pan wrella an hwarvos a worthebis dhodho arta, ha notyewgh pub sewyans (kemmerys, py dhe-ves gans y acheson).

Kammgemmeres glaf: aswon, na lettyewgh

  • Dysqwedhewgh dew aswonyer ple pynag a omdhysqwa data glaf: an hanow gans an dedh genesigeth, ha'n aswonyer kenedhlek gans y elven gwel (The Joint Commission, Quick Safety 45).
  • Devnydhewgh baner an glaf war bub skrin a oberas war rekord unn glaf, ha gwithewgh orth y welys.
  • Kyns gweythres war rekord forth dres hedna y'n baner, kadarnhewgh gans an hanow, an dedh genesigeth hag an aswonyer.
  • Kovnotyans a-dro dhe nebonan aral es an klavji (istori kar, fetus, rier) a lever yn kynsa, yn geryow, piw a'n jeves: rewgh dhe daklow an kovskrif subjectLabel ("Mamm"), ma na vo diagnosis kar redys bythkweyth avel diagnosis an klavji (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Na lettyewgh pyw lyes rekord a yll medhek egerry: previans randomys gans 3,356 medhek (JAMA, 2019) a gafas na dhisikhas ordenyow dhe'n klaf cam, ha tus a gav fordh a-dro dhodho.
  • Rol a wriansow war unn kovskrif a hanow an kovskrif na yn kynsa, gans subjectLabel war context-menu po dropdown-menu ("Ada Lovelace, gwask goes 3 Du"): kynsa rann anvenkenedhel yw ynwedh hanow hedhadow an rol.
  • Renkyewgh pub gwrians herwydh an pyth a wra, ha gwrewgh an renk gweladow kyns ev dhe resek. Usadow (mires, pryntya) a res a-dhistowgh. Skrifys a lever an pyth a skrif y'n kovskrif ("Ow keworra noten dhe'n kesvetyans"). Klinikel (hedhi, hepkorr arghadow) a wovyn nessa treveth, yn alert-dialog may ma an verb war y voton afydhya ("Hedhi"), bythkweyth "OK" po "Ya". Diskudhus (hedhas a-brys, kevranna yn-mes a'n bagas chyf) a wovyn kyns ken ha'y govskrifa.
  • Pan vo lies kovskrif ygor (tabow, fenestri, paneli rynnys), tekst gweladow ha hanow hedhadow pub tab a gomprehend hanow an klavji ha nessa aswonnvos, an panel bew a dhaskan an baner, ha nyns yw gwrians vyth a-dro dhe glavji aral es klavji y banel.
  • Diskwedhewgh an le may fydh kovskrifow attrybutys dhodho (an rann, an klinik po an dyghtyans dewisys orth omgelwel) avel tekst yn penn an folen, ha gwrewgh y janjya gwrians apert.
  • Diskwedhewgh an vysytyans bew, po "Vysytyans bew vyth", y'n baner. Furvlen a'n jeves edhom a vysytyans a lever henna hag a brof dalleth onan, yn le a fyllel pan vo gwithys.

Baner an glaf

An kesstrethans yw skrifys orth medical-banner, gans folen oberys orth /patient-banner y'n app skeul SvelteKit:

  • dew aswonyer, hag an oos ryb an dedh genesigeth;
  • alergiow dre rol alergiow, may na'n gwelir nevra haval “alergiow aswonys vyth nyns eus”, “ny notyas” ha “ny'th eus”;
  • gwerth ow ladhes yw geryow (“Anaswonys”), nevra arwodh govyn, dash py kell wag;
  • klaf marow: data-deceased rag an tema, ha linen welys a dhyskrifans, nevra liw hepken;
  • nyns eus maes trenkys, skubys py kudhys orth lethed vyth; ev a blegh.
  • baneri klavji ("Edhom a dreylyer", "Peryl klevejy") yw tag-group gans label a eryow, bythkweyth arwodhyow po liw yn unnsel, hag y a dryg gweladow pan vo an baner ow maylya.

Sewyansow

  • Unn displetyans rag sewyans, pynag system a dheuth anodho: an gwel a'n arsyans.
  • An baner yw geryow a'th treylyans (flagLabel), gans kod ynterprettyans FHIR avel data-interpretation rag an tema.
  • Dyberthewgh sewyansow nowydh a'n re kyns ha dyskwedhewgh tuedh (sparkline, py chart linen gans y dabel data): medhogyon a hwila chanj bryntyn, nyns hepken an ystynnans.
  • Sewyans na veu nevra notys ha re nyns yw ynno yw stadys dyffrans, gans geryow dyffrans.
  • Ankoth nyns yw usadow. Sewyans heb y amkan daskyrhadow, po ow karga hwath po anredyadow, ny'n jeves styryans hag ev a lever henna; observation-view ny dhyskwedh onan bythkweyth, ytho sewyans gans amkan ha heb interpretation ny dhiskwedh baner vyth.
  • Sewyans yn-mes a'n skeul yw finweth an toul gans kehevelydh ("> 33.3 mmol/L": formatQuantity gans ">") ha'gas baner peryl, bythkweyth niver noeth. Talvos ogas a with y ≈ ("~").
  • Rewgh amkanow henwys moy ("Peryl: yn-dann 2.5") avel ranges, pub onan y rann y honan.
  • Sewyans ewnhes po chanjys a with an talvos a gemmeras y le, yn <del>, gans agas geryow rag pan janjyas (previousValue, previousLabel), ma'n godhvo klinikydh a redyas an talvos koth y janjya.
  • Redyans spys a lever y les ha'y wrians ("Mayn, 24 our"), ha studh ha fordh redyans ("Esedhys, kroglen vras") yw tekst gweladow ryb henna, bythkweyth tip toul yn unnsel (openEHR INTERVAL_EVENT, state, protocol).
  • Edhom a'n jeves gwrys a boyntys hevelladow: na dennewgh linen yn-dann agas lyha, terrewgh an linen le may chanjyas an fordh po an assay, ha leverewgh an fordh ha'n styr yn geryow ("ow kodhevel, ow kwellhe").
  • Arwodhyow bewnans entrys yn unn kevreyth unsys a yll diskwedhes an aral ryb aga thu avel agas tekst ("70 kg (154 lb)"); ny dreyl Lily travydh, ytho leverewgh agas kelghyans. Entrewgh myns gans quantity-input-div, may hwra y niver kemeres finwethow pub unsys.
  • Tresen tevi yw line-chart gans agas linennow kansrann avel stelyow, poyntys an flogh ha'y daklen data a oos ha talvos; ny akont Lily kansrann vyth ha ny dhro daskyrhans tevi.

Medhegnow

  • Hanow kynsa yn lytherennow byghan, marnas lytherennow tall man a rolyow FDA hag ISMP py a'th pow (Ostrali ha Kanada a bupsha y honan). Ardhewgh anedha yn nameSegments; Lily ny waylyn nevra anedha.
  • Skrifewgh an nerth gans formatQuantity: heb nowt diwettha, gans nowt kynsa, gans spas heb terri kyns an unn.
  • Gwithewgh kehaval sewyans: formatQuantity(5, "mmol/L", locale, "<") a skriv “<5 mmol/L”. Quantity.comparator FHIR yw skrifys avel <, ≤, ≥ py >; mar teuvewgh anodho, “le es 5” a dheu “5”.
  • Skrifewgh mL, nevra cc, ha skeusewgh pub berrheans a rol ISMP a vydh tyn dhe gammow.
  • Na drenkewgh nevra hanow py dos medhegneth.

Dedhyow hag eurow

  • Skrifewgh an mis avel tekst may na yller redya dedh a'n dhew fordh (Intl.DateTimeFormat gans month: "short").
  • Dewisewgh an horlonj a-vyn: tremenewgh hourCycle yn splan. An NHS a wovynn horlonj 24 our; hedna yw reyth an Pow Unys, nyns yw reyth ollvys, ytho ny dhewisa Lily nevra ragowgh.
  • Oosow a sew bagasow an Common User Interface dre ageParts(); gonsel gans kevambos aral a dremen y honan lavarow.
  • Dydh godhvedhys bys y'n mis po y'n vledhen yn unnsel a dryg yndella: govynnewgh ragdho gans date-field precision="month" po "year", gwithewgh 2019-03 po 2019, ha'y skrifa gans formatPartialDate(). Na dhevisewgh dydh bythkweyth.
  • Hys a dermyn yw duration-view, <time datetime="P3DT4H"> ow sinsi agas geryow, dhyworth durationParts() ha Intl.DurationFormat.

Tavlennow-kenwel

  • Bord wardh py skrin kreslu-ardhyans a nowedha yn fenowgh. Na dherivewgh nevra pub chanj: gwithewgh unn rannvro dhyskrifans jentyl (“3 gwely rydh, 2 dyllans gwrys”) ha gesewgh tus dhe redya an bord.
  • Pub stad war bord (gwely glan, kemmerys, lettys) yw tekst py stad data-* gans geryow, nevra liw hepken.
  • Travydh ny lugh (WCAG 2.2.2, 2.3.1), ha bord a nowedh war amseryer a'n jeves rewler hedhi po ny nowedh marnas pan vo govynnys; nowedhyansow ny wayv an fog bythkweyth. Kovnotyans diwedhes a lever henna yn geryow ("Ow kortos dres 20 mynysen") gans data-overdue.
  • Niveryans po kevradh a dhiskwedh y rannyas ("12 a 68") hag a gevrenn dhe'n rol a-dryv dhodho.
  • Rol po linen-dermyn a lever pyth yw hi avel gwel: an pyth a dhiskwedh, hy aray ha'y fenester, an pyth yw kudhys ha prag, ha py fentynyow na worthybis. Rol wag dhyworth fenten na worthybis nyns yw prov nag eus travydh.
  • Rol porthkovyow yw record-list may'n jevydh hy thaklow dydh dendil (review-date) ha studh dendil yn geryow, gans data-due; an rewl a's gwrug yw dhywgh hwi.

Furvlenyow

  • Govyn gorthybys "ya", "na" po "na wovynnys" yw radio-group a dri gorthyp, onan vyth dewisys orth an dalleth, bythkweyth kist-merk: ny yll kist-merk diberth "nehys" ha "bythkweyth govynnys". Daswel a gevreythyow yw unn fieldset rag pub kevreyth korf, ha boton "oll an re erel absent" ny set marnas an re heb gorthyp.
  • Govyn gans rol a worthybow (medhegynyow, trigvaow) yw repeatable-fieldset: tak yw keworrys po removys, an fog a syw, ha pub boton remova yw henwys herwydh y dak.
  • Niver gans kroglinen degel: diskwedhewgh ev gans Intl.NumberFormat ha, le na dhegemmer type="number" an kroglinen, kemerewgh ev yn gwel tekst gans inputmode="decimal" ha'y bersya yn agas kod. Na janjyewgh bythkweyth talvos a skrifas an den, kyn fo rag y finya dhe amkan: talvos yn-mes a'n amkan yw kammwrians a yllons y weles.
  • Rol hir na dhiskwedh marnas rann a'y dewisyow war unn termyn a set aria-setsize ha aria-posinset war pub dewis, hag a berth kov na yll hwilas y'n folen gweles an remenant.

Kovskrifow, notennow ha'ga devedhyans

  • Leverewgh pyth yw rol po kloos avel gwel, kyns hy rewow: hy fenester ha'y aray, an pyth a as yn-mes ha prag, ha py fentynyow na worthybis ("12 mis diwettha, an diwettha kynsa. Ny worthybis kovskrif an medhek teylu."). Rewgh dhe record-list ha timeline-list coverageLabel, ha dhe'n gweresor data-grid y coverageLabel. Rol wag dhyworth fenten na worthybis a lever henna yn geryow, ma na vo hi redys bythkweyth avel "travydh kovskrifys".
  • Leverewgh a-ble teuth kovskrif hag yw ev finel gans record-provenance-view: sinys, ow kortos sin, chanjys, gwithys war an devis ma ha na dhannvenys hwath. Kynsskrif heb sin ny dal bythkweyth bos haval dhe sinys.
  • Kovnotyans a-dro dhe nebonan aral (kar, fetus, rier) a lever yn kynsa piw a'n jeves, gans subjectLabel.
  • Kovnotyans synsys a dryg y'n rol gans agas geryow ("Lesys: nyns yw kavadow dhywgh"), ha kovnotyans gwrys dre gammwrians a dryg treuslinennys gans "Entrys dre gammwrians": rewgh dhe record-list-item po timeline-list-item entryState ha entryStateLabel. Na removewgh onan vyth anedha yn kosel bythkweyth, drefen bolghen dhe vos redys avel "ny hwarva travydh".
  • Yn noten glinikel, merkyewgh fenten pub tremenyans (skrifys, leverys, skantlyn, dasskrifys a-rag, gwrys) gans data-source ha geryow gweladow, ma na vo tekst dasskrifys po gwrys kemerys bythkweyth avel apposyans hedhyw.
  • Rann na yll karga yw unavailable yn agas geryow, gans boton assaya arta; kod teknegel, mar pydh diskwedhys, a esedh a-dryv diskudhans. Fyllans kawsys gans gwrians den yw deklaryes, gans an talvos a'n jeves an kovskrif lemmyn; fyllans orth karga an folen nyns yw.
  • Istori arghadow yw timeline-list, unn tak pub kamm (towlys, amserys, bew, hedhys dres termyn, gorfennys, hepkorrys) gans y dermyn ha'y ken, ha'n studh a-lemmyn ynwedh war an tak.

A FHIR dhe Lily

Nyns usi Lily FHIR dhe redya; agas kod a'n mapya dhe berthow Lily. An tablys ma a vap Dyvyskrif Glaf Kesstrodhek HL7 FHIR (IPS 2.0.1, FHIR R4). An mapyans a godhow yw profys: agas dhivyn a surder klinikel a'n ordn, ha'n geryow rag peub stat yw agas aga honan.

Rannow IPS ha'n kuntellow Lily ragdhe
Rann IPS Lily
Alergiow ha heb-godhesans (48765-2) allergy-record-list ha'y elvennow
Dyvyskrif medhegnow (10160-0) medication-record-list, gans peub elven ow talgh medication-view
Rol a dhrefenow (11450-4) problem-record-list ha'y elvennow
Imynyansow (11369-6) immunization-record-list ha'y elvennow
Sewyansow (30954-2) observation-view, yn tabel data py rol dyvyskrif
Hyns a obereth (47519-4) procedure-record-list ha'y elvennow
Daffar medhegel (46264-8) device-record-list ha'y elvennow
Gwarnyansow (104605-1) Tekst gwarnya py gwarnyans, nevra tu ha daskor gwithyans degreys
Pub rann aral record-list ha'y elvennow
Rann res a asow an skrif dhe-ves Rol an rann gans status="omitted"
Kodow FHIR ha'n gwerthow Lily ragdhe
FHIR Lily
emptyReason nilknown status="none-known" an rol
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", gans geryow a laver pyth yw
Kodow IPS no-known-allergies, no-known-medications ha kehaval status="none-known"
Kodow IPS no-allergy-info, no-medication-info ha kehaval status="not-recorded"
AllergyIntolerance.criticality criticality, dyvers dhiworth severity a dhyskrans
clinicalStatus, verificationStatus An keth berthow war elvennow alergi ha drefenow, gans an keth kodow
MedicationStatement.status status an elven medhek
Dosage.text medication-view dosageText
Observation.status status observation-view, gans an keth kodow
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (ynwedh war an rolyow kovskrif)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Mapyewgh rekord entered-in-error dh'y stat entered-in-error, gans geryow, yn le y dhe-ves yn ostyn: pan na vo gwelys, dhe'gas gonis yw an dhivyn.

Dhyworth openEHR dhe Lily

Ny red Lily kesskrifow openEHR naneyl. An mappyans rag eghennow data ha kodow Patron Daskyrhans openEHR, avel profyans may hwra agas daswel saweteth klinikel ervira:

Eghennow data ha kodow openEHR, ha'n talvosow Lily ragdha
openEHR Lily
DV_QUANTITY (entrans) quantity-input-div; unsysow avel kodow UCUM gans agas geryow
DV_QUANTITY (diskwedhans), magnitude_status observation-view gans formatQuantity(value, unit, locale, comparator) (~ yw ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges gans meaning observation-view ranges
DV_DATE rannel (bledhen, bledhen ha mis) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view gans durationParts()
DV_PROPORTION formatProportion() a-ji dhe observation-view
DV_ORDINAL, DV_SCALE radio-group may'n jevydh hy labelyow an niver ha'y eryow
DV_CODED_TEXT patron an talvosow kodys a-woles
DV_BOOLEAN checkbox-input, marnas pan na yll "na wovynnys" hwarvos
ELEMENT.null_flavour 253 ankoth, 271 kedhlow vyth status="not-recorded" po "unavailable", gans geryow a laver pyth yw
null_flavour 272 kudhys observation-view status="masked"
null_flavour 273 anyagh status="not-applicable"
PARTY_RELATED testen subjectLabel war daklow an kovskrif
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Kammow Jynn Studh an Kevarwodhow timeline-list a gammow, gans an studh a-lemmyn war an tak
tak archetyp gans hwarvosow 0..* repeatable-fieldset

Gwerthow kodys

  • Diskwedhewgh Coding.display; mar nyns eus, CodeableConcept.text; mar nyns eus onan, system|code. Nevra kell wag.
  • Profyewgh gwithyans a dhiskwa an system godhow ha'n kod ryb peub gwerth, avel button trogh gans “Diskwedhewgh kodow”. Kodow kudhys a bys ves a'n ordn redya erna vons diskwedhys.
  • Merkyewgh tekst klinikel gans yeth an skrif (lang), a yll bos dyffrans dhiworth yeth an etrefas. Treylyewgh an etrefas; nevra an dalgh klinikel.
  • Nyns usi Lily termynologieth: nyns eus whythrans SNOMED CT, LOINC, ATC py UCUM. Skrifewgh an pyth a laver an skrif. An folen /patient-summary a'n ensample SvelteKit a dhiskwa an patron.

An pyth na wra Lily

  • Kontya skor ardhyans a-varr, centil kressyans, dos py ystynnans dheskrifa.
  • Danvon pennfenten medhegnow, rol tall man, py kodow SNOMED CT, CIM, LOINC py UCUM.
  • Eskopiya instrumant gans lis (Wong-Baker FACES) py gwrians corf aral (an chart NEWS2).
  • Lettya niver an rekordys ygor war an eur kynsa.
  • Dyskwedhes styryans dhyworth amkan, treylya unsys, po persya dydh kevrennek ("dy' Meurth a dheu").
  • Usya skwychel rag "ya, na po ankoth": nyns eus tressa studh dhe switch ARIA, ytho tri boton radyo yw.

An whelyans, an fentynnow ha'n dewisyansow a-dryv an hynsa ma yw yn spec/healthcare-ui.