환자 상세¶
이 페이지에서 찾을 수 있는 것
환자 상세 / 환자 정보 보기 / 환자 정보 수정 / 환자 차트 이력 / 환자 결제 이력 / 가족 등록 / 소개자 등록 / 환자 메모 / 환자 종합 / 빠른 예약
특정 환자의 모든 정보(기본 정보, 차트 이력, 예약 이력, 결제 이력, 상담 이력 등)를 한 화면에서 조회하는 통합 페이지입니다.
주소:
/patients/:id(환자 검색 또는 차트에서 진입)
화면 구성¶
| 영역 | 내용 |
|---|---|
| 상단 환자 정보 | 이름/생년월일/성별/연락처/차트번호/등록일/주민번호(마스킹) |
| 탭 메뉴 | 차트 이력 / 예약 이력 / 결제 이력 / 상담 이력 / 가족/소개 / 메모 |
| 본문 | 선택한 탭의 데이터 (시간순 정렬) |
| 우측 빠른 액션 | 새 예약 / 차트 진입 / 수납 팝업 / SMS 발송 |
자주 쓰는 동작¶
시나리오 1 — 환자 종합 이력 확인 (재방문 환자)¶
- 환자 검색 또는 현황판에서 환자 선택 → 상세 진입
- 차트 이력 탭 → 과거 진료 검토
- 결제 이력 탭 → 미수 / 선납권 잔액 확인
- 상담 이력 탭 → 마지막 상담 메모 검토
시나리오 2 — 환자 정보 수정¶
- 환자 상세 진입
- 상단 환자 정보에서 수정 버튼
- 이름/연락처/주소 등 수정
- 저장 → 모든 페이지에 즉시 반영
시나리오 3 — 가족/소개 환자 연결¶
- 가족/소개 탭
- + 가족 등록 또는 + 소개자 등록
- 다른 환자 검색 후 연결
- 가족 매출왕 / 소개왕 통계에 자동 반영
시나리오 4 — 빠른 예약 등록¶
- 환자 상세 우측 새 예약 버튼
- 날짜/시간/담당자 입력
- 저장 → 예약노트에 표시
자동 검증¶
- 수정 이력은 감사로그(
reservation_change_logs)에 기록 - 휴대폰 변경 시 정합성 봇이 중복 등록 여부 점검 (work-item 24)
- 가족 연결은 양방향 자동 동기화
권한별 차이¶
| 기능 | 권한 |
|---|---|
| 환자 상세 보기 | 🟢 모든 직원 |
| 정보 수정 (이름/연락처) | 🟢 모든 직원 |
| 주민번호 마스킹 해제 | 🟡 Level 1~2 (옵션 추가 예정) |
| 가족/소개 연결 변경 | 🟢 모든 직원 |
| 환자 삭제 | 🔴 Level 1~2 관리자 |
자주 묻는 질문¶
Q. 환자 정보를 수정했는데 다른 페이지에 안 보여요
잠시 후 자동 새로고침되거나 F5로 강제 새로고침. 그래도 안 보이면 캐시 문제 가능.
Q. 동명이인 환자가 있는데 어떻게 구분하나요?
차트번호 + 휴대폰 + 생년월일로 구분. 의도적 동명이인(부모/자녀 같은 번호)은 환자 등록 매뉴얼 시나리오 3 참고.
Q. 환자 삭제했는데 데이터가 남아있어요
soft delete (status='deleted')라 검색 결과에서만 사라지고 데이터는 보존. 복구는 #dev 문의.