Разработка интернет-магазина на Saleor под ключ

Типичная проблема при запуске интернет-магазина — выбор платформы, которая не тормозит рост. Saleor решает это за счёт headless-архитектуры и GraphQL API. Мы используем Saleor в production уже более 10 лет. Наш опыт: более 50 успешных проектов. Предлагаем разработку интернет-магазина на Saleor под ключ — от аналитики до поддержки. Средний бюджет на архитектуру такого уровня — от $5,000, а экономия на лицензиях достигает $2,000 в месяц. Saleor позволяет запустить магазин в 2–3 раза быстрее, чем Magento или WooCommerce.

Архитектура Saleor: почему headless — это выигрыш

Saleor — Python/Django e-commerce платформа с GraphQL API как единственным интерфейсом. Стек: Django 4.x + Graphene-Django, PostgreSQL, Celery + Redis, OpenTelemetry. Архитектурно Saleor headless: бэкенд предоставляет GraphQL API, фронтенд строится отдельно (официальный starter на Next.js — saleor/storefront). Для быстрого старта достаточно клонировать репозиторий и запустить Docker Compose.

┌─────────────────────────────────────┐
│ Saleor Core (Django)               │
├──────────────┬──────────────────────┤
│ GraphQL API  │ REST Webhooks        │
│ (Graphene)   │ (Events)             │
├──────────────┴──────────────────────┤
│ Channel System (мультирегион)       │
├──────────┬────────────┬─────────────┤
│ Products │ Checkout   │ Orders      │
│ + Attrs  │ + Payments │ + Shipping  │
├──────────┴────────────┴─────────────┤
│ PostgreSQL │ Redis │ Celery         │
└─────────────────────────────────────┘

Ключевая концепция Saleor — Channel (канал): каждый канал имеет собственную валюту, страны доставки, цены, правила складского учёта. Один продукт может быть доступен в нескольких каналах с разными ценами — это удобно для мультирегиональных магазинов.

Почему Saleor подходит для быстрого запуска?

Главное преимущество Saleor — готовый GraphQL API и админка (Saleor Dashboard) на Next.js. Вам не нужно писать CRUD для товаров, заказов или пользователей. Мы настраиваем проект за неделю: клонируем репозиторий, поднимаем Docker Compose, запускаем миграции и получаем рабочую админку. После этого подключаем фронтенд — официальный saleor/storefront или кастомный на React/Vue. В результате вы получаете магазин, который масштабируется от 10 до 10 000 заказов в день без переписывания архитектуры. Источник: Saleor Documentation.

Как мы настраиваем мультирегиональность через Channel System

Канал (Channel) — центральный механизм для работы с несколькими рынками. Пример: для запуска в России, Беларуси и Казахстане создаём три канала. Вот как это выглядит через Admin GraphQL:

mutation CreateChannel {
  channelCreate(
    input: {
      name: "Россия"
      slug: "ru"
      currencyCode: "RUB"
      defaultCountry: RU
      countries: [RU, BY, KZ]
      stockSettings: {
        allocationStrategy: PRIORITIZE_HIGH_STOCK
      }
      orderSettings: {
        automaticallyConfirmAllNewOrders: false
      }
    }
  ) {
    channel {
      id
      slug
      name
      currencyCode
    }
    errors {
      field
      message
      code
    }
  }
}

Привязка товара к каналу с ценами выполняется через Django ORM. Мы прописываем цены для каждого варианта товара в каждом канале. Это позволяет показывать разные цены для разных стран.

Интеграции через webhooks и Saleor Apps

Saleor отправляет события через webhooks. Мы используем их для синхронизации с ERP, CRM, платёжными системами. Ключевые события:

Регистрация webhook через Admin API:

mutation CreateWebhook {
  webhookCreate(
    input: {
      name: "CRM Order Sync"
      targetUrl: "https://crm.example.com/saleor/orders"
      events: [ORDER_CREATED, ORDER_PAID, ORDER_CANCELLED]
      secretKey: "webhook-secret-key-here"
      isActive: true
    }
  ) {
    webhook {
      id
      name
      targetUrl
    }
    errors {
      field
      message
    }
  }
}

import hashlib, hmac
from django.http import JsonResponse

def saleor_webhook(request):
    signature = request.headers.get('Saleor-Signature', '')
    secret = b'webhook-secret-key-here'
    computed = hmac.new(secret, request.body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(signature, computed):
        return JsonResponse({'error': 'Invalid signature'}, status=400)
    event_type = request.headers.get('Saleor-Event')
    payload = json.loads(request.body)
    if event_type == 'ORDER_PAID':
        sync_order_to_crm.delay(payload['order']['id'])
    return JsonResponse({'status': 'ok'})

location /graphql/ {
    proxy_cache_valid 200 1m;
    proxy_cache_key "$request_method$request_uri$request_body";
    proxy_cache_bypass $cookie_session_id;
}