# GOLFVX 멤버십 — 테스트 시나리오 인덱스

> 이 문서는 [Phase1/docs/test-scenarios/](.) 폴더의 25개 테스트 시나리오 파일을 **제품별 / 메뉴별**로 탐색하기 위한 인덱스입니다.

---

## 📊 전체 요약

| 제품 | 페이지 수 | TC 수 |
|---|---:|---:|
| **GOLFVX App** (사용자) | 8 | 1,016 |
| **VX Admin** (본사 관리자) | 10 | 906 |
| **Partner Admin** (매장 관리자) | 7 | 760 |
| **공용 위자드** (3-mode 통합) | — (08만, 별도 분리) | — |
| **합계** | **25 파일** | **2,627** |

> **분류별 합계** — 정상(Positive): 2,062 / 비정상(Negative): 473 / 경계값(Boundary): 92
> ※ TC_COMPETITION_WIZARD.md(154건)는 GOLFVX App·VX Admin·Partner Admin 3개 모드를 공용으로 다루므로 제품별 합계에는 GOLFVX App에 포함시켰습니다.

---

## 🟦 GOLFVX App (사용자) — 8 페이지

> 사용자 모바일/웹 앱. 4개 하단 탭(Home / Reservation / My Membership / Competition)으로 구성.

| # | 메뉴 | URL | TC (정상/비정상/경계값/계) | 핵심 기능 | 파일 |
|:--:|---|---|---|---|---|
| 01 | 시작하기 (전역) | — | 52 / 14 / 0 / **66** | 4탭 네비, 인증/토큰, JWT, 등급 5단계, 공통 표시 형식 | [TC_OVERVIEW.md](TC_OVERVIEW.md) |
| 02 | 홈 | `/membership` | 111 / 25 / 6 / **142** | 캠페인 배너, 활성 베이(PIN/카운트다운), 멤버십 카드, 등급 진행률, 매장 문 열기 | [TC_HOME.md](TC_HOME.md) |
| 03 | 예약 | `/membership/reservation` | 151 / 46 / 4 / **201** | 매장/날짜/룸타입 선택, 시간 그리드, 베이 자동 배정, Square 결제, 플랜 구입 통합 | [TC_RESERVATION.md](TC_RESERVATION.md) |
| 04 | MY / 멤버십 정보 | `/membership/me`, `/membership/membership-info` | 73 / 15 / 0 / **88** | 프로필 카드, 통계, 메뉴 그룹, 구매내역/포인트/혜택 3탭 | [TC_MY.md](TC_MY.md) |
| 05 | 포인트 지갑 | `/membership/wallet` | 47 / 9 / 0 / **56** | 잔액 카드, 4종 필터(전체/획득/사용/등급), 거래 내역 테이블 | [TC_WALLET.md](TC_WALLET.md) |
| 06 | 혜택 | `/membership/benefits` | 57 / 6 / 0 / **63** | 등급 배너, 등급 혜택, 구독 혜택, 다음 등급 미리보기, 등급별 비교 | [TC_BENEFITS.md](TC_BENEFITS.md) |
| 07 | 대회 | `/membership/competition` | 202 / 37 / 11 / **250** | 대시보드(트리/내 진행중/내 성적), 대회 목록, 참가 시트, 팀 구성, 결과 확인, 일반 라운드 | [TC_COMPETITION.md](TC_COMPETITION.md) |
| 08 | 대회 참가 위자드 (공용) | `/membership/competition/create` 외 | 113 / 34 / 7 / **154** | 3-mode(user/admin/partner) 공용 위자드, compType × scope 권한, 4단계 위자드 | [TC_COMPETITION_WIZARD.md](TC_COMPETITION_WIZARD.md) |

**소계**: 8 페이지 / **1,020 TC** (08은 3-mode 공용)

---

## 🟧 VX Admin (본사 관리자) — 10 페이지

