데이터 · 규칙 — 산후조리원 CRM 데모 「한달품」(가상)

화면 · 기능은 screens.md · requirements.md 가 이 문서의 엔티티 · 상태 이름을 그대로 쓴다. 값은 모두 가상이다.

1. 원칙

• 다지점: 업무 레코드는 모두 branchId 를 가진다. 본사 역할만 지점 필터 「전체」를 쓴다. 지점 사이 조회는 서버 정책으로 막는다(데모는 localOnly 저장소가 같은 규칙을 흉내 낸다).
• 금액은 원 단위 정수다. 통화 · 시간대(Asia/Seoul)는 화면 언어와 무관하게 고정한다(S-18).
• 주민등록번호 칸은 두지 않는다. 종이 서식에는 있지만 데모에서는 쓰지 않는다. 실서비스의 수집 근거 · 암호화는 실서비스 설계에서 다룬다.
• 의료 판단 없음: 바이탈 · 황달 · 체중은 기록과 추이만 보여 준다. 정상/이상 판정이나 권고를 내지 않는다.
• 결정적 시드: seed 1274, 기준 시각 2026-01-15T09:00:00+09:00(목요일).

2. 엔티티

3. 열거형

4. 규칙

4.1 요금

정가        = PricePlan(룸타입, 기간).정가
할인        = 당일계약(상담 당일 계약일 때)
            + max(지인 · 제휴병원 · 재이용 중 하나)        ← 서로 중복 불가
            + 에스테틱 완불(코스 5회 이상 완납, 룸타입별)  ← 중복 가능
추가        = 다둥이 추가 요금(기간별) + 보호자 식사 × 회수 + 기타
총액        = 정가 − 할인 + 추가
계약금      = PricePlan.계약금(총액의 10% 기준 정액표)
잔액        = 총액 − 받은 금액 합계

화면은 줄 단위 내역(정가 · 할인 각각 · 추가 · 총액)을 보여 준다 — 종이 상담신청서에서 총금액 아래 할인을 손으로 빼 적던 일을 대신한다. 상담 때 안내한 최종 금액은 「확정금액」으로 예약에 고정되고, 이후 변경은 내역 줄과 변경 이력으로 남는다. 임신 주수는 예정일 − 280일을 수태 기준으로 기준 시각까지 센 값이다(표시 전용 계산값). 기간을 바꾸면 박수로 다시 계산하고, 위약금 10% 를 줄로 더한다.

데모 요금표(가상 값, 만 원):

입실 제한: 재태기간 37주 이하 또는 출생 체중 2.5kg 이하 신생아는 입실 불가 — 예약 화면에 경고를 띄우고, 이 사유의 취소는 계약금 전액 환불로 분기한다.

4.2 해지 · 환불

종이 환불신청서의 「환불 규정 안내」 표(소비자분쟁해결기준 형식)를 그대로 규칙으로 옮긴다.

• 계약금이 총액의 10% 를 넘으면 넘는 금액은 먼저 전액 환급하고, 나머지에 위 비율을 적용한다.
• 이미 받은 서비스(산전 마사지 · 프로그램)는 회당 차감액을 뺀다(데모 값: 산전 40분 10만 원, 산후 60분 25만 원).
• 계산 결과 화면에는 적용한 행 · 일수 · 차감 줄을 모두 보여 주고, 원장이 확인하면 환불신청서 문서를 만든다(지급은 모의).

4.3 마사지 회차

• 계약에 포함된 서비스 회차는 SessionBucket(출처=서비스) 로 만든다. 산전 서비스는 입실일이 지나면 소멸한다.
• 산전 → 산후 전환은 기본 불가. 「진단서 확인」 표시가 있을 때만 전환 버킷을 만든다.
• 코스 구매는 SessionBucket(출처=코스) 를 만들고, 결제 시점(상담 당일 계약금 · 완납)에 따른 보너스 회차를 따로 만든다.
• 관리를 완료하면 지정한 버킷에서 1회 차감한다. 노쇼는 차감, 취소는 복원(규칙은 지점 설정).
• 퇴실 뒤에도 남은 회차로 예약할 수 있다 — 마사지 플래너는 「재실 산모」와 「퇴실 고객」을 함께 보여 준다.

4.4 업무일지 자동 집계

마감 기준(당일 17시)은 지점 설정이다. 작성자가 비고를 더하고 제출하면, 본사는 원본을 다시 정리하지 않고 그대로 열람하고 확인 표시를 한다.

4.5 통계

• 월별 장부: 예약 · 입실 · 해지 · 매출(결제 수단별) · 미수금.
• 상담 전환: 유입경로별 상담 → 예약 전환율.
• 객실 가동률: 사용 객실·박 ÷ 가용 객실·박(지점 · 월).
• 재방문: 재입실 산모 비율.

5. 데이터 분류 (S-18)

예외: 환불 규정 · 개인정보 동의처럼 법정 성격의 문구는 화면 언어로 번역해 보여 주되, 한국어 원문 보기를 함께 둔다(docs/locale-data.md 에 필드별로 기록 — 구현 단계).

6. 데모 세계(시드)