Client Policy · 확정 스펙 반영

퀀텀 레인지 (QR)
Client 정책서

타석 클라이언트(듀얼 스크린 — 메인 스크린 + 터치 패널)의 서비스 운영 기준을 카테고리별로 정리한 정책서입니다.

✅ 정책 기준값 (14개)

로그인 인원1인 로그인 (동시 1명)

로그인 방식회원(T ID) · 카카오 · 게스트

QR 로그인T ID 회원 계정만 지원

플랜 구분기본(무료) / 매장 구독(옵션) 2종

구독 판정해당 매장의 구독 상태에 따라 구독 화면 제공

스트로크기본 9홀 / 구독 9·18홀

제공 코스기본 30 / 구독 50 (Par3 20개 추가)

멀티플레이구독 전용 · 9홀만 · QR 별도 서버

미니게임다트만 제공 (틱택토 미제공)

AI 스윙분석기본·구독 제공 (IP 카메라 필요)

콘솔 종횡비Type A 세로(9:16) / Type B 가로(16:9)

몸풀기 연습장전 모드 미제공

자동 퍼팅 이어하기미제공 (1인 게임)

관리자 진입타이틀 화면에서만

1QR 하드웨어 스펙

타석 클라이언트의 하드웨어 구성. 상세 스펙은 기획 개요를 참조한다.

기본 구성	듀얼 스크린 — 게임 화면을 보여주는 메인 스크린 + 플레이어가 조작하는 터치 패널
콘솔 설치 방향	Type A 세로(9:16) · Type B 가로(16:9) 두 형태를 모두 지원 — 신규 콘솔은 세로형, 기존 콘솔은 가로형 기준
AI 스윙분석	IP 카메라 별도 필요 — 카메라 미설치 매장은 제공 불가
9X 스윙 플레이트	별도 하드웨어 필요 (구독 전용 기능)
센서 구성	신규 하드웨어는 Quantum-Eye Mini를 기본 센서로 사용 — 기존 하드웨어 매장은 기존 구형 센서를 사용
매트 디스플레이	별도 하드웨어 필요 (구독 전용 기능)

센서 세대와 옵션 하드웨어에 따른 기능 제공 범위는 별도 하드웨어 기준을 따른다. [[검수: 기존 구형 센서에서 신규 센서 기준 기능의 지원 범위 확정 필요]]

2콘솔 구성 (종횡비 · 플랜)

콘솔은 서로 독립적인 2개 축으로 구성된다. 두 축은 상호 영향이 없다.

축 1 · 종횡비	콘솔 설치 방향 — 신규 콘솔은 세로형, 기존 콘솔은 가로형. 두 형태를 모두 지원하며 화면 배치가 달라짐
축 2 · 매장 플랜	매장 구독 여부 — 해당 매장의 기본/구독 상태에 따라 이용 가능한 모드가 달라짐

2-1. 콘솔 종횡비 — 설치 방향

구분	화면비	해상도	비고
Type A · 세로	9:16	1080 × 1920	신규 세로형 콘솔 설치 (스크린·터치패널 세로)
Type B · 가로	16:9	1920 × 1080	기존 가로형 콘솔 설치

종횡비는 로비/메뉴 UI 배치에 영향을 준다. 기본 화면 구조는 동일하게 제공하되, 센서 세대와 옵션 하드웨어에 따라 일부 기능 제공 여부가 달라질 수 있다.

2-2. 매장 플랜 — 구독 여부

구분	제공 범위	모드 구성
기본 (무료)	기본 3종	스트로크(9홀) · 샷 트레이닝 · AI 스윙분석
구독 (매장 옵션)	전체	위 3종 + 스트로크 18홀 · 멀티플레이 · 코스 트레이닝 · 미니게임(다트) · 코스 30→50 (Par3 20개 추가)

구독 판정·가입 경로 — 구독은 매장 단위로 관리하며, 매장주가 QMS에서 가입·관리한다. 해당 매장의 구독 상태에 따라 클라이언트에서 구독 옵션을 제공한다.

조합 규칙 — 종횡비(2) × 매장 플랜(2)은 독립 → 4가지 조합 모두 성립. 종횡비 = 화면 배치, 매장 플랜 = 메뉴 구성을 바꾼다. 구독 제공 범위는 현재 기준이며, 오픈 업데이트 스펙에 따라 상이할 수 있음.

3기본 · 구독 모드 매트릭스

기본(무료)과 매장 구독 상태에 따라 클라이언트에서 제공되는 모드가 상이하다.

