# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [таблица соединений,hub/connector.py, docs/help/connector.txt]

СОЕДИНЕНИЯ — Соединения и интеграция (обзор)
=======================================================

ДАТА: 08.02.2026

Система Connections — это центральная таблица базы данных для ВСЕХ.
технические соединения в BACH. Есть ДВЕ разные подсистемы
с разными целями:

1. СИСТЕМА РАЗЪЕМОВ (НОВИНКА, v2.0)
--------------------------------
Внешние коммуникационные соединения (Telegram, Discord, HomeAssistant).
Полная система сообщений с очередью, повтором и автоматическим выключателем.

**ДЕТАЛИ → см. docs/help/connector.txt**

CLI: соединитель bach <операция>
Операции: список, статус, добавление, удаление, опрос, отправка, демон настройки и т. д.

Обработчик:hub/connector.py
Службы: Hub/_services/connector/queue_processor.py
API: gui/api/messages_api.py (4 конечные точки REST)

2. AI/MCP-СОЕДИНЕНИЯ (СТАРИЕ)
-------------------------------
Техническая инфраструктура для AI-партнеров и серверов MCP.
Управляет конечными точками, ключами API, токенами OAuth.

CLI: bach --connections list/show
Обработчики:hub/connections.py(?)

Типы:
  - Партнеры по искусственному интеллекту: Клод, Оллама, Близнецы (Anthropic, Local, Google)
  - Сервер MCP: pubmed, canva, gdrive (протокол контекста модели)

ВАЖНО: СОЕДИНЕНИЯ vs PARTNER vs CONNECTOR
--------------------------------------------
- СОЕДИНЕНИЯ (таблица): Центральный реестр ВСЕХ соединений
- РАЗЪЕМ (Подсистема): Внешняя связь (Telegram, Discord,...)
- ПАРТНЕР (логика): Делегирование и экспертиза (КТО ЧТО делает?)

ТАБЛИЦА БАЗЫ ДАННЫХ
-----------------
Таблица: связи
Поля:
  - имя, тип, категория, конечная точка, is_active
  - auth_type, auth_config (JSON с учетными данными)
  - счетчик_успехов, количество_ошибок, последнее_использование
  - последовательные_сбои, отключенные_до (только автоматический выключатель, разъемы)

Категории (категория):
  - «разъем»: внешняя связь (Telegram, Discord, ...)
  - «ai»: ИИ-партнеры (Клод, Оллама, Близнецы)
  - 'mcp': сервер MCP (PubMed, Canva,...)
  - 'api': Другие API

ИСПОЛЬЗОВАНИЕ
----------
Большинству пользователей нужна ТОЛЬКО **система коннекторов**.

Для внешней связи (Telegram, Discord, HomeAssistant):
  → Разъем Баха --help
  → docs/help/connector.txt (специальная документация)

Для партнеров AI и серверов MCP:
  → Бах --список соединений
  → бах --help Partner

СМОТРИТЕ ТАКЖЕ
----------
  docs/help/connector.txt Система коннекторов (Telegram, Discord, HA)
  bach --help partner    Логическое делегирование и зоны
  bach --help messages   Система внутреннего обмена сообщениями
  bach --help daemon     Фоновые задания (poll_and_route, диспетчеризация)
