여러 판매자의 상품을 구매자 통화로 표시하고 결제 시점 환율로 청구액을 확정하며, 대금은 배송 완료까지 묶어 두었다가 판매자·플랫폼·배송사 몫으로 나눠 정산하고, 해외 배송 추적과 반품·분쟁 시 부담 주체를 규칙으로 판정하는 마켓플레이스
‘MVP 기획’·‘AI 빌드 기획 패키지’·‘프로토타입 프롬프트’는 빌드 패키지 하나에 함께 들어갑니다 — 따로 결제하지 않습니다.
무엇을 만드나?
MVP 기획 · 베타 무료
PRD·기능정의·화면목록·DB·API 계약까지 — 이 자료로 저희가 먼저 만들어 확인시켜드리거나, 직접 개발에 바로 쓰실 수 있습니다.
샘플은 여기까지 공개합니다
파일 다운로드와 전문(全文) 복사는 실제 결과물에서만 제공됩니다. 내 아이디어를 입력하면 같은 형식의 결과물을 받아볼 수 있습니다.
국내 사업자가 해외로 온라인 상품을 판매할 수 있도록, 상품등록·주문·결제·배송·정산·분쟁처리를 웹 한 곳에서 쉽게 지원하는 최소기능 마켓플레이스를 만듭니다. 복잡한 자동화 없이 기본 흐름과 핵심 관리화면을 우선 확보하는 게 목표입니다.
국내 소상공인이 해외 소비자에게 상품을 쉽게 판매할 수 있도록, 결제·배송·정산·분쟁처리의 복잡성을 플랫폼이 기본적으로 해결해주는 최소기능의 웹 기반 글로벌 마켓플레이스입니다.
목표
비목표(1차 제외)
상품 등록 및 목록 표시
“판매자는 상품을 등록하고, 구매자는 그 목록과 상세를 볼 수 있습니다.”
주문/결제
“구매자가 상품을 장바구니에 담고, 수량/주소 입력 후 주문 및 결제할 수 있습니다.”
배송상태 연동 및 주문내역 조회
“구매자는 주문한 상품의 배송상태를 트래킹넘버로 조회할 수 있고, 판매자도 확인할 수 있습니다.”
대금 정산 로직 및 현황 관리
“플랫폼 운영자는 각 주문의 대금을 판매자, 플랫폼 수수료로 나누어 정산상태를 관리할 수 있습니다.”
기초 분쟁/반품 처리 및 책임 배분
“분쟁 또는 반품 발생 시, 어느 쪽(판매자/구매자/플랫폼)이 어떤 부담을 지게 되는지 시스템에서 기본 판정하고 처리할 수 있습니다.”
상품/주문/결제/정산/분쟁의 기본적 흐름과 관리자화면까지 포함된 MVP (웹/Next.js/Supabase auth only).
1단계 — 핵심 거래흐름(상품, 주문, 결제, 배송조회)
상품등록~목록~상세(이미지 포함), 구매자 장바구니/주문/결제(환율·USD 고정), 배송정보입력(트래킹넘버 저장·간단조회), 가입/로그인, 내 주문·내 판매내역 조회 등 거래 기본흐름. 권한별 최소 관리자(운영자) 대시보드 진입.
2단계 — 정산/분쟁 및 운영자 관리
대금 분리정산(판매자/플랫폼 수수료), 정산상태표, 분쟁기록·담당자배분·책임자 지정/변경 로직, 운영자 전용 대시보드, 커스텀 필터링/검색 등 보조.
견적 참고 · 모든 인증/쓰기동작은 Supabase Auth, 정책 및 서버컴포넌트로 보호. 과도한 자동화/추가기능(환율API, 멀티언어 등)은 1차범위 엄격히 제외하여 구성.
랜딩·메인페이지 /
상품 목록(카드뷰) · 로그인/회원가입 버튼 · 주요 안내/슬로건
상태: 상품 로딩, 상품 데이터 리스트, 로그인 상태
상품 상세 페이지 /products/[productId]
상품 이미지 · 상품명/설명/가격 표시 · 장바구니 담기 · 구매 버튼
상태: 상품 상세 데이터, 장바구니 담김 상태
주문 및 결제 화면 /checkout
장바구니 리스트 · 주소/수량 입력 폼 · 결제 버튼 · 총액·환율 정보 표시
상태: 장바구니 데이터, 결제 진행/완료 상태, 에러 메시지
주문내역·배송 상태 조회 /orders
주문 리스트 · 배송상태·트래킹넘버 · 상세보기(주문상세, 분쟁신청 등)
상태: 로그인 사용자 주문 데이터, 배송상태 로딩
판매자 상품·주문 관리 /seller/dashboard
상품 등록/수정/삭제 · 판매된 주문 리스트 · 배송 상태/트래킹번호 입력
상태: 판매자 상품 데이터, 판매 주문 데이터
운영자 정산/분쟁 관리 /admin/settlement
미정산 주문/정산 상태표 · 분쟁 내역/책임자 변경 폼 · 정산상태 변경/수정
상태: 관리자 권한 여부, 전체 주문/정산/분쟁 데이터
users
products
orders
shipments
payments
settlements
disputes
# API/Server Actions Spec | 기능 | METHOD | 경로/액션 | 인증 | 입력(body/params) | 출력(response) | |--------------------|--------|------------------------------------------|------------|--------------------------------------------|------------------------------------------| | 회원가입 | POST | /api/auth/signup | X(익명) | email, password, role | User 객체 | | 로그인 | POST | /api/auth/signin | X(익명) | email, password | 세션/토큰 생성, User 객체 | | 상품 목록 | GET | /api/products | X(공개) | page?, limit? | Product[] 페이징 | | 상품 상세 | GET | /api/products/:id | X(공개) | id | Product | | 상품 등록 | POST | /api/products | 판매자만 | name, description, price_usd | Product | | 주문 생성 | POST | /api/orders | 구매자만 | product_id, quantity, order_currency, 주문통화 | Order |
나머지 18줄은 실제 결과물에서 확인할 수 있습니다
# 주요 의사결정과 리스크 ● Supabase Auth 단일 인증 (외부 인증 직접 구현X) - 리스크: 공급자(판매자), 운영자 권한 분리 유지 필수. 규칙 미흡시 정보누출·오용 가능. → 역할별 권한 체크 서버에서 모두 강제. ● 실시간 환율/복합정산/다국어 등 생략 (MVP) - 리스크: 실제 해외사용 측면에서는 통화 차이, 복잡 정산 누락 등 오해 가능. → 가격·정산 고정, 문서/툴팁으로 안내. ● 주문·결제·정산 상태 분리 관리(Data Integrity) - 리스크: 클린업 및 상태 동기화 실패 시 유실·중복 위험 → 각 단계마다 status 필드 강제, 중복결제 방지 체크 구현.
나머지 9줄은 실제 결과물에서 확인할 수 있습니다
# 수용 테스트 체크리스트 회원 - [ ] 회원가입: 이메일/비밀번호/역할로 신규 가입 성공(중복 불가) - [ ] 로그인: 정확한 정보로 성공 및 잘못된 정보 시 실패 - [ ] 인증 필요 API(주문, 결제 등)는 미로그인시 401 반환 - [ ] 역할별 데이터 범위 다름 (구매자는 내 주문만, 판매자는 내 상품/주문만) 상품 - [ ] 상품 목록/상세: 비회원 포함 누구나 전체 상품 조회 가능
나머지 23줄은 실제 결과물에서 확인할 수 있습니다
M0프로젝트 초기화 및 기본 구조 세팅
M1DB 모델 설계 및 시드
M2기본 API와 서버 컴포넌트 통합
M3운영자 정산/분쟁처리 등 핵심 로직 적용
핵심이 동작하는 결과물로 먼저 만들어 확인하실 수 있도록 검토해 드립니다. 검증된 전문가에게 직접 의뢰할 수도 있습니다.
이 자료로 저희가 먼저 만들어 확인시켜드리거나, 개발자에게 그대로 전달할 수 있습니다.