QUANTUM RANGE · 정책 점검 · Consistency Check

QR POLICY · 검토 부록

정책 점검.

기획 결정 39건을 5개 관점(채널 일관성 · 결제/이용권 · 취소/노쇼 · 문서 불일치 · 거버넌스/의존성)으로 교차 검토한 결과입니다. 표기 불일치 7건은 동기화 완료했고, 사업·기획의 결정이 필요한 12건을 정리했습니다.

01 — SYNCED

표기 동기화 완료 문서 표현을 확정 결정값 기준으로 일괄 정리

5개 관점 교차 검토 50건 → 중복 제거 후 표기 불일치 7건 동기화 완료 결정이 필요한 12건은 아래 02 「확정 필요 항목」
✓이용권 차감 시점 — 마인드맵 06·08·09의 ‘체크인 시 차감(권장)’ 표현을 확정값 ‘예약 시 차감(D2)’으로 정정. 노쇼는 ‘차감 유지(복구 없음)’, 체크인은 ‘이미 차감된 이용권의 사용 확정’으로 명확화.
✓키오스크 범위 — 결제 정책의 ‘현장 결제—키오스크’, 취소 정책의 ‘키오스크 결제 취소’, 개발 2차의 ‘키오스크 결제’ 표현을 정리하고 D23(조회 · 체크인 · 이용권 사용까지)로 통일. ★사용자 지목 항목.
✓타석 배정 — ‘고객 선택 / 자동 / 관리자’ 나열을 ‘자동 배정 + 관리자 변경(D4)’으로 정정(고객 선택은 미채택 명기). 전 채널 동일 적용. ★사용자 지목 항목.
✓상품 구성 — ‘타석+레슨 결합 상품’·‘패키지’ 항목을 D9(타석 · 레슨 · 스크린 별도, 결합·패키지 미운영) 기준으로 정정.
✓외부 채널 단계 — 개발 단계에 ‘D7 목표 = API 실시간, 난이도 따라 단계 적용(수동/CSV는 폴백)’을 명시해 ‘API 우선 ↔ 3차’ 표현 충돌 해소.
✓시간 표기 — 예약 단위 15/30/60분(D1 · 기본 타석 30분 · 레슨 15분), 취소 가능 시간 분 전 단위(D5 · 기본 타석 60분 · 레슨 120분 전)로 통일, 근거 없는 레슨 ‘50분’ 제거.
✓메타 숫자 — 마인드맵 요약의 ‘8 결정’(구버전)을 실제 규모 ‘29 결정 · 10 검토’로 갱신.
원문 외부로 공유된 운영정책서 원문(구글 문서 등)에 남아 있는 ‘체크인 시 차감 추천’ · ‘고객 선택 추천’ · ‘결제 필수 여부 (결정 필요)’ 표기는 확정값 기준으로 갱신이 필요합니다.

02 — OPEN DECISIONS

확정 필요 항목 사업 · 기획이 결정해야 풀리는 12건

A. 미결 — 먼저 확정해야 다른 결정이 풀림 5의존성 순서상 선행 결정

미결 · 최우선A1 G5D26D14D10G8
PG 매입·정산 주체 — 본사 일괄 vs 매장별 PG
왜D26(매장주가 정산·환불까지, 본사 미관여)·G8(가격 매장 컨트롤)로 매장 자율이 확정됐는데 G5 추천안은 ‘본사 일괄 매입’. 본사가 PG를 가져가면 매장주 단독 PG 환불·‘매장 매출’ 전제가 깨지고, D14 자동 정산의 귀속·수수료 위치를 확정 구현할 수 없다.
선택지(a) 본사 일괄 → D26에 ‘PG 환불·정산은 본사’ 예외 명시 · (b) 매장별 PG → 매장 자율 일관 유지. 어느 쪽이든 G5를 D14·D26보다 먼저 확정.
미결 · 선행 과제A2 G1D13
회원 DB 개설 — 매칭·양도의 공통 선행 조건
왜G1(외부 비회원→회원 이름+휴대폰 자동 매칭)·D13(이용권 양도)이 모두 회원 DB 없이는 동작 불가. 양도 UI(TransferModal)는 코드에 이미 구현돼 정책-구현이 역전된 상태.
결정회원 DB 개설을 1차 선행 마일스톤으로 둘지 확정. 개설 전까지 양도 기능 비활성/제한 운영, 외부 예약은 ‘비회원 별도’로 운영.
미결 · 값 작성A3 G4D2D16
이용권 차감 매트릭스 — 실제 차감값 확정
왜G4는 ‘권종×상품 매트릭스로 정의한다’는 방향만 결정. 시간권/횟수권/기간권 × 타석/레슨/스크린 각각 얼마를 차감하는지 셀값이 없으면 D2 ‘예약 시 차감’을 구현할 수 없다.
결정매트릭스 셀값 작성 + 타석 등급(D16 일반·프리미엄·VIP) 가격 차등을 차감량에 반영할지 여부.
미결 · 규칙 확장A4 D22D10D14
쿠폰 적용 흐름 — 병용 · 복구 · 소진 시점 · 정산 부담
왜D22는 ‘1회 사용’만 결정. 쿠폰+이용권 병용 가부, 취소 시 쿠폰 복구/소멸(D10 환불표에 쿠폰 행 없음), 소진 시점(예약 시/체크인), 정산(D14)의 할인 부담 주체가 전부 미정.
결정네 가지를 한 번에 확정해 D10 환불표에 ‘쿠폰’ 행 추가, D14 정산 규칙에 할인 차감 반영.
미결 · API 의존A5 G9D29
알림 폴백 — Push 실패 시 대체 발송
왜D29 리마인드는 ‘시작 1h 전 1회’뿐이라 그 1회가 실패하면 보완 경로가 없다(노쇼 방지가 단일 실패점에 종속). G9는 ‘API 논의 후’로 미결.
결정최소한 ‘중요 알림(확정·취소·리마인드)만 폴백’ 기본값을 잠정 확정하고 API 논의 후 범위 조정.

