Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 55 additions & 0 deletions docs/adr/0017-action-result-delivery.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
# ADR-0017: результат действия доступен каждому каналу

- Статус: принято для MVP
- Дата: 2026-10-26

## Контекст

`Action Service` сохраняет итог после выполнения в Temporal. Ответ на кнопку подтверждения приходит
раньше этого итога. Telegram сейчас показывает только короткое `Решение принято.` во всплывающем
уведомлении. Web и будущие каналы тоже должны получать один и тот же статус действия.

## Решение

1. `Action Service` остаётся источником статуса и результата. Чтение действия проверяет и `tenantId`,
и пользователя, который его создал.
2. `Channel Gateway` даёт защищённый `GET /api/v1/actions/{actionId}/status`. Ответ содержит только
`actionId`, `status`, `kind` и короткий `title` из сохранённого действия. В нём нет полного payload,
`payloadHash` или токенов. Gateway не хранит подписки и не знает Telegram chat id.
3. Канал сам хранит адрес ответа. Telegram Adapter сохраняет ожидающий `actionId` вместе с chat id после
подтверждения, проверяет общий статус в фоне и отправляет постоянное сообщение при `SUCCEEDED`,
`FAILED` или `CANCELLED`. После перезапуска незавершённые проверки остаются в PostgreSQL.
4. Канал показывает короткий итог по статусу и `title`: выполнено, не удалось или отменено.
Правила выполнения календаря в адаптере не появляются. Web-клиент может читать тот же статус без Telegram.
5. Повтор проверки не создаёт повторное действие. Отправка сообщения в Telegram и отметка в нашей БД
не образуют одну транзакцию, поэтому после сбоя возможна повторная доставка. Этот предел виден в
документации и тестах.

```mermaid
sequenceDiagram
actor User as Пользователь
participant Channel as Адаптер канала
participant Gateway as Channel Gateway
participant Action as Action Service
participant Temporal as Temporal

User->>Channel: Подтвердить действие
Channel->>Gateway: POST решение
Gateway->>Action: Сохранить решение
Action-->>Gateway: APPROVED
Gateway-->>Channel: APPROVED
Channel->>Channel: Сохранить actionId и адрес ответа
Temporal->>Action: Сохранить SUCCEEDED или FAILED
Channel->>Gateway: GET статус actionId
Gateway->>Action: GET статус с identity пользователя
Action-->>Gateway: Общий итог
Gateway-->>Channel: Общий итог
Channel-->>User: Постоянное сообщение
```

## Почему так

Этот срез использует уже имеющиеся HTTP, PostgreSQL и проверку identity. Новый брокер и отдельный
сервис доставки пока не нужны. Когда частые проверки статуса станут измеримой нагрузкой, можно
заменить их событием из Action Service. Контракт результата и место хранения адреса канала при этом
остаются прежними.
2 changes: 2 additions & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,3 +37,5 @@ nav:
- Conversation Service: adr/0013-conversation-orchestration.md
- Привязка Telegram: adr/0014-telegram-account-link.md
- Подключение Google Calendar: adr/0015-google-calendar-connection.md
- Виджет подключения: adr/0016-external-connection-widget.md
- Доставка результата действия: adr/0017-action-result-delivery.md
99 changes: 59 additions & 40 deletions website/pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading
Loading