요구사항 — 산후조리원 CRM 데모 「한달품」(가상)

공개 설계 요약이다. 화면 · 권한 · 상태 머신은 screens.md, 데이터 · 규칙 · 시드는 data.md. 데모의 모든 사람 · 지점 · 금액 · 기록은 가상이다.

1. 요약

「한달품」은 지점 세 곳을 운영하는 가상의 산후조리원 체인이다. 센터 콘솔 하나로 다음을 처리한다.

종이 상담신청서 · 엑셀 월별 대장 · 수기 건강기록부 · 팩스로 보내는 업무일지 · 법인 휴대폰 단체 문자로 돌아가던 일을 한 화면 흐름으로 옮긴 데모다. 서버 없이(localOnly) 동작하고 실제 의료 판단 · 결제 · 발송은 하지 않는다. 모든 기록은 가상 시드다.

3분 투어 한 줄 요약: 데스크 태블릿으로 새 산모가 상담신청서를 쓰면 상담실장 콘솔에 바로 뜬다. 그 자리에서 VIP 2주 요금을 할인과 함께 계산하고 계약금을 카드와 지역화폐로 나눠 받는다(모의). 객실을 배정하고 간호사 · 신생아실 · 에스테틱으로 역할을 바꿔 입실 체크인 · 수유 기록 · 마사지 회차 차감을 한다. 원장은 다른 예약의 해지 환불을 규정대로 자동 계산하고, 대표는 본사 화면에서 세 지점의 오늘 숫자를 본다.

3. 목표 · 성공 지표 · 비목표

목표

  1. 체험자: 산후조리원 대표 · 원장 · 상담실장이 3분 안에 상담 → 예약 → 입실 → 기록 → 정산 → 본사 보고가 한 흐름으로 이어지는 것을 확인한다.
  2. 재사용: 다지점 권한 · 환불 규칙 엔진 · 자가 입력 서명 · 시간 격자 기록은 다른 숙박형 · 케어형 고객 프로젝트에도 쓴다.

성공 지표

지표 정의 목표
데모 투어 완료 3분 투어 11단계를 BDD 로 끝까지 통과 100%
첫 화면 Pages /app/ 첫 의미 있는 화면 4초 이내(데스크톱 · 캐시 없음)
업무 네트워크 정적 자산 외 요청 0건
권한 회귀 역할 7 × 화면 20 노출 행렬 시험 기대와 100% 일치
환불 규칙 경계값(24시간 · 10/11 · 30/31 · 60/61 · 90/91일 · 입소 후) 시험 전부 통과

비목표

4. 페르소나 (모두 가상)

페르소나 목표 불편 데모에서 확인하려는 것
대표 서지원(본사) 세 지점의 상담 · 예약 · 매출을 그날 안다 팩스 업무일지를 다시 정리해야 숫자가 나온다 지점 비교 · 업무일지 열람이 실시간인가
원장 문하린(물결점) 해지 · 환불을 규정대로 빠르게, 기록 누락 없이 환불 계산 · 서류가 수작업이다 규칙 자동 계산 · 확인 한 번으로 서류가 나오는가
상담실장 윤채원 상담 → 계약을 놓치지 않고, 같은 정보를 두 번 쓰지 않는다 종이 · 엑셀 · 휴대폰 문자가 흩어져 있다 신청서 → 카드 → 요금 → 결제 → 메시지가 이어지는가
간호사 임소율 입실 서류와 산모 기록을 빠르게 서류 묶음 보관 · 1일 2회 기록 체크인 단계 · 바이탈 입력이 태블릿에서 쉬운가
신생아실 정다온 근무조마다 수유 · 배설 · 점검을 남긴다 24시간 종이 격자 · 확인 서명 격자 입력 · 일 합계 · 확인 서명이 자연스러운가
에스테틱 백서아 산전 · 산후 · 퇴실 후 관리 회차를 정확히 회차 · 소멸 · 전환을 손으로 계산 회차 잔량 · 시간표 · 일일 보고
모유실장 오가람 입실 당일 유축기 설명 · 수유 계획 기록 대상자 파악 오늘 입실 · 수유 계획별 목록
데모 방문자 — 산후조리원 운영자 도입 전에 업무 흐름 · 권한 · 모의 범위를 판단한다 화면으로 확인할 시안이 없다 3분 안에 흐름 · 권한 · 모의 범위가 명확한가

