사용 안내

시작하기 · 공통

HPNK-SHOP은 K-상품과 글로벌 셀러를 다국어·다통화로 잇는 멀티벤더 커머스입니다. 이용 주체는 다음 세 가지 권한으로 나뉘며, 각 권한의 진입점이 다릅니다.

권한	하는 일	진입 경로
회원(구매자)	상품 탐색·구매, 장바구니/찜, 주문 조회	`/ko` 공개 쇼핑몰
셀러(판매자)	상품 등록·판매, 주문 발송, 정산 확인	`/seller-admin`
플랫폼 관리자	셀러·상품·주문·정산·환율 운영 전반	`/admin`

언어 · 통화 전환

상단 헤더 우측의 통화 칩(KRW/USD/IDR)과 언어 칩(KO/EN/ID)으로 언제든 전환할 수 있습니다. 선택값은 쿠키에 저장됩니다.

🛍️

1. 회원(구매자) 가이드

상품을 탐색하고 구매하는 일반 이용자를 위한 기능입니다. 로그인 없이도 둘러보기·장바구니 담기가 가능하며, 주문 시 로그인이 필요합니다.

가입 · 로그인

회원가입: /ko/member/signup — 이메일 + 비밀번호로 가입.
Google 로그인: 소셜 로그인을 지원합니다(운영에서 Google OAuth 키 설정 시 활성).
로그인: /ko/login. 로그인 후에는 보호된 페이지(찜·체크아웃·주문)로 자동 복귀합니다.

상품 탐색

전체 상품 /ko/products — 검색어·카테고리 필터와 정렬을 제공합니다.
카테고리 /ko/categories → 카테고리별 상품 목록.
통합 검색 /ko/shop/search?q=검색어 — 상품명 등으로 검색.
상품 상세 — 가격은 선택한 표시 통화로 환산되어 보이며, 셀러 정보·배송/반품 정책을 함께 확인할 수 있습니다.
셀러샵 /@셀러slug — 특정 셀러의 상품·소개·정책을 모아 봅니다(예: /@seoul-kbeauty).

장바구니 · 찜

장바구니 /ko/cart — 비회원(게스트)도 담을 수 있으며, 상품은 셀러별로 묶여 표시됩니다(셀러별 배송).
찜(위시리스트) /ko/wishlist — 로그인 후 관심 상품을 저장.

주문 · 결제

장바구니에서 주문하기 → 로그인 → 체크아웃 /ko/checkout.
받는 사람·배송지·국가를 입력합니다.
결제 진행 → 주문 생성. 주문 시점의 환율이 스냅샷으로 저장되어 이후 환율이 바뀌어도 결제 금액은 고정됩니다.
주문 내역 /ko/orders에서 진행 상태(결제완료 → 준비 → 배송 → 배송완료)를 확인합니다.

현재 결제는 테스트용 mock으로 즉시 성공 처리됩니다(실 PG 미연동). 참고 · 현재 상태

상품 리뷰

결제완료한 상품의 상세 페이지에서 별점(1~5)·제목·내용·사진으로 리뷰를 작성할 수 있습니다(구매 인증 표시).
상품당 1개의 리뷰를 쓰며, 작성 후 수정·삭제가 가능합니다. 다른 사람의 리뷰에는 "도움돼요"·신고를 할 수 있습니다.

셀러 입점 신청

판매를 원하면 로그인 후 /ko/become-seller에서 입점을 신청합니다. 자세한 흐름은 셀러 가이드를 참고하세요.

🏪

2. 셀러(판매자) 가이드

입점 승인을 받은 판매자가 상품을 등록·판매하고 주문을 처리하는 워크스페이스(/seller-admin)입니다. 별도 계정이 아니라 회원 계정에 셀러 권한이 연결되는 방식입니다.

입점 → 승인 흐름

회원 가입/로그인 후 /ko/become-seller에서 셀러 신청(표시명·셀러 URL slug·사업자 정보).
관리자가 신청을 승인하면 셀러로 등록됩니다(초기 상태 심사중 reviewing).
관리자가 활성(active)으로 전환하면 셀러샵이 공개되고 판매가 시작됩니다.

