예약노트¶

이 페이지에서 찾을 수 있는 것

예약노트 / 예약판 / 예약 보기 / 빈 셀 클릭 / 빠른 예약 / 예약 시간 변경 / 예약 카드 드래그 / 예약 합치기 / 예약 취소 / 예약 삭제 / 예약 복사 / 예약 이동 / 안내 SMS / 발송 설정 / 발송 이력 / 신환부재 / 부도 / 컬럼 그룹 / 진료구분 / 담당의 / 담당직원 / 카드 색상 / 핑크 / 주황 / 보라 / 좌측 초록바 / 전화상담

시간대별 그리드로 하루 예약 현황을 한눈에 보고, 빈 시간에 빠르게 예약을 잡거나 기존 예약을 드래그로 이동할 수 있는 화면입니다. 좌측 예약정보 패널에서 환자에게 안내 SMS를 수동으로 발송할 수 있고, 발송 이력도 같은 패널에서 확인할 수 있습니다.

화면 구성¶

영역	위치	내용
상단 헤더	화면 위	날짜 이동, 진료구분/담당의/담당직원 그룹 선택, 검색, 엑셀, 설정, 새로고침
시간×컬럼 그리드	가운데	행=시간(설정 간격), 열=컬럼(진료구분 또는 담당의/담당직원)
현재 시각 표시줄	그리드 안	빨간선으로 지금 시각 표시
예약 카드	그리드 셀	환자 이름, 시술, 메모 등 표시
빈 셀	예약 없는 시간	클릭/우클릭으로 빠른 예약 가능

카드 색상 의미¶

예약 카드는 (1) 카드 전체 배경색과 (2) 좌측 세로 바 두 가지로 상태를 표시합니다.

화면에서 바로 확인

예약노트 화면 우측 상단 ❓ 아이콘을 클릭하면 같은 색상 안내가 팝업으로 나옵니다. 매뉴얼을 찾을 필요 없이 그 자리에서 즉시 확인 가능합니다.

카드 배경색 (현재 상태)¶

배경색	상태	의미
⚪ 흰색	예약확정 / 수납대기(미수) / 부도예정	예약만 잡힌 상태 또는 진료비가 아직 미수된 상태
🟠 주황	접수	환자 내원 → 접수 완료
🟣 보라	진료	진료 중
🩷 연한 핑크	수납완료 / 내원완료	결제까지 완료된 상태
🟥 연한 빨강	부도(노쇼)	내원하지 않음
⬜ 회색	예약취소	취소된 예약

환자 흐름으로 색이 바뀝니다

흰색(예약) → 🟠 주황(접수) → 🟣 보라(진료) → 🩷 핑크(수납완료) 순서로 카드 색이 변합니다. 색만 봐도 환자가 어디까지 진행됐는지 알 수 있습니다.

좌측 세로 바 (별도 표시)¶

좌측 세로 바는 보통 배경색과 같은 상태를 표시하지만, 한 가지 예외가 있습니다.

좌측 바 색	의미
🟦 파랑	예약확정 (기본)
🟧 주황	접수
🟪 보라	진료
🩷 핑크	수납완료 / 내원완료
⬜ 진회색	수납대기 (미수)
🟥 빨강	부도
⬜ 연회색	부도예정 / 예약취소
🟩 초록	전화상담 완료된 환자 (영구 표시)

초록 좌측 바 = 전화상담 이력

🟩 초록 바는 "이 환자는 전화상담을 받았다"는 영구 이력 표시입니다. 환자가 접수 → 진료 → 수납완료로 진행되면서 카드 배경색이 변해도 좌측 초록 바는 그대로 남습니다.

주요 기능¶

시간 간격 설정¶

설정 모달에서 시간 행 간격을 변경할 수 있습니다.

10분 / 15분 / 20분 / 30분(기본) / 60분

컬럼 그룹핑¶

상단 드롭다운에서 컬럼을 어떤 기준으로 표시할지 선택합니다.

진료구분: 시술 카테고리별 컬럼
담당의: 의사별 컬럼
담당직원: 직원별 컬럼

→ 그룹을 바꾸면 같은 예약이 다른 컬럼으로 재배치됩니다.

수동 안내 문자 (알리고 SMS)¶

좌측 예약정보 패널의 발송 설정 (문자) 섹션에서 4종의 안내 SMS를 즉시 또는 예약 발송합니다.

오시는길 안내: 약도 이미지 포함 (MMS)
예약 즉시알림: 예약 확정 안내
내원전일 알림: 전일 리마인더 내용
내원당일 알림: 당일 리마인더 내용

