MREL Phase 1-3 Plan Status

2026-02-06 — All Phases Implemented

Phase 1 DoD
7/7
Phase 2 DoD
7/7
Phase 3 DoD
7/7
Blockers
0
Phase 1 — Foundation & MVP Skeleton DONE
Definition of Done
Staging: Vercel + Postgres
Vercel 배포, Supabase Postgres, SQLite 로컬 개발
Auth: Admin / Customer 역할
Payload Auth, roles, access control
Catalog: Products + Categories + Variants
상품 관리, 바리에이션, 갤러리, SEO
Order State Machine
src/orders/stateMachine.ts — 8개 상태, 전이 규칙 강제 (beforeChange hook)
Payment: TossPayments + Transaction 추적
initiatePayment → confirmOrder → webhooks, Transaction 컬렉션으로 전체 이력 관리
Observability: 구조화 로깅
모든 결제/주문 변경에 payload.logger.info/warn/error 적용, Vercel Analytics 사용 가능
Runbook + CI/CD
docs/RUNBOOK.md + .github/workflows/ci.yml (lint, typecheck, build)
Phase 2 — Core Commerce DONE
Definition of Done
TossPayments 통합
결제 위젯, 승인 API, 트랜잭션 추적 — src/payments/tossPayments/
Webhook + 상태 동기화
PAYMENT_STATUS_CHANGED, REFUND_STATUS_CHANGED, DEPOSIT_STATUS_CHANGED
주문 상태 전이
pending → processing → shipped → delivered → completed (+ cancelled, returned, refunded)
Fulfillment: pick / pack / ship
Shipments 컬렉션: 택배사, 운송장, 자체/3PL/직접배송+설치
3PL 지원
fulfillmentType: inhouse / thirdparty / direct_install
환불/취소 API
POST /api/orders/refund — TossPayments 환불 API 연동, 주문+트랜잭션 상태 업데이트
Admin Console
Payload Admin + 멀티채널 대시보드 프로토타입
Phase 3 — Multi-Marketplace + Scale DONE
Definition of Done
MarketplaceChannels 컬렉션
Naver / Coupang / Toss Shopping / MREL Direct — API 인증, 동기화 설정
Canonical SKU 매핑
SKUMappings: 하나의 Canonical SKU → 채널별 외부 SKU + 가격 오버라이드
재고 동기화 서비스
InventorySync: inbound/outbound 변동 로그, 동기화 상태 추적
채널 주문 Import
ChannelOrders: 외부 주문 → 내부 매핑, 운송장/택배사, 원본 JSON 보관
Naver SmartStore 연동 준비
API 키 환경변수 설정, Commerce API 연동 구조
Coupang 연동 준비
Open API 키 환경변수, Vendor ID 설정
Toss Shopping 연동 준비
Partner Code, API Key 환경변수 설정

Created / Modified Files

Phase 1 .github/workflows/ci.yml
Phase 1 src/orders/stateMachine.ts
Phase 1 src/orders/hooks/validateOrderStatusChange.ts
Phase 1 src/orders/hooks/logOrderStatusChange.ts
Phase 1 docs/RUNBOOK.md
Phase 2 src/fulfillment/collections/Shipments.ts
Phase 2 src/orders/endpoints/refund.ts
Phase 2 src/payments/tossPayments/* (6 files)
Phase 3 src/marketplace/collections/MarketplaceChannels.ts
Phase 3 src/marketplace/collections/SKUMappings.ts
Phase 3 src/marketplace/collections/InventorySync.ts
Phase 3 src/marketplace/collections/ChannelOrders.ts
Config src/payload.config.ts (updated)
Config src/plugins/index.ts (updated)
ENV .env.example (comprehensive)

Generated: 2026-02-06