친구 초대 쿠폰 받기

작성자 김성빈작성일 2026-09-10

시나리오 설명

이용자 유형초대 링크를 받은 피초대자
전제 조건
  • 초대 링크에 초대 코드가 실려 있다.
  • 친구 초대에 참여하는 매장이 1곳 이상이다.
진입점피초대자가 친구에게 받은 초대 링크를 연다.

시나리오

메인 시나리오

  1. 피초대자가 친구에게 받은 초대 링크를 연다. 앱이 설치되어 있으면 시스템이 앱으로 링크를 연다.
  2. 시스템이 링크에 실린 초대 코드의 형식을 확인한다.FE01FE02FE03
  3. 시스템이 위치를 확인해 참여 매장을 조회하고 가까운 순서로 정렬한다.BE01BE02
  4. 시스템이 쿠폰 혜택, 매장 선택, 추가 혜택 안내를 보여준다. 가장 가까운 매장을 기본으로 선택한다.BE01BE02
  5. 피초대자가 참여 매장 목록에서 혜택을 받을 매장을 고른다.
  6. 시스템이 고른 매장의 첫 달 할인액과 평생 할인률로 안내를 갱신한다.BE02
  7. 피초대자가 혜택 받기를 요청한다. 시스템은 로그인 상태를 확인하고 고른 매장을 귀속 매장으로 지정해 쿠폰 발급을 요청한다.BE03BE04BE10
  8. 시스템이 쿠폰 발급과 초대 귀속 기록을 확인하고 고른 매장의 상세로 이동한다.BE03BE04BE05

예외 시나리오

번호상황과 흐름
2a

초대 코드가 없거나 형식이 어긋난다

시스템은 서버에 묻지 않는다. 쿠폰을 찾지 못했다고 알리고 홈으로 가는 경로만 남긴다. 이번 흐름은 여기서 끝난다.FE01FE02FE03

3a

위치를 확인할 수 없다

시스템은 위치 없이 참여 매장을 조회한다. 거리 표기를 지우고 목록 순서만 유지한 뒤 4단계로 진행한다.

3b

참여 매장 조회가 실패한다

시스템은 초대 정보를 불러오지 못했다고 알리고 다시 시도 경로를 준다. 다시 시도를 받으면 3단계를 다시 진행한다.

4a

참여 매장이 0곳이다

시스템은 지금 받을 수 있는 쿠폰이 없다고 알린다. 만료가 아니라 중단 상태다. 이번 흐름은 여기서 끝난다.BE01

7a

피초대자가 로그인 상태가 아니다

피초대자가 로그인을 마치고 혜택 받기를 다시 요청한다. 시스템은 쿠폰을 발급하지 않고 로그인을 안내한다. 복귀 경로는 현재 화면이다.BE10

7b

피초대자가 혜택 받기를 연속으로 누른다

피초대자가 응답을 기다리는 동안 혜택 받기를 한 번 더 누른다. 시스템은 처리 중인 요청이 있으면 두 번째 요청을 막는다.

8a

초대 코드가 유효하지 않다

시스템은 링크가 만료됐다고 알리고 7단계 화면을 유지한다.FE01FE02FE03

8b

자기 초대 링크다

시스템은 자기 링크로는 쿠폰을 받을 수 없다고 알리고 7단계 화면을 유지한다.BE07

8c

신규 가입자가 아니다

시스템은 새로 가입한 친구만 받을 수 있다고 알리고 7단계 화면을 유지한다.BE06

8d

진행 중인 혜택이 없다

고른 매장의 혜택이 꺼졌거나 친구 초대가 멈춘 경우다. 시스템은 진행 중인 혜택이 없다고 알리고 7단계 화면을 유지한다.BE08BE09

8e

인증이 유효하지 않다

시스템은 안내 문구 대신 로그인을 안내한다. 이후는 7a와 같다.BE10

8f

네트워크가 끊긴다

시스템은 발급 요청을 자동으로 다시 보내지 않는다. 네트워크를 확인하고 다시 시도하라고 알린 뒤 7단계 화면을 유지한다.

8g

서버가 알 수 없는 사유를 준다

시스템은 서버가 준 한국어 문구가 있으면 그대로 보여주고, 없으면 쿠폰을 받지 못했다고 알린다. 7단계 화면을 유지한다.

8h

이미 같은 링크로 쿠폰을 받았다

서버는 기존 발급을 그대로 돌려준다. 시스템은 처음 받았을 때와 같이 8단계를 이어간다.BE05

정책

프론트 정책

번호규칙적용 화면
FE01초대 코드는 13자다.2, 2a, 8a
FE02초대 코드의 첫 글자는 A다.2, 2a, 8a
FE03초대 코드의 끝 글자는 R이다.2, 2a, 8a

서버 정책

번호규칙적용 화면
BE01친구 초대 혜택은 매장 단위로 등록한다.3, 4, 4a
BE02첫 달 할인액, 초대자 보상액, 지급 대기일수, 평생 할인률은 매장마다 다를 수 있다.3, 4, 6
BE03초대 쿠폰 수령은 요청 한 번으로 끝난다.7, 8
BE04초대 쿠폰의 귀속 매장은 수령 요청에 담은 매장으로 정해진다.7, 8
BE05같은 초대 코드로 같은 회원에게 발급하는 초대 쿠폰은 1개다. 요청을 다시 보내도 새로 발급하지 않는다.8, 8h
BE06초대 쿠폰은 신규 가입자만 받을 수 있다.8c
BE07자기 초대 코드로는 초대 쿠폰을 받을 수 없다.8b
BE08귀속 매장이 비활성이면 초대 쿠폰을 발급하지 않는다.8d
BE09친구 초대 혜택이 멈추면 초대 쿠폰을 발급하지 않는다.8d
BE10초대 쿠폰은 인증을 마친 회원만 받을 수 있다.7, 7a, 8e