Mu'amalar masu amfani ta kiwon lafiya

Jagora ga ƙungiyoyin da ke gina manhajar asibiti da Lily: kofofin asibiti, sakamako da rahoto, rubuta magani da bayar da magunguna, tallafin yanke shawara da allunan bayanan asibiti.

Fassarorin wannan shafi daftarin na'ura ne da ba a duba ba. Shafin Turanci shi ne sigar da aka dogara da ita.

Abin da Lily ke yi, da abin da ba ya yi

Lily yana ba ku yarjejeniyoyin nuni: alamar semantic, ARIA, halayen madannai da class hooks don abubuwan da allunan asibiti ke maimaitawa. Ba ya ba ku dabarun asibiti, abubuwan cikin asibiti ko da'awar bin ka'ida.

Abin da Lily ke bayarwa, da abin da ku ke bayarwa
Lily yana bayarwa Ku ke bayarwa
observation-view: ƙima, naúrar, tuta da kalmomi, iyaka, da yanayin rashi Ƙimar, hukuncin tuta, iyakar tunani
allergy-record-list da allergy-record-list-item: matsayi wanda ba ya zama fanko Bayanan rashin lafiyar jiki da kalmomin da ake amfani da su
medication-view: suna, ƙarfi, siffa, hanya da yawan sha, ba a yanke komai ba Bayanan magani, sassan tall man, ƙarfin da aka tsara
decision-support-card: siffar katin CDS Hooks Dokokin, ayyukan shawara, rubuta sakamako
early-warning-score-view: maki, mataki da ɗaga rahoto, a nuna Tsarin yin maki da lissafinsa da aka tabbatar
age-view da ageParts(): shekaru a ma'aunin da ya dace Kalmomin ma'aunan (Intl.DurationFormat ko lakabinku)
formatQuantity(): 5 mg, ba 5.0 mg ba; 0.5 mg, ba .5 mg ba Lambar, naúrar da yare
Haɗin tutar mara lafiya Kowane lakabi da ƙima, da waɗanda aka yarda su ga bayanan asibiti

Ka'ida. Manhajar da ke lissafa maki, centile, adadin magani ko mu'amalar magunguna yawanci na'urar likita ce. Lily ba ya lissafa ko ɗaya daga cikinsu, da gangan. Idan samfurinku yana ƙarƙashin ka'ida, ku ne ke da alhakin fayil ɗin injiniyancin amfani (IEC 62366-1, jagorar FDA kan abubuwan ɗan adam, EU MDR). Gwaje-gwajen Lily, rahotonsa na bin ka'idar samun dama da ya tantance kansa da teburin masu karanta allo na iya zama shaida a fayil ɗin; babu ɗayansu da'awar bin ka'ida, kuma teburin ba shi da sakamako tukuna.

Faɗakarwa: katse ne kawai don abin da ke da muhimmanci

Gajiyar faɗakarwa matsalar tsaro ce: idan kowace faɗakarwa tana katsewa, mutane za su yi watsi da dukkansu. Jagorar AHRQ ita ce a rarraba faɗakarwa gwargwadon tsananin su, a bar masu tsanani kawai su katse.

  • Bayani (indicator="info"): a cikin layi, kusa da aikin, katin tallafin yanke shawara a shafin.
  • Gargaɗi (indicator="warning"): a gani ba tare da toshewa ba, katin ɗaya, an tsara shi ya fito fili; babu modal.
  • Mai tsanani (indicator="critical"): a saka katin cikin akwatin faɗakarwa, kuma a bayar da overrideReasons don a nemi dalili idan an watsar da shi.
  • Katin tallafin yanke shawara ba ya zama yankin live da kansa. A sanar da sabon kati mai tsanani ta hanyar kai hankali (focus) cikin akwatin, ba ta aria-live ba.
  • A cire kati idan abin da ya amsa ya sake faruwa, a kuma rubuta kowane sakamako (an karɓa, ko an watsar da dalilinsa).

