WithPlace Workflow Document

WithPlace 예약 방문 인증 워크플로우

WithPlace는 네이버 스마트플레이스형 오프라인 방문/예약 체험단을 WithPlatform 안에서 운영하기 위한 전용 시스템입니다. 이 문서는 점주, 인플루언서, 총괄 관리자가 매장 등록, 위치 기반 탐색, 선결제 예약, QR 방문 인증, 영수증/사진 리뷰 검수, 노쇼 중재, 위드캐시(WithCash) 기반 글로벌 정산까지 같은 상태값으로 움직이도록 정리한 HTML 워크플로우 문서입니다.

통합 관리자 shell

WithPlace adapter implemented
영역 운영 기준
공통 shell Dashboard, Business / Store Profile, Catalog, Campaigns, Applicants, Orders / Reservations, Proof Review, Claims / Disputes, Marketing / Benefits, Group-buy, Settlement / Payout, Analytics, Staff / Permissions, Settings를 같은 구조로 제공합니다.
WithPlace adapter Place / Store, Service / Menu, Reservation / Visit, QR/GPS proof, No-show, Group visit, Visit campaign을 첫 완성 adapter로 연결합니다.
Other vertical placeholders WithMall, WithDelivery, WithView는 이번 branch에서 read-only placeholder bridge로만 표시하고 내부 feature 구현은 수정하지 않습니다.
Routing handoff CampaignDetail/WorkflowRouter 공통 라우팅은 직접 수정하지 않고 vertical=WithPlace, purchaseMode, benefitMode, actorRole 변경 필요 사항을 handoff_required로 남깁니다.

purchaseMode / benefit engine

settlement separation
항목 운영 기준
general_visit일반 방문 예약이며 campaign settlement와 influencer reimbursement를 만들지 않습니다.
normal_purchase매장 서비스/예약금/선결제 일반 구매이며 seller revenue만 생성합니다.
campaign_prepurchaseQR/GPS + receipt/photo/review proof 승인 후 reimburse/reward가 가능하고 proof 승인 전 settlement는 금지합니다.
group_buythreshold/deadline/slot hold와 success/failure 분기를 normal purchase settlement와 분리합니다.
semi_trial_group_buygroup-buy + posting/review obligation이며 influence score 기반 benefit을 산정하고 proof 승인 전 추가 혜택 지급을 금지합니다.
seller policy editorseller_manual_tier, seller_override, budget cap, auto/manual approval toggle을 운영합니다.
influencer explanation내 방문 영향력 점수, 예상 혜택, 다음 등급 조건, 지역/카테고리 적합도, QR/GPS 신뢰도, 노쇼/분쟁 리스크를 설명합니다.
live blockerprovider onboarding, provider secret wiring, finance approval, first live transfer authorization 전까지 live payout은 blocked입니다.

전체 예약 방문 인증 흐름

예약 · QR · 리뷰 · 정산
1

매장 온보딩

점주가 매장명, 주소, 카테고리, 영업시간, 휴무일, 주차, 메뉴, 체험 가능 슬롯, 사업자 증빙을 등록합니다.

2

매장 승인

관리자가 사업자 정보와 오프라인 운영 적합성을 검토하고 승인, 보완 요청, 반려, 정지 상태를 관리합니다.

3

위치 기반 탐색

인플루언서가 현재 위치, 지역, 카테고리, 예약 가능 시간, 선결제 금액, 리뷰 미션 기준으로 매장을 찾습니다.

4

선결제 예약

체험 금액 또는 보증금을 먼저 결제하고 예약번호, 방문 슬롯, 취소 규정, QR 입장 코드를 발급받습니다.

5

현장 QR 인증

방문 당일 점주가 방문자 QR코드를 스캔해 예약자 신원, 방문 시간, 캠페인 자격, 중복 체크를 확인하고 인플루언서 기기의 GPS 위치가 매장 좌표 반경과 일치하는지 백그라운드에서 교차 검증합니다.

6

영수증 리뷰 제출

인플루언서가 영수증, 현장 사진, 리뷰 URL, 위치 메타데이터를 업로드하고 검수 큐로 넘깁니다.

7

분쟁 및 노쇼 처리

점주와 관리자가 방문 실패, 지각, QR 미스캔, 악성 리뷰, 영수증 불일치 건을 중재합니다.

8

위드캐시 정산

승인된 방문만 국가, 통화, 세금, 지급 계좌, 위드캐시 적립 규칙을 거쳐 정산 대기 상태로 전환합니다.

9

통계 리포트

관리자는 예약 전환율, 방문 인증률, 노쇼율, 리뷰 승인율, 정산 대기 금액, 매장별 성과를 확인합니다.