5. 핵심 시나리오 · 사용자 흐름

3분 투어

# 역할 · 표면 행동 기대 결과
1 방문자 · C-00 로그인 패널에서 「상담실장 · 윤채원」(물결점) 계정을 고른다 체험용 안내 · 언어/테마 · 초기화는 로그인 화면에 있고, 홈에 자가 입력 접수함 · 오늘 상담 · 이번 주 입실 예정이 있다
2 데스크 태블릿 · K-01 → K-02 4자리 코드로 진입 → 상담신청서 6단계 작성 · 제출 콘솔 접수함에 새 카드가 바로 뜬다(재방문이면 연결 제안)
3 상담실장 · C-03 접수 카드 확인 → 「1차」 → 메모 → 「예약」으로 이동 단계 이력에 일시 · 담당자가 남는다
4 상담실장 · C-05 VIP · 13박14일 · 당일 계약 + 에스테틱 완불 할인 → 계약금 60만 원을 카드 40만 + 지역화폐 20만으로 결제(모의) 줄 단위 내역 · 총액이 요금표와 맞고, 상태가 예약완료가 되며 예약확인서 · 「예약 확정」 메시지 미리보기가 나온다
5 상담실장 · C-06 4단계의 예약을 입실 예정일(3/20)의 빈 VIP 객실에 배정 → 퇴실한 객실(308 · 706) 소독 완료 객실 바가 「배정됨」으로, 소독한 객실이 「사용 가능」으로 표시된다
6 간호사 · C-07 로그아웃 → 「간호사」 계정으로 로그인 → 입실 체크인: 태블릿 서류(K-03 · K-04) 완료 확인 → 수유 계획 → 신생아 인수(재태 38+5 · 3.24kg · 검사 5종) → 산모 초기 체크 → 완료 다섯 단계가 끝나야 「입실중」으로 바뀐다
7 신생아실 · C-08b 14시 칸에 분유 준비 80 · 먹은 70ml, 소변 1 → D 근무조 점검 · 확인 서명 일 합계 · 체중 추이가 갱신되고 근무조가 「확인 완료」가 된다
8 에스테틱 · C-09 산후 서비스 1회차를 15:00 로 예약 → 완료 산후 서비스 잔량이 2 → 1 이 된다
9 원장 · C-11 다른 예약의 해지: 입소 45일 전 · 소비자 귀책 계약금의 30% 환급(적용 행 표시) → 원장 확인 → 환불신청서 문서가 생긴다
10 대표 · C-02 지점 「전체」 물결점의 오늘 예약 · 매출이 반영돼 있고, 업무일지에 열람 확인을 남긴다
11 방문자 로그아웃 → 로그인 화면의 「데이터 초기화」 시드 · 기준 시각 상태로 돌아가 1단계 화면과 같다

부가 시나리오

  1. 빈 상태: 오늘 입실 예정이 없는 지점의 원장 홈 → S-01 「오늘 입실 예정이 없습니다 · 예약 보기」.
  2. 오류: 모의 오류 시나리오로 객실 보드를 열면 S-03 「객실 정보를 불러오지 못했어요 · 다시 시도」, 다시 시도하면 회복한다.
  3. 입실 제한 경고: 신생아 재태 37주 이하 또는 2.5kg 이하를 입력하면 경고가 뜨고, 이 사유의 취소는 계약금 전액 환불로 분기한다.
  4. 환불 경계: 입소 91일 전은 전액, 90일 전은 60% — 같은 예약의 날짜만 바꿔도 결과 행이 바뀐다.
  5. 권한: 신생아실 계정으로 예약 · 계약 주소에 직접 들어가면 S-04. 간호사 화면에는 금액 칸이 그려지지 않는다.
  6. QR 만료: 10분이 지난 코드로 진입하면 「만료된 코드입니다 · 데스크에 다시 요청하세요」.
  7. 재방문: 같은 전화번호의 과거 산모가 상담신청서를 쓰면 접수함에서 「재방문 산모와 연결」을 제안하고, 고객 상세에 지난 입실 · 만족도가 이어진다.
  8. 서버 없음: localOnly 가 아니고 서버 주소도 없으면 S-05 를 명시적으로 보여 준다(조용한 폴백 금지).

