환자 등록¶
이 페이지에서 찾을 수 있는 것
환자 등록 / 신규 환자 / 새 환자 추가 / 환자 만들기 / 휴대폰 중복 / 강제 등록 / 차트번호 / 주민번호 / 부모 자녀 같은 번호 / 가족 등록 / 보호자
신규 환자를 시스템에 등록하는 화면입니다. 휴대폰 중복 검사·주민등록번호 검증·자동 차트번호 생성·Daum 주소 검색 등이 통합되어 있어, 한 화면에서 환자 정보를 빠르게 입력할 수 있습니다.
화면 구성¶
| 영역 | 위치 | 내용 |
|---|---|---|
| 상단 사용자 정보 | 우상단 | 등록 작업자 표시 |
| 좌측 패널 | 좌측 | 환자 검색 (기존 환자 정보 불러오기용) |
| 본문 — 기본 정보 | 가운데 위 | 이름, 주민번호, 휴대폰, 보험 등 |
| 본문 — 추가 정보 | 가운데 아래 | 주소, 직업, 메모 등 |
| 하단 버튼 | 화면 끝 | 저장 / 취소 |
| 중복 확인 모달 | 팝업 | 휴대폰/이름 중복 시 자동 표시 |
입력 필드 — 기본 정보¶
필수 항목 (* 표시)¶
| 필드 | 형식 | 비고 |
|---|---|---|
| 환자명 | 한글 텍스트 | 부분 일치 검색 가능 |
| 주민등록번호 | 7자리 + 7자리 | 뒷자리는 ●●●●●●● 마스킹 표시 |
| 본인확인여부 | Y / N 라디오 | 신분증 확인 여부 |
| 나이 / 성별 | 자동 계산 + 남성/여성 라디오 | 주민번호로 자동 계산 |
선택 항목¶
| 필드 | 형식 | 비고 |
|---|---|---|
| 차트번호 | 자동 생성 | YY+6자리 (예: 26000123) |
| 실제생일 | 날짜 | 주민번호와 다른 경우만 입력 |
| 보험증번호 | 텍스트 | |
| 보험종류 | 일반 / 건강보험 / 자보 / 보훈 | |
| 휴대전화1 | 010-XXXX-XXXX | 입력 시 자동 중복 검사 |
| 휴대전화2 | (보호자 등) | 선택 |
| 주소 | Daum 주소 API | 우편번호 검색 자동 |
| 직업 | 텍스트 | |
| 결혼 여부 | 미혼/기혼/기타 | |
| 메모 | 자유 텍스트 | 직원 메모 |
자동 검증 (재발 방지 — work-item 24)¶
휴대폰 중복 검사 (실시간)¶
휴대전화 입력 후 포커스를 이동하면 시스템이 자동으로 동일 번호 환자를 검사합니다. 발견 시:
⚠️ 동일 휴대폰 번호로 등록된 환자가 있습니다.
- 김보미 (260319002)
010-1234-5678 (1981-03-19)
[기존 환자 정보 불러오기] [신규 등록 (강제)]
옵션 1 — 기존 환자 정보 불러오기 (재방문)¶
- 모달에서 기존 환자 선택
- 폼이 자동으로 채워짐
- "기존 환자 김보미 정보를 불러왔습니다" 안내
- 재방문 흐름으로 진행
옵션 2 — 신규 등록 (강제 등록 모드)¶
- "신규 등록" 버튼 클릭
- "강제 등록 모드 ON — 저장 시 중복 검사 우회됩니다" 안내
- 의도적인 동명이인(부모/자녀 같은 번호 사용 등) 등록 시 사용
이 fix의 효과
work-item 24 적용 후 김강희 같은 동명이인 5명 연속 등록 사고 방지: 이전에는 같은 번호로 환자가 무제한 등록되어 정합성 봇 7번 알림 빈발. 이제 등록 시점에 자동 차단되어 중복 발생 자체를 막음.
주민등록번호 형식 검증¶
- 13자리 숫자만 허용
- 잘못된 형식 입력 시 빨간 테두리 표시
차트번호 자동 생성¶
- 등록 저장 시 다음 차트번호 자동 부여
- 형식:
YY+6자리 일련번호(예:26000123= 2026년 123번째 환자)
자주 쓰는 동작¶
시나리오 1 — 신규 환자 등록 (일반)¶
처음 내원한 환자 등록
- 메뉴 > 환자관리 > 환자 등록
- 환자명 입력
- 주민등록번호 13자리 입력
- 자동으로 나이/성별 계산
- 본인확인여부 Y 선택 (신분증 확인 시)
- 휴대폰 번호 입력 (자동 중복 검사 실행)
- 중복 없음 → 다음 단계 진행
- 중복 있음 → 모달 → "신규 등록" 또는 "기존 환자 불러오기" 선택
- 보험 종류, 주소 등 추가 정보 입력
- 하단 저장 버튼
- 차트번호 자동 부여 + 환자 검색 페이지로 이동
시나리오 2 — 재방문 환자 (기존 정보 불러오기)¶
이미 등록된 환자가 다시 왔을 때
- 휴대폰 번호 입력 시 자동 중복 검사로 발견됨
- 모달에서 "기존 환자 정보 불러오기" 클릭
- 폼이 자동으로 채워짐
- 변경된 정보(주소 변경, 보험 변경 등)만 수정 후 저장
또는 좌측 환자 검색에서 이름/번호로 직접 찾아 클릭해도 정보가 불러와집니다.
시나리오 3 — 부모/자녀 같은 번호 등록 (의도적 동명이인)¶
보호자 휴대폰을 같이 쓰는 자녀 등록
- 자녀 정보 입력 (자녀 이름, 자녀 주민번호)
- 휴대폰 번호 = 부모 번호
- 자동 중복 검사 → "이 번호로 등록된 환자가 있습니다" 모달
- "신규 등록" 버튼 클릭 → 강제 등록 모드 ON
- 저장 → 자녀 신규 환자로 등록 (부모와 다른 환자)
시나리오 4 — 주소 자동 검색 (Daum API)¶
주소 입력 시 자동 검색 사용
- 주소 필드 옆 "주소 검색" 버튼 클릭
- Daum 주소 검색 팝업 열림
- 도로명/지번 검색 → 결과 선택
- 우편번호 + 도로명 주소 자동 입력
- 상세 주소(동/호수)만 직접 입력
권한별 차이¶
| 기능 | 권한 |
|---|---|
| 신규 환자 등록 | 🟢 모든 직원 |
| 휴대폰 중복 강제 등록 | 🟢 모든 직원 (의도적 동명이인 등록) |
| 환자 정보 수정 | 🟢 모든 직원 |
| 환자 삭제 (단건) | 🟡 Level 1~2 관리자 |
| 환자 일괄 삭제 (bulkDelete) | 🔴 Level 1~2 관리자 |
→ 등록 자체는 모든 직원 가능, 단 사고 방지를 위해 등록 전 자동 중복 검사가 진행됩니다.
자동 검증 (정합성)¶
환자 등록과 관련된 정합성 봇 알림:
| 검사 번호 | 내용 | 처리 |
|---|---|---|
| 7 | 환자 중복 (같은 이름+번호) | 환자 검색 → 빈 환자 식별 후 선택삭제 |
→ work-item 24 fix로 신규 등록 시점에 사전 차단되므로 향후 7번 알림 빈도 크게 감소.
자주 발생하는 문제 / FAQ¶
Q1. 휴대폰 번호 입력 후 모달이 안 떠요. A. 자동 중복 검사는 휴대폰 필드에서 포커스가 이동될 때(다른 필드 클릭 시) 실행됩니다. 또는 환자명/주민번호가 비어있으면 검사 안 될 수 있습니다.
Q2. "기존 환자 정보 불러오기"를 했는데 차트번호가 새로 생성됐어요. A. 정상 흐름입니다. 기존 환자가 선택된 상태로 폼이 채워지고, 저장 시 기존 환자 정보가 업데이트됩니다 (새 환자 생성 X). 차트번호 표시는 유지됩니다.
Q3. 강제 등록을 했는데 정합성 봇 알림이 또 떠요. A. 강제 등록은 의도적 동명이인 (부모/자녀 같은 번호 등) 등록 시에만 사용하세요. 단순 실수로 강제 등록하면 봇이 다음날 7번 알림을 보냅니다. 잘못 등록한 경우 환자 검색에서 정리하세요.
Q4. 주민등록번호 마스킹이 풀렸으면 좋겠어요. A. 보안 정책상 뒷자리는 ●●●●●●●로 마스킹 표시됩니다. 권한이 충분한 경우(Level 1~2)에만 풀어볼 수 있는 옵션이 추후 추가될 예정입니다.
Q5. 차트번호를 직접 지정하고 싶어요. A. 차트번호는 시스템이 자동 부여합니다 (중복 방지를 위해). 직접 지정 기능은 제공하지 않습니다.
Q6. 외국인 환자(주민번호 없음) 등록은 어떻게 하나요? A. 외국인 등록번호 또는 임시 식별번호로 입력하세요. 시스템상 7+7 자리 형식만 검증되며, 정확한 주민번호 검증은 별도로 하지 않습니다.
Q7. 등록 후 환자가 안 보여요. A. 다음 항목 확인: 1. 환자 검색에서 정확한 이름/번호로 검색했는지 2. 검색 종류(searchType)가 맞는지 3. 부서별 권한 제한이 있는지 (level 4 부서 제한)
Q8. 휴대폰 중복인데 모달이 잘못된 환자를 보여줘요. A. 같은 번호로 여러 환자가 등록되어 있을 수 있습니다 (과거 데이터). 정합성 봇 7번 알림에 잡히니 환자 검색에서 정리해주세요.
Q9. 보호자 정보를 어디에 입력하나요? A. 휴대전화2 필드에 보호자 번호 입력. 추가로 메모 필드에 "보호자: ○○○ (관계)" 메모 권장.
Q10. 등록 도중 페이지를 떠나면 입력 내용이 사라지나요? A. 저장 안 한 내용은 사라집니다. 입력 도중 자리를 비우거나 다른 페이지로 이동하기 전 반드시 저장하세요.