각 항목마다 즉시 / 예약 두 버튼이 있고, 클릭하면 미리보기 모달이 열립니다.

즉시 발송: 모달에서 메시지/수신자 확인 → "즉시 발송" → 알리고 API 호출 → 발송 즉시 이력 추가
예약 발송: 모달에서 발송 시각(분 단위)을 지정 → "예약 저장" → sms_reserve에 저장 → 1분 cron 잡이 시각 도래 시 자동 발송

발송 즉시 과금

"즉시 발송"은 확인 후 알리고 SMS가 실 발송됩니다. 환자 휴대폰 번호가 비어 있으면 버튼이 비활성화됩니다. 예약 발송도 cron이 시각 도래 시 실 발송하므로 동일하게 과금됩니다.

발송 이력¶

발송 설정 섹션 바로 아래에 해당 환자의 모든 SMS 발송 이력이 표시됩니다.

일시 / 템플릿 / 상태(발송/실패/예약/취소)
자동 발송된 상담예약 알림도 함께 노출
환자 변경 시 자동 새로고침

컬럼 너비/순서 개인 저장¶

각 직원이 본인이 사용하기 편하게 컬럼 너비와 순서를 조정할 수 있고, 본인 계정에 저장됩니다.

컬럼 경계 드래그 → 너비 변경
컬럼 헤더 드래그 → 같은 그룹 내 순서 변경

자동 새로고침¶

예약노트도 다른 직원이 변경한 내용이 즉시 반영되도록 실시간 동기화됩니다.

뷰 모드¶

상단 우측의 아이콘으로 화면 표시 방식을 전환합니다.

list (목록): 시간순 리스트
grid (그리드, 기본): 시간×컬럼 표
detail (상세): 예약 카드를 더 크게 표시

예약차수 + 패키지 차감¶

좌측 예약정보 패널의 예약차수 필드는 환자가 보유한 활성 패키지에서 자동으로 표시됩니다.

표시	의미
`5-3`	5회 패키지 중 이번 예약이 3회차 (기존 2회 사용 + 이번 1회)
`보유 패키지 없음`	활성 패키지가 없어 차감 대상이 없음
`환자 선택 시 자동 표시`	환자가 아직 선택되지 않음

이 필드는 자동 표시 전용

예약차수는 보유 패키지에서 derive되어 표시만 됩니다. 직접 편집은 막혀있습니다. 오류가 있다면 환자의 패키지 보유 상태를 먼저 확인하세요.

`차감` 버튼 — 패키지 회차 차감¶

예약차수 필드 옆 📦 차감 버튼을 클릭하면 패키지 차감 모달이 열립니다.

차트 우측 RightPanel의 보유 패키지 사용과 동일한 모달 (같은 동작)
환자 미선택 시 비활성, 보유 패키지 없으면 모달이 빈 상태로 표시
차감 완료 시 예약차수 표시가 자동 갱신됨
같은 예약 건에 두 번 차감하면 서버가 거부 (409) — 자동/수동 중복 방지

자주 쓰는 동작¶

빈 셀 빠른 예약¶

빠른 예약 만들기

그리드의 빈 셀(예약 없는 시간)을 클릭
빠른 예약 모달이 열립니다
환자 검색 → 시술 선택 → 저장
예약 카드가 그리드에 표시됩니다 (안내 SMS는 좌측 발송 설정 버튼으로 수동 발송)

예약 시간 드래그 변경¶

드래그로 시간 이동

예약 카드를 클릭한 채 다른 시간/컬럼으로 드래그
자동 저장 — 변경 안내가 필요하면 좌측 발송 설정에서 수동 발송
다른 환자와 시간 겹치면 "합치기 확인" 모달

예약 카드 우클릭 메뉴¶

메뉴	동작	권한
예약 수정	예약 정보 수정 폼	🟢 모든 직원
예약 취소	status='예약취소'로 변경 (이력 보존)	🟢 모든 직원
예약 삭제	예약판에서 완전 제거	🔴 Level 1~2만
차트보기	환자 차트 진입	🟢 모든 직원
정보/수정	환자 기본 정보 수정	🟢 모든 직원
문자/카톡 발송	메시지 즉시 발송	🟢 모든 직원

예약 취소 vs 예약 삭제

취소는 status만 바뀌고 이력 보존 — 실수로 취소한 경우 복구 가능
삭제는 데이터에서 완전히 사라짐 — 복구 불가, Level 1~2 권한 필요
부도/부재 상태(내원부도·신환부재 등)는 운영 통계 보존을 위해 삭제 차단 — 화면에서 안 보이게 하려면 상태를 '예약취소'로 변경하세요