흐름 · 상태 머신 다이어그램은 screens.md §7 · §8.

6. 정보 구조 · 화면 목록

screens.md — 콘솔 C-00C-15, 자가 입력 K-01K-05, 상태 S-01~S-07, 역할별 첫 화면, 권한 매트릭스, 반응형.

7. 기능 요구사항

깊이: 실동작(로컬 데이터가 실제로 바뀐다) · 모의(기록만 남고 외부로 나가지 않는다) · 목록(조회 · 간단 편집).

공통

ID 기능 수락 기준 깊이
FR-01 데모 입장 · 초기화 로그인 화면의 데모 계정 7개 중 하나를 고르면 그 역할 · 지점의 첫 화면이 열리고, 로그아웃하면 로그인 화면으로 돌아간다. 초기화(로그인 화면 · 확인 뒤)하면 시드 · 기준 시각 상태로 돌아간다 실동작
FR-02 지점 범위 대표만 지점 스위처로 「전체」와 지점을 바꾼다. 지점 역할이 다른 지점 레코드 주소로 들어오면 S-04 를 보여 준다 실동작
FR-03 역할별 메뉴 · 필드 노출 screens.md §5 매트릭스대로 메뉴가 숨고, 금액 칸은 대표 · 원장 · 상담실장 화면에만 그려진다 실동작
FR-04 전역 검색 이름 · 전화 뒤 4자리 · 호실로 산모를 찾아 고객 상세로 간다. 재방문 산모에는 배지가 붙는다 실동작
FR-05 역할별 홈 역할마다 screens.md §4 의 위젯이 나오고, 숫자는 데모 세계와 일치한다 실동작

상담 · 고객

ID 기능 수락 기준 깊이
FR-10 상담 등록 상담신청서 칸(성명 · 연락처 · 생년월일 · 주소 · 태명 · 병원 · 예정일 · 분만 예정 형태 · 분만 횟수 · 희망 조리기간 · 유입경로 · 보호자 · 상담 내용 · 상담자)을 입력한다. 필수(성명 · 연락처 · 예정일 · 상담일 · 상담자)가 비면 저장할 수 없고, 저장하면 「1차」 카드가 생긴다 실동작
FR-11 상담 파이프라인 칸반에서 카드를 1차 · 2차 · 3차 · 예약 · 보류로 옮긴다. 단계 이력에 일시 · 담당자가 남고, 필터(예정월 · 상담자 · 유입경로)가 칸반에 적용된다 실동작
FR-12 자가 입력 접수함 K-02 제출이 새로고침 없이 접수함에 나타난다. 같은 전화번호의 고객이 있으면 「재방문 산모와 연결」을 제안한다 실동작
FR-13 고객 상세 · 재방문 이력 상담 · 예약 · 입실 · 만족도 이력이 시간순으로 보이고 메모를 남길 수 있다 실동작
FR-14 임신 주수 표시 예정일이 있는 산모는 카드 · 목록 · 상세에서 예정일 옆에 기준 시각의 임신 주수(주+일)가 보인다 실동작

예약 · 계약 · 산전

