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:
2026-01-12 00:29:04 +03:00
parent 4629369823
commit 37394121e1
14 changed files with 804 additions and 200 deletions

View File

@@ -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'
)