Comhéadain úsáideora cúraim sláinte
Treoir do fhoirne a bhíonn ag tógáil bogearraí cliniciúla le Lily: tairseacha cliniciúla, torthaí agus tuairisciú, údarú agus riar cógas, tacaíocht cinnteoireachta agus deais ospidéil.
Is dréachtaí meaisín gan athbhreithniú iad aistriúcháin na leathanaigh seo. Is é an leathanach Béarla an leagan údarásach.
Cad a dhéanann Lily, agus cad nach ndéanann
Tugann Lily conarthaí taispeána duit: marcáil shéimeantach, ARIA, iompar méarchláir agus crúcaí aicme do na rudaí a athdhéanann scáileáin chliniciúla. Ní thugann sí loighic chliniciúil, ábhar cliniciúil ná éileamh rialála duit.
| Soláthraíonn Lily | Soláthraíonn tú |
|---|---|
| observation-view: luach, aonad, bratach i bhfocail, raon, agus staideanna luacha ar iarraidh | An luach, an cinneadh faoin mbratach, an raon tagartha |
| allergy-record-list agus allergy-record-list-item: stádas nach bhfuil folamh riamh | An taifead ailléirge agus a téarmaíocht |
| medication-view: ainm, neart, foirm, bealach agus minicíocht, gan aon rud giorraithe | Sonraí an chógais, na deighleoga tall man, an neart formáidithe |
| decision-support-card: cruth chárta CDS Hooks | Na rialacha, gníomhartha na moltaí, an toradh a thaifeadadh |
| early-warning-score-view: scór, banda agus ardú céime, ar taispeáint | An córas scórála agus a ríomh bailíochtaithe |
age-view agus ageParts(): aois in aonaid a oireann di |
Na focail do na haonaid (Intl.DurationFormat nó do lipéid féin) |
formatQuantity(): 5 mg, 5.0 mg riamh; 0.5 mg, .5 mg riamh |
An uimhir, an t-aonad agus an logchaighdeán |
| Comhdhéanamh mheirge an othair | Gach lipéad agus luach, agus cé a fhéadfaidh faisnéis chliniciúil a fheiceáil |
Rialáil. Is gnách gur feiste leighis é bogearra a ríomhann scór, ceatadán, dáileog nó idirghníomhú cógas. Ní ríomhann Lily aon cheann díobh seo, d’aon ghnó. Má tá do tháirge rialaithe, is leatsa a chomhad innealtóireachta inúsáidteachta (IEC 62366-1, treoir an FDA ar fhachtóirí daonna, EU MDR). Is féidir le tástálacha Lily, a tuarascáil féinmheasta ar chomhréireacht inrochtaineachta agus a maitrís léitheoirí scáileáin a bheith ina fianaise sa chomhad sin; ní éileamh comhréireachta aon cheann díobh, agus níl aon torthaí sa mhaitrís go fóill.
Foláirimh: ná cuir isteach ach ar an méid atá criticiúil
Is fadhb sábháilteachta é tuirse foláirimh: nuair a chuireann gach foláireamh isteach, déanann daoine neamhaird orthu go léir. Is é treoir AHRQ foláirimh a rangú de réir déine agus gan ligean ach do na cinn dhéine cur isteach.
- Faisnéis (
indicator="info"): inlíne, in aice leis an tasc, cárta tacaíochta cinnteoireachta sa leathanach. - Rabhadh (
indicator="warning"): infheicthe gan blocáil, an cárta céanna, stíleáilte le seasamh amach; gan modh. - Criticiúil (
indicator="critical"): cuir an cárta taobh istigh de dhialóg foláirimh, agus tairgoverrideReasonsionas go n-iarrfaidh a dhiúltú cúis. - Ní réigiún beo cárta tacaíochta cinnteoireachta leis féin riamh. Fógair cárta criticiúil nua trí fhócas a bhogadh isteach sa dialóg, ní trí
aria-live. - Bain cárta nuair a tharlaíonn an teagmhas ar fhreagair sé dó arís, agus taifead gach toradh (glactha, nó sáraithe lena chúis).
Earráidí an othair mhícheart: aithin, ná srian
- Taispeáin dhá aitheantóir aon áit a bhfuil sonraí othair le feiceáil: an t-ainm leis an dáta breithe, agus an t-aitheantóir náisiúnta lena chomhpháirt amhairc (The Joint Commission, Quick Safety 45).
- Úsáid meirge an othair ar gach scáileán a ghníomhaíonn ar thaifead othair amháin, agus coinnigh infheicthe é.
- Sula ndéanann tú gníomh ar thaifead seachas an ceann sa mheirge, deimhnigh é leis an ainm, an dáta breithe agus an t-aitheantóir.
-
Insíonn iontráil faoi dhuine seachas an t-othar (stair tuismitheora, féatas, deontóir) ar dtús, i bhfocail, cé leis í: tabhair do mhíreanna an taifid
subjectLabel("Máthair"), ionas nach léifear diagnóis gaoil riamh mar dhiagnóis an othair (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Ná cuir teorainn le líon na dtaifead a fhéadfaidh cliniceoir a oscailt: fuair triail randamaithe le 3,356 cliniceoir (JAMA, 2019) nár laghdaigh sé orduithe don othar mícheart, agus go dtéann daoine timpeall air.
-
Ainmníonn roghchlár gníomhartha ar thaifead amháin an taifead sin ar dtús, le
subjectLabelarcontext-menunódropdown-menu("Ada Lovelace, brú fola 3 Samh"): céad chuid neamh-idirghníomhach atá ina ainm inrochtana an roghchláir freisin. -
Rangaigh gach gníomh de réir a ndéanann sé, agus déan an leibhéal infheicthe sula ritheann sé. Gnáth (féachaint, priontáil) ritheann sé láithreach. Doiciméadaithe insíonn sé cad a scríobhfaidh sé sa taifead ("Cuireann nóta leis an teagmháil").
Cliniciúil (scor, ordú a chealú) iarrann sé an dara huair, i
alert-dialoga bhfuil an briathar ar a chnaipe deimhnithe ("Scoir"), riamh "OK" ná "Tá". Nochtach (rochtain éigeandála, comhroinnt lasmuigh den fhoireann chúraim) iarrann sé cúis ar dtús agus taifeadann sé í. - Nuair a bhíonn roinnt taifead oscailte (cluaisíní, fuinneoga, painéil scoilte), cuimsíonn téacs infheicthe agus ainm inrochtana gach cluaisín ainm an othair agus an dara aitheantóir, athdhéanann an painéal gníomhach an meirge, agus ní bhaineann aon ghníomh le hothar seachas othar a phainéil.
- Taispeáin an áit a gcuirfear taifid ina leith (an barda, an clinic nó an tsaoráid a roghnaíodh ag síniú isteach) mar théacs i gceanntásc an leathanaigh, agus déan gníomh sainráite de í a athrú.
- Taispeáin an chuairt ghníomhach, nó "Gan chuairt ghníomhach", sa mheirge. Insíonn foirm a dteastaíonn cuairt uaithi é sin agus tairgeann sí ceann a thosú, seachas teip nuair a shábháiltear í.
Meirge an othair
Tá an comhdhéanamh doiciméadaithe le medical-banner, le leathanach oibre ag /patient-banner in aip samplaí SvelteKit:
- dhá aitheantóir, agus an aois in aice leis an dáta breithe;
- ailléirgí trí liosta ailléirgí, ionas nach mbeidh “aon ailléirge aitheanta”, “gan taifeadadh” agus “gan a bheith ar fáil” cosúil le chéile riamh;
- is focail atá i luach atá ar iarraidh (“Anaithnid”), ní comhartha ceiste, fleiscín ná cill fholamh riamh;
- othar atá básaithe:
data-deceaseddon téama, agus líne théacs infheicthe, ní dath amháin riamh; - níl aon réimse giorraithe, gearrtha ná i bhfolach ag aon leithead; fillteann sé.
-
is
tag-grouplipéadaithe d'fhocail iad bratacha an othair ("Teastaíonn ateangaire", "Riosca ionfhabhtaithe"), riamh deilbhíní ná dath amháin, agus fanann siad infheicthe nuair a fhillteann an meirge.
Torthaí
- Amharc amháin ar thoradh, pé córas as ar tháinig sé: an t-amharc breathnóireachta.
- Is focail ón aistriúchán agatsa an bhratach (
flagLabel), le cód léirmhínithe FHIR mardata-interpretationdon téama. - Scar torthaí nua ó cheannacha níos luaithe, agus taispeáin treocht (spréacharlíne, nó cairt líne lena tábla sonraí): bíonn cliniceoirí ag lorg athraithe shuntasaigh, ní an raon amháin.
- Is staideanna difriúla iad toradh nár taifeadadh riamh agus toradh nach bhfuil ar fáil, le focail dhifriúla.
-
Ní hionann anaithnid agus gnáth. Níl aon léirmhíniú ag toradh a bhfuil a raon tagartha ar iarraidh, fós á lódáil nó doléite, agus deir sé é sin;
observation-viewní thátalaíonn sé ceann riamh, mar sin ní thaispeánann toradh le raon agus ganinterpretationaon bhratach. -
Is é toradh lasmuigh den scála teorainn na hionstraime le comparadóir ("> 33.3 mmol/L":
formatQuantityle">") agus do bhratach chriticiúil, riamh uimhir lom. Coinníonn luach garbh a ≈ ("~"). - Tabhair raonta ainmnithe eile ("Criticiúil: faoi 2.5") mar
ranges, gach ceann ina chuid féin. -
Coinníonn toradh ceartaithe nó leasaithe an luach a d'athsholáthair sé, i
<del>, le d'fhocail faoin uair a d'athraigh sé (previousValue,previousLabel), ionas go mbeidh a fhios ag cliniceoir a léigh an seanluach gur athraigh sé. -
Insíonn léamh eatramh a leithead agus a fheidhm ("Meán, 24 uair"), agus is téacs infheicthe in aice leis staid agus modh léimh ("Ina shuí, cufa mór"), riamh leid uirlise amháin (openEHR
INTERVAL_EVENT,state,protocol). - Teastaíonn pointí inchomparáide ó threocht: ná tarraing líne faoi d'íosmhéid, bris an líne nuair a d'athraigh an modh nó an measúnú, agus abair an treo agus an bhrí i bhfocail ("ag titim, ag feabhsú").
-
Féadfaidh comharthaí beatha a iontráladh i gcóras aonad amháin an córas eile a thaispeáint in aice leo mar do théacs ("70 kg (154 lb)"); ní thiontaíonn Lily aon rud, mar sin luaigh do shlánú. Iontráil cainníocht le
quantity-input-div, a nglacann a uimhir le teorainneacha gach aonaid. -
Is
line-charté cairt fáis le do línte ceintíle mar shraitheanna, pointí an linbh agus a tábla sonraí d'aois agus luach; ní ríomhann Lily aon cheintíl agus ní sholáthraíonn sé aon tagairt fáis.
Cógais
- Ainmneacha cineálacha i litreacha beaga, ach amháin litreacha tall man ó liostaí an FDA agus ISMP nó ó liosta do thíre (foilsíonn an Astráil agus Ceanada a gcuid féin). Marcáil iad in
nameSegments; ní thomhaiseann Lily riamh iad. - Scríobh an neart le
formatQuantity: gan nialas ag an deireadh, le nialas ar tosach, le spás neamhbhriste roimh an aonad. - Coinnigh comparadóir toraidh: scríobhann
formatQuantity(5, "mmol/L", locale, "<")“<5 mmol/L”. ScríobhtarQuantity.comparatorFHIR mar <, ≤, ≥ nó >; má fhágtar ar lár é, athraítear “níos lú ná 5” go “5”. - Scríobh mL, cc riamh, agus seachain gach giorrúchán atá ar liosta ISMP de na cinn is dóchúla earráid.
- Ná giorraigh riamh ainm ná dáileog cógais.
Dátaí agus amanna
- Scríobh an mhí mar théacs ionas nach féidir dáta a léamh ar dhá bhealach (
Intl.DateTimeFormatlemonth: "short"). - Roghnaigh an clog d’aon ghnó: pas
hourCyclego sainráite. Iarrann an NHS an clog 24 uair; riail na Ríochta Aontaithe é sin, ní riail dhomhanda, mar sin ní roghnaíonn Lily riamh duit é. - Leanann aoiseanna bandaí an Common User Interface trí
ageParts(); cuireann seirbhís le coinbhinsiún eile a focail féin ar aghaidh. -
Fanann dáta nach eol ach go dtí an mhí nó an bhliain amhlaidh: iarr é le
date-fieldprecision="month"nó"year", stóráil2019-03nó2019, agus scríobh é leformatPartialDate(). Ná cum lá riamh. -
Is
duration-viewé fad ama,<time datetime="P3DT4H">a choinníonn d'fhocail, ódurationParts()agusIntl.DurationFormat.
Deais
- Nuashonraítear bord barda nó scáileán lárionaid ceannais go minic. Ná fógair gach athrú riamh: coinnigh réigiún achoimre séimh amháin (“3 leaba saor, 2 scaoileadh amach ag teacht”) agus lig do dhaoine an bord a léamh.
- Is téacs nó staid
data-*le focail gach staid ar bhord (leaba glan, áitithe, blocáilte), ní dath amháin riamh. -
Ní phreabann aon rud (WCAG 2.2.2, 2.3.1), agus bíonn rialtán sosa ag clár a nuashonraíonn ar amadóir nó ní nuashonraíonn sé ach nuair a iarrtar; ní bhogann nuashonruithe an fócas riamh. Deir iontráil thar téarma é sin i bhfocail ("Ag fanacht le breis is 20 nóiméad") le
data-overdue. - Taispeánann líon nó ráta a ainmneoir ("12 as 68") agus nascann sé leis an liosta taobh thiar de.
- Deir liosta nó amlíne cad atá ann mar léargas: cad a thaispeánann sé, a ord agus a thréimhse, cad atá i bhfolach agus cén fáth, agus cé na foinsí nár fhreagair. Ní cruthúnas é liosta folamh ó fhoinse nár fhreagair nach bhfuil aon rud ann.
-
Is
record-listé liosta meabhrúchán a mbíonn dáta dlite ag a mhíreanna (review-date) agus staid dlite i bhfocail, ledata-due; is leatsa an riail a chruthaigh é.
Foirmeacha
-
Is
radio-groupde thrí fhreagra é ceist a bhfreagraítear "tá", "níl" nó "níor fiafraíodh" uirthi, gan aon cheann roghnaithe ar dtús, riamh ticbhosca: ní féidir le ticbhosca idirdhealú a dhéanamh idir "séanta" agus "níor fiafraíodh riamh". Isfieldsetamháin in aghaidh gach córais choirp é athbhreithniú córas, agus ní shocraíonn cnaipe "gach ceann eile as láthair" ach na cinn gan freagra. -
Is
repeatable-fieldseté ceist a bhfuil liosta freagraí aici (cógais, seoltaí): cuirtear mír leis nó baintear í, leanann an fócas, agus tá gach cnaipe bainte ainmnithe as a mhír. -
Uimhir le camóg dheachúlach: taispeáin í le
Intl.NumberFormatagus, nuair nach nglacanntype="number"leis an gcamóg, glac í i réimse téacs leinputmode="decimal"agus parsáil í i do chód. Ná hathraigh riamh luach a chlóscríobh an duine, fiú chun é a shrianadh go raon: earráid is féidir leo a fheiceáil is ea luach lasmuigh den raon. -
Socraíonn liosta fada nach dtaispeánann ach cuid dá roghanna ag an am
aria-setsizeagusaria-posinsetar gach rogha, agus cuimhnítear nach féidir le cuardach sa leathanach an chuid eile a fheiceáil.
Taifid, nótaí agus a mbunús
-
Abair cad is léargas ann do liosta nó do ghreille, roimh a sraitheanna: a thréimhse agus a ord, cad a fhágann sé ar lár agus cén fáth, agus cé na foinsí nár fhreagair ("12 mhí dheireanacha, an ceann is déanaí ar dtús. Níor fhreagair taifead an dochtúra teaghlaigh."). Tabhair do
record-listagus dotimeline-listcoverageLabel, agus don chúntóirdata-gridacoverageLabel. Deir liosta folamh ó fhoinse nár fhreagair é sin i bhfocail, ionas nach léifear riamh é mar "faic taifeadta". -
Abair cad as a dtáinig taifead agus an bhfuil sé críochnaitheach le
record-provenance-view: sínithe, ag fanacht ar shíniú, leasaithe, sábháilte ar an ngléas seo agus gan seoladh fós. Ní mór nach mbreathnódh dréacht gan síniú sínithe riamh. - Deir iontráil faoi dhuine eile (tuismitheoir, féatas, deontóir) ar dtús cé leis í, le
subjectLabel. -
Fanann iontráil choinnithe sa liosta le d'fhocail ("Srianta: níl sé ar fáil duit"), agus fanann iontráil a rinneadh trí dhearmad trasnaithe le "Iontráladh trí dhearmad": tabhair do
record-list-itemnótimeline-list-itementryStateagusentryStateLabel. Ná bain ceachtar acu go ciúin riamh, mar léitear bearna mar "níor tharla faic". -
I nóta cliniciúil, marcáil foinse gach sleachta (clóscríofa, deachtaithe, teimpléad, cóipeáilte ar aghaidh, ginte) le
data-sourceagus focail infheicthe, ionas nach nglacfar riamh le téacs cóipeáilte nó ginte mar scrúdú an lae inniu. -
Is
unavailableé rannán nach féidir a lódáil i d'fhocail, le cnaipe atriail; bíonn cód teicniúil, má thaispeántar é ar chor ar bith, taobh thiar de nochtadh. Fógraítear teip a tharla de bharr gnímh duine, leis an luach atá sa taifead anois; ní fhógraítear teip ag lódáil an leathanaigh. -
Is
timeline-listé stair ordaithe, mír amháin in aghaidh gach céime (pleanáilte, sceidealaithe, gníomhach, curtha ar fionraí, críochnaithe, cealaithe) lena am agus a chúis, agus an staid reatha ar an mír freisin.
Ó FHIR go Lily
Ní léann Lily acmhainní FHIR; mapálann do chód iad le props Lily. Mapálann na táblaí seo an HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Moladh is ea an mapáil cód: cinneann do athbhreithniú sábháilteachta cliniciúla é, agus is leatsa na focail do gach staid.
| Rannán IPS | Lily |
|---|---|
Ailléirgí agus éadulaingtí (48765-2) |
allergy-record-list agus a míreanna |
Achoimre cógais (10160-0) |
medication-record-list, agus medication-view i ngach mír |
Liosta fadhbanna (11450-4) |
problem-record-list agus a míreanna |
Imdhíonadh (11369-6) |
immunization-record-list agus a míreanna |
Torthaí (30954-2) |
observation-view, i dtábla sonraí nó i liosta achoimre |
Stair nósanna imeachta (47519-4) |
procedure-record-list agus a míreanna |
Feistí leighis (46264-8) |
device-record-list agus a míreanna |
Foláirimh (104605-1) |
Téacs rabhaidh nó foláireamh, ná taobh thiar de rialú fillte riamh |
| Aon rannán eile | record-list agus a míreanna |
| Rannán riachtanach a fhágann an doiciméad ar lár | Liosta an rannáin le status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
status="none-known" an liosta |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", le focail a deir cé acu |
Cóid IPS no-known-allergies, no-known-medications agus a leithéid |
status="none-known" |
Cóid IPS no-allergy-info, no-medication-info agus a leithéid |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, scartha ó severity imoibrithe |
clinicalStatus, verificationStatus |
Na props céanna ar na míreanna ailléirge agus fadhbanna, leis na cóid chéanna |
MedicationStatement.status |
status na míre cógais |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view status, leis na cóid chéanna |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (ar na liostaí taifead freisin) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Mapáil taifead entered-in-error dá stádas entered-in-error, le focail, in ionad é a scaoileadh go ciúin: cinneadh do sheirbhíse is ea an dtaispeántar ar chor ar bith é.
Ó openEHR go Lily
Ní léann Lily comhdhéanamh openEHR ach oiread. An mhapáil do chineálacha sonraí agus cóid Mhúnla Tagartha openEHR, mar mholadh a gcinnfidh d'athbhreithniú sábháilteachta cliniciúla air:
| openEHR | Lily |
|---|---|
DV_QUANTITY (iontráil) |
quantity-input-div; aonaid mar chóid UCUM le d'fhocail |
DV_QUANTITY (taispeáint), magnitude_status |
observation-view le formatQuantity(value, unit, locale, comparator) (~ is ≈ é) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges le meaning |
observation-view ranges |
DV_DATE páirteach (bliain, bliain agus mí) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view le durationParts() |
DV_PROPORTION |
formatProportion() laistigh de observation-view |
DV_ORDINAL, DV_SCALE |
radio-group a n-iompraíonn a lipéid an uimhir agus a focail |
DV_CODED_TEXT |
patrún na luachanna códaithe thíos |
DV_BOOLEAN |
checkbox-input, ach amháin nuair nach féidir le "níor fiafraíodh" tarlú |
ELEMENT.null_flavour 253 anaithnid, 271 gan aon fhaisnéis |
status="not-recorded" nó "unavailable", le focail a deir cé acu |
null_flavour 272 ceilte |
observation-view status="masked" |
null_flavour 273 ní bhaineann |
status="not-applicable" |
PARTY_RELATED ábhar |
subjectLabel ar mhíreanna an taifid |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Céimeanna Mheaisín Staide na dTreoracha | timeline-list de chéimeanna, leis an staid reatha ar an mír |
mír airchineála le minicíocht 0..* |
repeatable-fieldset |
Luachanna códaithe
- Taispeáin
Coding.display; mura bhfuil ceann ann,CodeableConcept.text; mura bhfuil ceachtar ann,system|code. Ná cill fholamh riamh. - Tairg rialú a nochtann an córas códaithe agus an cód le taobh gach luacha, mar chnaipe scoránaigh a deir “Taispeáin cóid”. Fanann cóid fholaithe lasmuigh d’ord léitheoireachta go dtí go dtaispeántar iad.
- Marcáil an téacs cliniciúil le teanga an doiciméid (
lang), a d’fhéadfadh a bheith difriúil le teanga an chomhéadain. Aistrigh an comhéadan; ná haistrigh an t-ábhar cliniciúil riamh. - Ní sholáthraíonn Lily téarmeolaíocht: gan cuardach SNOMED CT, LOINC, ATC ná UCUM. Scríobh an méid a deir an doiciméad. Taispeánann leathanach
/patient-summaryshampla SvelteKit an patrún.
Na rudaí nach ndéanfaidh Lily
- Scór luathrabhaidh, ceatadán fáis, dáileog nó raon tagartha a ríomh.
- Bunachar sonraí cógas, liosta tall man, ná cóid SNOMED CT, CIE, LOINC nó UCUM a sheoladh.
- Ionstraim cheadúnaithe (Wong-Baker FACES) nó dearadh comhlachta eile (cairt NEWS2) a atáirgeadh.
- Teorainn a chur le líon na dtaifead atá oscailte ag an am céanna.
- Léirmhíniú a thátal ó raon, aonad a thiontú, nó dáta coibhneasta a pharsáil ("Dé Máirt seo chugainn").
- Lasc a úsáid do "tá, níl nó anaithnid": níl tríú staid ag
switchARIA, mar sin is trí chnaipe raidió é.
Tá an taighde, na foinsí agus na cinntí taobh thiar den treoir seo ag spec/healthcare-ui.