취부도 카드가 쌓여서 지저분할 때

재부도·재취소가 잦은 환자 카드를 화면에서 정리하려면:

부도/부재 카드 → 상태를 '예약취소'로 변경
⚙️ 설정 → "예약 취소 환자 숨김" 토글 ON

→ 예약취소 카드가 예약노트에서 숨겨집니다. 데이터는 보존되므로 부도율 통계·CRM 이력에는 영향 없습니다.

검색 / 엑셀 / 설정¶

상단 우측 아이콘: - 🔍 검색: 환자 이름/번호로 예약 찾기 - 📊 엑셀: 현재 보기 기준 엑셀 다운로드 - ⚙️ 설정: 시간 간격, 표시 옵션, 컬럼 표시 여부 등 - 🔄 새로고침: 최신 데이터 다시 불러오기

중복 예약 합치기¶

같은 환자에게 같은 시간/같은 진료구분 예약이 두 건 들어가면 시스템이 자동 감지하여 "합치기 확인" 모달을 띄웁니다.

→ 합치면 하나의 예약으로 통합됩니다. SMS는 별도 발송 설정에서 수동으로 보내세요.

실무 시나리오¶

시나리오 1 — 신환 상담 예약 등록 (가장 일반적)¶

좌측 메뉴 예약 → 예약노트 진입
캘린더에서 예약 날짜 선택
컬럼 모드 = "진료구분"으로 설정
신환상담 컬럼의 원하는 시간 빈 칸 클릭 → 우측 상세 패널 열림
환자 검색 → 신규 환자면 "+ 신규 등록" 버튼
담당의 + 실장 + 진료분야 입력
저장 클릭 → 그리드에 예약 카드 표시
(필요 시) 좌측 발송 설정에서 안내 SMS 버튼 클릭 → 확인 팝 → 즉시 발송

시나리오 2 — 부재 처리 후 재예약¶

환자가 예약 시간에 안 옴 → 시스템이 1시간 후 자동으로 status="부도예정"으로 전환
다음 날 06:00 "내원부도"로 자동 확정 (당일 연락 없으면)
환자가 다시 연락 와서 재예약 요청 시:
- 예약노트에서 신규 빈 칸 클릭 → 환자 검색 → 같은 환자 선택
- 새 시간 + 진료구분으로 등록
- 합치기 모달이 뜨면: "같은 시간에 ○○ 예약이 있습니다 — 합치시겠습니까?" → 일반적으로는 새 시간이라 모달 안 뜸
같은 날 다른 시간 등록 시 안내 모달 → "○월 ○일에 다른 예약 N건 있습니다" → "추가 등록" 선택

시나리오 3 — 신환부재 카드를 실장 칸으로 옮기기¶

부재 처리된 환자가 다시 내원해서 유안나 실장이 보기로 함
예약노트에서 해당 환자 카드 (신환부재 컬럼에 있음) 찾기
카드를 유안나 실장 칸으로 드래그
시스템이 자동으로 진료구분을 "신환상담"으로 변경 + 토스트 안내
카드가 유안나 실장 칸에 표시됨 (신환부재 컬럼에서 사라짐)

WI#43 — 자동 변경

신환부재 카드는 visit_type='신환상담'이 아니라 실장 칸 자동 표시 정책에서 제외됩니다. 드래그 시 시스템이 자동으로 변경 + 토스트로 안내합니다.

시나리오 4 — 내일 예약 환자 일괄 안내 SMS¶

캘린더에서 내일 날짜 선택
화면에 표시된 예약 카드 = 내일 예약 환자
우측 상단 🔍 검색 또는 엑셀로 명단 추출
또는 리콜 관리에서 "예약 D-1" 필터 → 일괄 SMS 발송

시나리오 5 — 동일 시간 중복 예약 정리¶

정합성 봇 슬랙 알림: "동일 시간 중복 예약 N건"
예약노트에서 해당 환자 검색
카드 두 개 발견 → 한쪽 카드 우클릭
예약 취소 (이력 보존) 또는 합치기 모달 활용
다음 날 06:00 봇 알림 해소 확인

시나리오 6 — 예약 시간 드래그 변경¶

환자 예약 시간 변경 요청 (예: 10시 → 14시)
예약 카드를 14시 슬롯으로 드래그
자동 저장 — 변경 안내가 필요하면 좌측 발송 설정에서 즉시알림/오시는길 SMS 버튼 수동 발송
다른 환자와 시간 겹치면 합치기 모달

