QR Deferred DeepLink 기획 문서

서비스 흐름도

QR 스캔부터 첫 주문까지 전체 유저 시나리오 · 예외 처리 흐름

Happy Path — 전체 흐름

ADM
QR 발급

담당자
QR 보유

식당
QR 스캔

랜딩페이지
ref?code=test001

iOS

클립보드 자동 복사

Android

Referrer 파라미터 보존

앱 설치 완료

앱 첫 실행 — 코드 조회

성공

유실

코드 자동 입력
read-only

Fingerprint fallback

회원가입 완료
담당자 매핑 저장

담당자 푸시 알림

첫 주문 완료 ✓

예외 처리 흐름

비정상 스캔

기준: 30분 내 30회 초과

→ 자동 플래그 + 알림

동일 기기 복수 QR 스캔

기준: 3개 이상 다른 QR

→ 이상 감지 플래그 등록

iOS 클립보드 코드 유실

앱 첫 실행 시 코드 조회 실패

→ Fingerprint 매칭 fallback

담당자 비활성

ADM에서 삭제 시 비활성 처리

→ QR 즉시 비활성 / 기존 가입 식당 유지

QR 스캔 상세 플로우 — 설치 여부 · 로그인 여부 분기

시스템 구조도

ADM 화면 구성 · 앱 가입 화면 · 데이터 모델

ADM 화면 구성 — 오더히어로 관리 > QR 관리

QR 관리 ADM

대시보드

가입 완료 · 첫 주문 완료 현황 요약

오늘 기준 수치

QR 관리

담당자 이름 입력 + 추천인 아이디 입력 + 비고 입력으로 QR 생성 · 미리보기 즉시 노출 · PNG 다운로드 · 링크 복사

목록: 담당자(추천인ID) · 비고 · 가입수 · 상태 · 상세보기/비활성

QR 상세보기

우측 슬라이드 드로어로 노출. 발급된 QR 이미지 · 링크 주소 · 다운로드 · 링크 복사 · 담당자명/추천인ID/비고 수정 · 상태 확인

저장 시 목록 행 즉시 반영

전환 퍼널

월별/일별 · 담당자별 퍼널 필터 조회 (2단계). 직접 입력 선택 시 날짜 범위 입력 필드 노출

가입 → 첫주문 단계별 수치. 담당자별 가입수/첫주문수 비교

이벤트 로그

가입/주문 이벤트 실시간 조회 · 기간/담당자/유형 검색 · 발생 일시(YYYY-MM-DD HH:MM:SS) 노출 · 첫 주문 완료 시 주문 금액 노출

event_type(signup/first_order) · seller_code · 발생일시 · amount(first_order)

앱 가입 화면 흐름 (오더히어로 앱)

Step 1

랜딩페이지

담당자명 노출
앱스토어 / 구글플레이 버튼
iOS: 클립보드 자동 복사
"설치 후 추천코드 자동 입력" 안내

›

Step 2

회원가입 화면

사업자명
사업자번호
연락처
추천인 코드 — 자동입력 + read-only

›

Step 3

가입 완료

완료 메시지
담당자 연락 예고
담당자에게 푸시 알림 즉시 발송

데이터 모델

sellers 담당자

idINTPK

nameVARCHAR담당자 입력값

ref_idVARCHAR추천인 아이디

noteTEXT비고 (nullable)

statusENUMactive / inactive

qr_codes QR 코드

codeVARCHARPK

seller_idINTFK

statusENUMactive / inactive

expires_atDATETIMENULL = 상시

created_atDATETIME

referral_events 이벤트 로그

idINTPK

event_typeENUMsignup/first_order

seller_codeVARCHARFK

amountINTfirst_order 시 주문금액

device_idVARCHAR

ipVARCHAR

restaurant_idINTnullable

created_atDATETIME

restaurants 식당

idINTPK

nameVARCHAR

business_numberVARCHAR

seller_codeVARCHARFK

joined_atDATETIME

테이블 관계

sellers──1:N──›qr_codes발급

sellers──1:N──›restaurants유치

qr_codes──1:N──›referral_events스캔