ID 기능 수락 기준 깊이
FR-20 요금 계산 룸타입 × 기간을 고르고 할인 · 추가를 켜면 줄 단위 내역과 총액이 data.md §4.1 과 일치한다. 지인 · 제휴병원 · 재이용 할인은 동시에 켤 수 없다 실동작
FR-21 계약 상태 상담 → 가계약(계약금 대기 · 기한) → 예약완료(계약금 결제)로 바뀐다. 기한이 지난 가계약은 취소 후보로 표시된다 실동작
FR-22 혼합 결제 · 결제 링크 결제 한 건을 카드 · 현금(현금영수증) · 계좌이체 · 간편결제 · 지역화폐 · 바우처로 나눈다. 수단별 합이 결제액과 다르면 확정할 수 없다. 가결제는 확정 · 취소만 할 수 있다. 문자/알림톡 결제 링크 요청은 「요청됨 → 결제됨」 기록만 남긴다 모의
FR-23 예약확인서 예약완료 시 고객용 예약확인서(성명 · 예정일 · 조리기간 · 총금액 · 계약금 · 잔금 · 준비물 안내) 출력 미리보기가 생긴다 실동작
FR-24 입실 제한 경고 신생아 재태 37주 이하 또는 2.5kg 이하가 입력되면 경고하고, 그 사유의 취소를 계약금 전액 환불로 분기한다 실동작
FR-25 산전 관리 · 해피콜 예정일 기준 대상 목록에서 통화 결과(출산 전/출산 완료)를 기록한다. 출산 완료면 실제 분만일 · 입실/퇴실 예정일이 다시 계산된다 실동작
FR-26 기간 변경 기간을 바꾸면 박수로 다시 계산하고 위약금 10% 를 내역 줄로 더한다 실동작
FR-27 대기 목록 · 만실 대안 희망 기간 · 룸타입이 만실이면 대기 목록에 올리고, 같은 기간에 빈 객실이 있는 다른 지점을 추천한다. 대안 순서(출산병원 연장 · 타 지점 · 아기만 먼저 입실(산모는 귀가해 대기 — 방이 나면 산모 입실) 등)를 상담 메모로 남긴다 실동작

객실 · 입실

ID 기능 수락 기준 깊이
FR-30 객실 현황 보드 객실 × 날짜 타임라인에서 배정한다. 겹치는 기간에는 배정할 수 없다. 퇴실한 객실은 「정리 · 소독 필요」가 되고 소독 완료를 체크해야 「사용 가능」이 된다 실동작
FR-31 입실 예정자 카드 객실 · 산모 · 분만형태 · 출산 횟수 · 병원 · 보호자 식사 · 기간 · 신생아(태명 · 출생일 · 성별/체중 · 재태기간) · 비고를 한 장으로 출력 미리보기한다(부서 배포용) 실동작
FR-32 객실 카드 보기 · 입퇴실 집계 타임라인과 같은 데이터를 객실 카드(호실 · 룸타입 · 투숙 산모 · 공실 예정일 · 즉시 배정 가능)로도 본다. 금일 · 내일 입실/퇴실 예정 수와 입실/공실 수를 패널로 보여 준다 실동작
FR-40 입실 체크인 다섯 단계(서류 · 유축기/수유 계획 · 신생아 인수 · 산모 초기 체크 · 완료)를 각 역할이 처리한다. 모두 끝나야 「입실중」이 되고, 단계마다 담당 · 시각이 남는다 실동작
FR-41 서류 연동 태블릿 K-03 · K-04 진행 상태가 체크인 1단계에 실시간으로 보이고, 서명이 끝난 서류는 문서 목록에 서명자 · 시각과 함께 생긴다 실동작
FR-42 신생아 인수 출생 정보 · 검사 5종 · 신체 사정 14항목(그림 위 위치) · 입실 후 1~3시간 관찰을 기록한다 실동작
FR-43 수유 계획 · 산모 초기 체크 모유 · 분유 · 혼합 · 단유와 분만형태 · 초기 체중 · 상태를 기록한다 실동작

케어 기록

ID 기능 수락 기준 깊이
FR-50 산모 차트 일자 열 × 오전/오후(출혈 · 체온 · 혈압 · 유방통증 · 부종)를 기록하고 추이를 본다. 판정 문구 없이 값만 보여 준다 실동작
FR-51 신생아 기록 격자 24시간 칸에 직모유(분) · 병모유(ml) · 분유(준비/먹은 ml) · 소변 · 대변 · 체온 · 구토를 빠르게 입력한다. 일 합계 · 체중 · 전일 대비가 자동으로 계산된다 실동작
FR-52 근무조 점검 · 인계 D/E/N 근무조마다 호흡기 · 결막염 · 배꼽/피부 · 황달(두 부위) · 그 밖의 증상과 담당 서명을 남긴다. 확인자 서명 전에는 「확인 대기」로 표시된다. 다음 근무조에 넘길 인계 표(호실별 체중 · 발열 · 황달 · 발진 · 대변 · 수유 메모)를 출력 미리보기한다 실동작
FR-53 아가 · 산모 일지 날짜 · 대상 · 내용을 사건 기록으로 남긴다 실동작
FR-54 퇴실 교육 체크리스트 교육 항목 × 방법(설명/시범/기타) × 교육자와 퇴실 시 아기 상태(유/무)를 기록하고 부모가 서명한다. 필수 항목이 끝나지 않으면 퇴실 정산 화면에 경고가 뜬다 실동작

