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.

Cad a sholáthraíonn Lily, agus cad a sholáthraíonn tú
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 tairg overrideReasons ionas 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 (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • 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 subjectLabel ar context-menu nó 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-dialog a 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-deceased don 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-group lipé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 mar data-interpretation don 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-view ní thátalaíonn sé ceann riamh, mar sin ní thaispeánann toradh le raon agus gan interpretation aon bhratach.
  • Is é toradh lasmuigh den scála teorainn na hionstraime le comparadóir ("> 33.3 mmol/L": formatQuantity le ">") 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íobhtar Quantity.comparator FHIR 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.DateTimeFormat le month: "short").
  • Roghnaigh an clog d’aon ghnó: pas hourCycle go 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-field precision="month" nó "year", stóráil 2019-03 nó 2019, agus scríobh é le formatPartialDate(). Ná cum lá riamh.
  • Is duration-viewé fad ama, <time datetime="P3DT4H"> a choinníonn d'fhocail, ó durationParts() agus Intl.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, le data-due; is leatsa an riail a chruthaigh é.

Foirmeacha

  • Is radio-group de 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". Is fieldset amhá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.NumberFormat agus, nuair nach nglacann type="number" leis an gcamóg, glac í i réimse téacs le inputmode="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-setsize agus aria-posinset ar 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-list agus do timeline-list coverageLabel, agus don chúntóir data-grid a coverageLabel. 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-item nó timeline-list-item entryState agus entryStateLabel. 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-source agus 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áin IPS agus na comhpháirteanna Lily dóibh
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"
Cóid FHIR agus na luachanna Lily dóibh
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:

Cineálacha sonraí agus cóid openEHR, agus na luachanna Lily dóibh
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-summary shampla 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 switch ARIA, mar sin is trí chnaipe raidió é.

Tá an taighde, na foinsí agus na cinntí taobh thiar den treoir seo ag spec/healthcare-ui.