매장 온보딩
점주가 매장명, 주소, 카테고리, 영업시간, 휴무일, 주차, 메뉴, 체험 가능 슬롯, 사업자 증빙을 등록합니다.
WithPlace는 네이버 스마트플레이스형 오프라인 방문/예약 체험단을 WithPlatform 안에서 운영하기 위한 전용 시스템입니다. 이 문서는 점주, 인플루언서, 총괄 관리자가 매장 등록, 위치 기반 탐색, 선결제 예약, QR 방문 인증, 영수증/사진 리뷰 검수, 노쇼 중재, 위드캐시(WithCash) 기반 글로벌 정산까지 같은 상태값으로 움직이도록 정리한 HTML 워크플로우 문서입니다.
| 영역 | 운영 기준 |
|---|---|
| 공통 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로 남깁니다. |
| 항목 | 운영 기준 |
|---|---|
| general_visit | 일반 방문 예약이며 campaign settlement와 influencer reimbursement를 만들지 않습니다. |
| normal_purchase | 매장 서비스/예약금/선결제 일반 구매이며 seller revenue만 생성합니다. |
| campaign_prepurchase | QR/GPS + receipt/photo/review proof 승인 후 reimburse/reward가 가능하고 proof 승인 전 settlement는 금지합니다. |
| group_buy | threshold/deadline/slot hold와 success/failure 분기를 normal purchase settlement와 분리합니다. |
| semi_trial_group_buy | group-buy + posting/review obligation이며 influence score 기반 benefit을 산정하고 proof 승인 전 추가 혜택 지급을 금지합니다. |
| seller policy editor | seller_manual_tier, seller_override, budget cap, auto/manual approval toggle을 운영합니다. |
| influencer explanation | 내 방문 영향력 점수, 예상 혜택, 다음 등급 조건, 지역/카테고리 적합도, QR/GPS 신뢰도, 노쇼/분쟁 리스크를 설명합니다. |
| live blocker | provider onboarding, provider secret wiring, finance approval, first live transfer authorization 전까지 live payout은 blocked입니다. |
점주가 매장명, 주소, 카테고리, 영업시간, 휴무일, 주차, 메뉴, 체험 가능 슬롯, 사업자 증빙을 등록합니다.
관리자가 사업자 정보와 오프라인 운영 적합성을 검토하고 승인, 보완 요청, 반려, 정지 상태를 관리합니다.
인플루언서가 현재 위치, 지역, 카테고리, 예약 가능 시간, 선결제 금액, 리뷰 미션 기준으로 매장을 찾습니다.
체험 금액 또는 보증금을 먼저 결제하고 예약번호, 방문 슬롯, 취소 규정, QR 입장 코드를 발급받습니다.
방문 당일 점주가 방문자 QR코드를 스캔해 예약자 신원, 방문 시간, 캠페인 자격, 중복 체크를 확인하고 인플루언서 기기의 GPS 위치가 매장 좌표 반경과 일치하는지 백그라운드에서 교차 검증합니다.
인플루언서가 영수증, 현장 사진, 리뷰 URL, 위치 메타데이터를 업로드하고 검수 큐로 넘깁니다.
점주와 관리자가 방문 실패, 지각, QR 미스캔, 악성 리뷰, 영수증 불일치 건을 중재합니다.
승인된 방문만 국가, 통화, 세금, 지급 계좌, 위드캐시 적립 규칙을 거쳐 정산 대기 상태로 전환합니다.
관리자는 예약 전환율, 방문 인증률, 노쇼율, 리뷰 승인율, 정산 대기 금액, 매장별 성과를 확인합니다.
| 항목 | 현재 상태 | 완료 조건 |
|---|---|---|
| Repository implementation | covered | VisitCenter, StoreManager, QR/GPS backend route, static workflow가 repo-level로 존재합니다. |
| Production route smoke | covered / latest evidence required | /withplace, /guide/withplace, /withplace-workflow.html, /consumer/withplace, /seller/withplace 최신 smoke가 필요합니다. |
| VisitCenter | covered | QR pass, wake lock fallback, GPS refresh, proof upload가 모바일에서 검증되어야 합니다. |
| StoreManager | covered | QR scanner, manual QR input fallback, reservation calendar, proof review queue가 점주 세션에서 검증되어야 합니다. |
| QR/GPS backend route | covered | expired, duplicate, wrong_store, GPS mismatch가 정산 이벤트 없이 blocked/dispute/manual_review로 남아야 합니다. |
| Production D1 migration 0027 | evidence required | remote D1에서 latitude, longitude, geofence_radius_meters 컬럼 확인 JSON을 보관해야 합니다. |
| Real iPhone/Android QR/GPS | blocked | iPhone Safari/Chrome과 Android Chrome physical QR/GPS evidence가 필요합니다. |
| Payout provider onboarding/contracts | blocked | provider 계약, schema confirmation, finance/live approval, rollback rehearsal, first transfer authorization 전까지 live-money는 차단합니다. |
| GSM/Cloudflare secret readiness | blocked | 운영 credential 원문 없이 secret name/readiness evidence만 남겨야 합니다. |
| Real owner/influencer/admin sessions | blocked | 실제 역할 세션 read-only screenshot package와 authenticated real-data UI audit가 필요합니다. |
/seller/withplace에서 매장명, 대표 사진, 카테고리, 주소, 좌표, 연락처, 오시는 길, 주차, 편의시설을 입력합니다.visited로 전환하고, 지각/미방문/대리 방문 의심은 노쇼 또는 분쟁 상태로 보류합니다./consumer/withplace에서 현재 위치, 지도 반경, 지역명, 카테고리, 예약 가능일, 제공 혜택을 기준으로 매장을 검색합니다./admin/operations에서 신규 매장의 사업자 증빙, 주소 좌표, 카테고리, 영업시간, 메뉴 가격, 체험 가능성을 검토합니다.대표 이미지, 지도, 주소, 전화, 영업상태, 메뉴, 편의시설, 리뷰 미션, 예약 가능 슬롯을 한 화면에 배치합니다.
검색 결과는 거리순뿐 아니라 오늘 예약 가능, 이번 주 마감 임박, 선결제 금액, 리뷰 난이도 기준으로 정렬합니다.
스마트플레이스 예약 확인처럼 QR 스캔, 예약자 확인, 방문 상태 변경, 노쇼 처리, 현장 메모를 모바일 점주 화면에서 처리합니다.
지도 리뷰 URL, 영수증, 현장 사진, 방문 시간의 일치 여부를 자동 플래그로 표시하고 관리자 중재 큐로 넘깁니다.
임시 휴무, 브레이크타임, 공휴일, 특정일 예약 제한이 일반 예약과 체험단 예약에 동시에 반영됩니다.
외국인 인플루언서에게 예약 안내, QR 체크인, 리뷰 제출, 정산 상태를 언어별로 제공할 수 있게 설계합니다.
| 단계 | 예약 상태 | QR 상태 | 증빙 상태 | 정산 상태 | 운영 액션 |
|---|---|---|---|---|---|
| 매장 승인 전 | locked | not_issued | not_required | blocked | 관리자 승인 또는 보완 요청 |
| 예약 완료 | scheduled | issued | pending | pending | 방문 리마인더와 취소 규정 안내 |
| 현장 도착 | arrived | scan_pending | pending | pending | 점주 QR 스캔으로 신원 확인 |
| QR 인증 완료 | visited | scanned | pending | review | 영수증과 사진 리뷰 업로드 요청 |
| 리뷰 제출 | visited | scanned | submitted | review | 점주 또는 관리자 검수 |
| 승인 완료 | completed | scanned | approved | payable | 위드캐시 적립과 지급 대기 등록 |
| 보완 요청 | visited | scanned | revision_requested | review | 누락 자료 재제출 요청 |
| 노쇼/반려 | no_show | missing_or_invalid | rejected | blocked | 분쟁 코드, 페널티, 정산 차단 |