Violesura vya watumiaji vya huduma za afya

Mwongozo kwa timu zinazounda programu za kliniki kwa kutumia Lily: tovuti za kliniki, matokeo na ripoti, kuandika dawa na kutoa dawa, usaidizi wa maamuzi na dashibodi za hospitali.

Tafsiri za ukurasa huu ni rasimu za mashine ambazo hazijakaguliwa. Ukurasa wa Kiingereza ndio toleo rasmi.

Lily hufanya nini, na haifanyi nini

Lily inakupa mikataba ya uonyeshaji: alama za kisemantiki, ARIA, tabia ya kibodi na class hooks kwa mambo yanayojirudia kwenye skrini za kliniki. Haikupi mantiki ya kliniki, maudhui ya kliniki wala dai la udhibiti.

Lily hutoa nini, na wewe unatoa nini
Lily hutoa Wewe unatoa
observation-view: thamani, kipimo, alama kwa maneno, kiwango, na hali za kutokuwepo Thamani, uamuzi wa alama, kiwango rejea
allergy-record-list na allergy-record-list-item: hali ambayo kamwe haiachwi wazi Rekodi ya mzio na istilahi zake
medication-view: jina, nguvu, umbo, njia na marudio, hakuna kinachokatwa Data ya dawa, sehemu za tall man, nguvu iliyoumbizwa
decision-support-card: umbo la kadi ya CDS Hooks Kanuni, vitendo vya mapendekezo, kurekodi matokeo
early-warning-score-view: alama, daraja na kupandisha ngazi, vinaonyeshwa Mfumo wa alama na hesabu yake iliyothibitishwa
age-view na ageParts(): umri katika vipimo vinavyofaa Maneno ya vipimo (Intl.DurationFormat au lebo zako mwenyewe)
formatQuantity(): 5 mg, kamwe si 5.0 mg; 0.5 mg, kamwe si .5 mg Nambari, kipimo na lugha ya eneo (locale)
Muundo wa bango la mgonjwa Kila lebo na thamani, na nani anaweza kuona taarifa za kliniki

Udhibiti. Programu inayokokotoa alama, sentail, dozi au mwingiliano wa dawa kwa kawaida ni kifaa cha matibabu. Lily haikokotoi chochote kati ya hivi, kwa makusudi. Ikiwa bidhaa yako inadhibitiwa, wewe ndiye mmiliki wa faili lake la uhandisi wa utumiaji (IEC 62366-1, mwongozo wa FDA wa vipengele vya binadamu, EU MDR). Majaribio ya Lily, ripoti yake ya kujitathmini ya ulinganifu wa ufikivu na jedwali lake la visoma skrini yanaweza kuwa ushahidi katika faili hilo; hakuna kati ya hivyo ni dai la ulinganifu, na jedwali bado halina matokeo.

Tahadhari: katiza kwa yale muhimu sana tu

Uchovu wa tahadhari ni tatizo la usalama: kila tahadhari ikikatiza, watu huzikataa zote. Mwongozo wa AHRQ ni kupanga tahadhari kwa ngazi kulingana na ukali na kufanya zile kali tu ndizo zikatize.

  • Taarifa (indicator="info"): ndani ya mstari, kando ya kazi, kadi ya usaidizi wa maamuzi ndani ya ukurasa.
  • Onyo (indicator="warning"): inaonekana bila kuzuia, kadi ile ile, iliyopambwa ili ionekane; hakuna modali.
  • Hatari (indicator="critical"): weka kadi ndani ya kisanduku cha tahadhari, na toa overrideReasons ili kuikataa kuulize sababu.
  • Kadi ya usaidizi wa maamuzi kamwe si eneo la moja kwa moja yenyewe. Tangaza kadi mpya ya hatari kwa kuhamisha mwelekeo (focus) ndani ya kisanduku, si kwa aria-live.
  • Ondoa kadi tukio ililolijibu likitokea tena, na rekodi kila matokeo (imekubaliwa, au imepuuzwa pamoja na sababu yake).

