Saleor
Saleor는 Python/Django 기반의 오픈소스 headless commerce 플랫폼으로, GraphQL API를 통해 모든 상거래 기능을 제공한다.
개요
Saleor는 composable commerce 철학을 따르는 API-first 커머스 엔진이다. 모놀리식 커머스 플랫폼과 달리 프론트엔드와 백엔드가 완전히 분리되어 있어, 📚 222 Next.js 같은 프레임워크로 자유롭게 스토어프론트를 구축할 수 있다.
백엔드는 📚 231 PostgreSQL을 데이터베이스로 사용하며, Redis를 캐시와 작업 큐로 활용하는 서비스 지향 아키텍처를 채택하고 있다. 수평 확장이 가능한 Web Worker와 Background Worker 구조로 대규모 트래픽을 처리한다.
핵심 특징
- GraphQL 전용 API — REST 없이 GraphQL만으로 모든 조회와 변경을 처리한다. Webhook subscription까지 GraphQL로 제어할 수 있어 서드파티 앱도 동일한 유연성을 갖는다.
- Composable 아키텍처 — 각 컴포넌트를 독립적으로 교체할 수 있어, 전체 시스템을 재구축하지 않고도 점진적으로 개선할 수 있다.
- 멀티채널 — 하나의 백엔드에서 여러 판매 채널(온라인몰, 마켓플레이스, 오프라인 등)을 통합 관리한다.
- 확장 가능한 앱 시스템 — Dashboard 앱과 외부 통합을 직접 개발하여 플랫폼을 확장할 수 있다.
주요 레시피
- 멀티 리전 — 지역, 통화, 스토어프론트별 글로벌 경험 구축
- 디지털 상품 — 라이선스, 서비스 등 비물리적 상품 판매
- 커스텀 배송 — 고객 맞춤 배송 옵션
- Click and Collect — 매장 내 주문 수령
- 마켓플레이스 — 다중 판매자 플랫폼
문서 목록
Saleor란?
- 📒 Saleor Composable Commerce — Composable commerce 철학
- 📒 Saleor GraphQL — GraphQL 기반 API
- 📒 Saleor Architecture — 시스템 아키텍처
환경 셋업
- 📒 Saleor Cloud Setup — Cloud sandbox 시작
- 📒 Saleor Local Setup — Docker 로컬 환경
- 📒 Saleor First API Call — 첫 API 호출
- 📒 Saleor Storefront — Next.js 스토어프론트
핵심 도메인
- 📒 Saleor Core Concepts — 핵심 개념 개요
- 📒 Saleor Channels — 멀티채널
- 📒 Saleor Products — 상품 관리
- 📒 Saleor Checkout — 체크아웃
- 📒 Saleor Orders — 주문 관리
- 📒 Saleor Payments — 결제
GraphQL API
- 📒 Saleor Authentication — 인증
- 📒 Saleor Error Handling — 에러 처리
- 📒 Saleor Developer Tools — 개발 도구
커스터마이징 & 확장
- 📒 Saleor Extending Overview — 확장 모델 개요
- 📒 Saleor Webhooks — Webhook 생성, 페이로드, 서명 검증
- 📒 Saleor Async Events — 비동기 이벤트
- 📒 Saleor Sync Events Overview — 동기 이벤트 개요, Circuit Breaker
- 📒 Saleor Sync Events Payment — 결제 동기 이벤트 (Transaction, Stored Payment)
- 📒 Saleor Sync Events Tax — 세금 계산 위임
- 📒 Saleor Sync Events Shipping — 배송 방법 동적 제어
Apps 개발
- 📒 Saleor Apps — 앱 개요 & 빠른 시작
- 📒 Saleor App Architecture — 앱 아키텍처, Manifest, 권한, 통신
- 📒 Saleor App Bridge — App Bridge, APL, Server/Client 호출
- 📒 Saleor Dashboard Extensions — Dashboard UI 확장 (40+ 마운트 포인트)
- 📒 Saleor Payment App Development — 결제 앱 구축 튜토리얼
데이터 모델 확장
- 📒 Saleor Attributes — 속성 시스템 (타입, API, 설정, 생명주기)
- 📒 Saleor Metadata — 메타데이터 & External Reference
- 📒 Saleor Apollo Federation — API 게이트웨이 (멀티테넌트 아키텍처)
- 📒 Saleor Data Modeling — 모델링 개념, 모델 타입, 구조체
도메인 상세
- 📒 Saleor Channels Detail — 채널 API, 설정, 생명주기, 트러블슈팅
- 📒 Saleor Checkout Detail — 주소, API 가이드, cookbook, 성능, 문제해결
- 📒 Saleor Order Detail — Draft 주문, fulfillment, 만료, 주문 수정
- 📒 Saleor Payments Detail — 트랜잭션, 환불, 결제 앱, 가격 계산
- 📒 Saleor Products Detail — API, 설정, cookbook, 생명주기
- 📒 Saleor Discounts — Promotions, Vouchers, 수동 할인, 카탈로그 할인
- 📒 Saleor Shipping Detail — 배송 존, 배송 방법, 주문 내 배송
- 📒 Saleor Stock — 재고 할당, 예약, 추적
- 📒 Saleor Users — 고객 계정, 고객 관리, 직원 사용자
- 📒 Saleor Permissions — 권한 시스템, 그룹, JWT
- 📒 Saleor Address — 주소 검증, 포맷
- 📒 Saleor Taxes — 세금 설정, Tax Class, 국가별 설정
- 📒 Saleor Price Calculation — 가격 계산 흐름, Price Freeze, Gift Cards
API 심화
- 📒 Saleor API Filtering — 필터링, 페이지네이션, 검색, Slug
- 📒 Saleor API Prices — 가격 표현, i18n, 사용량 제한
포크 & 코어 분석
- 📒 Saleor Core Fork Analysis — 코어 코드 구조, 포크 타당성 (7/10), 한국 현지화 포인트