05. 도메인 모델 (as-is) — 닥터팔레트에서 관찰한 엔티티·열거값·상태 머신

상태: 통합본 v1 (2026-09-30) · 작성: S4 통합 목적: 닥터팔레트 공개 자료(제품소식·고객사례·기능 페이지·매뉴얼 영상 프레임)에서 관찰된 데이터 구조를 한곳에 모은다. 우리 앱의 to-be 모델(docs/design/domain-model.md)을 확정하기 직전의 근거 자료다. 범위: 엔티티·필드·열거값·상태 머신을 다룬다. 규칙은 06-business-rules.md, 흐름은 04-workflows.md에 있다.

표기

• 확신도: 확인 = 화면·원문에 직접 보인다 / 추정 = 정황으로 판단했다 / 미확인 = 자리만 보이고 내용은 모른다.
• 출처 태그: A1~A6 = 텍스트 분석 파일, V1~V9 = 매뉴얼 영상 분석 파일, V#:영상-초 = 프레임, news#idx = 제품소식 게시글 번호.
• 필드명은 구현 관점에서 영문 camelCase로 옮겼다. 괄호 안은 화면에 보인 한글 라벨이다.
• 버전 표기: v2.4 = 2022-09 매뉴얼 영상(V1~V8), 2024 = 플래너 개편(news#124177982), 2025 = 2025 화면(A3·A4·A6).

0. 전체 구조 한눈에

닥터팔레트의 데이터는 환자(Patient) — 내원(Visit) — 차트 칸들을 축으로 도는 구조다. 예약(플래너)은 내원 앞에, 수납·문서·청구는 내원 뒤에 붙는다. 원내 동선은 내원의 위치(대기열) × 상태 두 축으로 표현한다 [A1 구현 시사점, V3 R17].

erDiagram
  Hospital ||--o{ Member : "소속(멀티 병원)"
  Hospital ||--o{ Room : "대기열·공간"
  Hospital ||--o{ Patient : owns
  Patient ||--o{ PatientTagLink : tags
  Patient ||--o{ FamilyLink : family
  Patient ||--o{ ConsentRecord : consents
  Patient ||--o{ IdentityVerification : "본인확인"
  Patient ||--o{ EligibilityCheck : "자격조회"
  Patient ||--o{ PatientNote : "환자기록 스레드"
  Patient ||--o{ Plan : "예약(플랜)"
  PlanCategory ||--o{ Plan : "열·색"
  Schedule ||--o{ SchedulePeriod : "기간 규칙(v2.4)"
  Schedule ||--o{ Plan : "슬롯(v2.4)"
  Plan |o--o| ChartDraft : "차트 초안"
  Plan |o--o| Visit : "접수 전환"
  ExternalBooking |o--o| Plan : "네이버·구글·여신"
  ReceptionRequest |o--o| Visit : "태블릿 접수신청"
  Patient ||--o{ Visit : visits
  Visit ||--o{ QueueEntry : "위치×상태 이동"
  Room ||--o{ QueueEntry : hosts
  Visit ||--o{ ChartSection : "역할별 기록 칸"
  Visit ||--o{ Diagnosis : "상병"
  Visit ||--o{ OrderLine : "진단 및 처방"
  Visit ||--o{ Task : "할 일"
  Visit ||--o{ VisitImage : "≤30장"
  Visit ||--o{ VitalSign : "임상관찰"
  Visit ||--|| Charge : "진료비 산정"
  Visit ||--o{ Payment : "수납·환불"
  Visit ||--o{ IssuedDocument : "문서발급"
  Visit ||--o{ CouponApplication : "쿠폰"
  Patient ||--o{ PointLedger : "포인트"
  Patient ||--o{ PrepaidLedger : "선납금"
  TicketProduct ||--o{ PatientTicket : "판매"
  Patient ||--o{ PatientTicket : owns
  PatientTicket ||--o{ TicketUsage : "회차 차감"
  OrderLine |o--o| TicketUsage : "사용 오더"
  Visit ||--o{ MessageDispatch : "접수 안내"
  Plan ||--o{ MessageDispatch : "예약 알림"
  ClaimBatch ||--o{ ClaimStatement : "명세서"
  Visit ||--o{ ClaimStatement : "원천"

1. 테넌시·조직·권한

권한 매트릭스(2025, 관찰된 세부 동작) [A4 권한 — 확인]

• 한 사용자가 여러 역할을 갖는지, 기본권한이 신규 멤버 기본값인지는 추정이다.
• AI 상담 녹취 기록은 병원 관리자 + 해당 상담실장 본인만 열람한다(레코드 단위 접근 정책) [A3 "닫힌 기록" — 확인(원문)].

2. 병원 설정 마스터

Room.kind(관찰값): 진료실(담당의 연결) · 상담실 · 레이저실/시술실 · 진료지원 · 검사실/방사선실 · 수납실 · 접수실 · 태블릿접수(가상 — 유입 채널이 대기열처럼 보임) [V1, V9 위치 그룹, A3 원내 운영].

3. 환자

3-1 Patient

3-2 환자 부속

3-3 환자기록(직원 스레드)

• 환자기록은 방문과 무관하게 환자 단위로 누적된다 [A1]. 접수 모달·예약 모달의 주요기록/최근기록(최근 10건)에 재노출된다 [V1 F6, A2 접수 모달].

4. 예약 — 두 세대의 모델

닥터팔레트 예약은 두 모델이 공존·교체됐다. 우리 설계는 이 차이를 알고 골라야 한다.

VOC 표에 "슬롯 구간에 묶이지 않는 자유 시간 예약", "시작·종료 시간 설정", "플래너 시간 간격 변경"이 반영 항목으로 있다 → 슬롯 모델에서 자유 시간 모델로 의도적으로 옮겼다(확인, A2 플래너).

4-1 v2.4 스케줄 모델 [V5·V6 — 확인]

4-2 Plan(예약·업무 플랜) — 2024~2025 통합

ReservationStatus 상태 머신(2025 플래너 기준) [A3 플래너, A6 S20, A2 네이버 — 확인 / 전이 조건 일부 추정]

stateDiagram-v2
  [*] --> 요청 : 외부 채널 유입(네이버·구글·여신)
  [*] --> 확정 : 내부 등록(데스크·코디)
  요청 --> 확정 : 확정(수동 / 상품별 자동확정)
  요청 --> 거절 : 거절(모두 거절·개별)
  확정 --> 접수 : 내원 접수(태블릿·데스크)
  확정 --> 취소 : 예약취소(사유) / 노쇼
  요청 --> 취소 : 외부 취소 동기화(추정)
  접수 --> 완료 : 진료·수납 종료(추정: 내원 완료)
  취소 --> 확정 : 복구(미확인)
  확정 --> 삭제 : 플랜 삭제(권한 '플랜 삭제')
  완료 --> [*]
  거절 --> [*]

• v2.4 목록 탭은 예약 / 접수 / 예약취소(+전체)뿐이었다 [V5 R10]. 2024-10 초기 카드 접두어는 대기 · 방문 · 취소 · 요청 · 업무였다가 2025-02부터 요청 · 확정 · 접수 · 완료 · 취소로 정리됐다 [A2, A4].
• 노쇼는 독립 상태가 아니라 **취소 + 사유 칩(취소:노쇼)**으로 표현된다 [A2 — 확인]. 지각은 색 규칙 트리거로만 보인다 [A4].
• 삭제는 취소와 구분되는 영구 삭제(VOC "예약 영구 삭제")이며 로그에 남는다 [A2].

4-3 외부 예약 채널

5. 접수·내원·대기열

5-1 Visit(접수 = 내원)

5-2 QueueEntry(위치 × 상태)

QueueStatus(배지 색) [V1 R15, V9, A2, A3 — 확인]

Visit/Queue 상태 머신 [A1 동선, V3 R17, V9, A3 — 확인, 보류는 우리 초안에만 있음]

stateDiagram-v2
  [*] --> 접수신청 : 태블릿·앱 셀프 접수(룸=태블릿접수)
  [*] --> 대기 : 데스크 접수(첫 상태 선택, 기본 대기)
  [*] --> 우선대기 : 데스크 접수(첫 상태=우선대기)
  접수신청 --> 대기 : 원무 확인·룸 배정
  대기 --> 우선대기 : 우선대기 지정
  우선대기 --> 대기
  대기 --> 진행중 : 진행하기 / 행 클릭
  우선대기 --> 진행중
  진행중 --> 대기 : 보내기(다른 룸, 맨 뒤)
  대기 --> 대기 : 보내기(룸 이동)
  진행중 --> 완료 : 병원에서 내보내기(귀가)
  대기 --> 완료 : 병원에서 내보내기
  완료 --> [*]

• 보내기 = (다음 위치, 상태)를 한 번에 바꾼다. 현재 위치와 같은 목적지는 비활성 [V3 S5, V9 — 확인].
• 대기 보드 대기 N = 필터로 고른 룸들의 인원 합(진행중·우선대기 포함) [V1 R14].
• 초기 접수 상태를 사람이 고른다: 대기열* [진료실1▾][대기▾] [V1 R8].

5-3 ReceptionRequest(접수신청) / SelfCheckIn

6. 차트

OrderLine.kind(행 아이콘으로 구분) [V9, V3, A3 — 확인]: 진찰료/관리료(수가) · 약 · 주사 · 처치/행위 · 검사(영상·검체) · 치료재료 · 문서 · 예방접종 · 코드 오더(MS002 원내투약 주사제) · 지시·메모(가루약 처방) · 티켓 구매 / 티켓 사용.

Task 상태 머신 [A3 — 확인]

stateDiagram-v2
  [*] --> 대기 : 수동 등록 / 오더 추가 시 자동 등록(설정 ON)
  대기 --> 진행중 : 시작(경과시간 표시)
  진행중 --> 완료 : 완료(소요시간·완료시각 기록, 취소선)
  대기 --> 완료
  대기 --> [*] : 삭제

7. 라이브러리(마스터)

8. 수납·원무

8-1 진료비·수납

수납(내원 단위) 상태 — 닥터팔레트는 명시 상태 배지를 보여주지 않고 남은 금액으로 판단한다(추정 상태 머신).

stateDiagram-v2
  [*] --> 미수납 : 오더 발생(받을 금액>0)
  미수납 --> 부분수납 : 수납 추가(합계 < 받을 금액)
  부분수납 --> 완납 : 남은 금액 = 0 (+수납 추가 버튼 숨김)
  미수납 --> 완납
  완납 --> 부분수납 : 오더 추가로 받을 금액 증가 / 환불
  부분수납 --> 미수 : 귀가(내보내기) 후에도 잔액 > 0 → 미수 목록
  미수 --> 완납 : 나중 날짜 수납(통계는 수납일 기준)

8-2 쿠폰·포인트·선납금 (2025)

8-3 티켓(회차권)

PatientTicket 상태 머신 [A3 — 확인(탭·버튼) / 만료 처리 미확인]

stateDiagram-v2
  [*] --> 사용중 : 구매 오더 수납
  사용중 --> 사용중 : 칩 클릭(사용 n/N) · 기간 연장
  사용중 --> 완료 : usedCount = totalCount
  사용중 --> 환불 : 우클릭 '티켓 환불'(금액 수동)
  사용중 --> 만료 : expiresAt 경과(처리 방식 미확인)
  완료 --> [*]

9. 문서·전자서명

IssuedDocument 상태: (오더·자동 생성) 미발급 → 발급(번호 부여·확정) → 출력(인쇄/PDF, 반복 가능). 전체 발급 후 헤더 버튼이 전체 출력으로 바뀐다 → 발급과 출력은 별개 [V3 R13 — 확인(버튼) / 분리 해석 추정].

10. CRM·메시지

MessageDispatch 상태 머신 [V6·A1 — 확인(3색 배지) / 대체발송 판정 추정]

stateDiagram-v2
  [*] --> 예약됨 : 트리거 발생(즉시) / 리마인더 시각 도래 대기
  예약됨 --> 발송중 : 발송 시각
  발송중 --> 발송성공 : 알림톡 성공(과금)
  발송중 --> 발송실패 : 실패(과금 제외)
  발송실패 --> 대체발송 : 카카오 미사용·실패 → SMS/LMS(fallbackOf)
  대체발송 --> 발송성공
  예약됨 --> 취소 : 예약 취소·CRM 제외 체크(추정)

11. 청구(보험)

A5는 여기에 코드 기간 버전·규칙 엔진·명세서 상세(E-01~E-38)를 제안한다 — 우리 P3 범위다.

ClaimBatch 상태 머신 [V8 — 확인]

stateDiagram-v2
  [*] --> 생성중 : 원청구서 생성(비동기 수집)
  생성중 --> 작성중 : 수집 완료(건수·금액 채움)
  작성중 --> 작성중 : 제외(즉시 반영) · ↻ 재생성·재집계
  작성중 --> 발급완료 : 발급하기(확인창 없음, 청구번호·.ghp)
  발급완료 --> 발급완료 : 내려받기(재다운로드)
  작성중 --> [*] : 원청구서 삭제
  발급완료 --> [*] : 원청구서 삭제(발급 후에도 가능)

12. 통계·경영(저장 모델 관찰)

통계 기준일(추정, V4 §8): 매출 = 진료일, 수납 = 수납일, 미수 = 진료일. 객단가 = 매출 ÷ 진료횟수(접수 건).

13. 우리 설계 초안(docs/design/domain-model.md v0.1)과의 차이·누락

판정: 반영됨 = 초안이 이미 담음 / 차이 = 초안과 관찰이 다름(결정 필요) / 누락 = 초안에 없음. 우선순위는 mvp-scope.md 기준(P1 MVP · P2 · P3). "권고"는 구현 직전 확정안 제안이다. 초안은 수정하지 않았다(읽기 전용).

13-1 차이 — 모델 형태가 다른 것 (결정 필요)

13-2 누락 — 초안에 없는 엔티티·필드

13-3 초안에만 있는 것 (닥터팔레트에서 관찰 안 됨 — 유지 판단)

출처 파일

• 텍스트 분석: A1_news_2022_2023.md(외래접수·환자기록·수납·CRM·동선·태블릿·구현 시사점), A2_news_2023_2024.md(본인확인·접수 모달·수납 패널·네이버·플래너·차트 초안·CRM 규칙·CID·권한), A3_news_2025_2026.md(접수 모달·쿠폰·포인트·티켓·플래너·파트너사·메디톡·만족도·통합뷰·할 일·녹취 동의), A4_customer_stories.md(①·②·모듈별·권한 매트릭스·IP 제한), A5_billing_rules_and_market.md(②·③·1-5·1-7·4-4), A6_feature_pages_ui.md(S12·S16·S19·S20·S23·S24·S26~S29)
• 영상 분석: V1_reception_treatment.md, V2_chart.md, V3_dxrx_documents.md, V4_stats_insight.md, V5_reservation_crm_part1.md, V6_reservation_crm_part2.md, V7_library.md, V8_claims.md, V9_intro.md — 각 '도메인 규칙·데이터' 절
• 비교 대상: docs/design/domain-model.md(v0.1), docs/product/mvp-scope.md