항목	기본 제공	구독	비고
스트로크	9홀	9홀 · 18홀
9홀 멀티플레이	✕	O
제공 코스	30	50	Par3 20개 추가
샷 트레이닝	O	O	롱 · 숏 · 퍼팅 모두 포함
클럽 측정	O	O	샷 트레이닝 안에 있는 기능
AI 스윙분석	O	O	하드웨어 별도 필요 (IP 카메라)
코스 트레이닝	✕	O
미니게임 · 다트	✕	O	틱택토는 2인 이상 게임이라 제공 불가
9X 스윙 플레이트	✕	O	하드웨어 별도 필요
매트 디스플레이	✕	O	하드웨어 별도 필요

기본(무료) — 스트로크(9홀) · 샷트레이닝 · AI 스윙분석
구독(매장 옵션) — 스트로크(9/18홀, 코스 +20) · 멀티플레이 · 샷트레이닝 · AI 스윙분석 · 코스 트레이닝 · 미니게임
구독 제공 범위는 현재 기준이며, 오픈 업데이트 스펙에 따라 상이할 수 있음.

3-1. 매장 구독 요금 (초기 책정안)

기본 플랜은 무료이며, 매장 구독은 시설 이용권이 아니라 콘텐츠·기능 언락 층위다(기본 플랜에서 스트로크 9홀·샷트레이닝·AI 스윙분석 제공).

대상	요금	가입 경로
매장주 QMS 구독	월 10만~20만원 /매장 · 잠정	QMS (매장 단위)

매장주 잠정가 근거 — 매장 구독은 매장 전체 타석에 구독 기능을 제공하는 매장 단위 상품이다. 해외 시뮬레이터 SW 라이선스와 실내 연습장 타석 월정액을 비교군으로 삼으며, QMS 전체 요금제·정산과 묶어 확정할 잠정치다.

4로그인 정책

1인 로그인. 로그인은 모드 선택 화면 진입 후 모드 실행 시점에 유도된다.

로그인 인원	1인만 로그인 (동시 1명)
로그인 방식	회원 · 카카오 로그인 · 게스트 로그인 지원
QR 로그인	회원 계정(T ID) 로그인만 지원 (카카오·게스트는 QR 미지원)
미로그인 진입	로그인하지 않아도 모드 선택 화면 진입은 가능. 단, 어떤 모드 버튼이든 누르면 로그인 팝업이 떠 로그인을 유도 → 로그인 후 다시 버튼을 눌러 진입
로그인 시 화면 갱신	로그인 시점에 해당 매장 구독 상태를 반영하여, 팝업 뒤 모드 선택 화면의 메뉴 내용·데이터가 매장 플랜에 맞게 변경됨
모드 내 로그인	스트로크·멀티플레이 화면 안에서 로그인하면 해당 매장 구독 상태에 따라 화면 내용이 변경될 수 있음

확인 필요 — TR / FR / Q 회원 계정이 모두 하나의 계정인가? → 통합 계정이 맞으면 QR 로그인 연동이 쉽게 해결됨.

5플레이어 설정

플레이어 설정은 1인만 지원한다. 클럽별 비거리 설정은 기존 Q와 동일하다.

지원 인원	1인만 지원
클럽별 비거리	기존 Q와 동일한 기준으로 설정 (아래 표 참조)

5-1. 클럽 비거리 범위 (Driver · 7Iron)

구분	Driver			7 Iron
구분	Max	Min	디폴트	Max	Min	디폴트
남자	300	140	200	190	90	140
여자	260	100	160	150	70	100
게스트	300	100	200	190	70	140

5-2. 7아이언 디폴트 값에 따른 클럽별 변동값 (Q와 동일)

No	클럽	남성 비거리	여자 비거리	게스트
1	Driver	250	260	260
2	W3	235	135	225
3	W5	225	125	215
4	I4	215	115	205
5	I5	205	105	195
6	I6	195	95	185
7	I7	185	85	175
8	I8	175	75	165
9	I9	165	65	155
10	PW	150	55	140
11	SW	110	35	110

15m 미만인 경우에는 15m 고정.

데이터 확인 필요 — 5-2표 Driver 행(남 250 / 여 260 / 게 260)이 5-1표 디폴트값 및 클럽 순서와 어긋나 보임 (여자 Driver가 W3보다 큼). 원본 수치 그대로 옮겼으니 확정 전 재확인 필요.

6모드 선택 화면

접속 시 표시되는 데이터는 이전 마지막 접속 때 플레이한 데이터를 기준으로 한다.

초기 데이터	접속 시, 이전에 마지막으로 접속했을 때 플레이한 데이터를 표시
데이터 갱신	접속 유지 상태에서 특정 모드를 마치고 나오면 기존 표시 외 추가로 표시. 이미 데이터가 있던 모드는 최신 데이터로 갱신
미진행 모드	데이터가 없는(진행한 적 없는) 모드는 모드 타이틀만 출력
로그아웃 후 재접속	다시 접속하면 마지막 로그아웃 때 플레이한 데이터 종류만 표시
구독 상태 반영	로그인 시 해당 매장 구독 상태에 따라 제공 모드 개수가 다름 (기본/구독 2구분). 이에 따라 모드 버튼 크기가 가변