B. 결정 간 충돌 — 우선순위 확정 1확정 결정끼리 같은 대상을 이중 규정

충돌 · 택1B1 D5D25G3
레슨 취소 기준 — D5와 D25가 같은 대상을 이중 규정
왜레슨 취소 마감을 D5(‘APP 취소 마감’ — 레슨 기본 120분 전)와 D25(‘매장주 커스텀’)가 둘 다 규정해 어느 값이 적용되는지 단일 소스가 없다. 레슨 취소 시 1:1(G3)로 묶인 타석 슬롯·강사 스케줄 동시 해제도 미연결.
선택지(a) D5 ‘APP 취소 마감’ 필드를 단일 소스로, D25는 그 값을 매장주가 조정하는 권한으로 해석 · (b) D25 전용 커스텀 필드 신설 + D5보다 우선 명시. 취소 시 타석·강사 슬롯 원자적 해제 동시 명문화.

C. 예외 규칙 신설 — 현재 공백 6결정 사이에 빠져 있는 처리 규칙

예외 신설C1 D2D3D6
현장결제(미결제) 예약의 노쇼 패널티
공백‘현장 결제 대기’ 예약은 차감할 이용권도 선결제도 없어 노쇼해도 무패널티 → 무료 재고 점유 어뷰징 경로.
권장(a) 노쇼 카운트 누적 → 반복 시 선결제 강제, (b) 사전 카드 인증/보증금 중 택일. D2 ‘노쇼 차감’은 이용권 예약 한정임을 단서로.
예외 신설C2 D28D6G7
장애·휴무 예약을 자동 노쇼·자동 개방에서 제외
공백휴무·장애로 고객이 못 온 예약이 D6 대기시간 경과로 ‘고객 노쇼’로 자동 처리되고 타석이 워크인에 자동 개방(G7)될 수 있다.
권장장애·휴무 등록 시 해당 타석·예약을 자동 노쇼/개방 대상에서 제외(suspend). ‘매장 사유’와 ‘고객 노쇼’ 상태 분리, 수동 흐름이 자동을 오버라이드.
예외 신설C3 G2D27G7
타석 락(10분) · 결제 holding(N분) 타이머 정리
공백G2 락과 D27 holding 모두 ‘미확정 점유 후 자동 해제’인데 트리거·시간 관계 미정리. 노쇼 개방 직후 락/holding 만료 직전 재결제가 확정되면 같은 타석 이중 확정 위험.
권장이용권 차감은 예약 확정(D2)에 고정(락 구간은 홀딩만). 두 타이머를 통합하거나 트리거 구분. 락/holding 생존 중엔 개방 보류.
예외 신설C4 D5D10D28
마감 후 취소의 환불 · 이용권 부분 복구
공백‘마감 후 환불 제한(불가/일부)’과 ‘매장 사유 전액 환불(D28)’의 우선순위 미명시. ‘일부 환불’ 시 이용권(횟수권/시간권)을 어떻게 부분 복구하는지도 미정의.
권장취소 사유를 ‘고객/매장’으로 분기 — 매장 사유는 마감 무관 전액 환불·전량 복구. 부분 환불의 이용권 환산 규칙을 D10에 보강.
예외 신설C5 D24D7G7
수동/CSV 구간의 외부 예약 충돌 · 취소 지연 처리
공백외부 예약이 수동/CSV로 들어오는 동안은 실시간 timestamp가 없어 D24 자동 충돌 처리가 동작 불가. 외부 취소가 늦게 동기화되는 동안 해당 슬롯에 워크인이 들어오는 경합도 규칙 없음.
권장D24에 ‘수동/CSV 구간 = 관리자 수동 보정’ 예외 추가. 외부 취소 동기화 지연 중엔 슬롯 즉시 개방 보류 안전장치 정의.
예외 신설C6 D10D2D27
취소·노쇼 × 결제수단 상태 전이표
공백‘현장 결제 대기 취소(결제 없음 → 예약만 취소)’ · ‘PG 선결제 노쇼의 환불 처분’ 등 예약 분기(취소/노쇼)에 대응하는 결제 상태 전이가 표로 확정돼 있지 않다.
권장예약 상태(취소/노쇼) × 결제수단(PG/이용권/현장 대기/외부) 교차표를 만들어 각 칸의 처리(환불/복구/유지/없음)를 D10에 확정.
백로그 APP 예약 차단 규칙(D8) — 기획 스펙에만 있고 web 미구현. 매장 휴무·차단 설정이 App 예약을 실제로 막도록 클라이언트 구현 백로그로 등재 필요(미구현 동안 D28 관리자 수동 부담 증가). 결정이 끝난 항목은 정책 사항에서 해당 카드의 선택을 갱신하면 됩니다.