> 본사 직원이 사용하는 통합 관리 도구. `/membership-admin` 경로 + 사이드바의 "GolfVX Admin" 그룹.

| # | 메뉴 | URL | 권한 | TC | 핵심 기능 | 파일 |
|:--:|---|---|---|---|---|---|
| 09 | 관리자 시작하기 (레이아웃) | `/membership-admin` | — | 30 / 5 / 0 / **35** | 사이드바 그룹, 매장 컨텍스트, 프로토/인증 모드, 권한 체크 흐름 | [TC_ADMIN_OVERVIEW.md](TC_ADMIN_OVERVIEW.md) |
| 10 | 대시보드 | `/dashboard` | (인증 사용자) | 44 / 10 / 0 / **54** | KPI 4종, 등급 분포 도넛, 포인트 트렌드, 등급별 분포 테이블 | [TC_DASHBOARD.md](TC_DASHBOARD.md) |
| 11 | 회원 관리 | `/members` | `store.member.view` | 80 / 21 / 9 / **110** | 12컬럼 테이블, 등급 탭/포인트 범위 필터, 상세 시트, 포인트 조정, 역할 변경 | [TC_MEMBERS.md](TC_MEMBERS.md) |
| 12 | 등급 설정 | `/grade-settings` | `hq.membership.tier.view` | 39 / 9 / 2 / **50** | 5등급 탭, 색상/포인트/설명 편집, 카드 미리보기 | [TC_GRADE_SETTINGS.md](TC_GRADE_SETTINGS.md) |
| 13 | 등급 혜택 | `/grade-benefits` | `hq.membership.tier.view` | 58 / 18 / 6 / **82** | 아코디언, 혜택 추가/수정/삭제/드래그 정렬, 파라미터 인라인 편집 | [TC_GRADE_BENEFITS.md](TC_GRADE_BENEFITS.md) |
| 14 | 혜택 설정 | `/benefit-settings` | `hq.membership.benefit.view` | 41 / 14 / 0 / **55** | 필터 탭(전체/시스템/시즌/표시용), System/Display 모드 BenefitItem CRUD | [TC_BENEFIT_SETTINGS.md](TC_BENEFIT_SETTINGS.md) |
| 15 | 플랜 관리 | `/plans` | `hq.membership.plan.view` | 49 / 10 / 0 / **59** | 플랜 아코디언, 노출 토글(isVisible/isActive), 혜택 ko/en 분리, cascade 삭제 | [TC_PLANS.md](TC_PLANS.md) |
| 16 | 배너 설정 | `/banner-settings` | `hq.system.settings` | 41 / 13 / 0 / **54** | 배너 카드, 활성 토글, 배너 타입(competition/promotion/announcement), 노출 조건 | [TC_BANNERS.md](TC_BANNERS.md) |
| 17 | 본사 대회 관리 | `/hq-competition` | `hq.comp.view` | 135 / 30 / 11 / **176** | 리더보드/대회관리/참가자 3탭, 투어 관리, 4단계 위자드, 트리 + 인라인 상세 | [TC_HQ_COMPETITION.md](TC_HQ_COMPETITION.md) |
| 18 | 역할/권한 관리 | `/role-management` | `hq.auth.view` / `hq.auth.manage` | 136 / 25 / 11 / **172** | 7역할 × 40권한 매트릭스, 매장 할당, Auth Logs, 권한 비교 다이얼로그 | [TC_ROLE_MANAGEMENT.md](TC_ROLE_MANAGEMENT.md) |

**소계**: 10 페이지 / **906 TC**

---

## 🟩 Partner Admin (매장 관리자) — 7 페이지

> 매장 관리자가 사용하는 도구. `/membership-admin` 경로 + 사이드바의 "GolfVX Partner" 그룹. 모든 페이지가 `contextStoreId` 기반 storeScoped.