Repository 구현 / Production smoke / Live launch closeout 상태표

live-complete 아님
항목 현재 상태 완료 조건
Repository implementationcoveredVisitCenter, StoreManager, QR/GPS backend route, static workflow가 repo-level로 존재합니다.
Production route smokecovered / latest evidence required/withplace, /guide/withplace, /withplace-workflow.html, /consumer/withplace, /seller/withplace 최신 smoke가 필요합니다.
VisitCentercoveredQR pass, wake lock fallback, GPS refresh, proof upload가 모바일에서 검증되어야 합니다.
StoreManagercoveredQR scanner, manual QR input fallback, reservation calendar, proof review queue가 점주 세션에서 검증되어야 합니다.
QR/GPS backend routecoveredexpired, duplicate, wrong_store, GPS mismatch가 정산 이벤트 없이 blocked/dispute/manual_review로 남아야 합니다.
Production D1 migration 0027evidence requiredremote D1에서 latitude, longitude, geofence_radius_meters 컬럼 확인 JSON을 보관해야 합니다.
Real iPhone/Android QR/GPSblockediPhone Safari/Chrome과 Android Chrome physical QR/GPS evidence가 필요합니다.
Payout provider onboarding/contractsblockedprovider 계약, schema confirmation, finance/live approval, rollback rehearsal, first transfer authorization 전까지 live-money는 차단합니다.
GSM/Cloudflare secret readinessblocked운영 credential 원문 없이 secret name/readiness evidence만 남겨야 합니다.
Real owner/influencer/admin sessionsblocked실제 역할 세션 read-only screenshot package와 authenticated real-data UI audit가 필요합니다.

판매자/광고주 워크플로우

오프라인 점주

매장 정보 등록

/seller/withplace에서 매장명, 대표 사진, 카테고리, 주소, 좌표, 연락처, 오시는 길, 주차, 편의시설을 입력합니다.
네이버 스마트플레이스처럼 영업시간, 브레이크타임, 정기 휴무, 공휴일 예외, 메뉴/서비스 가격, 대표 키워드를 관리합니다.
사업자등록증과 매장 실소유 확인 자료를 업로드하고 승인 전에는 예약 판매를 열 수 없습니다.

예약 캘린더 관리

요일별 슬롯, 특정일 예외, 슬롯당 수용 인원, 선결제 금액, 취소 마감 시간을 설정합니다.
승인된 체험단 예약과 일반 예약을 분리해 중복 예약, 초과 예약, 임시 휴무 충돌을 차단합니다.
예약 확정 시 방문자에게 예약번호와 일회성 QR코드가 발급되고 점주 콘솔에는 스캔 대기 상태로 표시됩니다.

QR 방문 확인과 노쇼 관리

방문 당일 점주는 QR 스캔 화면에서 예약자 이름 마스킹, 예약 시간, 캠페인명, 선결제 상태, 중복 스캔 여부를 확인합니다.
단순 QR 스캔뿐만 아니라, 인플루언서 기기의 GPS 위치가 매장 좌표와 일치하는지 백그라운드에서 교차 검증해 대리 출석 어뷰징을 방지합니다.
예약 시간 기준 30분 초과 시점까지 QR 스캔이 없으면 점주 예약 캘린더에 [수동 노쇼(No-show) 처리] 버튼이 활성화됩니다.
정상 방문은 visited로 전환하고, 지각/미방문/대리 방문 의심은 노쇼 또는 분쟁 상태로 보류합니다.
정산 전에는 영수증 금액, 방문 시간, 리뷰 URL을 확인하고 승인 또는 보완 요청을 처리합니다.

인플루언서/소비자 워크플로우

탐색 · 예약 · 인증

위치 기반 매장 탐색

/consumer/withplace에서 현재 위치, 지도 반경, 지역명, 카테고리, 예약 가능일, 제공 혜택을 기준으로 매장을 검색합니다.
매장 상세에서는 사진, 메뉴, 체험 조건, 선결제 금액, 리뷰 미션, 취소 규정, 방문 가능 슬롯을 확인합니다.
찜, 최근 본 매장, 가까운 예약 가능 매장, 마감 임박 슬롯을 제공해 네이버 플레이스형 탐색 경험을 만듭니다.

선결제 및 예약

인플루언서는 본인 계정, 예약 날짜, 방문 인원, 요청사항을 확인하고 선결제 또는 보증금 결제를 완료합니다.
예약 완료 후 예약번호, 매장 주소, 취소 가능 시간, QR코드, 리뷰 제출 마감 시간이 모바일 화면에 표시됩니다.
QR코드 발급 및 열람 시, 기기의 위치 정보(GPS) 접근 권한 동의를 필수로 요청하여 점주 스캔 시 교차 검증에 대비합니다.
방문 전 리마인더는 예약 시간, 지도 링크, 신분 확인 기준, QR 체크인 안내를 함께 전달합니다.