Makosa ya mgonjwa asiye sahihi: tambua, usizuie

  • Onyesha vitambulisho viwili popote data ya mgonjwa inapoonekana: jina na tarehe ya kuzaliwa, na kitambulisho cha taifa pamoja na kijenzi chake cha kuonyesha (The Joint Commission, Quick Safety 45).
  • Tumia bango la mgonjwa kwenye kila skrini inayofanya kazi kwenye rekodi ya mgonjwa mmoja, na liache lionekane.
  • Kabla ya hatua kwenye rekodi tofauti na ile iliyo kwenye bango, ithibitishe kwa jina, tarehe ya kuzaliwa na kitambulisho.
  • Kiingilio kuhusu mtu mwingine asiye mgonjwa (historia ya mzazi, kijusi, mtoaji) kinasema kwanza kwa maneno ni cha nani: vipe vipengee vya rekodi subjectLabel ("Mama"), ili utambuzi wa ndugu usisomwe kamwe kama wa mgonjwa (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Usipunguze idadi ya rekodi ambazo mhudumu wa kliniki anaweza kufungua: jaribio la nasibu la wahudumu 3,356 (JAMA, 2019) lilipata kuwa halikupunguza maagizo ya mgonjwa asiye sahihi, na watu hulikwepa.
  • Menyu ya vitendo kwenye rekodi moja inataja rekodi hiyo kwanza, kwa subjectLabel kwenye context-menu au dropdown-menu ("Ada Lovelace, shinikizo la damu 3 Nov"): sehemu ya kwanza isiyo ya kuingiliana ambayo pia ni jina linalofikika la menyu.
  • Panga kila kitendo kwa ngazi kulingana na kile kinachofanya, na ifanye ngazi ionekane kabla hakijaendeshwa. Cha kawaida (tazama, chapisha) kinaendeshwa mara moja. Kilichorekodiwa kinasema kitakachoandika kwenye rekodi ("Kinaongeza dokezo kwenye ziara"). Cha kitabibu (sitisha, ghairi agizo) kinauliza mara ya pili, ndani ya alert-dialog ambacho kitufe chake cha kuthibitisha ni kitenzi ("Sitisha"), kamwe si "Sawa" au "Ndiyo". Cha kufichua (ufikiaji wa dharura, kushiriki nje ya timu ya huduma) kinaomba sababu kwanza na kuirekodi.
  • Rekodi kadhaa zikiwa wazi (vichupo, madirisha, paneli zilizogawanywa), maandishi yanayoonekana na jina linalofikika la kila kichupo yanajumuisha jina la mgonjwa na kitambulisho cha pili, paneli hai inarudia bango, na hakuna kitendo kinachomhusu mgonjwa mwingine isipokuwa wa paneli yake.
  • Onyesha mahali ambapo rekodi zitahusishwa (wodi, kliniki au kituo kilichochaguliwa wakati wa kuingia) kama maandishi kwenye kichwa cha ukurasa, na kufanya kubadilisha kuwa kitendo cha wazi.
  • Onyesha ziara hai, au "Hakuna ziara hai", kwenye bango. Fomu inayohitaji ziara inasema hivyo na kujitolea kuanzisha moja, badala ya kushindwa inapohifadhiwa.

Bango la mgonjwa

Muundo huu umeandikwa pamoja na medical-banner, na ukurasa unaofanya kazi kwenye /patient-banner katika programu ya mfano ya SvelteKit:

  • vitambulisho viwili, na umri kando ya tarehe ya kuzaliwa;
  • mizio kupitia orodha ya mizio, ili "hakuna mzio unaojulikana", "haijarekodiwa" na "haipatikani" visionekane kamwe kuwa sawa;
  • thamani isiyopo ni maneno ("Haijulikani"), si alama ya kuuliza, kistari au seli tupu;
  • mgonjwa aliyefariki: data-deceased kwa mandhari, na mstari wa maandishi unaoonekana, si rangi peke yake;
  • hakuna sehemu iliyokatwa, kupunguzwa au kufichwa kwa upana wowote; inajifunga mstarini.
  • alama za mgonjwa ("Anahitaji mkalimani", "Hatari ya maambukizi") ni tag-group yenye lebo ya maneno, kamwe si aikoni au rangi pekee, na zinabaki kuonekana bango linapojikunja.

Matokeo

  • Onyesho moja kwa matokeo, yawe yametoka mfumo gani: observation view.
  • Alama ni maneno kutoka tafsiri yako (flagLabel), na msimbo wa ufasiri wa FHIR kama data-interpretation kwa mandhari.
  • Tenganisha matokeo mapya na ya awali, na onyesha mwelekeo (sparkline, au mchoro wa mstari pamoja na jedwali lake la data): wahudumu hutafuta mabadiliko makubwa, si kiwango tu.
  • Matokeo ambayo hayajawahi kurekodiwa na yale ambayo hayapatikani ni hali tofauti, zenye maneno tofauti.
  • Isiyojulikana si ya kawaida. Matokeo ambayo kiwango chake cha marejeleo hakipo, bado kinapakiwa au hakisomeki hayana tafsiri na yanasema hivyo; observation-view haikisii tafsiri kamwe, kwa hiyo matokeo yenye kiwango na bila interpretation hayaonyeshi alama.
  • Matokeo nje ya kipimo ni kikomo cha kifaa pamoja na alama ya kulinganisha ("> 33.3 mmol/L": formatQuantity pamoja na ">") na alama yako ya hatari, kamwe si namba tupu. Thamani ya kukadiria inabaki na ≈ yake ("~").
  • Toa viwango vingine vyenye majina ("Hatari: chini ya 2.5") kama ranges, kila kimoja sehemu yake.
  • Matokeo yaliyosahihishwa au kubadilishwa yanabaki na thamani yaliyoibadilisha, ndani ya <del>, pamoja na maneno yako kuhusu lini ilibadilika (previousValue, previousLabel), ili mtabibu aliyesoma thamani ya zamani ajue kwamba ilibadilika.
  • Kipimo cha muda kinasema upana na kazi yake ("Wastani, saa 24"), na hali na mbinu ya kipimo ("Ameketi, kofu kubwa") ni maandishi yanayoonekana kando yake, kamwe si kidokezo pekee (openEHR INTERVAL_EVENT, state, protocol).
  • Mwenendo unahitaji alama zinazolinganishwa: usichore mstari chini ya kiwango chako cha chini, kata mstari pale mbinu au kipimo kilipobadilika, na sema mwelekeo na maana kwa maneno ("inashuka, inaimarika").
  • Viashiria muhimu vilivyoingizwa katika mfumo mmoja wa vipimo vinaweza kuonyesha mwingine kando kama maandishi yako ("70 kg (154 lb)"); Lily haibadilishi chochote, kwa hiyo taja jinsi unavyokadiria. Ingiza kiasi kwa quantity-input-div, ambacho namba yake inafuata mipaka ya kila kipimo.
  • Chati ya ukuaji ni line-chart yenye mistari yako ya sentaili kama mfululizo, alama za mtoto na jedwali lake la data la umri na thamani; Lily haikokotoi sentaili na haitoi marejeleo ya ukuaji.

Dawa

  • Majina ya jumla kwa herufi ndogo, isipokuwa herufi za tall man kutoka orodha za FDA na ISMP au za nchi yako (Australia na Kanada huchapisha zao). Ziweke alama katika nameSegments; Lily haikisii kamwe.
  • Andika nguvu kwa formatQuantity: hakuna sifuri ya mwisho, sifuri ya mwanzo, na nafasi isiyovunjika kabla ya kipimo.
  • Weka kilinganishi cha matokeo: formatQuantity(5, "mmol/L", locale, "<") huandika "<5 mmol/L". Quantity.comparator ya FHIR huandikwa <, ≤, ≥ au >; kukiacha hubadilisha "chini ya 5" kuwa "5".
  • Andika mL, kamwe si cc, na epuka kila kifupi kilicho kwenye orodha ya ISMP ya makosa yanayoweza kutokea.
  • Kamwe usikate jina au dozi ya dawa.

Tarehe na saa

  • Andika mwezi kwa maandishi ili tarehe isisomeke kwa njia mbili (Intl.DateTimeFormat pamoja na month: "short").
  • Chagua saa kwa makusudi: toa hourCycle waziwazi. NHS inaomba saa 24; hiyo ni kanuni ya Uingereza, si ya dunia nzima, kwa hiyo Lily haichagui kwa niaba yako kamwe.
  • Umri hufuata madaraja ya Common User Interface kupitia ageParts(); huduma yenye utaratibu mwingine hutoa maneno yake yenyewe.
  • Tarehe inayojulikana hadi mwezi au mwaka pekee inabaki hivyo: iulize kwa date-field precision="month" au "year", hifadhi 2019-03 au 2019, na iandike kwa formatPartialDate(). Kamwe usibuni siku.
  • Muda ni duration-view, <time datetime="P3DT4H"> yenye maneno yako, kutoka durationParts() na Intl.DurationFormat.

Dashibodi

  • Ubao wa wodi au skrini ya kituo cha uongozaji husasishwa mara kwa mara. Usitangaze kila badiliko: weka eneo moja la muhtasari la upole ("vitanda 3 vitupu, wagonjwa 2 wanatarajiwa kuruhusiwa") na uwaache watu wasome ubao.
  • Kila hali kwenye ubao (kitanda safi, kimekaliwa, kimezuiwa) ni maandishi au hali ya data-* yenye maneno, si rangi peke yake.
  • Hakuna kinachometameta (WCAG 2.2.2, 2.3.1), na ubao unaosasishwa kwa kipima muda una kidhibiti cha kusitisha au husasishwa tu unapoombwa; masasisho hayahamishi umakini kamwe. Kiingilio kilichochelewa kinasema hivyo kwa maneno ("Anasubiri zaidi ya dakika 20") pamoja na data-overdue.
  • Idadi au kiwango kinaonyesha kigawanyo chake ("12 kati ya 68") na kuunganisha na orodha iliyo nyuma yake.
  • Orodha au rekodi ya matukio inasema ni mwonekano wa nini: inaonyesha nini, mpangilio na kipindi chake, nini kimefichwa na kwa nini, na vyanzo gani havikujibu. Orodha tupu kutoka chanzo kisichojibu si uthibitisho kwamba hakuna kitu.
  • Orodha ya vikumbusho ni record-list ambayo vipengee vyake vina tarehe ya mwisho (review-date) na hali ya muda kwa maneno, pamoja na data-due; kanuni iliyoitengeneza ni yako.

Fomu

  • Swali linalojibiwa "ndiyo", "hapana" au "halikuulizwa" ni radio-group la majibu matatu, hakuna lililochaguliwa mwanzoni, kamwe si kisanduku cha kuteua: kisanduku hakiwezi kutofautisha "amekana" na "hakuulizwa kamwe". Mapitio ya mifumo ni fieldset moja kwa kila mfumo wa mwili, na kitufe cha "vingine vyote havipo" kinaweka yale tu yasiyojibiwa.
  • Swali lenye orodha ya majibu (dawa, anwani) ni repeatable-fieldset: kipengee kinaongezwa au kuondolewa, umakini unafuata, na kila kitufe cha kuondoa kimepewa jina la kipengee chake.
  • Namba yenye koma ya desimali: ionyeshe kwa Intl.NumberFormat na, pale ambapo type="number" haikubali koma, ipokee katika sehemu ya maandishi yenye inputmode="decimal" na uichanganue katika msimbo wako. Kamwe usibadilishe thamani aliyoandika mtu, hata kuiweka ndani ya kiwango: thamani nje ya kiwango ni kosa ambalo anaweza kuliona.
  • Orodha ndefu inayoonyesha sehemu tu ya chaguo zake kwa wakati mmoja inaweka aria-setsize na aria-posinset kwenye kila chaguo, na kukumbuka kwamba utafutaji kwenye ukurasa hauoni zilizobaki.

Rekodi, madokezo na asili yake

  • Sema orodha au gridi ni mwonekano wa nini, kabla ya safu zake: kipindi na mpangilio wake, inachoacha nje na kwa nini, na vyanzo gani havikujibu ("Miezi 12 iliyopita, mpya kwanza. Rekodi ya daktari wa familia haikujibu."). Vipe record-list na timeline-list coverageLabel, na msaidizi wa data-grid yake coverageLabel. Orodha tupu kutoka chanzo kisichojibu inasema hivyo kwa maneno, ili isisomwe kamwe kama "hakuna kilichorekodiwa".
  • Sema rekodi imetoka wapi na kama ni ya mwisho kwa record-provenance-view: imesainiwa, inasubiri sahihi, imerekebishwa, imehifadhiwa kwenye kifaa hiki na bado haijatumwa. Rasimu isiyosainiwa haipaswi kamwe kuonekana imesainiwa.
  • Kiingilio kuhusu mtu mwingine (mzazi, kijusi, mtoaji) kinasema kwanza ni cha nani, kwa subjectLabel.
  • Kiingilio kilichozuiliwa kinabaki kwenye orodha pamoja na maneno yako ("Kimezuiliwa: hakipatikani kwako"), na kiingilio kilichofanywa kwa makosa kinabaki kimekatwa mstari pamoja na "Kiliingizwa kwa makosa": vipe record-list-item au timeline-list-item entryState na entryStateLabel. Kamwe usiondoe chochote kati yao kimyakimya, kwa sababu pengo husomwa kama "hakuna kilichotokea".
  • Katika dokezo la kitabibu, weka alama chanzo cha kila kifungu (kimeandikwa, kimeimbishwa, kiolezo, kimenakiliwa mbele, kimetengenezwa) kwa data-source na maneno yanayoonekana, ili maandishi yaliyonakiliwa au kutengenezwa yasichukuliwe kamwe kuwa uchunguzi wa leo.
  • Sehemu isiyoweza kupakia ni unavailable kwa maneno yako, pamoja na kitufe cha kujaribu tena; msimbo wa kiufundi, ukionyeshwa kabisa, uko nyuma ya kifichuzi. Hitilafu iliyosababishwa na kitendo cha mtu inatangazwa, pamoja na thamani ambayo rekodi inashikilia sasa; hitilafu wakati wa kupakia ukurasa haitangazwi.
  • Historia ya agizo ni timeline-list, kipengee kimoja kwa kila hatua (imepangwa, imeratibiwa, hai, imesitishwa, imekamilika, imeghairiwa) pamoja na muda na sababu yake, na hali ya sasa pia kwenye kipengee.

Kutoka FHIR hadi Lily

Lily haisomi rasilimali za FHIR; msimbo wako huzioanisha na props za Lily. Majedwali haya yanaoanisha HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Uoanishaji wa misimbo ni pendekezo: mapitio yako ya usalama wa kliniki ndiyo huamua, na maneno ya kila hali ni yako mwenyewe.

Sehemu za IPS na vijenzi vya Lily kwa ajili yake
Sehemu ya IPS Lily
Mzio na kutovumilia (48765-2) allergy-record-list na vipengee vyake
Muhtasari wa dawa (10160-0) medication-record-list, kila kipengee kikiwa na medication-view
Orodha ya matatizo (11450-4) problem-record-list na vipengee vyake
Chanjo (11369-6) immunization-record-list na vipengee vyake
Matokeo (30954-2) observation-view, katika jedwali la data au orodha ya muhtasari
Historia ya taratibu (47519-4) procedure-record-list na vipengee vyake
Vifaa vya matibabu (46264-8) device-record-list na vipengee vyake
Tahadhari (104605-1) Maandishi ya onyo au tahadhari, kamwe si nyuma ya kidhibiti kilichokunjwa
Sehemu nyingine yoyote record-list na vipengee vyake
Sehemu inayohitajika ambayo hati imeiacha Orodha ya sehemu hiyo yenye status="omitted"
Misimbo ya FHIR na thamani za Lily kwa ajili yake
FHIR Lily
emptyReason nilknown status="none-known" ya orodha
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", pamoja na maneno yanayosema ni ipi
Misimbo ya IPS no-known-allergies, no-known-medications na kama hiyo status="none-known"
Misimbo ya IPS no-allergy-info, no-medication-info na kama hiyo status="not-recorded"
AllergyIntolerance.criticality criticality, mbali na severity ya mwitikio
clinicalStatus, verificationStatus Props zilezile kwenye vipengee vya mzio na tatizo, pamoja na misimbo ileile
MedicationStatement.status status ya kipengee cha dawa
Dosage.text medication-view dosageText
Observation.status observation-view status, pamoja na misimbo ileile
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (pia kwenye orodha za rekodi)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Oanisha rekodi ya entered-in-error na hali yake ya entered-in-error, pamoja na maneno, badala ya kuiacha kimya kimya: kuionyesha au la ni uamuzi wa huduma yako.

Kutoka openEHR hadi Lily

Lily haisomi pia tungo za openEHR. Ulinganisho wa aina za data na misimbo ya Kielelezo cha Marejeleo cha openEHR, kama pendekezo ambalo ukaguzi wako wa usalama wa kitabibu unaamua:

Aina za data na misimbo ya openEHR, na thamani za Lily kwa ajili yake
openEHR Lily
DV_QUANTITY (kuingiza) quantity-input-div; vipimo kama misimbo ya UCUM pamoja na maneno yako
DV_QUANTITY (kuonyesha), magnitude_status observation-view pamoja na formatQuantity(value, unit, locale, comparator) (~ ni ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges pamoja na meaning observation-view ranges
DV_DATE sehemu (mwaka, mwaka na mwezi) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view pamoja na durationParts()
DV_PROPORTION formatProportion() ndani ya observation-view
DV_ORDINAL, DV_SCALE radio-group ambalo lebo zake zina namba na maneno yake
DV_CODED_TEXT mfumo wa thamani zenye msimbo hapa chini
DV_BOOLEAN checkbox-input, tu pale ambapo "halikuulizwa" haliwezi kutokea
ELEMENT.null_flavour 253 haijulikani, 271 hakuna taarifa status="not-recorded" au "unavailable", pamoja na maneno yanayosema ni ipi
null_flavour 272 imefichwa observation-view status="masked"
null_flavour 273 haihusiki status="not-applicable"
PARTY_RELATED mhusika subjectLabel kwenye vipengee vya rekodi
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Hatua za Instruction State Machine timeline-list ya hatua, pamoja na hali ya sasa kwenye kipengee
kipengee cha aina kuu chenye matukio 0..* repeatable-fieldset

Thamani zenye misimbo

  • Onyesha Coding.display; ikiwa hakuna, CodeableConcept.text; ikiwa hakuna zote mbili, system|code. Kamwe usiache seli tupu.
  • Toa kidhibiti kinachofichua mfumo wa msimbo na msimbo kando ya kila thamani, kama kitufe cha kubadilisha kinachosema "Onyesha misimbo". Misimbo iliyofichwa hukaa nje ya mpangilio wa usomaji hadi ioneshwe.
  • Weka alama kwenye maandishi ya kliniki kwa lugha ya hati (lang), ambayo inaweza kutofautiana na ya kiolesura. Tafsiri kiolesura; kamwe usitafsiri maudhui ya kliniki.
  • Lily haisafirishi istilahi: hakuna utafutaji wa SNOMED CT, LOINC, ATC au UCUM. Andika kile hati inachosema. Mfano wa SvelteKit unaonyesha mtindo huo kwenye ukurasa wa /patient-summary.

Lily haitafanya nini

  • Kukokotoa alama ya tahadhari ya mapema, sentail ya ukuaji, dozi au kiwango rejea.
  • Kusafirisha hifadhidata ya dawa, orodha ya tall man, au misimbo ya SNOMED CT, ICD, LOINC au UCUM.
  • Kunakili chombo chenye leseni (Wong-Baker FACES) au muundo wa shirika lingine (chati ya NEWS2).
  • Kupunguza idadi ya rekodi zilizofunguliwa kwa wakati mmoja.
  • Kukisia tafsiri kutoka kwa kiwango, kubadilisha kipimo, au kuchanganua tarehe linganishi ("Jumanne ijayo").
  • Kutumia swichi kwa "ndiyo, hapana au haijulikani": switch ya ARIA haina hali ya tatu, kwa hiyo ni redio tatu.

Utafiti, vyanzo na maamuzi nyuma ya mwongozo huu yako katika spec/healthcare-ui.