| # | 메뉴 | URL | 권한 | TC | 핵심 기능 | 파일 |
|:--:|---|---|---|---|---|---|
| 19 | 매장 관리 | `/stores` | `store.view` | 95 / 32 / 5 / **132** | 매장명 인라인 편집, 베이 속성, 운영시간 v2(요일/zone), 룸타입, 인원 요금 | [TC_STORES.md](TC_STORES.md) |
| 20 | 베이 현황 | `/bay-status` | `store.view` | 115 / 19 / 2 / **136** | 4상태 카드/리스트 뷰, AutoMode 위상, 매장 공용/베이 장비 제어, SSE 실시간 | [TC_BAY_STATUS.md](TC_BAY_STATUS.md) |
| 21 | 상품 관리 | `/products` | `store.membership.product.view` | 86 / 14 / 4 / **104** | 기본/프로모션 상품 카드, 구독 주기 4종, 혜택 인라인 편집, 자동 가격 라벨 | [TC_PRODUCTS.md](TC_PRODUCTS.md) |
| 22 | 파트너 회원 | `/partner-members` | `store.member.view` | 44 / 9 / 0 / **53** | 멤버십 + 방문 유저 통합 테이블, 포인트 이력 모달 (조회 전용) | [TC_PARTNER_MEMBERS.md](TC_PARTNER_MEMBERS.md) |
| 23 | 파트너 예약 | `/partner-reservations` | `store.reservation.view` | 115 / 33 / 9 / **157** | 타임 그리드, 9종 상태, 드래그 이동, Walk-in, 시간 조정, 가격 산출, SSE | [TC_PARTNER_RESERVATIONS.md](TC_PARTNER_RESERVATIONS.md) |
| 24 | 파트너 대회 관리 | `/competition-management` | `store.comp.view` | 85 / 18 / 5 / **108** | 리더보드/대회관리/참가자 3탭, 4단계 위자드(Partner 모드), 매장 단위 필터링 | [TC_PARTNER_COMPETITION.md](TC_PARTNER_COMPETITION.md) |
| 25 | 파트너 예약 내역 | `/partner-reservation-history` | `store.reservation.view` | 63 / 7 / 0 / **70** | Reservations / History 듀얼 탭, 6종 필터, 4종 변경 이력, read-only 과거 | [TC_PARTNER_RESERVATION_HISTORY.md](TC_PARTNER_RESERVATION_HISTORY.md) |

**소계**: 7 페이지 / **760 TC**

---

## 🔍 빠른 탐색

### 사용 빈도 / 위험도 Top 페이지

가장 복잡하고 핵심적인 페이지(TC 수 기준 Top 5):

| 순위 | 페이지 | TC | 사유 |
|:--:|---|---:|---|
| 1 | 07 GOLFVX 대회 | 250 | 13개 위젯, 3개 탭, 트리/카드/시트 다층 UX |
| 2 | 03 GOLFVX 예약 | 201 | 결제·실시간·동시성·타임존 모두 포함 |
| 3 | 17 본사 대회 관리 | 176 | 17+ API, 5개 엔티티, 4단계 위자드 |
| 4 | 18 역할/권한 | 172 | 7×40 매트릭스, 보안 핵심 |
| 5 | 23 파트너 예약 | 157 | 드래그·SSE·노쇼·가격산출 |

### 주제별 인덱스

