healthcare-emr-patterns

name	healthcare-emr-patterns
description	헬스케어 애플리케이션을 위한 EMR/EHR 개발 패턴입니다. 임상 안전성, encounter 워크플로, 처방 생성, CDSS 연동, 의료 데이터 입력용 접근성 우선 UI를 다룹니다.
origin	Health1 Super Speciality Hospitals — contributed by Dr. Keyur Patel
version	1.0.0

의료 EMR 개발 패턴 (Healthcare EMR Development Patterns)

전자의무기록(EMR) 및 전자건강기록(EHR) 시스템을 구축하기 위한 패턴입니다. 환자 안전, 임상적 정확성 및 의료진의 효율성을 최우선으로 합니다.

사용 시점

• 환자 진료(encounter) 워크플로를 구축할 때
• 임상 기록(clinical note) 작성 기능을 구현할 때
• 약물 상호작용 체크가 포함된 처방/약물 모듈을 설계할 때
• 임상 의사결정 지원 시스템(CDSS)을 연동할 때
• 참고 범위(reference range) 강조가 포함된 검사 결과 표시 기능을 만들 때
• 임상 데이터에 대한 감사 추적(audit trail)을 구현할 때
• 의료 데이터 입력을 위한 접근성 높은 UI를 설계할 때

동작 방식

환자 안전 우선 (Patient Safety First)

모든 설계 결정은 "이것이 환자에게 해를 끼칠 수 있는가?"라는 관점에서 평가되어야 합니다.

• 약물 상호작용은 반드시 알림(alert)을 생성해야 함
• 비정상적인 검사 수치는 반드시 시각적으로 강조 표시해야 함
• 위험한 활력 징후(vitals)는 에스컬레이션 워크플로를 트리거해야 함
• 감사 추적 없이는 임상 데이터를 수정할 수 없어야 함

단일 페이지 진료 흐름 (Single-Page Encounter Flow)

임상 진료(encounter)는 탭 전환 없이 하나의 페이지에서 수직적인 흐름으로 진행되어야 합니다.

환자 헤더 (Patient Header, 고정)
├── 인구통계 정보, 알레르기, 현재 복용 약물
│
진료 흐름 (Encounter Flow)
├── 1. 주소 (Chief Complaint)
├── 2. 현병력 (History of Present Illness)
├── 3. 신체 검진 (Physical Examination)
├── 4. 활력 징후 (Vitals)
├── 5. 진단 (Diagnosis)
├── 6. 약물 처방 (Medications)
├── 7. 검사 의뢰 (Investigations)
├── 8. 계획 및 추적 관찰 (Plan & Follow-up)
└── 9. 서명 / 잠금 / 출력 (Sign / Lock / Print)

스마트 템플릿 시스템 (Smart Template System)

interface ClinicalTemplate {
  id: string;
  name: string;
  chips: string[];
  requiredFields: string[];
  redFlags: string[];
  icdSuggestions: string[];
}

템플릿에 정의된 어떤 '레드 플래그(red flag)'라도 탐지되면, 반드시 무시할 수 없는(non-dismissable) 알림을 트리거해야 합니다.

약물 안전 패턴 (Medication Safety Pattern)

사용자가 약물 선택
  → 현재 복용 중인 약물 확인
  → 현재 진료 중 처방된 약물 확인
  → 환자 알레르기 확인
  → 용량 검증
  → 치명적(CRITICAL) 상호작용 발견 시: 처방 차단(BLOCK)
  → 의료진이 차단 해제(override) 사유 기록
  → 주요(MAJOR) 상호작용 발견 시: 경고 표시 + 인지(acknowledgment) 확인
  → 알림 및 차단 해제 내역 기록

치명적인 상호작용은 기본적으로 처방 프로세스를 차단해야 합니다.

진료 기록 잠금 패턴 (Locked Encounter Pattern)

임상 진료 기록에 서명이 완료되면:

• 편집이 불가능해짐
• 추가 기록(addendum)만 허용됨
• 원본 기록과 추가 기록이 모두 타임라인에 표시됨
• 누가, 언제 서명했는지, 어떤 추가 기록이 있었는지에 대한 감사 추적 유지

UI 패턴

활력 징후 표시 (Vitals Display)

• 현재 수치와 정상 범위를 함께 강조
• 이전 수치 대비 추세를 나타내는 화살표 표시
• NEWS2, qSOFA와 같은 임상 점수 자동 계산
• 인라인 에스컬레이션 가이드 제공

검사 결과 표시 (Lab Results Display)

• 정상 범위를 벗어난 수치 강조
• 과거 수치와의 비교 데이터 제공
• 치명적 수치(critical value) 발생 시 무시할 수 없는 알림 표시
• 검체 채취 및 분석 시각 명시
• 대기 중인 처방(pending order)과 예상 완료 시간 표시

처방전 PDF (Prescription PDF)

• 환자 인구통계 정보, 알레르기, 진단명, 상세 약물 정보, 의료진 서명 란 포함

접근성 (Accessibility)

• 텍스트 대비 최소 4.5:1 유지
• 44x44px 이상의 터치 타깃 확보
• 키보드 내비게이션 지원
• 색상만으로 상태를 전달하지 않음
• 모든 폼 필드에 스크린 리더용 레이블 제공
• 임상 알림(alert)에 자동 사라짐(auto-dismiss) 토스트 메시지 사용 금지

안티패턴

• 임상 데이터를 브라우저의 localStorage에 저장하는 것
• 약물 상호작용 체크 실패를 소리 없이 무시(silent failure)하는 것
• 치명적 알림을 닫을 수 있는 토스트 메시지로 표시하는 것
• 임상 워크플로를 단절시키는 탭 기반 UI를 사용하는 것
• 서명된 진료 기록의 직접 수정을 허용하는 것
• 감사 추적 없이 임상 데이터를 표시하는 것
• 임상 데이터 구조에 any 타입을 사용하는 것