셀러 상태: reviewing(심사중) · active(영업중) · private(비공개) · suspended(정지). 정지 상태에서는 조회만 가능하고 등록·수정은 차단됩니다.

셀러 관리자 메뉴

대시보드 /seller-admin

매출·주문·재고 KPI 요약.

판매 상품 /seller-admin/products

플랫폼 마스터 상품을 검색·연결한 뒤 판매가·세일가·재고정책(수량/무제한)·배송/반품 정책·추천 여부를 설정. 활성/비활성 토글로 노출 제어.

주문 관리 /seller-admin/orders

내 셀러 주문을 확인하고 상태를 전이(접수 → 준비 → 배송 → 배송완료)하며 발송 처리.

매출 · 정산 /seller-admin/revenue · /settlements

매출 현황과 정산 내역(수수료 차감 후 지급액)을 확인.

셀러샵 설정 /seller-admin/shop

로고·배너·소개/공지(다국어). 공개 URL은 /@셀러slug.

프로필 · 정책 /seller-admin/profile · /policies

정산 계좌 정보, 배송/반품 정책 관리. 고객 문의 응대(/inquiries).

수수료는 셀러별로 설정되며 기본 10%입니다. 주문 시점의 수수료율이 정산에 스냅샷으로 적용됩니다.

🛠️

3. 플랫폼 관리자 가이드

플랫폼 운영 전반(셀러·상품·주문·정산·환율)을 담당합니다. 운영자 계정으로 /admin/login에서 로그인합니다. 비밀번호를 여러 번 틀리면 계정이 일정 시간 잠깁니다.

셀러 · 상품 운영

셀러 신청 /admin/seller_applications — 입점 신청 심사(승인/거절).
셀러 관리 /admin/sellers — 정보 수정, 정지/활성 전환.
셀러샵 상태 /admin/seller_shops — 공개/비공개 상태 관리.
마스터 상품 /admin/master_products — 플랫폼 공통 상품 원장(SKU·가격·카테고리·다국어명·이미지) CRUD. 셀러는 이를 연결해 판매합니다.
카테고리 /admin/product_categories — 공통 카테고리(계층·다국어) 관리.

주문 · 정산 · 통화

주문 /admin/orders(전체) · /admin/seller_orders(셀러별, 상태 변경).
통화 /admin/currencies — 지원 통화 관리/활성화.
환율 /admin/exchange_rates — KRW 기준 USD/IDR 환율 수동 등록/수정.
정산 /admin/settlements — 기간별 셀러 정산 생성 및 상태 전이(pending → confirmed → payable → paid, 보류/취소 분기).

모니터링 · 권한

Provider 로그 /admin/provider_logs — 결제·배송·환율 외부 호출 기록.
감사 로그 /admin/audit_logs — 주문·정산·셀러 승인 등 민감 작업 추적(추가만 가능, 수정 불가).
통계 /admin/statistics — 판매 통계.
권한(RBAC) — 역할(Role)별 읽기/쓰기 권한으로 메뉴 접근이 제어됩니다(super_admin은 전체 접근).

다국어 · 다통화

언어: 한국어(ko) · 영어(en) · 인도네시아어(id). URL 접두(/en 등) 또는 헤더 언어 칩으로 전환. 번역이 없으면 id → en → ko 순으로 대체됩니다.
통화: KRW · USD · IDR. 내부 기준 통화는 KRW이며, 표시 통화는 환율로 환산됩니다.
환율 스냅샷: 주문 생성 시점의 환율이 주문에 저장되어, 이후 환율 변동과 무관하게 결제 금액이 유지됩니다.

참고 · 현재 상태

미연동 / 준비 중 항목

결제·배송·알림·환율은 현재 mock(테스트) 어댑터로 동작합니다. 실 연동은 운영 키 설정과 provider 전환이 필요합니다.
고객 문의, 환불 플로우, 구독/광고 수익모델은 골격/준비 중 상태입니다.

로컬 테스트 계정·시드 데이터·환경변수 등 개발/운영 상세는 저장소 문서 docs/SITE_MANUAL.md 와 README.md 를 참고하세요.

보안: 로그인·가입 등 주요 폼은 reCAPTCHA와 요청 빈도 제한(rate limiting)으로 보호됩니다.

HPNK-SHOP 이용 가이드