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

Типова проблема під час запуску інтернет-магазину — вибір платформи, яка не гальмує зростання. Saleor вирішує це завдяки headless-архітектурі та GraphQL API. Ми використовуємо Saleor у production вже понад 10 років. Наш досвід: понад 50 успішних проєктів. Пропонуємо розробку інтернет-магазину на Saleor під ключ — від аналітики до підтримки. 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: "ua"
      currencyCode: "UAH"
      defaultCountry: UA
      countries: [UA, PL, DE]
      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: "YOUR_CRM_WEBHOOK_URL"
      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;
}