에스테틱

ID 기능 수락 기준 깊이
FR-60 메뉴 · 코스 카탈로그 계열 · 시간 · 단가, 코스 등급 · 할인율 · 구성을 조회 · 편집한다 목록
FR-61 회차 버킷 계약 포함 서비스(산전/산후) · 구매 코스 · 보너스를 따로 쌓는다. 입실일이 지나면 산전 서비스 잔량이 소멸로 표시되고, 「진단서 확인」이 있을 때만 산후로 전환된다 실동작
FR-62 마사지 플래너 관리사 × 시간 시간표에서 예약 · 완료 · 노쇼 · 취소를 처리한다. 같은 관리사 · 시간에는 중복 예약이 안 되고, 완료하면 지정 버킷에서 1회 차감된다. 퇴실 고객도 예약할 수 있다 실동작
FR-63 에스테틱 일일 보고 관리 수(종류별) · 신규 코스 계약 · 누적 매출이 그날 기록에서 계산된다 실동작

정산 · 환불

ID 기능 수락 기준 깊이
FR-70 퇴실 정산 추가비용 줄(보호자 식사 · 추가 관리 · 기타) · 잔금을 혼합 결제로 받는다. 잔액이 0원이어야 「퇴실완료」가 된다(미수 허용은 원장 확인) 모의
FR-71 입실확인서 가상 사업자 정보 · 산모명 · 기간 · 결제액으로 연말정산용 확인서 출력 미리보기를 만든다 실동작
FR-72 해지 · 환불 계산 시점 · 귀책 · 일수 · 이용 박수 · 서비스 차감으로 data.md §4.2 를 계산하고 적용 행을 보여 준다. 경계(24시간 · 10/11 · 30/31 · 60/61 · 90/91일)가 표와 일치한다 실동작
FR-73 환불신청서 · 원장 확인 원장 확인 전에는 지급 동작이 없다. 확인하면 환불신청서(지점 · 산모 · 결제 항목 · 방법 · 금액 · 사유 · 적용 규칙 · 원장 확인)가 문서로 생긴다 실동작(지급 모의)

메시지

ID 기능 수락 기준 깊이
FR-80 템플릿 트리거별 템플릿을 변수 칩({산모명} · {예정일} · {지점} …)으로 편집하고, 실제 산모 값으로 치환한 미리보기와 글자 수(단문/장문)를 본다 실동작
FR-81 발송 그룹 조건(예정 입실월 · 예약 상태 · 지점 · 산전 서비스 잔량)으로 그룹을 만들고 대상 인원을 미리 본다 실동작
FR-82 모의 발송 발송하면 기록만 남고 외부 요청은 0건이다. 화면에 「모의 발송」 안내가 붙는다 모의
FR-83 임신 주차별 자동 안내 주차(예: 28 · 32 · 36주)마다 템플릿 · 사용 여부를 정하면, 예정일 기준으로 그날 대상 산모 목록과 발송 예정이 계산된다(산전 마사지 안내 · 준비물 안내 자동화) 모의

업무일지 · 통계 · 본사

ID 기능 수락 기준 깊이
FR-90 업무일지 자동 집계(data.md §4.4) · 근무표 · 금일 예약/입실/퇴실 목록 · 매출 누계에 비고를 더해 제출한다. 집계 값은 데모 세계와 일치한다 실동작
FR-91 본사 열람 확인 대표가 제출된 일지에 열람 확인을 남기고, 지점은 확인 여부를 본다(결재 기능 아님) 실동작
FR-92 월별 장부 · 통계 예약 · 입실 · 해지 · 매출(수단별) · 유입경로 전환 · 가동률 · 재방문 비율을 월별로 본다 실동작
FR-93 본사 통합 대시보드 지점 비교 카드 · 차트를 보여 준다. 「전체」 합계는 지점 합과 같다 실동작

