캠페인 지원
인플루언서가 방문형 캠페인에 지원하고, 점주는 승인할 신청자를 확인합니다.
통합 관리자 shell
WithPlace first| 항목 | 운영 기준 |
|---|---|
| 공통 관리자 구조 | Dashboard, Store Profile, Catalog, Campaigns, Applicants, Reservations, Proof Review, Claims, Benefits, Group-buy, Settlement, Analytics, Staff, Settings를 같은 shell에서 봅니다. |
| WithPlace adapter | 매장, 서비스/메뉴, 예약/방문, QR/GPS proof, no-show/dispute, 공동 방문, visit campaign을 운영합니다. |
| WithMall/WithDelivery/WithView | 이번 작업에서는 read-only placeholder로만 연결하며 각 vertical 내부 feature 구현은 건드리지 않습니다. |
| handoff_required | CampaignDetail/WorkflowRouter 공통 라우팅 변경은 직접 수정하지 않고 vertical=WithPlace, purchaseMode, benefitMode, actorRole 기준으로 인계합니다. |
purchaseMode / benefit engine
proof gated| mode | 이용자 안내 |
|---|---|
| general_visit | 일반 방문 예약입니다. 캠페인 정산과 인플루언서 환급은 없습니다. |
| normal_purchase | 일반 구매/예약금/선결제입니다. 매장 매출로만 처리됩니다. |
| campaign_prepurchase | 체험단 선결제 방문입니다. QR/GPS와 영수증/사진/리뷰 proof 승인 후 보상 처리됩니다. |
| group_buy | 공동구매입니다. threshold, deadline, slot hold 결과에 따라 성공/실패와 환불/해제가 갈립니다. |
| semi_trial_group_buy | 공동구매와 포스팅/리뷰 의무가 결합된 모드입니다. proof 승인 전 추가 혜택은 지급되지 않습니다. |
| benefit engine | 방문 영향력 점수, 예상 혜택, 다음 등급 조건, 지역/카테고리 적합도, QR/GPS 방문 신뢰도, 노쇼/분쟁 리스크를 설명합니다. |
| seller policy editor | 점주는 수동 tier, seller override, budget cap, auto/manual approval을 설정할 수 있습니다. |
| live blocker | provider 계약, secret wiring, finance approval, first transfer authorization 전까지 live payout은 차단됩니다. |
핵심 프로세스
방문 예약 · 선구매 · 정산신청자 선정
선정된 신청자만 예약 후보로 노출되며 예약 생성 시 캠페인, 신청, 정산 링크가 연결됩니다.
선구매 방문 예약
점주는 방문일, 보증금, 선결제 금액, 예약 메모를 주간 슬롯과 특정일 운영 예외에 맞춰 확정합니다.
현장 방문 인증
인플루언서는 영수증, 방문 사진, 리뷰 URL, 지도 핀 또는 위치 메타데이터를 모바일에서 제출합니다.
검수와 중재
점주 또는 관리자가 승인, 보완 요청, 반려, 노쇼, 페널티, 수동 지급 참조값을 처리합니다.
글로벌 정산
국가, 통화, 결제 증빙, 방문 증빙, 리뷰 증빙을 기준으로 환급금과 리워드 지급 가능 여부를 판단합니다.
역할별 사용 탭
점주 · 인플루언서 · 관리자매장과 방문 예약을 한 화면에서 운영
/seller/withplace에서 매장명, 카테고리, 연락처, 주소, 영업시간, 브레이크타임, 휴무일, 오시는 길, 주차 정보를 저장합니다.메뉴와 서비스는 사진, 가격, 설명, 소요 시간, 슬롯당 수용 인원까지 등록합니다.
예약 캘린더에서 일반 방문과 캠페인 선구매 방문을 분리하고, 승인 신청자 기반 예약을 생성합니다.
주간 수용량과 특정일 휴무/연장 영업을 비교해 예약 충돌, 마감 임박, 노쇼 후속 처리를 확인합니다.
모바일 현장 인증과 리뷰 제출
/consumer/withplace에서 방문 예정일, 매장명, 예약 상태, 선구매 증빙 상태를 확인합니다.방문 후 영수증 URL, 현장 사진, 리뷰 URL, 지도 핀 또는 위치 정보를 제출합니다.
보완 요청이 오면 누락된 영수증, 위치, 사진, 리뷰 링크를 같은 방문 건에 다시 제출합니다.
정산 화면에서는 국가, 통화, 선결제 금액, 리워드, 지급 상태, 지급 계좌 라벨을 확인합니다.
검수, 분쟁, 상점 승인, 수동 정산 중재
/admin/operations에서 매장 승인/반려/정지, 캠페인 승인/반려/강제 종료를 처리합니다.증빙 큐에서 방문 승인, 보완 요청, 반려, 노쇼 표시, 노쇼 페널티와 같은 운영 액션을 수행합니다.
수동 지급 완료 시 지급 참조값을 남겨 settlement event와 admin adjustment 추적성을 보존합니다.
실제 외부 송금은 provider onboarding, 비밀값 배선, finance approval, rollback evidence가 모두 준비된 뒤 별도 승인으로 진행합니다.
실제 화면 스크린샷
운영 화면 기준
상태값과 정산 연결
동기화 기준| 운영 단계 | 예약 상태 | 증빙 상태 | 정산 판단 | 다음 액션 |
|---|---|---|---|---|
| 예약 생성 | scheduled | pending | pending | 방문일, 선결제 금액, 캠페인/신청/정산 링크 확인 |
| 방문 대기 | scheduled | pending | pending | 점주와 인플루언서가 방문 정보 확인 |
| 증빙 제출 | visited | submitted | review | 영수증, 사진, 지도 핀, 리뷰 URL 검수 |
| 승인 완료 | completed | approved | payable | 환급금과 리워드 지급 가능 상태로 전환 |
| 보완 요청 | visited | revision_requested | review | 누락 증빙 재제출 요청 |
| 반려 또는 노쇼 | cancelled/no_show | rejected | blocked | 정산 중단, 페널티, 블랙리스트 또는 관리자 중재 |
글로벌 정산 운영 원칙
외부 증빙 필요모든 국가의 방문형 캠페인은 선구매가 기본 조건이며, 국가별 통화와 지급 수단은 country-rules와 payout readiness 기준을 따릅니다.
필수 증빙은 영수증 URL, 방문 일정, 매장명이며, 실제 지급 전에는 방문 사진, 리뷰 URL, 지도 핀, 세금 거주지, 지급 계좌 라벨이 함께 확인되어야 합니다.
외부 송금 provider는 계약 확인, schema confirmation, finance approval, rollback rehearsal, first-transfer authorization, production secret readiness가 모두 준비되기 전까지 live-money로 실행하지 않습니다.
이 HTML 매뉴얼은 운영 흐름과 화면 안내 문서이며, secret 값이나 provider credential 원문을 포함하지 않습니다.