Files
chatballs/apps/backend/hub_platform/integrations/models.py
T
AndreyandClaude Opus 4.8 12227cd448 feat(integrations): M0 — integrations section (providers + connections)
Backend integrations app (ADR-HUB-0020): Integration model (LLM provider /
messenger connection) with Fernet-encrypted secret, config (base_url, default
model), status + last check. DRF CRUD (IsOwner, org-scoped) plus a Проверить
action that validates connectivity — OpenRouter via GET /key, MAX via /me,
Telegram via getMe — and records OK/ERROR with a message. Secret is never
returned by the serializer.

Internal UI: enable the Интеграции section — list grouped by providers /
connections, create/edit modal, test and delete. Wire route, sidebar, titles.

Channel binding of connections and provider-from-DB wiring land in M1.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-28 00:21:23 +03:00

59 lines
2.5 KiB
Python

from django.db import models
from hub_platform.identity.crypto import EncryptedCharField
# Интеграции: провайдеры (LLM) и подключения (боты/виджеты). ADR-HUB-0020.
# Привязка подключения к каналу обработки появляется в M1 (ADR-HUB-0019).
class IntegrationKind(models.TextChoices):
LLM_PROVIDER = "LLM_PROVIDER", "LLM-провайдер"
MESSENGER = "MESSENGER", "Подключение-мессенджер"
class IntegrationProvider(models.TextChoices):
OPENROUTER = "OPENROUTER", "OpenRouter"
MAX = "MAX", "MAX"
TELEGRAM = "TELEGRAM", "Telegram"
WEB = "WEB", "Web-виджет"
class IntegrationStatus(models.TextChoices):
UNCHECKED = "UNCHECKED", "Не проверено"
OK = "OK", "Подключено"
ERROR = "ERROR", "Ошибка"
# Какой провайдер к какому роду относится.
PROVIDER_KIND = {
IntegrationProvider.OPENROUTER: IntegrationKind.LLM_PROVIDER,
IntegrationProvider.MAX: IntegrationKind.MESSENGER,
IntegrationProvider.TELEGRAM: IntegrationKind.MESSENGER,
IntegrationProvider.WEB: IntegrationKind.MESSENGER,
}
class Integration(models.Model):
organization = models.ForeignKey("identity.Organization", on_delete=models.PROTECT, related_name="integrations")
kind = models.CharField(max_length=16, choices=IntegrationKind.choices)
provider = models.CharField(max_length=16, choices=IntegrationProvider.choices)
name = models.CharField(max_length=255)
# Зашифрованный секрет: ключ провайдера или токен бота (Fernet).
secret = EncryptedCharField(max_length=1024, blank=True)
# Несекретная конфигурация: base_url, модель по умолчанию и т.п.
config = models.JSONField(default=dict, blank=True)
status = models.CharField(max_length=16, choices=IntegrationStatus.choices, default=IntegrationStatus.UNCHECKED)
last_checked_at = models.DateTimeField(null=True, blank=True)
last_error = models.TextField(blank=True)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
class Meta:
ordering = ["provider", "name"]
constraints = [
models.UniqueConstraint(fields=["organization", "provider", "name"], name="uniq_integration_org_provider_name"),
]
def __str__(self) -> str:
return f"{self.provider}:{self.name}"