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 | 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 toaoverrideReasonsili 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelkwenyecontext-menuaudropdown-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-dialogambacho 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-deceasedkwa 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-groupyenye 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 kamadata-interpretationkwa 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-viewhaikisii tafsiri kamwe, kwa hiyo matokeo yenye kiwango na bilainterpretationhayaonyeshi alama. -
Matokeo nje ya kipimo ni kikomo cha kifaa pamoja na alama ya kulinganisha ("> 33.3 mmol/L":
formatQuantitypamoja 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-chartyenye 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.comparatorya 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.DateTimeFormatpamoja namonth: "short"). - Chagua saa kwa makusudi: toa
hourCyclewaziwazi. 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-fieldprecision="month"au"year", hifadhi2019-03au2019, na iandike kwaformatPartialDate(). Kamwe usibuni siku. -
Muda ni
duration-view,<time datetime="P3DT4H">yenye maneno yako, kutokadurationParts()naIntl.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-listambayo vipengee vyake vina tarehe ya mwisho (review-date) na hali ya muda kwa maneno, pamoja nadata-due; kanuni iliyoitengeneza ni yako.
Fomu
-
Swali linalojibiwa "ndiyo", "hapana" au "halikuulizwa" ni
radio-groupla majibu matatu, hakuna lililochaguliwa mwanzoni, kamwe si kisanduku cha kuteua: kisanduku hakiwezi kutofautisha "amekana" na "hakuulizwa kamwe". Mapitio ya mifumo nifieldsetmoja 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.NumberFormatna, pale ambapotype="number"haikubali koma, ipokee katika sehemu ya maandishi yenyeinputmode="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-setsizenaaria-posinsetkwenye 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-listnatimeline-listcoverageLabel, na msaidizi wadata-gridyakecoverageLabel. 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-itemautimeline-list-itementryStatenaentryStateLabel. 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-sourcena maneno yanayoonekana, ili maandishi yaliyonakiliwa au kutengenezwa yasichukuliwe kamwe kuwa uchunguzi wa leo. -
Sehemu isiyoweza kupakia ni
unavailablekwa 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 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" |
| 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:
| 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":
switchya ARIA haina hali ya tatu, kwa hiyo ni redio tatu.
Utafiti, vyanzo na maamuzi nyuma ya mwongozo huu yako katika spec/healthcare-ui.