서류발급¶
진입 위치: - 차트(진료실) 우측 패널 → [서류] 또는 [진단서] 버튼 → DocumentsModal - 환자 상세 → 서류 발급 메뉴 → 페이지 진입 - 좌측 메뉴 → 서류별 직접 진입 (TopMenuBar) 권한: 전 직원 (level 1~5) — 일부 인쇄/서명은 의사/관리자 권한
한 줄 요약
의료 서류 22종을 모달 또는 페이지로 발급. 양식별 폼 작성 → 미리보기 → A4 인쇄/PDF 저장.
발급 가능한 서류 22종¶
진단서 (4종)¶
| 서류 | 모달 ID | 페이지 |
|---|---|---|
| 진단서 | diagnosis |
/popup/documents/diagnosis |
| 진단서(영문) | diagnosis-en |
/popup/documents/diagnosis-en |
| 상해 진단서 | injury-diagnosis |
/popup/documents/injury-diagnosis |
| 병무용 진단서 | military-diagnosis |
/popup/documents/military-diagnosis |
소견서 (2종)¶
- 소견서 |
opinion - 소견서(영문) |
opinion-en
확인서 (4종)¶
- 진료(통원) 확인서 |
treatment-confirm - 입·퇴원 확인서 |
admission-confirm - 수술 확인서 |
surgery-confirm - 진료비(약제비) 납입 확인서 |
payment-confirm
기록지 (4종)¶
- 진료 기록부 |
medical-record - 수술 기록지 |
surgery-record - 간호 기록지 |
nursing-record - 판독 기록지 |
reading-record
의뢰서 (3종)¶
- 진료 의뢰서 |
referral - 요양 급여 의뢰서 |
care-benefit-referral - 의료 급여 의뢰서 |
medical-benefit-referral
비용 관련 (3종)¶
- 향후 진료비 추정서 |
future-cost-estimate - 진료비 세부 내역서 |
cost-detail - 진료비 세부 산정 내역서 |
cost-calculation
기타 (2종)¶
- 회송서 |
return - 처방전(영문) |
prescription-en
발급 흐름 (공통)¶
1. 환자 차트/진료실 진입
↓
2. 우측 패널 → [서류] 또는 [진단서] 버튼
↓
3. DocumentsModal → 좌측 서류 메뉴 → 원하는 서류 선택
↓
4. 우측에 양식 폼 표시 — 환자 정보 자동 채움
↓
5. 진단명/소견/날짜 등 입력
↓
6. [미리보기] → A4 인쇄 레이아웃 출력
↓
7. [인쇄] (Ctrl+P) → 프린터 출력 또는 PDF 저장
↓
8. 환자에게 종이 또는 PDF 파일 제공
양식별 입력 필드 (대표 예시)¶
진단서 (가장 자주 사용)¶
| 필드 | 설명 | 자동/수동 |
|---|---|---|
| 환자 정보 | 이름/생년월일/주민번호/주소 | 자동 (patients) |
| 진단명 | 한글 진단명 (필수) | 수동 |
| 질병분류기호 | KCD 코드 | 수동 (의사) |
| 발병일 | YYYY-MM-DD | 수동 |
| 진단연월일 | YYYY-MM-DD | 수동 |
| 치료내용 | 자유 텍스트 | 수동 |
| 향후 치료 계획 | 자유 텍스트 | 수동 (선택) |
| 발급 의사 | 진료의 + 면허번호 | 자동 (users) |
수술 확인서 (수술 기록 자동 로드)¶
- 환자 정보 자동
- 연결된 수술 기록 자동 표시 (수술일, 수술명, 마취 정보)
- 의사 서명/도장 자동
인쇄 흐름¶
각 서류는 인쇄 전용 레이아웃 (PDF에 최적화):
- /pages/documents/print/{서류}PrintLayout.jsx
- A4 단위 페이지 분할 + 의사 도장 (DoctorStamp.jsx) 자동 삽입
- 병원 로고/주소 자동 채움
미리보기 화면에서 [인쇄] → 브라우저 인쇄 다이얼로그 (Ctrl+P) → PDF 저장 또는 프린터 출력.
일괄 서명 (전자서명)¶
진입: 좌측 메뉴 전자서명 카테고리
| 메뉴 | 라우트 | 용도 |
|---|---|---|
| 일괄서명 | /esign/batch |
여러 서류 한 번에 의사 서명 |
| 진료기록부 | /esign/medical-record |
진료기록 전자서명 + 보관 |
| 본부금수납대장 | /esign/payment-ledger |
본인부담금 영수증 서명 |
| 주소증 | /esign/address-cert |
주소 증명서 발급 |
| 수술기록지 | /esign/surgery-record |
수술 기록 전자서명 |
| 간호기록지 | /esign/nursing-record |
간호 기록 전자서명 |
전자서명 라우트는 별도 시스템
전자서명 영역은 의사 도장 자동 삽입 + 의무 보관 기능 포함. 일부 영역은 외부 인증 시스템 연동 (현재 백엔드 일부 진행 중).
권한별 차이¶
| 기능 | 권한 |
|---|---|
| 서류 모달 열기 / 조회 | 🟢 전 직원 |
| 진단서 / 소견서 작성 | 🟡 의사 또는 admin (의사 도장 필요) |
| 확인서 / 기록지 인쇄 | 🟢 전 직원 |
| 의뢰서 발급 | 🟡 의사 또는 admin |
| 일괄 전자서명 | 🟡 의사 본인 |
| 환자 정보 수정 (서류 발급 후) | 🔴 admin (audit 로그 남음) |
발급 이력 / 보관¶
- 발급된 서류는 PDF로 환자에게 제공 + 필요 시
chart_attachments에 저장 - 일부 서류 (진단서 등)는 발급 사실 + 발급일 기록 (법적 보관 의무)
- 진료기록부는 영구 보관 (의료법)
자주 묻는 질문 / FAQ¶
Q. 진단서 인쇄 시 의사 도장이 안 보여요
DoctorStamp.jsx 컴포넌트가 자동 삽입. 의사 정보(users.signature_url)가 등록되지 않은 경우 미표시. 시스템 설정 → 사용자 관리에서 의사 도장 이미지 업로드 필요.
Q. 영문 진단서/소견서가 한글로 출력돼요
영문 양식 폼(diagnosis-en / opinion-en)을 별도로 선택해야 합니다. 한글 양식과 영문 양식은 다른 모달 메뉴.
Q. 수술 확인서에 수술 정보가 자동으로 안 채워져요
수술 기록(surgery_records)이 연결되지 않은 환자. 차트에서 [수술 기록지] 먼저 작성 후 수술 확인서 발급 시 자동 매칭.
Q. 진료비 세부 내역서와 세부 산정 내역서가 어떻게 달라요?
- 세부 내역서 (
cost-detail): 항목별 가격 표시 - 세부 산정 내역서 (
cost-calculation): 항목별 보험 적용/본인부담 계산식 표시
Q. 발급한 서류를 다시 확인하고 싶어요
현재 발급 이력 전용 페이지는 없음 (chart_attachments 에 저장된 서류는 차트에서 확인 가능). 정식 이력 페이지는 후속 work-item.
Q. 일괄 서명을 한 번에 여러 서류에 하려면?
/esign/batch 진입 → 서명 대기 서류 리스트 → 다중 선택 → [일괄 서명]. 단, 현재 일부 기능 진행 중일 수 있어 작동 안 하면 #dev 문의.
Q. 처방전(영문)은 처방 시스템과 별개인가요?
별개. 일반 처방전은 차트 → [처방전 출력] (별도 흐름). 영문 처방전은 외국인 환자용 별도 양식.
Q. 회송서는 언제 발급하나요?
환자를 다른 의료기관으로 회송(전원)할 때. 보통 입원 환자가 다른 병원으로 이동, 또는 전문 분야 진료 필요 시.