6-1. 모드별 데이터 출력 내용

모드	출력 내용
샷 트레이닝 (통합)	한 버튼으로 통합 — 아래 4개 중 화면 방문 시마다 임의 1개 로테이션 출력, 클릭 시 그 모드로 연습장 진입 (같은 Scene)
└롱게임	드라이버 · 7번 아이언 최근 5샷 평균 비거리
└숏게임	최근 5회 어프로치 니어핀 거리
└퍼팅	최근 5회 성공률
└클럽테스트	마지막 측정 등급 (예: A)
코스 트레이닝	마지막 연습 코스 이름
AI 스윙분석	NOT BAD — 마지막 진단
스트로크	최근 88 / 베스트 79
멀티플레이	최근 순위 / 최고 순위
다트	표시 안 함

검토 중 — 클라이언트에서 모드가 종료되면 데이터를 가진 상태에서 가공해 서버→DB로 전송하는 방법 고려 중.

7샷 트레이닝

제공 범위	기본 · 구독 모두 제공
최초 화면	샷 트레이닝 입장 시 최초 화면은 롱 게임을 기준으로 함
구성	롱 · 숏 · 퍼팅 모두 포함. 클럽 측정은 샷 트레이닝 안에 있는 기능

8코스 트레이닝

제공 범위

구독 전용 (기본 미제공)

9AI 스윙분석

제공 범위	기본 · 구독 모두 제공
하드웨어	IP 카메라 별도 필요 — 미설치 매장은 제공 불가

10스트로크

플레이어 설정	기존 T3_Lobby와 달리 플레이어 일괄설정 페이지 없음 (1인 로그인이므로)
홀 수 (플랜)	매장 구독 상태에 따라 18홀 지원. 기본은 9홀만 가능 — 스트로크 상세 설정 화면에서 18홀 버튼 비활성화, 기본 상태에서 18홀 터치 시 구독 안내 팝업 발생
자동 퍼팅 이어하기	버튼 없어야 함 (1인 게임)
몸풀기 연습장	미제공 — 스트로크뿐 아니라 모든 모드에서 몸풀기 연습장 콘텐츠 없음
제공 코스	기본 30종, 구독은 +20종(Par3) 추가하여 50종 제공

코스 데이터 처리 — 기존 코스 CSV에 "QFree / QOption" 2개 컬럼 추가: 1이면 제공, 0이면 미제공. (기존 데이터를 유지하기 위함 — 불가할 경우 별도 CSV를 만들어야 함)

11멀티플레이

제공 범위	구독 전용 (기본 미제공)
홀 수	9H만 지원
서버	Q와 별도로 QR만의 별도 서버로 운영 — 순위·방 리스트 등 전부 QR끼리만 연동
자동 퍼팅 이어하기	버튼 없어야 함 (1인 게임)

12다트

제공 범위	구독 전용 미니게임
미니게임 구성	다트만 제공 — 틱택토는 2인 이상 게임이라 제공 불가

13관리자 설정

관리자 설정은 타이틀 화면에서만 입장 가능하다 (기존 Q와 동일). 내용은 Q를 기준으로 하되 제공되는 모드만 표시한다.

진입	타이틀 화면에서만 입장 가능 (기존 Q와 동일)
표시 범위	내용은 Q 기준이나, 제공되는 모드만 표시

13-1. 게임일반 탭

개인 규칙	난이도 · 티박스 · 매트룰 · 스윙플레이트 · 깃대표시 · 나의스윙팝업 · 타석 변경 · 퍼팅 가이드 · 티 높이
경기 환경	멀리건 · 컨시드 · 캐디 · 핀 위치 · 바람 세기 · 그린 빠르기 · 카메라 · 캐디 보이스 · 거리 단위 · 홀컵 크기 · 매트 디스플레이 · 페널티 드롭 (자동 퍼팅 이어하기 삭제 — 1인이므로)
트레이닝 환경	볼 분포도/플라이트 · 그린 빠르기 · 카메라 · 클럽 패스 자동 팝업 · 스윙 영상 자동 팝업
소프트웨어	언어 선택 (몸풀기 연습시간 · 몸풀기 종료 후 시간요청 삭제)

13-2. 기타 탭 (T3_Lobby와 동일)

사운드 설정	T3_Lobby 프로젝트에서 제공하는 내용과 동일
카메라	T3_Lobby 프로젝트에서 제공하는 내용과 동일
센서	T3_Lobby 프로젝트에서 제공하는 내용과 동일
타석	T3_Lobby 프로젝트에서 제공하는 내용과 동일