Kuskuren mara lafiya: a tantance, kada a hana

  • A nuna alamomin tantancewa biyu duk inda bayanan mara lafiya suka bayyana: suna da ranar haihuwa, da lambar shaidar ƙasa tare da sashenta na kallo (The Joint Commission, Quick Safety 45).
  • A yi amfani da tutar mara lafiya a kowane shafi da ke aiki a kan bayanan mara lafiya ɗaya, a kuma bar ta a bayyane.
  • Kafin wani aiki a kan bayanan da ba na mara lafiyar da ke tutar ba, a tabbatar da shi da suna, ranar haihuwa da lambar shaida.
  • Shigarwa game da wani ba majiyyaci ba (tarihin iyaye, tayi, mai bayarwa) ya fara faɗa da kalmomi na wane ne: ba wa abubuwan rikodin subjectLabel ("Uwa"), don kada a taɓa karanta ganewar dangi a matsayin ta majiyyaci (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Kada a iyakance yawan bayanan da likita zai iya buɗewa: gwajin bazuwar kan likitoci 3,356 (JAMA, 2019) ya gano cewa bai rage odar mara lafiyar da ba daidai ba, kuma mutane na ƙetare shi.
  • Menu na ayyuka a kan rikodi ɗaya yana fara ambaton wannan rikodin, da subjectLabel a kan context-menu ko dropdown-menu ("Ada Lovelace, hawan jini 3 Nuw"): sashe na farko marar hulɗa wanda kuma shi ne sunan menu mai isa.
  • Rarraba kowane aiki bisa abin da yake yi, kuma sa matakin ya bayyana kafin ya gudana. Na yau da kullum (duba, buga) yana gudana nan take. Wanda aka rubuta yana faɗin abin da zai rubuta a rikodi ("Yana ƙara bayani ga ziyara"). Na asibiti (dakatar, soke umarni) yana tambaya karo na biyu, a cikin alert-dialog wanda maɓallin tabbatarwarsa shi ne fi'ili ("Dakatar"), ba "To" ko "Eh" ba. Mai bayyanawa (shiga na gaggawa, rabawa a wajen ƙungiyar kulawa) yana fara neman dalili kuma ya rubuta shi.
  • Idan rikodi da yawa a buɗe suke (shafuka, tagogi, rabe-raben fanel), rubutun da ake gani da sunan mai isa na kowane shafi sun ƙunshi sunan majiyyaci da wani mai ganewa na biyu, fanel mai aiki yana maimaita tuta, kuma babu aikin da ya shafi majiyyaci ban da na fanel ɗinsa.
  • Nuna wurin da za a danganta rikodin da shi (sashen asibiti, asibitin waje ko cibiyar da aka zaɓa lokacin shiga) a matsayin rubutu a kan saman shafi, kuma sa canza shi ya zama aiki bayyananne.
  • Nuna ziyara mai aiki, ko "Babu ziyara mai aiki", a cikin tuta. Fom da ke buƙatar ziyara yana faɗin haka kuma yana ba da damar fara ɗaya, maimakon ya kasa lokacin ajiyewa.

Tutar mara lafiya

An rubuta haɗin a cikin medical-banner, tare da shafi mai aiki a /patient-banner cikin manhajar misali ta SvelteKit:

  • alamomin tantancewa biyu, da shekaru kusa da ranar haihuwa;
  • rashin lafiyar jiki ta hanyar jerin rashin lafiyar jiki, don "babu rashin lafiyar jiki da aka sani", "ba a rubuta ba" da "babu" kada su yi kama da juna;
  • ƙimar da ba ta nan kalmomi ne ("Ba a sani ba"), ba alamar tambaya, layi ko ɗakin fanko ba;
  • mara lafiya da ya mutu: data-deceased don jigo, da layin rubutu a bayyane, ba launi kaɗai ba;
  • babu filin da aka yanke, aka datse ko aka ɓoye a kowane faɗi; yana naɗewa.
  • alamomin majiyyaci ("Yana buƙatar mai fassara", "Haɗarin kamuwa da cuta") su ne tag-group mai lakabi na kalmomi, ba gumaka ko launi kaɗai ba, kuma suna kasancewa a bayyane idan tuta ta naɗe.

Sakamako

  • Nuni ɗaya ga sakamako, ko daga wane tsari ya fito: observation view.
  • Tutar kalmomi ne daga fassararku (flagLabel), tare da lambar fassarar FHIR a matsayin data-interpretation don jigo.
  • A raba sabbin sakamako da na baya, a nuna yanayin sauyi (sparkline, ko zanen layi da teburin bayanansa): likitoci suna neman sauyi mai muhimmanci, ba iyaka kaɗai ba.
  • Sakamakon da ba a taɓa rubutawa ba da wanda babu su yanayi ne daban-daban, masu kalmomi daban-daban.
  • Ba a sani ba ba yana nufin daidai ba. Sakamakon da kewayon tunani nasa ya ɓace, har yanzu ana lodawa ko ba za a iya karantawa ba ba shi da fassara kuma yana faɗin haka; observation-view ba ya taɓa hasashen ɗaya, saboda haka sakamako mai kewayon kuma ba tare da interpretation ba ya nuna alama.
  • Sakamakon da ya wuce sikeli iyakar na'urar ne tare da mai kwatanta ("> 33.3 mmol/L": formatQuantity tare da ">") da alamarku ta haɗari, ba lamba kawai ba. Ƙimar kusan tana riƙe ≈ ɗinta ("~").
  • Ba da ƙarin kewayon da ke da suna ("Mai haɗari: ƙasa da 2.5") a matsayin ranges, kowanne a matsayin sashensa.
  • Sakamakon da aka gyara ko aka canza yana riƙe ƙimar da ya maye gurbinta, a cikin <del>, tare da kalmominku game da lokacin da ta canza (previousValue, previousLabel), don likitan da ya karanta tsohuwar ƙima ya san ta canza.
  • Aunawa ta tazara tana faɗin faɗinta da aikinta ("Matsakaici, awa 24"), kuma yanayi da hanyar aunawa ("A zaune, babban kuf") rubutu ne da ake gani a gefensa, ba bayanin kayan aiki kaɗai ba (openEHR INTERVAL_EVENT, state, protocol).
  • Yanayin canji yana buƙatar maki masu kwatantuwa: kada ku zana layi ƙasa da mafi ƙanƙantarku, yanke layin inda hanya ko gwaji ya canza, kuma ku faɗi alkibla da ma'ana da kalmomi ("yana raguwa, yana inganta").
  • Muhimman alamu da aka shigar a tsarin ma'auni ɗaya za su iya nuna ɗayan a gefe a matsayin rubutunku ("70 kg (154 lb)"); Lily ba ta canza komai, don haka faɗi yadda kuke zagayewa. Shigar da adadi da quantity-input-div, wanda lambarsa ke bin iyakokin kowane ma'auni.
  • Jadawalin girma shi ne line-chart tare da layukan kashi-kashi naku a matsayin jerin, maki na yaron da teburin bayanai na shekaru da ƙima; Lily ba ta lissafa kashi-kashi kuma ba ta ba da ma'aunin girma.

Magunguna

  • Sunayen gama-gari da ƙananan haruffa, sai dai haruffan tall man daga jerin FDA da ISMP ko na ƙasarku (Ostiraliya da Kanada suna buga nasu). A yi musu alama a cikin nameSegments; Lily ba ya hasashensu ba.
  • A rubuta ƙarfi da formatQuantity: babu sifili a ƙarshe, sifili a farko, da sarari maras karyewa kafin naúrar.
  • A kiyaye alamar kwatanta ta sakamako: formatQuantity(5, "mmol/L", locale, "<") yana rubuta "<5 mmol/L". Ana rubuta Quantity.comparator na FHIR a matsayin <, ≤, ≥ ko >; barin shi yana mayar da "ƙasa da 5" zuwa "5".
  • A rubuta mL, ba cc ba, a guji kowane taƙaitawa da ke jerin kurakuran ISMP.
  • Kada a yanke sunan magani ko adadinsa.

Kwanuka da lokuta

  • A rubuta wata da kalmomi don kada a iya karanta kwanan wata ta hanyoyi biyu (Intl.DateTimeFormat da month: "short").
  • A zaɓi agogo da gangan: a ba da hourCycle a fili. NHS tana buƙatar agogon awa 24; wannan dokar Birtaniya ce, ba ta duniya ba, don haka Lily ba ya zaɓa muku ba.
  • Shekaru suna bin rukunin Common User Interface ta ageParts(); sabis mai wata al'ada yana ba da nasa kalmomin.
  • Kwanan wata da aka sani har zuwa wata ko shekara kaɗai yana zama haka: tambaye shi da date-field precision="month" ko "year", ajiye 2019-03 ko 2019, kuma rubuta shi da formatPartialDate(). Kada ku taɓa ƙirƙira rana.
  • Tsawon lokaci shi ne duration-view, <time datetime="P3DT4H"> mai ɗauke da kalmominku, daga durationParts() da Intl.DurationFormat.

Allunan bayanai

  • Allon unguwar asibiti ko cibiyar umarni yana sabuntawa akai-akai. Kada a sanar da kowane sauyi: a ajiye yankin taƙaitawa guda mai sauƙi ("gadaje 3 babu kowa, ana sa ran sallama 2") a bar mutane su karanta allon.
  • Kowane yanayi a allo (gado mai tsabta, da mutum, an rufe) rubutu ne ko yanayin data-* mai kalmomi, ba launi kaɗai ba.
  • Babu abin da ke ƙyalƙyali (WCAG 2.2.2, 2.3.1), kuma allon da ke sabuntawa da agogo yana da maɓallin dakatarwa ko yana sabuntawa ne kawai idan an nema; sabuntawa ba sa motsa mayar da hankali. Shigarwar da ta wuce lokaci tana faɗin haka da kalmomi ("Yana jira sama da minti 20") tare da data-overdue.
  • Ƙidaya ko ƙima tana nuna mai rabawa ("12 cikin 68") kuma tana haɗi da jerin da ke bayanta.
  • Jeri ko layin lokaci yana faɗin abin da yake nunawa: abin da yake nunawa, tsari da lokacinsa, abin da aka ɓoye da dalili, da waɗanne tushe ba su amsa ba. Jeri mara komai daga tushen da bai amsa ba ba hujja ba ce cewa babu komai.
  • Jerin tunatarwa shi ne record-list wanda abubuwansa ke ɗauke da ranar ƙarshe (review-date) da yanayin ƙarshen lokaci da kalmomi, tare da data-due; ƙa'idar da ta samar da shi taku ce.

Fom

  • Tambayar da ake amsawa da "eh", "a'a" ko "ba a tambaya ba" ita ce radio-group ta amsoshi uku, babu wanda aka zaɓa a farko, ba akwatin zaɓi ba: akwatin zaɓi ba zai iya bambanta "ya musanta" da "ba a taɓa tambaya ba". Bitar tsarin jiki ita ce fieldset ɗaya ga kowane tsarin jiki, kuma maɓallin "duk sauran babu" yana saita waɗanda ba a amsa ba kaɗai.
  • Tambayar da ke da jerin amsoshi (magunguna, adireshi) ita ce repeatable-fieldset: ana ƙara ko cire abu, mayar da hankali yana bi, kuma kowane maɓallin cirewa yana da sunan abinsa.
  • Lamba mai waƙafin goma: nuna ta da Intl.NumberFormat kuma, inda type="number" ba ya karɓar waƙafi, karɓe ta a filin rubutu da inputmode="decimal" kuma ku fassara ta a cikin lambar ku. Kada ku taɓa canza ƙimar da mutum ya rubuta, ko da don iyakance ta cikin kewayo: ƙima a wajen kewayo kuskure ne da zai iya gani.
  • Dogon jeri da ke nuna wani ɓangare na zaɓuɓɓukansa a lokaci guda yana saita aria-setsize da aria-posinset a kan kowane zaɓi, kuma yana tuna cewa bincike a shafi ba ya ganin sauran.

Rikodi, bayanai da asalinsu

  • Faɗi abin da jeri ko grid ke nunawa, kafin layukansa: lokaci da tsarinsa, abin da ya bari da dalili, da waɗanne tushe ba su amsa ba ("Watanni 12 na ƙarshe, sabo farko. Rikodin likitan iyali bai amsa ba."). Ba wa record-list da timeline-list coverageLabel, kuma ga mai taimako na data-grid nasa coverageLabel. Jeri mara komai daga tushen da bai amsa ba yana faɗin haka da kalmomi, don kada a taɓa karanta shi a matsayin "ba a rubuta komai ba".
  • Faɗi daga ina rikodi ya fito da ko na ƙarshe ne da record-provenance-view: an sa hannu, yana jiran sa hannu, an gyara, an ajiye a wannan na'ura kuma ba a aika ba tukuna. Daftarin da ba a sa hannu ba kada ya taɓa yin kama da an sa hannu.
  • Shigarwa game da wani (iyaye, tayi, mai bayarwa) ta fara faɗin na wane ne, da subjectLabel.
  • Shigarwar da aka hana tana zama a cikin jeri da kalmominku ("An taƙaita: ba a samu gare ku ba"), kuma shigarwar da aka yi bisa kuskure tana zama an ja layi a kanta da "An shigar bisa kuskure": ba wa record-list-item ko timeline-list-item entryState da entryStateLabel. Kada ku taɓa cire ɗayansu a ɓoye, domin ana karanta gibi a matsayin "babu abin da ya faru".
  • A cikin bayanin asibiti, yi wa tushen kowane sashe alama (an rubuta, an karanta, samfuri, an kwafa gaba, an samar) da data-source da kalmomin da ake gani, don kada a taɓa ɗaukar rubutun da aka kwafa ko aka samar a matsayin binciken yau.
  • Sashen da ba zai iya lodawa ba shi ne unavailable da kalmominku, tare da maɓallin sake gwadawa; lambar fasaha, idan an nuna ta kwata-kwata, tana bayan mai bayyanawa. Gazawar da aikin mutum ya haifar ana sanar da ita, tare da ƙimar da rikodin ke riƙe yanzu; gazawa a lokacin loda shafi ba a sanar.
  • Tarihin umarni shi ne timeline-list, abu ɗaya ga kowane mataki (an tsara, an saka lokaci, mai aiki, an dakatar, an kammala, an soke) tare da lokaci da dalilinsa, da yanayin yanzu ma a kan abin.

Daga FHIR zuwa Lily

Lily ba ya karanta albarkatun FHIR; lambar ku tana daidaita su da props na Lily. Waɗannan teburori suna daidaita HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Daidaita lambobi shawara ce: nazarin amincin asibiti naku ne zai yanke shawara, kuma kalmomin kowane yanayi naku ne.

Sassan IPS da abubuwan Lily nasu
Sashen IPS Lily
Alerji da rashin jurewa (48765-2) allergy-record-list da abubuwan cikinsa
Taƙaitaccen magunguna (10160-0) medication-record-list, kowane abu yana ɗauke da medication-view
Jerin matsaloli (11450-4) problem-record-list da abubuwan cikinsa
Allurar rigakafi (11369-6) immunization-record-list da abubuwan cikinsa
Sakamako (30954-2) observation-view, a cikin teburin bayanai ko jerin taƙaitawa
Tarihin hanyoyin jinya (47519-4) procedure-record-list da abubuwan cikinsa
Na'urorin lafiya (46264-8) device-record-list da abubuwan cikinsa
Gargaɗi (104605-1) Rubutun gargaɗi ko faɗakarwa, ba a bayan abin sarrafawa da aka naɗe ba
Duk wani sashe record-list da abubuwan cikinsa
Sashen da ake buƙata wanda takardar ta bari Jerin sashen tare da status="omitted"
Lambobin FHIR da ƙimar Lily nasu
FHIR Lily
emptyReason nilknown status="none-known" na jerin
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", tare da kalmomin da ke faɗar wanne
Lambobin IPS no-known-allergies, no-known-medications da makamantansu status="none-known"
Lambobin IPS no-allergy-info, no-medication-info da makamantansu status="not-recorded"
AllergyIntolerance.criticality criticality, ban da severity na amsa
clinicalStatus, verificationStatus Props iri ɗaya a kan abubuwan alerji da matsala, da lambobi iri ɗaya
MedicationStatement.status status na abin magani
Dosage.text medication-view dosageText
Observation.status observation-view status, da lambobi iri ɗaya
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (har ma a kan jerin rikodi)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

A daidaita rikodin entered-in-error da yanayinsa na entered-in-error, tare da kalmomi, maimakon a jefar da shi a hankali: ko a nuna shi ko a'a shawarar sabis ɗinku ce.

Daga openEHR zuwa Lily

Lily ba ta karanta tsararrun openEHR ma. Taswirar nau'ikan bayanai da lambobin Tsarin Tunani na openEHR, a matsayin shawara da bitar amincin asibiti naku za ta yanke:

Nau'ikan bayanai da lambobin openEHR, da ƙimomin Lily a gare su
openEHR Lily
DV_QUANTITY (shigarwa) quantity-input-div; ma'auni a matsayin lambobin UCUM tare da kalmominku
DV_QUANTITY (nuni), magnitude_status observation-view tare da formatQuantity(value, unit, locale, comparator) (~ shi ne ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges tare da meaning observation-view ranges
DV_DATE rabi (shekara, shekara da wata) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view tare da durationParts()
DV_PROPORTION formatProportion() a cikin observation-view
DV_ORDINAL, DV_SCALE radio-group wanda lakabinsa ke ɗauke da lamba da kalmominta
DV_CODED_TEXT tsarin ƙimomi masu lamba a ƙasa
DV_BOOLEAN checkbox-input, sai lokacin da "ba a tambaya ba" ba zai iya faruwa ba
ELEMENT.null_flavour 253 ba a sani ba, 271 babu bayani status="not-recorded" ko "unavailable", tare da kalmomin da ke faɗar wanne
null_flavour 272 an ɓoye observation-view status="masked"
null_flavour 273 bai dace ba status="not-applicable"
PARTY_RELATED wanda abin ya shafa subjectLabel a kan abubuwan rikodi
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Matakan Instruction State Machine timeline-list na matakai, tare da yanayin yanzu a kan abin
abin samfuri tare da yawan faruwa 0..* repeatable-fieldset

Ƙimar da aka sa wa lamba

  • A nuna Coding.display; idan babu, CodeableConcept.text; idan babu ko ɗaya, system|code. Kada a taɓa barin akwati fanko.
  • A bayar da abin sarrafawa da ke bayyana tsarin lamba da lambar kusa da kowace ƙima, kamar maɓallin sauyawa da ke cewa "Nuna lambobi". Lambobin da aka ɓoye ba sa cikin tsarin karatu har sai an nuna su.
  • A yi wa rubutun asibiti alama da harshen takardar (lang), wanda zai iya bambanta da na mahaɗa. A fassara mahaɗa; kada a taɓa fassara abubuwan asibiti.
  • Lily ba ya kawo ƙamus na likitanci: babu binciken SNOMED CT, LOINC, ATC ko UCUM. A rubuta abin da takardar ta faɗa. Misalin SvelteKit yana nuna tsarin a shafin /patient-summary.

Abin da Lily ba zai yi ba

  • Lissafa maki na gargaɗin farko, centile na girma, adadin magani ko iyakar tunani.
  • Bayar da rumbun bayanan magani, jerin tall man, ko lambobin SNOMED CT, ICD, LOINC ko UCUM.
  • Kwafar kayan aiki mai lasisi (Wong-Baker FACES) ko zanen wata hukuma (taswirar NEWS2).
  • Iyakance yawan bayanan da za a buɗe a lokaci ɗaya.
  • Hasashen fassara daga kewayo, canza ma'auni, ko fassara kwanan wata na dangantaka ("Talata mai zuwa").
  • Amfani da maɓallin sauyawa don "eh, a'a ko ba a sani ba": switch na ARIA ba shi da yanayi na uku, don haka maɓallan rediyo uku ne.

Bincike, tushe da shawarwarin da ke bayan wannan jagorar suna cikin spec/healthcare-ui.