feat(integrations): добавлен фундамент для интеграций с внешними сервисами

- Создано приложение integrations с базовой архитектурой
- BaseIntegration (абстрактная модель) для всех интеграций
- BaseIntegrationService (абстрактный сервисный класс)
- IntegrationConfig модель для тумблеров в system_settings
- Добавлена вкладка "Интеграции" в системные настройки
- Заготовка UI с тумблерами для включения интеграций

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-01-11 23:02:42 +03:00
parent b562eabcaf
commit 4450e34497
16 changed files with 346 additions and 1 deletions

View File

@@ -0,0 +1,30 @@
# Generated by Django 5.0.10 on 2026-01-11 19:36
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name='IntegrationConfig',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('integration_id', models.CharField(choices=[('woocommerce', 'WooCommerce')], max_length=50, unique=True, verbose_name='Интеграция')),
('is_enabled', models.BooleanField(default=False, help_text='Глобальное включение интеграции для тенанта', verbose_name='Включена')),
('last_sync_at', models.DateTimeField(blank=True, null=True, verbose_name='Последняя синхронизация')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
('updated_at', models.DateTimeField(auto_now=True, verbose_name='Дата обновления')),
],
options={
'verbose_name': 'Настройка интеграции',
'verbose_name_plural': 'Настройки интеграций',
'ordering': ['integration_id'],
},
),
]

View File

@@ -0,0 +1,3 @@
from .integration_config import IntegrationConfig
__all__ = ['IntegrationConfig']

View File

@@ -0,0 +1,53 @@
from django.db import models
class IntegrationConfig(models.Model):
"""
Глобальные тумблеры для включения/выключения интеграций.
Одна запись на доступную интеграцию.
"""
INTEGRATION_CHOICES = [
('woocommerce', 'WooCommerce'),
# Здесь добавлять новые интеграции:
# ('shopify', 'Shopify'),
# ('telegram', 'Telegram'),
]
integration_id = models.CharField(
max_length=50,
choices=INTEGRATION_CHOICES,
unique=True,
verbose_name="Интеграция"
)
is_enabled = models.BooleanField(
default=False,
verbose_name="Включена",
help_text="Глобальное включение интеграции для тенанта"
)
last_sync_at = models.DateTimeField(
null=True,
blank=True,
verbose_name="Последняя синхронизация"
)
created_at = models.DateTimeField(
auto_now_add=True,
verbose_name="Дата создания"
)
updated_at = models.DateTimeField(
auto_now=True,
verbose_name="Дата обновления"
)
class Meta:
verbose_name = "Настройка интеграции"
verbose_name_plural = "Настройки интеграций"
ordering = ['integration_id']
def __str__(self):
status = "вкл" if self.is_enabled else "выкл"
return f"{self.get_integration_id_display()}: {status}"

View File

@@ -25,7 +25,12 @@
<i class="bi bi-tag"></i> Скидки
</a>
</li>
<!-- Здесь в будущем добавятся: Категории, Статусы заказов, Часовой пояс, Интеграции и т.д. -->
<li class="nav-item" role="presentation">
<a class="nav-link {% if 'integrations' in request.resolver_match.namespaces %}active{% endif %}"
href="{% url 'system_settings:integrations:list' %}">
Интеграции
</a>
</li>
</ul>
<!-- Контент конкретной страницы настроек -->

View File

@@ -0,0 +1,66 @@
{% extends "system_settings/base_settings.html" %}
{% block title %}Интеграции{% endblock %}
{% block settings_content %}
<div class="row">
<!-- Левая колонка: список интеграций с тумблерами -->
<div class="col-md-5">
<div class="card shadow-sm">
<div class="card-header bg-light">
<h5 class="mb-0">Доступные интеграции</h5>
</div>
<div class="card-body">
{% for value, label in integration_choices %}
<div class="d-flex align-items-center justify-content-between py-2 border-bottom">
<div>
<span class="fw-medium">{{ label }}</span>
<small class="text-muted d-block">Маркетплейс</small>
</div>
<div class="form-check form-switch">
<input class="form-check-input integration-toggle"
type="checkbox"
data-integration="{{ value }}"
id="integration-{{ value }}">
<label class="form-check-label" for="integration-{{ value }}"></label>
</div>
</div>
{% endfor %}
</div>
</div>
</div>
<!-- Правая колонка: placeholder для настроек -->
<div class="col-md-7">
<div class="card shadow-sm">
<div class="card-header bg-light">
<h5 class="mb-0">Настройки интеграции</h5>
</div>
<div class="card-body">
<div class="text-center text-muted py-5">
<svg xmlns="http://www.w3.org/2000/svg" width="64" height="64" fill="currentColor" class="bi bi-plug mb-3" viewBox="0 0 16 16">
<path d="M6 0a.5.5 0 0 1 .5.5V3h3V.5a.5.5 0 0 1 1 0V3h1v2.5a1.5 1.5 0 0 1-1 1.25v4.5a.5.5 0 0 1-1 0v-4.25c-.286.14-.6.25-1 .25a2.5 2.5 0 0 1-1-.25v4.25a.5.5 0 0 1-1 0v-4.5a1.5 1.5 0 0 1-1-1.25V3h1V.5A.5.5 0 0 1 6 0Zm0 3a.5.5 0 0 1 .5.5v2a.5.5 0 0 1-1 0v-2A.5.5 0 0 1 6 3Zm3.5-.5a.5.5 0 0 1 1 0v2a.5.5 0 0 1-1 0v-2Z"/>
</svg>
<p class="mb-0">Выберите интеграцию слева для настройки</p>
<small class="text-muted">Здесь появится форма с настройками выбранной интеграции</small>
</div>
</div>
</div>
</div>
</div>
<!-- JavaScript для переключения интеграций (placeholder) -->
<script>
document.querySelectorAll('.integration-toggle').forEach(toggle => {
toggle.addEventListener('change', function() {
const integration = this.dataset.integration;
const isEnabled = this.checked;
// TODO: отправить состояние на сервер
console.log(`Интеграция ${integration}: ${isEnabled ? 'включена' : 'выключена'}`);
// TODO: показать/скрыть блок настроек справа
});
});
</script>
{% endblock %}

View File

@@ -8,4 +8,5 @@ urlpatterns = [
path("", SystemSettingsView.as_view(), name="settings"),
path("roles/", include('user_roles.urls', namespace='user_roles')),
path("discounts/", include('discounts.urls', namespace='discounts')),
path("integrations/", include('integrations.urls', namespace='integrations')),
]