| 주제 | 관련 페이지 |
|---|---|
| **예약** | [03 GOLFVX 예약](TC_RESERVATION.md), [23 파트너 예약](TC_PARTNER_RESERVATIONS.md), [25 파트너 예약 내역](TC_PARTNER_RESERVATION_HISTORY.md), [02 홈 활성 베이](TC_HOME.md) |
| **결제 / 플랜** | [03 GOLFVX 예약(플랜 구입 통합)](TC_RESERVATION.md), [15 플랜 관리](TC_PLANS.md), [21 상품 관리](TC_PRODUCTS.md), [04 MY 구매내역](TC_MY.md) |
| **포인트** | [05 포인트 지갑](TC_WALLET.md), [04 MY 포인트 이력](TC_MY.md), [11 회원 관리(포인트 조정)](TC_MEMBERS.md) |
| **등급** | [12 등급 설정](TC_GRADE_SETTINGS.md), [13 등급 혜택](TC_GRADE_BENEFITS.md), [14 혜택 설정](TC_BENEFIT_SETTINGS.md), [06 혜택](TC_BENEFITS.md) |
| **대회** | [07 GOLFVX 대회](TC_COMPETITION.md), [08 대회 위자드 (공용)](TC_COMPETITION_WIZARD.md), [17 본사 대회](TC_HQ_COMPETITION.md), [24 파트너 대회](TC_PARTNER_COMPETITION.md) |
| **권한 / 보안** | [18 역할/권한](TC_ROLE_MANAGEMENT.md), [09 관리자 시작하기(공통 레이아웃)](TC_ADMIN_OVERVIEW.md) |
| **매장 운영** | [19 매장 관리](TC_STORES.md), [20 베이 현황](TC_BAY_STATUS.md), [22 파트너 회원](TC_PARTNER_MEMBERS.md) |
| **회원 관리** | [11 회원 관리](TC_MEMBERS.md), [22 파트너 회원](TC_PARTNER_MEMBERS.md) |
| **마케팅 / 콘텐츠** | [16 배너 설정](TC_BANNERS.md), [02 홈 캠페인 배너](TC_HOME.md) |
| **분석 / 모니터링** | [10 대시보드](TC_DASHBOARD.md), [20 베이 현황 SSE](TC_BAY_STATUS.md) |

### 권한별 페이지 매트릭스 (VX Admin / Partner Admin)

| 권한 코드 | 필요 페이지 |
|---|---|
| `hq.system.settings` | [16 배너 설정](TC_BANNERS.md) |
| `hq.auth.view` / `hq.auth.manage` | [18 역할/권한](TC_ROLE_MANAGEMENT.md) |
| `hq.membership.tier.view` | [12 등급 설정](TC_GRADE_SETTINGS.md), [13 등급 혜택](TC_GRADE_BENEFITS.md) |
| `hq.membership.benefit.view` | [14 혜택 설정](TC_BENEFIT_SETTINGS.md) |
| `hq.membership.plan.view` | [15 플랜 관리](TC_PLANS.md) |
| `hq.comp.view` | [17 본사 대회 관리](TC_HQ_COMPETITION.md) |
| `store.member.view` | [11 회원 관리](TC_MEMBERS.md), [22 파트너 회원](TC_PARTNER_MEMBERS.md) |
| `store.view` | [19 매장 관리](TC_STORES.md), [20 베이 현황](TC_BAY_STATUS.md) |
| `store.membership.product.view` | [21 상품 관리](TC_PRODUCTS.md) |
| `store.reservation.view` | [23 파트너 예약](TC_PARTNER_RESERVATIONS.md), [25 예약 내역](TC_PARTNER_RESERVATION_HISTORY.md) |
| `store.comp.view` | [24 파트너 대회 관리](TC_PARTNER_COMPETITION.md) |

### 데이터 연동 (Web ↔ App ↔ Admin)

각 TC 파일의 **§데이터 연동** 섹션에서 양방향 동기화 케이스를 확인할 수 있습니다. 주요 연결:

- **App 03 ↔ Partner Admin 23**: 동일 `store-reservations` 컬렉션 (시간축 분기)
- **App 02 ↔ Partner Admin 20**: 활성 베이 위젯 ↔ 베이 현황 (SSE 실시간)
- **App 06 ↔ VX Admin 12/13**: 등급/혜택 변경 즉시 사용자 화면 반영
- **App 07 ↔ VX Admin 17 / Partner Admin 24**: 대회 데이터 단일 소스
- **VX Admin 18 ↔ 모든 Admin 페이지**: 권한 변경 → 메뉴 노출/액션 가시성 전파

---

