[WORKSOUT] 회원 등급 (멤버십)

화면 정보

Screen ID	Screen Title	Screen Path
ACCT-GRD-01	회원 등급 (멤버십)	/mypage/membership

개요

앱 계정 화면 내 회원 등급 화면에서 사용자의 현재 등급, 다음 시즌 예상 등급, 구매 진행률을 표시한다.

YETI 스토어는 이 문서를 원본으로 하여 “화면 구조 및 등급 기준은 WORKSOUT과 동일”하다고 위임하고 있다 (YETI mypage-account.md ACCT-GRD-01 참고). YETI는 회원 혜택 카피만 전용으로 별도 작성한다.

관리 어드민: 자체 어드민 > 회원 관리 > 회원 정보 관리

---

화면 구성

동작 규칙

항목	규칙
노출 위치	앱 > 계정 > 회원 등급 화면
노출 대상	로그인한 회원만 접근 가능 (비회원 접근 불가)
현재 등급 표시	사용자의 현재 시즌 등급 표시 (MEMBER/NEIGHBOR/FRIEND/FAMILY)
시즌 라벨 표시	현재 시즌 정보 표시 (SS 시즌: 2월7월, FW 시즌: 8월1월)
진행률 바	현재 시즌 구매 금액 기준으로 다음 등급까지의 진행률을 시각적으로 표시
100% 달성 시	진행률 바 100% 채움 + “다음 시즌 {등급명} 등급 달성” 텍스트 표시 (등급명은 동적 변경)

회원 등급 체계

등급	전 시즌 구매 금액 기준	혜택
MEMBER	30만 원 미만 (또는 신규 가입)	웰컴 5% 쿠폰, 생일 5% 쿠폰, 구매 금액 1% 적립
NEIGHBOR	30만 원 이상 ~ 100만 원 미만	NEIGHBOR 10% 쿠폰 2장, 생일 10% 쿠폰, 구매 금액 1% 적립
FRIEND	100만 원 이상 ~ 600만 원 미만	FRIEND 10% 쿠폰 2장, 생일 10% 쿠폰, 구매 금액 1.5% 적립
FAMILY	600만 원 이상	FAMILY 15% 쿠폰 2장, 생일 15% 쿠폰, 구매 금액 2% 적립, WORKSOUTER BENEFIT

등급 산정 기준

• 구매 확정된 구매 금액만 반영
• 할인, 쿠폰, 적립금, 배송비, 기프트 카드를 제외한 최종 결제 금액 기준
• 다음 시즌에 등급 반영 (예: SS 시즌 구매 금액 → FW 시즌 등급 적용)

시즌 운영 기준

시즌	기간	등급 쿠폰 지급일
SS 시즌	2월 ~ 7월	2월 1일, 5월 1일
FW 시즌	8월 ~ 1월	8월 1일, 11월 1일

시즌 변경 시점에 전 시즌 구매 금액 기준으로 등급 자동 조정. 생일 쿠폰은 생일이 포함된 달 매월 5일 발행 (5일 이후 가입 시 지급 불가).

---

정책

어드민 작업 절차

자체 어드민 > 회원 관리 > 회원 정보 관리에서 작업.

등급 조회: 회원 정보 관리 메뉴 접속 → 회원 검색 → 상세보기 → 회원 등급 정보 확인

등급 수정: 상세보기 → 수정하기 버튼 → 회원 등급 드롭다운에서 변경할 등급 선택 → 저장

• 관리자 수정 시 ADMIN_MODIFY 이벤트로 기록됨
• 등급 하향 조정 사유: 비정상적 서비스 이용, 부당한 목적 이용, 부적절한 고객 응대 등
• 등급 수정 시 회원에게 별도 안내 필요 여부 확인

등급 변동 내역 조회: 회원 정보 관리 > 상세보기에서 등급 변동 이력 확인 가능

변동 유형	설명
MEMBER_JOIN	회원 가입으로 인한 등급 생성
SEASON_START	시즌 변경으로 인한 등급 변경
ADMIN_MODIFY	관리자 등급 수정

데이터 없음 / 예외 처리

상황	처리 방식
비회원 접근	계정 화면 자체 접근 불가 (로그인 필요)
신규 가입 회원	MEMBER 등급으로 표시, 진행률 0%부터 시작
시즌 전환 시점	새 시즌 정보로 자동 업데이트 (SEASON_START 이벤트 발생)
등급 하향 조정	관리자 수정 시 즉시 반영 (ADMIN_MODIFY 이벤트 발생)

---

API 연동

회원 등급 정보 조회

엔드포인트: GET /v1/membership/info 호출 시점: 앱 계정 > 회원 등급 화면 진입 시

응답 구조

{
  "code": "string",
  "message": "string",
  "payload": {
    "nextSeasonGrade": "BASIC",
    "season": "string",
    "totalSeasonPaidAmount": 0,
    "userGrade": "BASIC",
    "userNeedPriceToUpgrade": 0
  }
}

응답 필드	활용
userGrade	현재 시즌 회원 등급 표시 (MEMBER/NEIGHBOR/FRIEND/FAMILY)
season	시즌 라벨 표시 (예: “2026 SS”)
nextSeasonGrade	다음 시즌 예상 등급 표시 (100% 달성 시 텍스트에 사용)
totalSeasonPaidAmount	현재 시즌 구매 확정 금액 (진행률 바 계산에 사용)
userNeedPriceToUpgrade	다음 등급까지 필요한 금액 (진행률 바 계산에 사용)

비즈니스 룰

• 진행률 계산: totalSeasonPaidAmount / (totalSeasonPaidAmount + userNeedPriceToUpgrade) * 100
• 100% 달성 조건: userNeedPriceToUpgrade = 0
• 100% 달성 시 진행률 바는 100% 채워진 상태로 표시
• 100% 달성 시 텍스트: “다음 시즌 {nextSeasonGrade} 등급 달성” (동적 변경)

---

미결 사항

항목	내용
GET /v1/membership/info 실패 시 처리	원본 문서에 “[확인 필요] 개발팀에서 처리 중”으로 표기됨 — 개발팀 확정 필요

---

변경 이력

버전	날짜	변경 내용
v1.0	2026-07-30	최초 작성 (회원 등급 마스터.md 이전)