docs: define external connection widget flow

docs/adr/0016-external-connection-widget.md

@@ -0,0 +1,85 @@
+# ADR-0016: Каналы показывают общий виджет подключения
+
+- Status: accepted
+- Date: 2026-10-04
+
+## Контекст
+
+Пользователь может попросить создать встречу до подключения Google Calendar. Telegram Adapter не
+должен знать правила Google OAuth. То же поведение должно работать в Web, VK, СберЧате и будущих
+каналах.
+
+Ссылка Google OAuth содержит одноразовый `state`. Если сохранить её как обычный ответ диалога, повтор
+запроса может вернуть старую ссылку. Также секреты OAuth не должны попасть в БД Conversation Service,
+логи, события или историю Temporal.
+
+## Решение
+
+Conversation Service проверяет активное подключение перед созданием действия с внешним connector.
+Он передаёт исходный Bearer JWT в Connection Service и не принимает владельца подключения из JSON.
+
+Если активного подключения нет:
+
+1. Conversation Service сохраняет только безопасное намерение показать подключение: provider,
+   заголовок и текст.
+2. Перед HTTP-ответом Conversation Service запрашивает у Connection Service новую короткоживущую
+   authorization URL.
+3. В ответ добавляется общий `connection` widget из репозитория contracts.
+4. Channel Gateway передаёт ответ без своих правил.
+5. Адаптер канала отображает кнопку-ссылку доступным для канала способом.
+6. После OAuth MVP просит повторить исходную команду. Автоматическое продолжение будет отдельным
+   решением с callback-событием и надёжной маршрутизацией в канал.
+
+```mermaid
+sequenceDiagram
+    participant U as Пользователь
+    participant T as Адаптер канала
+    participant G as Channel Gateway
+    participant C as Conversation Service
+    participant N as Connection Service
+    participant A as Action Service
+
+    U->>T: Создай встречу
+    T->>G: сообщение + JWT
+    G->>C: сообщение + JWT
+    C->>N: список подключений + JWT
+    N-->>C: Google Calendar не подключён
+    C->>N: начать OAuth + JWT
+    N-->>C: короткоживущая HTTPS-ссылка
+    C-->>G: connection widget
+    G-->>T: connection widget
+    T-->>U: кнопка «Подключить»
+    U->>N: Google OAuth
+    N-->>U: подключение готово, повторите команду
+    U->>T: повтор команды
+    C->>N: список подключений + JWT
+    N-->>C: одно активное подключение
+    C->>A: создать действие
+```
+
+## Состояние и повторы
+
+- Conversation Service не сохраняет authorization URL, `state`, code или token.
+- Идемпотентный повтор сообщения создаёт новую ссылку через Connection Service.
+- Connection Service остаётся единственным владельцем OAuth state и PKCE verifier.
+- Если найдено несколько подключений без default, сервис не выбирает одно молча. Выбор аккаунта будет
+  отдельным виджетом и контрактом.
+- Если Connection Service недоступен, действие не создаётся, а клиент получает контролируемую ошибку.
+
+## Границы репозиториев
+
+- `contracts` — тип ответа `connection` и JSON Schema общего виджета.
+- `conversation-service` — проверка подключения и прикладное решение показать виджет.
+- `connection-service` — OAuth, список подключений и короткоживущая ссылка.
+- `channel-gateway` — проверка и передача ответа без выбора провайдера.
+- `widget-sdk` — проверка общего формата, без HTTP и состояния.
+- `telegram-adapter` — только Telegram-кнопка с URL.
+- `deploy` и `test-lab` — конфигурация и fake OAuth acceptance без внешних секретов.
+
+## Последствия
+
+- подключение не привязано к Telegram;
+- старую OAuth-ссылку нельзя случайно вернуть из БД;
+- перед созданием действия появляется один внутренний HTTP-вызов;
+- автоматическое продолжение команды пока отсутствует, зато MVP не вводит ненадёжную скрытую очередь;
+- новый OAuth-провайдер добавляется через тот же тип виджета и новую provider strategy.

docs/delivery/WORK_PLAN.md

@@ -98,6 +98,17 @@ Connection Service и Google Calendar provider реализованы. Авто
 конец и часовой пояс. `fake-calendar` остаётся обязательным автономным CI-провайдером. Google использует
 тот же контракт и выбирается только при доступном подключении пользователя.
 
+### 6.1 Общий виджет подключения
+
+Состояние: контракт и реализация готовятся отдельными pull request.
+
+- Conversation Service проверяет подключение до создания внешнего действия;
+- одноразовая OAuth-ссылка не сохраняется в состоянии диалога;
+- Channel Gateway передаёт общий ответ `connection`;
+- Widget SDK и адаптеры каналов отображают один контракт;
+- Test Lab проверяет путь через fake OAuth без настоящего Google аккаунта;
+- после подключения MVP просит повторить команду.
+
 ### 7. Следующий продуктовый срез
 
 Состояние: требуется RFC до изменения контрактов.