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.
| 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 profyewghoverrideReasonsmay 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelwarcontext-menupodropdown-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-dialogmay 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-deceasedrag 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-groupgans 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 aveldata-interpretationrag 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-viewny dhyskwedh onan bythkweyth, ytho sewyans gans amkan ha hebinterpretationny dhiskwedh baner vyth. -
Sewyans yn-mes a'n skeul yw finweth an toul gans kehevelydh ("> 33.3 mmol/L":
formatQuantitygans">") 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-chartgans 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.comparatorFHIR 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.DateTimeFormatgansmonth: "short"). - Dewisewgh an horlonj a-vyn: tremenewgh
hourCycleyn 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-fieldprecision="month"po"year", gwithewgh2019-03po2019, ha'y skrifa gansformatPartialDate(). Na dhevisewgh dydh bythkweyth. -
Hys a dermyn yw
duration-view,<time datetime="P3DT4H">ow sinsi agas geryow, dhyworthdurationParts()haIntl.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-listmay'n jevydh hy thaklow dydh dendil (review-date) ha studh dendil yn geryow, gansdata-due; an rewl a's gwrug yw dhywgh hwi.
Furvlenyow
-
Govyn gorthybys "ya", "na" po "na wovynnys" yw
radio-groupa dri gorthyp, onan vyth dewisys orth an dalleth, bythkweyth kist-merk: ny yll kist-merk diberth "nehys" ha "bythkweyth govynnys". Daswel a gevreythyow yw unnfieldsetrag 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.NumberFormatha, le na dhegemmertype="number"an kroglinen, kemerewgh ev yn gwel tekst gansinputmode="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-setsizehaaria-posinsetwar 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-listhatimeline-listcoverageLabel, ha dhe'n gweresordata-gridycoverageLabel. 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-itempotimeline-list-itementryStatehaentryStateLabel. 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-sourceha geryow gweladow, ma na vo tekst dasskrifys po gwrys kemerys bythkweyth avel apposyans hedhyw. -
Rann na yll karga yw
unavailableyn 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.
| 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" |
| 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:
| 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-summarya'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
switchARIA, ytho tri boton radyo yw.
An whelyans, an fentynnow ha'n dewisyansow a-dryv an hynsa ma yw yn spec/healthcare-ui.