## 📝 작성 규칙 (참고)

작성 원칙은 [Phase1 Test.md](../../../Phase1%20Test.md)에 정의되어 있습니다. 모든 파일은 다음 규칙을 따릅니다:

- **3개 제품 메뉴 구성대로 작성** — 제품/메뉴 메타 테이블을 헤더에 명시
- **명세 §섹션명 표시** — 각 TC 영역에 출처 명세 섹션 표기
- **UI 텍스트 그대로 작성** — 옵션/버튼 등 UI 텍스트는 명세 그대로 (영문/한글 정확히)
- **분류 컬럼**: 정상(Positive) / 비정상(Negative) / 경계값(Boundary)
- **테스트결과**: Pass / Fail / N/A / Block / Not Test
- **우선순위**: High / Medium / Low

### 표준 섹션 구조

각 TC 파일은 다음 섹션을 일관되게 포함합니다:

1. **메인 영역** (위젯별 A/B/C... 섹션) — 명세 기반 정상/비정상/경계값/UI 케이스
2. **§추가 권장 케이스** — 명세에 없거나 ⚠️ 미정의로 표시된 항목
3. **§데이터 연동** — Web ↔ App ↔ Admin 양방향 동기화
4. **§사용성** — UX 시각/편의성 케이스
5. **§예외상황** — API 실패, 네트워크, 동시성 등
6. **§명세 외 비고** (선택) — 정책 확정이 필요한 항목 정리표
7. **§TC 통계** — 섹션별 카운트 합계

---

## 🗺️ 메뉴 매핑 다이어그램

```
GOLFVX App (4개 하단 탭)
├── Home          → 02 TC_HOME.md
├── Reservation   → 03 TC_RESERVATION.md
├── My Membership → 04 TC_MY.md
│   ├── (서브) 포인트 지갑 → 05 TC_WALLET.md
│   └── (서브) 혜택      → 06 TC_BENEFITS.md
├── Competition   → 07 TC_COMPETITION.md
│   └── 개인 대회 만들기 → 08 TC_COMPETITION_WIZARD.md (공용)
└── (전역 정책)    → 01 TC_OVERVIEW.md

VX Admin (사이드바 GolfVX Admin 그룹)
├── 대시보드        → 10 TC_DASHBOARD.md
├── 회원 관리       → 11 TC_MEMBERS.md
├── 등급 설정       → 12 TC_GRADE_SETTINGS.md
├── 등급 혜택       → 13 TC_GRADE_BENEFITS.md
├── 혜택 설정       → 14 TC_BENEFIT_SETTINGS.md
├── 플랜            → 15 TC_PLANS.md
├── 대회(HQ)        → 17 TC_HQ_COMPETITION.md
│   └── 대회 생성  → 08 TC_COMPETITION_WIZARD.md (공용, admin 모드)
├── 역할 관리       → 18 TC_ROLE_MANAGEMENT.md
├── 배너 설정       → 16 TC_BANNERS.md
└── (공통 레이아웃)  → 09 TC_ADMIN_OVERVIEW.md

Partner Admin (사이드바 GolfVX Partner 그룹)
├── 매장             → 19 TC_STORES.md
├── 베이 현황         → 20 TC_BAY_STATUS.md
├── 상품             → 21 TC_PRODUCTS.md
├── 파트너 회원        → 22 TC_PARTNER_MEMBERS.md
├── 파트너 예약        → 23 TC_PARTNER_RESERVATIONS.md
│   └── (자매) 예약 내역 → 25 TC_PARTNER_RESERVATION_HISTORY.md
├── 파트너 대회 관리    → 24 TC_PARTNER_COMPETITION.md
│   └── 대회 생성    → 08 TC_COMPETITION_WIZARD.md (공용, partner 모드)
└── (공통 레이아웃)    → 09 TC_ADMIN_OVERVIEW.md
```

---

*최종 갱신: 2026-05-04 / 25개 파일 / 2,627 TC*