Story: 팝업 노출 조건 로직

메타

항목	값
Story ID	E-11-S-02
Epic	E-11 온보딩 팝업
상태	ready-for-dev
우선순위	P0
규모	S
담당 개발자	수민 (FE)

---

사용자 스토리

As a 연동 전 셀러,
I want 매번 로그인할 때마다 연동 안내를 받고 싶다,
So that 연동을 까먹지 않고 진행할 수 있다.

---

수락 기준 (Acceptance Criteria)

AC-01: 가입 직후 팝업 노출

항목	내용
Given	회원가입을 완료했을 때
When	연동된 마켓이 0개이면
Then	온보딩 팝업이 노출된다

AC-02: 로그인 시 팝업 노출

항목	내용
Given	로그인을 완료했을 때
When	연동된 마켓이 0개이면
Then	온보딩 팝업이 노출된다

AC-03: 연동 완료 후 미노출

항목	내용
Given	1개 이상의 마켓이 연동되어 있을 때
When	로그인 또는 페이지 이동 시
Then	온보딩 팝업이 노출되지 않는다

AC-04: 조건 체크 API 호출

항목	내용
Given	팝업 노출 여부를 판단할 때
When	GET /api/user/vendors 호출 시
Then	vendors.length === 0 이면 팝업 노출

---

태스크 분해

Task 1: 노출 조건 훅 개발 AC-01, AC-02, AC-03

• [ ] 1.1: useOnboardingPopup 커스텀 훅 생성
• [ ] 1.2: 연동 마켓 수 체크 로직 (GET /api/user/vendors)
• [ ] 1.3: 조건 충족 시 팝업 상태 true 반환

Task 2: 트리거 포인트 연동 AC-01, AC-02

• [ ] 2.1: 회원가입 완료 후 훅 트리거
• [ ] 2.2: 로그인 완료 후 훅 트리거

Task 3: 팝업 렌더링 연동

• [ ] 3.1: App 레벨 또는 Layout에서 팝업 컴포넌트 마운트
• [ ] 3.2: 조건 충족 시에만 렌더링

---

Dev Notes

의존성

• E-11-S-01 (OnboardingPopup 컴포넌트) 완료 필요

로직 플로우

[가입/로그인 완료]
       │
       ▼
[GET /api/user/vendors]
       │
       ├── vendors.length >= 1 ──→ 팝업 미노출
       │
       └── vendors.length === 0 ──→ 팝업 노출

주의사항

• 별도 상태 저장 불필요 (연동 여부만 체크)
• "나중에" 클릭해도 다음 로그인 시 재노출

---

생성일: 2026-01-23