현장 방문 및 리뷰 업로드

현장에서 QR을 제시하고 점주의 스캔이 완료되면 방문 인증 시각과 매장 좌표가 기록됩니다.
체험 후 영수증 이미지 또는 URL, 매장 사진, 리뷰 URL, 추가 코멘트를 제출합니다.
리뷰 보완 요청(반려) 시 24시간 이내에 재제출해야 하며, 기한 만료 시 페널티가 부여됩니다.
보완 요청 시 같은 예약 건에 누락 자료를 재업로드하고, 승인 후 환급/리워드 정산 상태를 확인합니다.

위드플랫폼 총괄 관리자 워크플로우

승인 · 분쟁 · 정산 · 통계

매장 승인과 품질 관리

/admin/operations에서 신규 매장의 사업자 증빙, 주소 좌표, 카테고리, 영업시간, 메뉴 가격, 체험 가능성을 검토합니다.
보완 요청에는 필수 수정 항목을 남기고, 반복 위반 매장은 예약 노출 중단 또는 정지 상태로 전환합니다.
매장별 예약 전환율, QR 인증률, 리뷰 승인률, 노쇼율을 기준으로 운영 품질을 등급화합니다.

악성 리뷰 및 노쇼 분쟁 중재

QR 스캔 기록, 예약 시간, 영수증 금액, 사진 메타데이터, 리뷰 URL, 점주 메모를 한 화면에서 비교합니다.
무단 불참, QR 미스캔, 허위 영수증, 악성 리뷰, 점주 부당 반려를 각각 다른 분쟁 코드로 분리합니다.
중재 결과는 페널티, 재방문 요청, 리뷰 수정 요청, 정산 차단, 수동 승인으로 이어집니다.

글로벌 다국어 정산과 통계

국가, 통화, 언어, 세금 거주지, 지급 계좌 라벨을 기준으로 다국어 정산 안내를 제공합니다.
위드캐시 연동은 승인된 방문 금액을 포인트 단위로 적립하고 지급 대기, 지급 완료, 회수 상태를 추적합니다.
관리자 통계는 예약 매출, 선결제 보증금, 방문 인증률, 리뷰 발행률, 노쇼 비용, 정산 예정액을 매장/지역/카테고리별로 집계합니다.

네이버 스마트플레이스 벤치마킹 설계

WithPlace 맞춤 기능

플레이스형 매장 상세

대표 이미지, 지도, 주소, 전화, 영업상태, 메뉴, 편의시설, 리뷰 미션, 예약 가능 슬롯을 한 화면에 배치합니다.

예약 가능 시간 우선 노출

검색 결과는 거리순뿐 아니라 오늘 예약 가능, 이번 주 마감 임박, 선결제 금액, 리뷰 난이도 기준으로 정렬합니다.

점주 현장 체크인

스마트플레이스 예약 확인처럼 QR 스캔, 예약자 확인, 방문 상태 변경, 노쇼 처리, 현장 메모를 모바일 점주 화면에서 처리합니다.

리뷰 품질 검수

지도 리뷰 URL, 영수증, 현장 사진, 방문 시간의 일치 여부를 자동 플래그로 표시하고 관리자 중재 큐로 넘깁니다.

현장 운영 예외

임시 휴무, 브레이크타임, 공휴일, 특정일 예약 제한이 일반 예약과 체험단 예약에 동시에 반영됩니다.

다국어 운영

외국인 인플루언서에게 예약 안내, QR 체크인, 리뷰 제출, 정산 상태를 언어별로 제공할 수 있게 설계합니다.

상태값 매트릭스

시스템 동기화 기준
단계 예약 상태 QR 상태 증빙 상태 정산 상태 운영 액션
매장 승인 전lockednot_issuednot_requiredblocked관리자 승인 또는 보완 요청
예약 완료scheduledissuedpendingpending방문 리마인더와 취소 규정 안내
현장 도착arrivedscan_pendingpendingpending점주 QR 스캔으로 신원 확인
QR 인증 완료visitedscannedpendingreview영수증과 사진 리뷰 업로드 요청
리뷰 제출visitedscannedsubmittedreview점주 또는 관리자 검수
승인 완료completedscannedapprovedpayable위드캐시 적립과 지급 대기 등록
보완 요청visitedscannedrevision_requestedreview누락 자료 재제출 요청
노쇼/반려no_showmissing_or_invalidrejectedblocked분쟁 코드, 페널티, 정산 차단