feat(integrations): архитектура включения/выключения интеграций
- Удалена лишняя модель IntegrationConfig из system_settings - Singleton-паттерн: одна запись на интеграцию с is_active тумблером - Добавлено шифрование токенов (EncryptedCharField с Fernet AES-128) - UI: тумблеры слева, форма настроек справа - API endpoints: toggle, settings, form_data - Модель Recommerce: store_url + api_token (x-auth-token) - Модель WooCommerce: store_url + consumer_key/secret Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -1,6 +1,5 @@
|
||||
from django.db import models
|
||||
from django.core.exceptions import ValidationError
|
||||
from abc import ABC, abstractmethod
|
||||
|
||||
|
||||
class IntegrationType(models.TextChoices):
|
||||
@@ -12,7 +11,9 @@ class IntegrationType(models.TextChoices):
|
||||
class BaseIntegration(models.Model):
|
||||
"""
|
||||
Абстрактный базовый класс для всех интеграций.
|
||||
Содержит общие поля и логику валидации.
|
||||
|
||||
Singleton-паттерн: каждая конкретная интеграция имеет только одну запись в БД.
|
||||
Поле is_active служит глобальным тумблером включения/выключения.
|
||||
"""
|
||||
|
||||
integration_type = models.CharField(
|
||||
@@ -23,16 +24,18 @@ class BaseIntegration(models.Model):
|
||||
)
|
||||
|
||||
is_active = models.BooleanField(
|
||||
default=True,
|
||||
default=False,
|
||||
verbose_name="Активна",
|
||||
db_index=True,
|
||||
help_text="Интеграция используется только если включена здесь и в системных настройках"
|
||||
help_text="Глобальный тумблер включения интеграции"
|
||||
)
|
||||
|
||||
name = models.CharField(
|
||||
max_length=100,
|
||||
blank=True,
|
||||
default='',
|
||||
verbose_name="Название",
|
||||
help_text="Произвольное название для удобства"
|
||||
help_text="Произвольное название для удобства (опционально)"
|
||||
)
|
||||
|
||||
created_at = models.DateTimeField(
|
||||
@@ -45,21 +48,6 @@ class BaseIntegration(models.Model):
|
||||
verbose_name="Дата обновления"
|
||||
)
|
||||
|
||||
# Общие credential поля (можно переопределить в наследниках)
|
||||
api_key = models.CharField(
|
||||
max_length=255,
|
||||
blank=True,
|
||||
verbose_name="API ключ",
|
||||
help_text="Будет зашифрован при сохранении"
|
||||
)
|
||||
|
||||
api_secret = models.CharField(
|
||||
max_length=255,
|
||||
blank=True,
|
||||
verbose_name="API секрет",
|
||||
help_text="Будет зашифрован при сохранении"
|
||||
)
|
||||
|
||||
# Дополнительные настройки в JSON для гибкости
|
||||
extra_config = models.JSONField(
|
||||
default=dict,
|
||||
@@ -73,21 +61,29 @@ class BaseIntegration(models.Model):
|
||||
indexes = [
|
||||
models.Index(fields=['is_active', 'integration_type']),
|
||||
]
|
||||
# Singleton: только одна запись на тип интеграции
|
||||
constraints = [
|
||||
models.UniqueConstraint(
|
||||
fields=['integration_type'],
|
||||
name='%(class)s_singleton'
|
||||
)
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.get_integration_type_display()}: {self.name}"
|
||||
status = "вкл" if self.is_active else "выкл"
|
||||
return f"{self.get_integration_type_display()}: {self.name or self._meta.verbose_name} ({status})"
|
||||
|
||||
@property
|
||||
def is_configured(self) -> bool:
|
||||
"""
|
||||
Проверить, есть ли необходимые credentials.
|
||||
Можно переопределить в наследниках.
|
||||
Переопределить в наследниках.
|
||||
"""
|
||||
return bool(self.api_key)
|
||||
return False
|
||||
|
||||
def clean(self):
|
||||
"""Валидацияcredentials"""
|
||||
"""Валидация: нельзя включить ненастроенную интеграцию"""
|
||||
if self.is_active and not self.is_configured:
|
||||
raise ValidationError({
|
||||
'api_key': 'API ключ обязателен для активной интеграции'
|
||||
})
|
||||
raise ValidationError(
|
||||
'Невозможно включить интеграцию без настроенных credentials'
|
||||
)
|
||||
|
||||
@@ -1,59 +1,36 @@
|
||||
from django.db import models
|
||||
from .base import MarketplaceIntegration
|
||||
from ...fields import EncryptedCharField
|
||||
|
||||
|
||||
class RecommerceIntegration(MarketplaceIntegration):
|
||||
"""
|
||||
Интеграция с Recommerce.
|
||||
Recommerce - сервис для управления товарами на маркетплейсах.
|
||||
|
||||
Recommerce - платформа для управления интернет-магазином.
|
||||
API документация: запросы отправляются на домен магазина с заголовком x-auth-token.
|
||||
|
||||
Обязательные настройки:
|
||||
- store_url: URL магазина (домен для API запросов)
|
||||
- api_token: токен авторизации (передаётся в заголовке x-auth-token)
|
||||
"""
|
||||
|
||||
# API endpoint (может отличаться от store_url)
|
||||
api_endpoint = models.URLField(
|
||||
blank=True,
|
||||
verbose_name="API Endpoint",
|
||||
help_text="URL API Recommerce (если отличается от URL магазина)"
|
||||
)
|
||||
|
||||
# API токен (основной метод авторизации)
|
||||
api_token = models.CharField(
|
||||
# API токен (x-auth-token) - ЗАШИФРОВАН
|
||||
api_token = EncryptedCharField(
|
||||
max_length=500,
|
||||
blank=True,
|
||||
verbose_name="API Токен",
|
||||
help_text="Токен авторизации Recommerce API"
|
||||
)
|
||||
|
||||
# ID магазина в системе Recommerce
|
||||
merchant_id = models.CharField(
|
||||
max_length=100,
|
||||
blank=True,
|
||||
verbose_name="ID магазина",
|
||||
help_text="Идентификатор магазина в Recommerce"
|
||||
)
|
||||
|
||||
# Синхронизация цен
|
||||
sync_prices = models.BooleanField(
|
||||
default=True,
|
||||
verbose_name="Синхронизировать цены",
|
||||
help_text="Обновлять цены на маркетплейсе"
|
||||
)
|
||||
|
||||
# Синхронизация остатков
|
||||
sync_stock = models.BooleanField(
|
||||
default=True,
|
||||
verbose_name="Синхронизировать остатки",
|
||||
help_text="Обновлять остатки на маркетплейсе"
|
||||
verbose_name="API Токен (x-auth-token)",
|
||||
help_text="Токен авторизации из панели управления Recommerce"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "Recommerce"
|
||||
verbose_name_plural = "Recommerce"
|
||||
managed = False # Пока заготовка - без создания таблицы
|
||||
|
||||
def __str__(self):
|
||||
return f"Recommerce: {self.name or self.merchant_id}"
|
||||
return f"Recommerce: {self.name or self.store_url or 'не настроен'}"
|
||||
|
||||
@property
|
||||
def is_configured(self) -> bool:
|
||||
"""Recommerce требует api_token"""
|
||||
return bool(self.api_token)
|
||||
"""Recommerce требует store_url и api_token"""
|
||||
return bool(self.store_url and self.api_token)
|
||||
|
||||
@@ -1,21 +1,27 @@
|
||||
from django.db import models
|
||||
from .base import MarketplaceIntegration
|
||||
from ...fields import EncryptedCharField
|
||||
|
||||
|
||||
class WooCommerceIntegration(MarketplaceIntegration):
|
||||
"""Интеграция с WooCommerce"""
|
||||
"""
|
||||
Интеграция с WooCommerce.
|
||||
WooCommerce - плагин электронной коммерции для WordPress.
|
||||
"""
|
||||
|
||||
# WooCommerce-specific credentials
|
||||
consumer_key = models.CharField(
|
||||
# WooCommerce REST API credentials - ЗАШИФРОВАНЫ
|
||||
consumer_key = EncryptedCharField(
|
||||
max_length=255,
|
||||
blank=True,
|
||||
verbose_name="Consumer Key"
|
||||
verbose_name="Consumer Key",
|
||||
help_text="REST API Consumer Key (хранится зашифрованным)"
|
||||
)
|
||||
|
||||
consumer_secret = models.CharField(
|
||||
consumer_secret = EncryptedCharField(
|
||||
max_length=255,
|
||||
blank=True,
|
||||
verbose_name="Consumer Secret"
|
||||
verbose_name="Consumer Secret",
|
||||
help_text="REST API Consumer Secret (хранится зашифрованным)"
|
||||
)
|
||||
|
||||
# API версия (WooCommerce REST API v1, v2, v3)
|
||||
@@ -23,18 +29,18 @@ class WooCommerceIntegration(MarketplaceIntegration):
|
||||
max_length=10,
|
||||
default='v3',
|
||||
blank=True,
|
||||
verbose_name="Версия API"
|
||||
verbose_name="Версия API",
|
||||
help_text="Версия WooCommerce REST API"
|
||||
)
|
||||
|
||||
class Meta:
|
||||
verbose_name = "WooCommerce"
|
||||
verbose_name_plural = "WooCommerce"
|
||||
managed = False # Пока заготовка - без создания таблицы
|
||||
|
||||
def __str__(self):
|
||||
return f"WooCommerce: {self.name or self.store_url}"
|
||||
return f"WooCommerce: {self.name or self.store_url or 'не настроен'}"
|
||||
|
||||
@property
|
||||
def is_configured(self) -> bool:
|
||||
"""WooCommerce требует consumer_key и consumer_secret"""
|
||||
return bool(self.consumer_key and self.consumer_secret)
|
||||
return bool(self.consumer_key and self.consumer_secret and self.store_url)
|
||||
|
||||
Reference in New Issue
Block a user