직원 · 사후 · 자가 입력

ID 기능 수락 기준 깊이
FR-100 직원 정규 · 파트 직원을 등록한다. 퇴사 처리하면 로그인 계정 목록과 권한에서 사라진다. 자격 · 서류 만료 예정(30일 이내)을 표시한다 목록
FR-101 권한 보기 역할 × 기능 매트릭스를 조회한다(편집은 본사 · 원장) 목록
FR-102 주간 근무표 근무조별 인원을 편집한다. 업무일지 근무표와 같은 값이 나온다 목록
FR-103 재고 기준 수량 이하인 품목을 표시한다 목록
FR-104 점검 · 소독 기록 소독 기록 대장(일자 · 구역 · 방법 · 담당)과 시설 점검표를 기록 · 출력한다(보건소 점검 대비) 목록
FR-105 삭제 복원 · 감사 기록 산모 기록은 삭제해도 지워지지 않고 「삭제됨」이 되며 원장이 복원할 수 있다. 상태 전환 · 결제 · 환불 · 서명 · 삭제는 감사 기록에 남는다 실동작
FR-110 사후 해피콜 · 설문 퇴실 7일 뒤 대기열에서 만족도(1~5) · 추천 의향 · 선택/불편 사유 · 건의 · 후속 조치를 기록한다 실동작
FR-120 QR · 코드 발급 콘솔에서 목적(상담신청서/입실 서류)을 고르면 QR · 4자리 코드 · 10분 만료가 생긴다 실동작
FR-121 상담신청서 자가 작성 단계를 오가도 입력이 유지되고, 필수 검증 뒤 제출하면 접수함에 들어간다 실동작
FR-122 입실 서류 · 서명 입실신청서 · 동의서 4종을 읽고 서명한다. 개인정보 선택 동의를 하지 않아도 제출할 수 있다 실동작
FR-123 제출 뒤 정리 제출하면 세션이 끝나고, 뒤로 가기를 해도 입력 내용이 다시 보이지 않는다 실동작

8. 비기능 요구사항

ID 요구
NFR-01 공개 Pages 는 localOnly 다. 업무 네트워크 요청은 0건, 콘솔 오류도 0건이다
NFR-02 결정적 시드: seed 1274 · 기준 시각 2026-01-15 09:00 KST. 초기화하면 같은 화면이 나온다
NFR-03 11개 언어 UI · 아랍어 RTL · 로케일 형식, co_demo_prefs 로 포털의 언어 · 테마를 이어받는다(S-18). 통화(KRW) · 시간대는 고정한다
NFR-04 라이트 · 다크 모두 지원하고, 첫 프레임 전 배경을 칠한다
NFR-05 R-1~R-4 를 지킨다 — 고정 높이 예산 금지 · 가용 폭 판정 · 와이드 정보량 하한 · 터치 48dp × scaling
NFR-06 WCAG AA 대비를 지키고, 상태는 색과 문구를 함께 쓴다
NFR-07 지점 격리: 지점 범위 밖 레코드는 서버 정책으로 막는다(구현 단계 모듈 시험)
NFR-08 개인정보 최소 수집: 주민등록번호 칸이 없고, 연락처는 역할별로 마스킹한다
NFR-09 감사 기록: 상태 전환 · 결제 · 환불 · 서명은 누가 · 언제 했는지 남긴다
NFR-10 인쇄 레이아웃을 둔다 — 예약확인서 · 입실 예정자 카드 · 환불신청서 · 입실확인서 · 업무일지
NFR-11 신생아 격자(24행 × 12열)를 재실 30명 기준으로 빠르게 넘겨도 끊기지 않는다

9. 데이터

data.md — 엔티티 37종 · 열거형 · 요금 · 환불 · 회차 · 집계 규칙 · A/B/C 분류 · 시드.

10. 규제 · 고지

11. 범위 밖