정합성 점검 13+2종 처리 안내¶
이 페이지에서 찾을 수 있는 것
정합성 봇 / 정합성 점검 / paid_amount 불일치 / 수납완료인데 미수 / 환자 중복 / 선납권 잔액 / 패키지 음수 / 환불 불일치 / 동일 시간 중복 예약 / 봇 알림 처리 / 매일 06시 알림
매일 새벽 06:00에 시스템이 자동으로 데이터 정합성 15종을 점검하고, 이상이 발견되면 슬랙으로 알림을 보냅니다. 이 페이지는 알림을 받았을 때 직원이 어디서 어떻게 처리해야 하는지 안내합니다.
권한별 분류 요약¶
| 분류 | 건수 | 처리 가능 권한 |
|---|---|---|
| 🟢 일반 직원 가능 | 8개 | level 4 OK (2, 3, 4, 5, 6, 9, 12, 13) |
| 🟡 관리자 협조 필요 | 3개 | Level 1~2 관리자 (1, 7, 11 일부) |
| 🔴 개발팀 문의 (#dev) | 2개 | UI 자체 처리 불가 (8, 10) |
| 🆕 신규 추가 | 2개 (14, 15) | 직원 + 관리자 협조 |
paid_amount 불일치 ¶
증상: 차트의 paid_amount와 실제 결제(payments) 합계가 안 맞음.
처리 방법: 1. 환자 차트 진입 → 우측 "수납" 버튼 2. 결제 항목 목록에서 잘못된 결제 식별 3. 누락이면 "+ 결제 추가" / 잘못된 결제는 우측 ✕ 삭제 (결제 삭제는 level 3) 4. 차트 새로고침 → paid_amount 자동 재계산 확인
수납완료인데 미수 ¶
증상: 예약 status='수납완료'인데 차트 청구액 > 실수납액
처리 방법 (3가지 중 택1): - A. 환자 카드 우클릭 → "수납 관리" → 잔여 결제 추가 - B. 차트 → 오더 항목 정정 (단가/수량 수정) - C. 환자 카드 우클릭 → status를 "수납대기"로 변경
💡 협찬 차트는 제외:
진료구분='협찬'은 수납액 0원(정가만 표시, 실제 결제 없음)이 정상이라 이 알림에서 자동 제외됩니다.
수납대기인데 완납 ¶
증상: 결제 끝났는데 status가 '수납대기'
처리 방법: 1. 현황판 또는 예약노트에서 환자 카드 우클릭 2. "수납완료" 선택 → 자동 저장
관련 매뉴얼: 현황판
선납금/포인트 잔액 마이너스 ¶
증상: patient_prepaid_balance.prepaid_balance 또는 point_balance < 0
처리 방법: 1. 환자 차트 → "패키지/선납권" 탭 2. 충전/사용/환불 이력 시간순으로 확인 3. 잘못 입력된 사용/환불 이력 → "취소" 버튼 4. 잔액 0 이상 정상화 확인
⚠️ 정상 환불을 잘못 취소하면 잔액 다시 늘어남.
관련 매뉴얼: 패키지/선납권
초과 결제 ¶
증상: 차트 paid_amount > total_amount
처리 방법 (2가지): - A. 차트 → 수납 팝업 → 해당 결제 → "환불" 버튼 → 초과액 입력 - B. 차트에 누락된 시술 오더 추가하여 청구액 보정
담당의사/담당직원 기본값 ¶
증상: 차트 doctor='담당의사' 또는 staff='담당직원' (기본값) 그대로
처리 방법: 1. 차트 진입 → 상단 "담당의사" / "담당직원" 드롭다운 2. 실제 담당자 선택 → 자동 저장
관련 매뉴얼: 차트(진료실)
환자 중복 ¶
증상: 같은 이름 + 같은 휴대폰 번호로 환자 2명 이상 등록
처리 방법: 1. 환자관리 > 환자 검색 → 이름/번호 검색 2. 동명이인 목록 → 각 환자 클릭 → 차트/예약/결제 활동 확인 3. 활동 없는 빈 환자만 식별 (활동 있는 환자는 절대 삭제 금지) 4. 빈 환자 체크박스 선택 → "선택환자 삭제" (Level 1~2 관리자 권한 필요)
둘 다 활동 있는 경우 (병합 필요): 🔴 #dev 문의
선납권 잔액 불일치 ¶
증상: 캐시 잔액 ≠ 이력 합산 (예: "캐시=2,000,000 계산=3,800,000 차이=1,800,000")
처리 방법 (🔴 자체 처리 불가): - 단순 캐시 누락이 아니라 이력 정정이 필요한 복잡 케이스 (실 사례에서 확인) - 슬랙 #dev 채널에 다음 정보 전달: 1. 환자 이름 + chart_no 2. 봇 메시지의 캐시/계산/차이값 (스크린샷) 3. 발생 시점 4. 인지한 결제/환불 흐름
관련 매뉴얼: 패키지/선납권
패키지 음수 회차 ¶
증상: patient_packages.remaining_sessions < 0
처리 방법: 1. 환자 차트 → "패키지" 탭 → 해당 패키지 클릭 2. 잘못 사용된 회차 이력 → "취소" 버튼 3. used_sessions 자동 감소 → remaining_sessions 0 이상 정상화
관련 매뉴얼: 패키지/선납권
환불 상태/금액 불일치 ¶
증상: status='refunded'인데 refund_amount=0 (코드상 발생 거의 불가)
처리 방법 (🔴 자체 처리 금지): - "환불 버튼" 재호출 시 이중 환불 위험 - 슬랙 #dev에 결제ID + 환자 이름 + 결제일 + 실 환불액 전달
관련 매뉴얼: 수납 처리
:material-numeric-11-circle: 접수/진료 방치 ¶
증상: 과거 날짜 + status='접수' 또는 '진료' + 청구/수납 금액 있음
처리 방법 (3가지): - A. 실제 수납했으면 → 차트에서 수납 추가 + status를 "수납완료"로 - B. 환자 결제 안 하고 귀가 → 상담실장에게 미수 회수 요청 + status를 "수납대기"로 - C. 차트 자체가 잘못 만들어졌으면 → 차트 삭제 (Level 1~2 필요)
💡 협찬 차트 마감:
진료구분='협찬'은 실제 결제가 없어(수납 0원) 진료 상태에 머물기 쉽습니다. 이 알림에서 자동 제외되며, 진료 끝난 협찬 차트는 환자 카드 우클릭 → "수납완료"로 직접 마감하세요. (협찬은 미수금이 있어도 수납완료 변경이 통과됩니다 — 정상 흐름)
:material-numeric-12-circle: 동일 시간 중복 예약 ¶
증상: 같은 환자가 같은 시간/같은 visit_type에 2건 이상 예약
처리 방법: 1. 예약노트 → 해당 날짜로 이동 2. 같은 시간 같은 환자 중복 카드 식별 3. 잘못된 카드 우클릭 → "예약 취소" 또는 "삭제" 4. 한 건만 남기기
관련 매뉴얼: 예약노트
:material-numeric-13-circle: 차트에 선납권 패키지 혼입 ¶
증상: 차트 오더에 "선납권 Standard/Gold/VIP" 등 항목 포함 → 매출 이중집계 위험
처리 방법: 1. 환자 차트 진입 2. 오더 목록에서 "선납권" 명칭 항목 식별 3. 해당 오더 우측 ✕ 삭제 4. 차트 저장 → total_amount 정상화 확인
14. 수납됐는데 시술 기록 없음 ¶
증상: paid_amount > 0인데 차트 오더 0건 (수납했는데 시술 기록 없음)
처리 방법: - 환자 차트 진입 → 누락된 시술 항목(오더) 추가 후 저장 - 또는 결제가 잘못된 거면 결제 정정 (실장/관리자 협조)
15. 선납권 차감했는데 시술 기록 없음 ¶
증상: patient_prepaid usage 있는데 차트 오더 0건 (선납권 차감했는데 시술 기록 없음)
처리 방법: - 환자 차트 진입 → 누락된 시술 항목 추가 - 또는 선납권 사용 취소 후 재처리
20. 차트 작성된 환자 중 담당 실장 미배정 ¶
증상: 최근 14일 차트 작성된 환자 중 progress_notes.staff + patient_reservations.assigned_staff + inhouse_consult.assigned_counselor_name 3 컬럼 모두 빈값/NULL
원인 패턴: 1. 직원/관계자 환자 (상담 실장 없는 정상 케이스) — 자동 발송 제외되어야 함 2. 운영 입력 누락 — 차트 작성 시 staff 미선택 3. 외부인 무료 쿠폰 + 추가 시술 케이스
자동 차단: WI#54 자동 발송 배치(customerMgmtAutoBatch)는 auto_send=1 룰에서 staff 매칭 안 된 환자 자동 제외 → 직원/관계자에게 마케팅 SMS 발송 위험 없음
처리: 1. 알림 받은 환자 목록 확인 2. 차트 진입 → 담당 실장 선택 후 저장 (실수 누락인 경우) 3. 직원/관계자/외부 쿠폰 케이스이면 그대로 두기 (자동 발송 자동 제외)
관련 매뉴얼: 고객관리
19. 콜내역 20분 내 동일 메모 반복 ¶
증상: 같은 환자(lead_id)에 같은 콜내역 메모가 20분 내 두 번 이상 입력됨 (단, '부재' 무응답은 제외)
원인: ① [콜내역 입력] 버튼을 짧은 간격으로 다시 눌러 동일 메모 재입력, 또는 ② 같은 내용을 실수로 두 번 입력
중복 차단 가드 (WI#107, 2026-05-21 적용): - 백엔드 1분 내 동일 (lead_id, content) INSERT 차단 (더블 클릭 방지) - 1~20분 사이 재통화는 정상으로 허용 (예: 전화 → 무응답 → 잠시 후 재통화) - 본 알림(20분 창)은 그 사이 동일 메모 반복을 참고용으로 보여주는 모니터링입니다
💡 '부재'(무응답) 재통화는 제외됩니다. 무응답 후 몇 분 뒤 다시 거는 건 정상이고 메모("부재")가 같을 뿐이라, 알림에서 빠집니다.
봇 알림 받았을 때 (운영자 검토): 1. 표시된 lead/환자명/메모 preview 확인 2. 실수로 같은 메모를 두 번 입력한 것이면 → [신청자관리] 상세에서 중복 콜내역 1건 삭제 3. 실제로 두 번 통화한 정상 건이면 → 그냥 무시 (다음날 알림에서 자동 제외) 4. 같은 패턴이 계속 대량 발생하면 → #dev 슬랙에 문의
관련 매뉴얼: 신청자관리
처리 흐름 요약¶
1. 새벽 06:00 정합성 봇 슬랙 알림 도착
2. 메시지에 적힌 환자/차트 정보 확인
3. 위 13+2종 매뉴얼 참조하여 직접 처리
4. 다음날 06:00 봇 점검에서 자동 사라짐
💡 처리하다가 막히면 #dev 슬랙 채널에 문의해주세요. 데이터 손실 우려가 있으면 반드시 자체 처리 시도 전에 문의를 우선합니다.
실무 시나리오¶
시나리오 1 — 매일 아침 봇 알림 일괄 처리 (가장 일반적)¶
- 09:00 출근 → 슬랙 #dev 채널 확인
- 06:00에 도착한 정합성 봇 메시지 검토
- 권한별 분류 확인:
- 🟢 직원 가능 항목 → 본인 또는 데스크가 처리
- 🟡 관리자 협조 → 실장/원장에게 요청
- 🔴 개발팀 → #dev에 차트번호 + 증상 첨부
- 각 항목별 매뉴얼 링크 따라 처리
- 다음 날 06:00 봇 재점검 → 알림 해소 확인
시나리오 2 — "수납완료인데 미수" 알림 (#2) 처리¶
- 봇 메시지: "수납완료인데 미수 N건"
- 환자명/차트번호 확인 → 환자 검색 또는 현황판
- 환자 카드 우클릭 → "차트보기"
- 우측 상태 드롭다운에서 "수납대기"로 변경 + 저장
- 또는 잔금을 수납 팝업에서 추가 결제 받아 "수납완료" 유지
시나리오 3 — "환자 중복" 알림 (#7) 처리 (관리자 권한)¶
- 봇 메시지: "환자 중복 N건 — 김호영(010-2540-0897) 4명"
- 환자관리 → 환자 검색으로 김호영 검색
- 4명 모두 클릭하여 차트/예약/결제 활동 확인
- 빈 환자(차트 0건) 체크박스 선택 → "선택환자 삭제" (Level 1~2 관리자)
- 활동 있는 환자가 둘 이상이면 → slack #dev 채널에 chart_no 전달 (병합 요청)
- 자세한 흐름은 중복환자 정리 참고
시나리오 4 — "동일 시간 중복 예약" 알림 (#12) 처리¶
- 봇 메시지: "동일 시간 중복 예약 N건"
- 예약노트에서 해당 환자 검색
- 같은 시간/같은 환자 카드 두 개 발견
- 한쪽 카드 우클릭 → "예약 취소" (이력 보존) 또는 합치기 모달 활용
- 다음 날 06:00 봇 알림 해소 확인
시나리오 5 — "선납권 잔액 불일치" 알림 (#8) 처리 (개발팀)¶
- 봇 메시지: "선납권 잔액 불일치"
- 즉시 자체 처리하지 마세요. 잘못 건드리면 매출 정합성 깨짐
- slack #dev 채널에 다음 정보 전달:
- 환자 chart_no
- 봇 메시지 전문
- 현재 환자가 진료 중인지 (대기 중이면 우선순위 높음)
- 개발팀이 데이터 검토 후 보정
자주 묻는 질문 / FAQ¶
Q. 봇 알림이 매일 같은 환자로 떠요
어제 처리가 누락됐거나, 처리 후 다시 같은 패턴이 발생한 것입니다. 환자 차트/결제 이력을 다시 확인하고 어떤 흐름에서 재발했는지 파악 → #dev에 패턴 보고 (재발 방지 fix 필요).
Q. 봇 메시지를 못 봤어요. 어디서 다시 볼 수 있나요?
슬랙 #dev 채널 검색 → 키워드 "정합성" 또는 "WI#" 검색. 또는 봇이 매일 같은 시간(06:00)에 메시지 보내므로 다음 날 새 메시지 확인.
Q. 권한이 없어서 #2번 처리 못 해요
각 항목별 권한 표시(🟢/🟡/🔴) 확인. 🟢인데 권한 부족이면 먼저 부서 매니저에게 권한 요청. 🟡/🔴이면 실장/관리자/개발팀에 즉시 요청.
Q. "처리했다"고 보고하면 어떻게 확인하나요?
다음 날 06:00 봇이 자동으로 재점검. 알림에서 해당 환자/케이스가 사라지면 처리 완료. 사라지지 않으면 처리가 부분적이었거나 다른 정합성 이슈 발생한 것.
Q. 환자 데이터를 잘못 변경하면 복구 가능한가요?
감사로그(/settings/logs)에 변경 이력 보존. Level 1~2 관리자가 이력 확인 가능. 단 결제 데이터는 정합성에 직접 영향이라 #dev 즉시 문의 권장.
Q. 정합성 봇을 끌 수 있나요?
봇은 데이터 무결성 보호 핵심이라 끄지 않습니다. 알림이 너무 잦으면 #dev에 패턴 보고 → 봇 정확도 개선 작업.