의료 사용자 인터페이스
Lily로 임상 소프트웨어를 만드는 팀을 위한 안내서: 임상 포털, 검사 결과와 보고, 처방과 투약 관리, 의사결정 지원, 병원 대시보드.
이 페이지의 번역은 검토되지 않은 기계 번역 초안입니다. 영어 페이지가 공식 버전입니다.
Lily가 하는 일과 하지 않는 일
Lily는 표시 계약을 제공합니다. 임상 화면에서 반복되는 요소를 위한 시맨틱 마크업, ARIA, 키보드 동작, 클래스 훅입니다. 임상 로직, 임상 콘텐츠, 규제상의 주장은 제공하지 않습니다.
| Lily가 제공하는 것 | 사용자가 제공하는 것 |
|---|---|
| observation-view: 값, 단위, 말로 된 플래그, 범위, 누락 상태 | 값, 플래그 판정, 참고 범위 |
| allergy-record-list와 allergy-record-list-item: 비어 있지 않은 상태 표시 | 알레르기 기록과 그 용어 체계 |
| medication-view: 이름, 함량, 제형, 투여 경로, 빈도. 어느 것도 줄여서 자르지 않음 | 약물 데이터, tall man 구간, 서식이 적용된 함량 |
| decision-support-card: CDS Hooks 카드 형태 | 규칙, 제안 동작, 결과 기록 |
| early-warning-score-view: 점수, 단계, 에스컬레이션의 표시 | 점수 체계와 검증된 계산 |
age-view와 ageParts(): 나이에 알맞은 단위로 표시한 나이 |
단위를 나타내는 말(Intl.DurationFormat 또는 직접 만든 레이블) |
formatQuantity(): 5.0 mg가 아니라 5 mg, .5 mg가 아니라 0.5 mg |
숫자, 단위, 로캘 |
| 환자 배너 구성 | 모든 레이블과 값, 그리고 임상 정보를 볼 수 있는 사람 |
규제. 점수, 성장 백분위수, 용량, 약물 상호작용을 계산하는 소프트웨어는 대개 의료기기입니다. Lily는 의도적으로 이 중 어느 것도 계산하지 않습니다. 제품이 규제 대상이라면 사용적합성 엔지니어링 파일(IEC 62366-1, FDA의 인적 요인 지침, EU MDR)은 사용자의 책임입니다. Lily의 테스트, 자체 평가한 접근성 적합성 보고서, 스크린 리더 매트릭스는 그 파일의 근거가 될 수 있지만, 어느 것도 적합성 주장은 아니며, 매트릭스에는 아직 결과가 없습니다.
경고: 중대한 것에만 화면을 가로막기
경고 피로는 안전 문제입니다. 모든 경고가 화면을 가로막으면 사람들은 모두 닫아 버립니다. AHRQ의 지침은 경고를 심각도에 따라 단계로 나누고, 심각한 것만 가로막도록 하는 것입니다.
- 정보(
indicator="info"): 작업 옆에 인라인으로 표시하는, 페이지 안의 의사결정 지원 카드. - 경고(
indicator="warning"): 작업을 막지 않고 보이게 표시하는 같은 카드로, 눈에 띄도록 꾸밈. 모달은 쓰지 않음. - 위험(
indicator="critical"): 카드를 경고 대화상자 안에 넣고,overrideReasons를 제공하여 닫을 때 사유를 묻게 함. - 의사결정 지원 카드 자체는 라이브 리전이 아닙니다. 새로운 위험 카드는
aria-live가 아니라 대화상자 안으로 포커스를 옮겨서 알립니다. - 카드가 대응했던 사건이 다시 발생하면 카드를 제거하고, 각 결과(수락, 또는 사유와 함께 무시)를 기록합니다.
환자 오인 오류: 확인하게 하되 제한하지 않기
- 환자의 데이터가 나타나는 모든 곳에 두 가지 식별자를 표시합니다. 이름과 생년월일, 그리고 국가 식별번호를 해당 view 컴포넌트로 표시합니다(The Joint Commission, Quick Safety 45).
- 한 환자의 기록에 대해 작업하는 모든 화면에서 환자 배너를 사용하고, 항상 보이게 유지합니다.
- 배너에 표시된 기록이 아닌 다른 기록에 작업을 하기 전에, 이름, 생년월일, 식별자로 확인을 받습니다.
-
환자가 아닌 다른 사람에 관한 항목(부모의 병력, 태아, 기증자)은 누구의 것인지 먼저 말로 밝힙니다. 기록 항목에
subjectLabel("어머니")을 지정해 친척의 진단이 환자의 진단으로 읽히는 일이 없게 합니다(openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 임상의가 열 수 있는 기록의 수를 제한하지 마십시오. 임상의 3,356명을 대상으로 한 무작위 시험(JAMA, 2019)에서 제한해도 환자를 잘못 지정한 오더가 줄지 않았으며, 사람들은 제한을 우회합니다.
-
한 기록에 대한 작업 메뉴는 먼저 그 기록의 이름을 밝힙니다.
subjectLabel을(를)context-menu또는dropdown-menu에 사용하세요("Ada Lovelace, 혈압 11월 3일"): 상호작용하지 않는 첫 부분이며 메뉴의 접근 가능한 이름이기도 합니다. -
각 작업을 하는 일에 따라 등급을 나누고, 실행되기 전에 등급이 보이게 하세요. 일상 (보기, 인쇄)은 바로 실행됩니다. 기록형 은 기록에 무엇을 쓸지 알려 줍니다("진료에 메모를 추가합니다").
임상형 (중단, 처방 취소)은 한 번 더 묻습니다.
alert-dialog을 사용하며 확인 버튼은 동사("중단")이고, 절대 "확인"이나 "예"가 아닙니다. 공개형 (긴급 접근, 진료팀 밖과 공유)은 먼저 사유를 묻고 기록합니다. - 여러 기록이 열려 있을 때(탭, 창, 분할 창) 각 탭의 보이는 텍스트와 접근 가능한 이름에는 환자 이름과 두 번째 식별자가 들어가고, 활성 창은 배너를 반복하며, 어떤 작업도 해당 창의 환자가 아닌 환자에게 적용되지 않습니다.
- 기록이 귀속될 장소(로그인할 때 고른 병동, 외래, 기관)를 페이지 머리글에 텍스트로 보여 주고, 이를 바꾸는 것은 명시적인 작업으로 만드세요.
- 배너에 현재 방문 또는 "현재 방문 없음"을 표시하세요. 방문이 필요한 양식은 그렇다고 알리고 방문 시작을 제안하며, 저장할 때 실패하지 않습니다.
환자 배너
이 구성은 medical-banner에 기술되어 있으며, SvelteKit 예제 앱의 /patient-banner에 동작하는 페이지가 있습니다.
- 두 가지 식별자, 그리고 생년월일 옆의 나이.
- 알레르기는 allergy list로 표시하여 "알려진 알레르기 없음", "기록되지 않음", "확인 불가"가 결코 비슷해 보이지 않게 함.
- 누락된 값은 말로("알 수 없음") 표시하고, 물음표, 대시, 빈 셀로 표시하지 않음.
- 사망한 환자: 테마용
data-deceased와 눈에 보이는 문장. 색상만으로 나타내지 않음. - 어떤 너비에서도 필드를 줄여 자르거나, 잘라 내거나, 숨기지 않음. 줄바꿈하여 표시함.
-
환자 표시("통역사 필요", "감염 위험")는 단어로 이루어진 레이블이 있는
tag-group이며, 아이콘이나 색만으로 나타내지 않고 배너가 줄바꿈되어도 보입니다.
검사 결과
- 어느 시스템에서 온 결과든 표시는 하나입니다. observation view를 사용합니다.
- 플래그는 번역된 말(
flagLabel)이며, FHIR 해석 코드는 테마용data-interpretation으로 제공합니다. - 새 결과와 이전 결과를 구분하고, 추이(스파크라인, 또는 데이터 테이블이 있는 선 그래프)를 보여 줍니다. 임상의는 범위만이 아니라 유의미한 변화를 찾습니다.
- 한 번도 기록되지 않은 결과와 확인할 수 없는 결과는 서로 다른 상태이며, 서로 다른 말로 표시합니다.
-
알 수 없음은 정상이 아닙니다. 참고 범위가 없거나, 아직 불러오는 중이거나, 읽을 수 없는 결과에는 해석이 없으며 그렇다고 알립니다.
observation-view은(는) 해석을 추론하지 않으므로, 범위는 있지만interpretation이(가) 없는 결과는 표시가 나타나지 않습니다. -
측정 범위를 벗어난 결과는 비교 기호가 붙은 기기의 한계값("> 33.3 mmol/L":
formatQuantity과(와)">")과 사용자의 위급 표시로 나타내며, 숫자만 두지 않습니다. 근삿값은 ≈를 유지합니다("~"). - 추가로 이름이 붙은 범위("위급: 2.5 미만")는
ranges(으)로 제공하고, 각각 별도 부분으로 둡니다. -
수정되거나 정정된 결과는 대체된 값을
<del>에 남기고, 언제 바뀌었는지를 사용자의 말로 덧붙입니다(previousValue,previousLabel). 예전 값을 읽은 임상의가 바뀐 것을 알 수 있도록 하기 위해서입니다. -
구간 측정은 그 폭과 함수("평균, 24시간")를 밝히고, 측정의 상태와 방법("앉은 자세, 큰 커프")은 옆에 보이는 텍스트로 두며, 툴팁으로만 두지 않습니다(openEHR
INTERVAL_EVENT,state,protocol). - 추세에는 비교 가능한 점이 필요합니다. 최소 개수보다 적으면 선을 긋지 말고, 방법이나 검사가 바뀐 곳에서 선을 끊고, 방향과 의미를 말로 밝히세요("감소, 호전").
-
한 단위계로 입력한 활력 징후는 다른 단위계를 옆에 사용자의 텍스트로 보여 줄 수 있습니다("70 kg (154 lb)"). Lily는 아무것도 변환하지 않으므로 반올림 방식을 밝히세요. 수량은
quantity-input-div(으)로 입력하며, 그 숫자는 각 단위의 한계를 따릅니다. -
성장 곡선은
line-chart(으)로, 백분위 선을 계열로 두고 아이의 점과 나이·값 데이터 표를 함께 둡니다. Lily는 백분위를 계산하지 않고 성장 기준도 제공하지 않습니다.
의약품
- 일반명은 소문자로 쓰되, FDA와 ISMP 목록 또는 자국 목록(호주와 캐나다는 자체 목록을 발표합니다)의 tall man 대문자는 예외입니다. 이를
nameSegments에 표시합니다. Lily는 이를 추측하지 않습니다. - 함량은
formatQuantity로 씁니다. 뒤에 붙는 0 없음, 앞의 0 있음, 단위 앞에 줄바꿈 없는 공백. - 결과의 비교 기호를 유지합니다.
formatQuantity(5, "mmol/L", locale, "<")는 "<5 mmol/L"로 씁니다. FHIR의Quantity.comparator는 <, ≤, ≥ 또는 >로 적으며, 이를 빼면 "5 미만"이 "5"가 됩니다. - cc가 아니라 mL로 쓰고, ISMP의 오류 유발 약어 목록에 있는 모든 약어를 피합니다.
- 의약품 이름이나 용량을 절대 줄여 자르지 마십시오.
날짜와 시간
- 날짜가 두 가지로 읽히지 않도록 월은 문자로 씁니다(
Intl.DateTimeFormat과month: "short"). - 시계 방식은 의도적으로 선택합니다.
hourCycle을 명시적으로 전달하십시오. NHS는 24시간제를 요구하지만, 이는 영국의 규칙이지 전 세계의 규칙이 아니므로 Lily는 대신 선택하지 않습니다. - 나이는
ageParts()를 통해 Common User Interface 구간을 따릅니다. 다른 관례를 쓰는 서비스는 자체 용어를 전달합니다. -
월이나 연도까지만 아는 날짜는 그대로 둡니다.
date-fieldprecision="month"또는"year"(으)로 묻고,2019-03또는2019(으)로 저장하며,formatPartialDate()(으)로 씁니다. 날짜를 지어내지 마세요. -
기간은
duration-view, 즉<time datetime="P3DT4H">에 사용자의 말을 담은 것이며,durationParts()와(과)Intl.DurationFormat.
대시보드
- 병동 보드나 상황실 화면은 자주 갱신됩니다. 변경 때마다 알리지 마십시오. 정중한(polite) 요약 리전 하나를 유지하고("빈 병상 3개, 퇴원 예정 2명") 사람들이 보드를 직접 읽게 합니다.
- 보드의 모든 상태(병상 청소 완료, 사용 중, 사용 불가)는 텍스트 또는 말이 있는
data-*상태이며, 색상만으로 나타내지 않습니다. -
아무것도 깜박이지 않으며(WCAG 2.2.2, 2.3.1), 타이머로 갱신되는 보드에는 일시 정지 컨트롤이 있거나 요청할 때만 갱신됩니다. 갱신은 포커스를 옮기지 않습니다. 기한이 지난 항목은 말로 알리고("20분 넘게 대기 중")
data-overdue. - 개수나 비율은 분모를 보여 주고("68건 중 12건") 그 뒤의 목록으로 연결합니다.
- 목록이나 타임라인은 무엇의 보기인지 밝힙니다: 무엇을 보여 주는지, 순서와 기간, 무엇을 왜 숨겼는지, 어느 출처가 응답하지 않았는지. 응답하지 않은 출처의 빈 목록은 아무것도 없다는 증거가 아닙니다.
-
알림 목록은
record-list(으)로, 각 항목에 마감일(review-date)과 말로 된 마감 상태를 담고data-due을(를) 지정합니다. 이를 만든 규칙은 사용자의 것입니다.
양식
-
"예", "아니요", "묻지 않음"으로 답하는 질문은
radio-group에 세 가지 답을 두고 처음에는 아무것도 선택하지 않으며, 체크박스로 만들지 않습니다. 체크박스는 "부인함"과 "묻지 않음"을 구별할 수 없습니다. 계통 문진은 신체 계통마다 하나의fieldset(으)로 하고, "나머지 모두 없음" 버튼은 답하지 않은 항목만 설정합니다. -
답의 목록이 있는 질문(약, 주소)은
repeatable-fieldset입니다. 항목을 추가하거나 제거하면 포커스가 따라가고, 각 제거 버튼에는 해당 항목의 이름이 붙습니다. -
소수점 쉼표가 있는 숫자는
Intl.NumberFormat(으)로 표시하고,type="number"이(가) 쉼표를 받지 않는 곳에서는inputmode="decimal"을(를) 쓴 텍스트 필드로 받아 코드에서 해석하세요. 사람이 입력한 값은 범위에 맞추기 위해서라도 절대 바꾸지 마세요. 범위를 벗어난 값은 본인이 볼 수 있는 오류입니다. -
한 번에 선택지 일부만 그리는 긴 목록은 각 선택지에
aria-setsize와(과)aria-posinset을(를) 지정하고, 페이지 내 찾기로는 나머지를 볼 수 없다는 점을 염두에 둡니다.
기록, 메모, 그리고 출처
-
행 앞에서 목록이나 그리드가 무엇의 보기인지 밝히세요: 기간과 순서, 무엇을 왜 빼는지, 어느 출처가 응답하지 않았는지("최근 12개월, 최신순. 주치의 기록이 응답하지 않았습니다.").
record-list와(과)timeline-list에coverageLabel을(를),data-grid도우미에는 그coverageLabel을(를) 지정하세요. 응답하지 않은 출처의 빈 목록은 그렇다고 말로 알려, "기록 없음"으로 읽히는 일이 없게 합니다. -
기록의 출처와 확정 여부는
record-provenance-view(으)로 밝히세요: 서명됨, 서명 대기, 정정됨, 이 기기에 저장되었고 아직 전송되지 않음. 서명하지 않은 초안이 서명된 것처럼 보여서는 안 됩니다. - 다른 사람(부모, 태아, 기증자)에 관한 항목은 기록 항목의
subjectLabel(으)로 누구의 것인지 먼저 밝힙니다. -
보류된 항목은 사용자의 말과 함께 목록에 남고("제한됨: 볼 수 없음"), 잘못 입력된 항목은 "잘못 입력됨"과 함께 취소선이 그어진 채 남습니다:
record-list-item또는timeline-list-item에entryState과(와)entryStateLabel을(를) 지정하세요. 어느 쪽도 조용히 삭제하지 마세요. 빈자리는 "아무 일도 없었다"로 읽히기 때문입니다. -
임상 메모에서는 각 단락의 출처(입력, 구술, 템플릿, 이전 기록 복사, 생성)를
data-source와(과) 보이는 말로 표시해, 복사되거나 생성된 글이 오늘의 진찰로 오인되지 않게 합니다. -
불러올 수 없는 섹션은
unavailable(으)로 사용자의 말과 다시 시도 버튼을 함께 둡니다. 기술 코드를 보여 준다면 펼침 요소 뒤에 둡니다. 사람의 작업으로 생긴 실패는 기록이 지금 가진 값과 함께 알리고, 페이지를 불러올 때의 실패는 알리지 않습니다. -
처방 이력은
timeline-list(으)로, 단계마다 하나의 항목(계획됨, 예약됨, 진행 중, 보류, 완료, 취소)을 시간과 사유와 함께 두고, 현재 상태도 항목에 표시합니다.
FHIR에서 Lily로
Lily는 FHIR 리소스를 읽지 않으며, 여러분의 코드가 이를 Lily의 props에 대응시킵니다. 이 두 표는 HL7 FHIR International Patient Summary(IPS 2.0.1, FHIR R4)를 대응시킨 것입니다. 코드 대응은 제안일 뿐이며, 결정은 임상 안전성 검토가 내리고, 모든 상태를 나타내는 말은 여러분이 직접 정합니다.
| IPS 섹션 | Lily |
|---|---|
알레르기 및 불내성(48765-2) |
allergy-record-list 및 그 항목 |
투약 요약(10160-0) |
medication-record-list, 각 항목에 medication-view를 포함 |
문제 목록(11450-4) |
problem-record-list 및 그 항목 |
예방접종(11369-6) |
immunization-record-list 및 그 항목 |
검사 결과(30954-2) |
observation-view, 데이터 테이블 또는 요약 목록 안에서 사용 |
시술 이력(47519-4) |
procedure-record-list 및 그 항목 |
의료기기(46264-8) |
device-record-list 및 그 항목 |
경고(104605-1) |
경고 문구 또는 알림. 접힌 컨트롤 뒤에는 절대 두지 않음 |
| 그 밖의 섹션 | record-list 및 그 항목 |
| 문서가 생략한 필수 섹션 | 해당 섹션의 목록에 status="omitted" 지정 |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
목록의 status="none-known" |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", 어느 쪽인지 알려 주는 문구와 함께 |
IPS 코드 no-known-allergies, no-known-medications 등 |
status="none-known" |
IPS 코드 no-allergy-info, no-medication-info 등 |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, 반응의 severity와는 별개 |
clinicalStatus, verificationStatus |
알레르기 및 문제 항목의 동일한 props, 동일한 코드 |
MedicationStatement.status |
투약 항목의 status |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view의 status, 동일한 코드 |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (기록 목록에도) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
entered-in-error 기록은 조용히 제외하지 말고 문구와 함께 entered-in-error 상태에 대응시킵니다. 표시할지 여부는 서비스가 결정합니다.
openEHR에서 Lily로
Lily는 openEHR 컴포지션도 읽지 않습니다. openEHR 참조 모델의 데이터 형식과 코드 대응표를, 임상 안전 검토가 결정하는 제안으로 제시합니다:
| openEHR | Lily |
|---|---|
DV_QUANTITY (입력) |
quantity-input-div; 단위는 UCUM 코드와 사용자의 말로 |
DV_QUANTITY (표시), magnitude_status |
observation-view 와(과) formatQuantity(value, unit, locale, comparator) (~ 는 ≈) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges 와(과) meaning |
observation-view ranges |
DV_DATE 부분 날짜(연도, 연도와 월) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view 와(과) durationParts() |
DV_PROPORTION |
formatProportion() 안의 observation-view |
DV_ORDINAL, DV_SCALE |
radio-group (으)로, 레이블에 숫자와 그 말을 담음 |
DV_CODED_TEXT |
아래의 코드값 패턴 |
DV_BOOLEAN |
checkbox-input, "묻지 않음"이 있을 수 없을 때만 |
ELEMENT.null_flavour 253 알 수 없음, 271 정보 없음 |
status="not-recorded" 또는 "unavailable", 어느 쪽인지 알려 주는 문구와 함께 |
null_flavour 272 가려짐 |
observation-view status="masked" |
null_flavour 273 해당 없음 |
status="not-applicable" |
PARTY_RELATED 대상자 |
subjectLabel 을(를) 기록 항목에 |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| 지시 상태 기계의 단계 | 단계로 된 timeline-list , 현재 상태를 항목에 표시 |
발생 횟수가 다음인 원형 항목 0..* |
repeatable-fieldset |
코드화된 값
Coding.display를 표시하고, 없으면CodeableConcept.text, 둘 다 없으면system|code를 표시합니다. 빈 셀은 절대 두지 않습니다.- 각 값 옆에 코드 체계와 코드를 보여 주는 컨트롤을 제공합니다. 예를 들어 "코드 표시"라고 적힌 토글 버튼입니다. 숨겨진 코드는 표시되기 전까지 읽기 순서에서 제외됩니다.
- 임상 텍스트에는 인터페이스의 언어와 다를 수 있는 문서의 언어(
lang)를 표시합니다. 인터페이스는 번역하되 임상 내용은 절대 번역하지 않습니다. - Lily는 용어 체계를 제공하지 않습니다. SNOMED CT, LOINC, ATC, UCUM 조회도 없습니다. 문서에 적힌 대로 쓰십시오. SvelteKit 예제의
/patient-summary페이지가 이 패턴을 보여 줍니다.
Lily가 하지 않는 일
- 조기 경고 점수, 성장 백분위수, 용량, 참고 범위를 계산하는 것.
- 약물 데이터베이스, tall man 목록, 또는 SNOMED CT, ICD, LOINC, UCUM 코드를 포함하는 것.
- 라이선스가 있는 도구(Wong-Baker FACES)나 다른 기관의 디자인(NEWS2 차트)을 재현하는 것.
- 동시에 열 수 있는 기록의 수를 제한하는 것.
- 범위에서 해석을 추론하거나, 단위를 변환하거나, 상대 날짜("다음 주 화요일")를 해석하는 일.
- "예, 아니요, 알 수 없음"에 스위치를 쓰는 일: ARIA의
switch에는 세 번째 상태가 없으므로 라디오 버튼 세 개로 만듭니다.
이 안내서의 배경이 된 조사, 출처, 결정은 spec/healthcare-ui에 있습니다.