자동 검증 (정합성)¶

검증 항목	자동 동작
시간 1시간 경과 미접수	status=예약확정 → "부도예정"으로 자동 전환 (cron)
다음 날 06:00 부도 확정	"부도예정" → "내원부도" 자동 처리
같은 환자/같은 시간 중복	합치기 또는 차단 모달 (work-item 42)
같은 환자/같은 날 다른 시간	"추가 등록 확인" 안내 모달 (work-item 42)
신환부재 → 실장 칸 드래그	진료구분 자동 변경 + 토스트 (work-item 43)
PR 예약취소 → CRM 동기화	consultation_reservations / consultation_visits 자동 cancel (work-item 39)

정합성 봇이 매일 06:00 점검하여 슬랙으로 알림. 자세한 처리는 정합성 점검 페이지 참고.

권한별 차이¶

기능	권한
예약 조회 / 검색 / 그룹 변경	🟢 모든 직원
빈 셀 빠른 예약	🟢 모든 직원
예약 시간/내용 수정	🟢 모든 직원
예약 취소	🟢 모든 직원
예약 삭제	🔴 Level 1~2 (실장/부원장)
컬럼 너비/순서 저장	🟢 본인 계정 단위

자주 묻는 질문¶

Q. 환자가 예약을 잡았는데 예약노트에 안 보여요. A. 다음 항목을 확인하세요. 1. 상단의 날짜가 환자 예약일과 같은지 2. 컬럼 그룹 설정(진료구분/담당의/담당직원) 때문에 다른 컬럼으로 표시되어 있는지 3. 컬럼 표시 설정에서 해당 컬럼을 숨겼는지 (설정 모달에서 확인) 4. 환자 status가 "예약취소" / "내원취소"인지 (설정에서 "취소 환자 숨김" 옵션 확인)

Q. 안내 SMS를 보내려는데 즉시/예약 버튼이 비활성이에요. A. 환자를 먼저 선택해야 하고, 해당 환자의 휴대폰 번호가 등록되어 있어야 합니다. 다른 발송이 처리 중일 때도 잠시 비활성됩니다. 환자 상세에서 휴대폰 번호 확인 후 다시 시도해주세요.

Q. 예약 발송을 했는데 언제 나가나요? A. 입력한 시각(분 단위)에 1분 cron 잡이 자동 발송합니다. 발송 이력 섹션에 status="예약(pending)"으로 표시되고, 시각 도래 시 "발송(sent)"으로 변경됩니다. 시각 전이라면 우클릭 메뉴(또는 별도 관리 화면)에서 취소 가능 — 아직 미구현이면 운영팀에 문의.

Q. 보낸 SMS 이력을 어디서 확인하나요? A. 좌측 예약정보 패널의 발송 이력 섹션에서 해당 환자의 모든 발송 기록(수동/자동 모두)을 확인할 수 있습니다.

Q. 예약 시간을 드래그로 옮겼는데 다른 직원 화면에는 안 보여요. A. 잠시 후 자동 새로고침되거나, 우측 상단의 새로고침(🔄) 버튼을 눌러주세요.

Q. 컬럼 너비를 조정했는데 다음에 들어가면 다시 원래대로 돼요. A. 컬럼 너비/순서는 본인 계정 단위로 저장됩니다. 다른 PC에서 로그인했다면 다시 조정해주셔야 합니다. 또는 브라우저 캐시 문제일 수 있습니다.

Q. 신환부재/부도예정/내원부도 카드 삭제 시 "정책상 완전 삭제할 수 없습니다" 알림이 떠요. (2026-05-13) A. 의도된 정책입니다 (시스템 보호).

이유: - 신환부재율/부도율 등 운영 통계 카운트 보존 - 신청자관리 예약 이력 추적 (lead 연결) - 재예약(부도→재예약) 흐름 운영 인사이트 추적 - 인하우스 통계 / 결제·환불 정합성

해결 방법 — 화면에서 안 보이게 하려면 삭제 대신 상태 변경:

예약노트 카드 클릭 → 우측 상세/편집 패널 → 상태를 '예약취소'로 변경 → 저장
또는 신청자관리에서 예약 상태 변경

→ 카드가 취소 컬럼으로 이동하거나 흐리게 표시, 데이터는 보존됩니다.

Q. 실장 칸 드래그가 안 됐어요. "실장 배정 변경 중 오류" 알림. A. 2026-05-13 핫픽스로 해결됐습니다. 실장 칸 드롭은 실장 배정만 전송되도록 수정 — 접수 환자도 정상 동작.