From eb844f77f58ed819b2511261c69f6db9273d1bfe Mon Sep 17 00:00:00 2001 From: DanliaQwerty20 Date: Mon, 26 Oct 2026 23:37:06 +0300 Subject: [PATCH 1/3] Define channel-neutral action result delivery --- docs/adr/0017-action-result-delivery.md | 54 +++++++++++++++++++++++++ mkdocs.yml | 2 + 2 files changed, 56 insertions(+) create mode 100644 docs/adr/0017-action-result-delivery.md diff --git a/docs/adr/0017-action-result-delivery.md b/docs/adr/0017-action-result-delivery.md new file mode 100644 index 0000000..c248533 --- /dev/null +++ b/docs/adr/0017-action-result-delivery.md @@ -0,0 +1,54 @@ +# 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` и безопасный итог. Gateway не хранит подписки и не знает Telegram chat id. +3. Канал сам хранит адрес ответа. Telegram Adapter сохраняет ожидающий `actionId` вместе с chat id после + подтверждения, проверяет общий статус в фоне и отправляет постоянное сообщение при `SUCCEEDED`, + `FAILED` или `CANCELLED`. После перезапуска незавершённые проверки остаются в PostgreSQL. +4. Текст сообщения строится из общего результата действия. Адаптер переводит его в формат Telegram; + правила выполнения календаря в нём не появляются. 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. Контракт результата и место хранения адреса канала при этом +остаются прежними. diff --git a/mkdocs.yml b/mkdocs.yml index b502fe5..ce6c3db 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -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 From ca172c17068231805306ece9b4d9f7ab73c7959f Mon Sep 17 00:00:00 2001 From: DanliaQwerty20 Date: Mon, 26 Oct 2026 23:41:41 +0300 Subject: [PATCH 2/3] Update documentation transitive dependencies --- website/pnpm-lock.yaml | 99 ++++++++++++++++++++++--------------- website/pnpm-workspace.yaml | 9 ++++ 2 files changed, 68 insertions(+), 40 deletions(-) diff --git a/website/pnpm-lock.yaml b/website/pnpm-lock.yaml index a66872c..80dd884 100644 --- a/website/pnpm-lock.yaml +++ b/website/pnpm-lock.yaml @@ -5,6 +5,15 @@ settings: excludeLinksFromLockfile: false overrides: + body-parser: 1.20.9 + compression: 1.8.2 + dompurify: 3.4.17 + follow-redirects: 1.16.1 + launch-editor: 2.14.2 + proxy-addr: 2.0.8 + shell-quote: 1.11.0 + source-map-js: 1.2.2 + tinypool: 2.1.2 js-yaml: 4.3.2 serialize-javascript: 7.0.3 image-size: 2.0.3 @@ -2092,8 +2101,8 @@ packages: resolution: {integrity: sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==} engines: {node: '>=8'} - body-parser@1.20.6: - resolution: {integrity: sha512-p5tAzS57i5MV9fZFDj9LeIiTZEufbSe2eDozP+ElheSUq1m74CRq1jI4mYNDdVs9vQztXFLuk/Gd6BWTdwRJ5g==} + body-parser@1.20.9: + resolution: {integrity: sha512-FISIQxV5u91Y9gvuFq3q/tA/qTqLJn3AhRcEvyozyhJTh5OBFFtv827AdHU7Rbyct4r+Ba1/99oFa1Y3yuFsdw==} engines: {node: '>= 0.8', npm: 1.2.8000 || >= 1.4.16} bonjour-service@1.4.4: @@ -2301,8 +2310,8 @@ packages: resolution: {integrity: sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==} engines: {node: '>= 0.6'} - compression@1.8.1: - resolution: {integrity: sha512-9mAqGPHLakhCLeNyxPkK4xVo746zQ/czLH1Ky+vkitMnWfWZps8r0qXuwhwizagCRttsL4lfG4pIOvaWLpAP0w==} + compression@1.8.2: + resolution: {integrity: sha512-o8vI5RE5A6EVVOd9o41jKp41aJom+QTEO/Bx8MYNjexMo/Bv2WOjUfZr+aL0WnYSgymUy6zeguqLTsIhV0gMvQ==} engines: {node: '>= 0.8.0'} concat-map@0.0.1: @@ -2786,8 +2795,8 @@ packages: resolution: {integrity: sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==} engines: {node: '>= 4'} - dompurify@3.4.14: - resolution: {integrity: sha512-dVoH9z+MY+C9IilgGCk3YfFqjLi3fChm2OiKJMzh6axrJ5qwxqWaZamgmHrpv22CN/KdbZJuGEGgfQoL00LTdg==} + dompurify@3.4.17: + resolution: {integrity: sha512-B/pSlYVHQ58kqISD/yDjuJ1yfzI34m1gF4lAod2bwSRhiN4K5Cl3H8Af7hqB2PmTL911tdEudnnXn5FnhRoz0w==} domutils@2.8.0: resolution: {integrity: sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==} @@ -3036,8 +3045,8 @@ packages: resolution: {integrity: sha512-b6suED+5/3rTpUBdG1gupIl8MPFCAMA0QXwmljLhvCUKcUvdE4gWky9zpuGCcXHOsz4J9wPGNWq6OKpmIzz3hQ==} hasBin: true - follow-redirects@1.16.0: - resolution: {integrity: sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw==} + follow-redirects@1.16.1: + resolution: {integrity: sha512-FNvFGzoMLWmE6Yj9spb/zjd7yiNCHiAW9/Tg9CXrQ8wuu32HtlJOwWO11OJafl5FfY3DxTdQ0vj42zU1kvv5jg==} engines: {node: '>=4.0'} peerDependencies: debug: '*' @@ -3568,8 +3577,8 @@ packages: resolution: {integrity: sha512-KvNT4XqAMzdcL6ka6Tl3i2lYeFDgXNCuIX+xNx6ZMVR1dFq+idXd9FLKNMOIx0t9mJ9/HudyX4oZWXZQ0UJHeg==} engines: {node: '>=14.16'} - launch-editor@2.14.1: - resolution: {integrity: sha512-QWBrQsMpH7gPr965dsKD/3cKWiNoTjpATQf++Xq63N6sKRGMwlVXz41O1IZTMfZQgBctD/K5Zt06+/I6pP6+HA==} + launch-editor@2.14.2: + resolution: {integrity: sha512-NHJEb30MGBCkmZXLZwz25t37QR4aY03ZzPYUJXOJaOa92uWwExI9SBQUuIznBYc1xkD7cJNGX7oc3Nl3sq2kQQ==} layout-base@1.0.2: resolution: {integrity: sha512-8h2oVEZNktL4BH2JCOI90iD1yXwL6iNW7KcCKT2QZgQJR2vbqDsldCTPRU9NifTCqHZci57XvQQ15YTu+sTYPg==} @@ -4605,8 +4614,8 @@ packages: proto-list@1.2.4: resolution: {integrity: sha512-vtK/94akxsTMhe0/cbfpR+syPuszcuwhqVjJq26CuNDgFGj682oRBXOP5MJpv2r7JtE8MsiepGIqvvOTBwn2vA==} - proxy-addr@2.0.7: - resolution: {integrity: sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==} + proxy-addr@2.0.8: + resolution: {integrity: sha512-5nnx0yGyVUcY6t9RnWcARWtwT9F1D8O9rt08htPvnd49W1IgZtmLkhu9WfMzQj1cFxjHIO6connUNVW5k7AVyQ==} engines: {node: '>= 0.10'} punycode@2.3.1: @@ -4628,6 +4637,10 @@ packages: resolution: {integrity: sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==} engines: {node: '>=0.6'} + qs@6.16.0: + resolution: {integrity: sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==} + engines: {node: '>=0.6'} + queue-microtask@1.2.3: resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==} @@ -4944,8 +4957,8 @@ packages: resolution: {integrity: sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==} engines: {node: '>=8'} - shell-quote@1.10.0: - resolution: {integrity: sha512-w1aiOKwKuRgtwAReIIj89puqg+I7GvX4IbLrvmhXbzQsj1+Zwi4VO3+fa6ZF91TWSjIxoEkKnMeHcLEODK5ZXA==} + shell-quote@1.11.0: + resolution: {integrity: sha512-JdxDPD0DBTyu08pq0kPC0xSNet/qsU07qT6IsX1AS8oO2ICNRY4ldNa8OAI6PuwAH8tG3lxEhbqmyp4Dw4036g==} engines: {node: '>= 0.4'} side-channel-list@1.0.1: @@ -5001,8 +5014,8 @@ packages: resolution: {integrity: sha512-0xtkGhWCC9MGt/EzgnvbbbKhqWjl1+/rncmhTh5qCpbYguXh6S/qwePfv/JQ8jePXXmqingylxoC49pCkSPIbA==} engines: {node: '>= 6.3.0'} - source-map-js@1.2.1: - resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} + source-map-js@1.2.2: + resolution: {integrity: sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==} engines: {node: '>=0.10.0'} source-map-support@0.5.21: @@ -5196,9 +5209,9 @@ packages: resolution: {integrity: sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==} engines: {node: '>=18'} - tinypool@1.1.1: - resolution: {integrity: sha512-Zba82s87IFq9A9XmjiX5uZA/ARWDrB03OHlq+Vw1fSdt0I+4/Kutwy8BP4Y/y/aORMo61FQ0vIb5j44vSo5Pkg==} - engines: {node: ^18.0.0 || >=20.0.0} + tinypool@2.1.2: + resolution: {integrity: sha512-9YodfrxS9g9IbFr/KOjE5bAeJ0p61n3bW6mqvy0jtoeKd1kTW1Cxm0oulm6KX2lyM9Gl6WIe8nEbY7LWv5ZJww==} + engines: {node: ^20.0.0 || >=22.0.0} to-regex-range@5.0.1: resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==} @@ -6879,7 +6892,7 @@ snapshots: react-router-dom: 5.3.4(react@19.2.8) semver: 7.8.5 serve-handler: 6.1.7 - tinypool: 1.1.1 + tinypool: 2.1.2 tslib: 2.8.1 update-notifier: 6.0.2 webpack: 5.109.2(clean-css@5.3.3)(cssnano@6.1.2(postcss@8.5.26))(csso@5.0.5)(html-minifier-terser@7.2.0)(postcss@8.5.26) @@ -8723,7 +8736,7 @@ snapshots: binary-extensions@2.3.0: {} - body-parser@1.20.6(supports-color@8.1.1): + body-parser@1.20.9(supports-color@8.1.1): dependencies: bytes: 3.1.2 content-type: 1.0.5 @@ -8733,7 +8746,7 @@ snapshots: http-errors: 2.0.1 iconv-lite: 0.4.24 on-finished: 2.4.1 - qs: 6.15.3 + qs: 6.16.0 raw-body: 2.5.3 type-is: 1.6.18 unpipe: 1.0.0 @@ -8955,11 +8968,12 @@ snapshots: dependencies: mime-db: 1.54.0 - compression@1.8.1(supports-color@8.1.1): + compression@1.8.2(supports-color@8.1.1): dependencies: bytes: 3.1.2 compressible: 2.0.18 debug: 2.6.9(supports-color@8.1.1) + destroy: 1.2.0 negotiator: 0.6.4 on-headers: 1.1.0 safe-buffer: 5.2.1 @@ -9112,12 +9126,12 @@ snapshots: css-tree@2.2.1: dependencies: mdn-data: 2.0.28 - source-map-js: 1.2.1 + source-map-js: 1.2.2 css-tree@2.3.1: dependencies: mdn-data: 2.0.30 - source-map-js: 1.2.1 + source-map-js: 1.2.2 css-what@6.2.2: {} @@ -9479,7 +9493,7 @@ snapshots: dependencies: domelementtype: 2.3.0 - dompurify@3.4.14: + dompurify@3.4.17: optionalDependencies: '@types/trusted-types': 2.0.7 @@ -9664,7 +9678,7 @@ snapshots: dependencies: accepts: 1.3.8 array-flatten: 1.1.1 - body-parser: 1.20.6(supports-color@8.1.1) + body-parser: 1.20.9(supports-color@8.1.1) content-disposition: 0.5.4 content-type: 1.0.5 cookie: 0.7.2 @@ -9682,7 +9696,7 @@ snapshots: on-finished: 2.4.1 parseurl: 1.3.3 path-to-regexp: 0.1.13 - proxy-addr: 2.0.7 + proxy-addr: 2.0.8 qs: 6.15.3 range-parser: 1.2.1 safe-buffer: 5.2.1 @@ -9770,7 +9784,7 @@ snapshots: flat@5.0.2: {} - follow-redirects@1.16.0(debug@4.4.3(supports-color@8.1.1)): + follow-redirects@1.16.1(debug@4.4.3(supports-color@8.1.1)): optionalDependencies: debug: 4.4.3(supports-color@8.1.1) @@ -10099,7 +10113,7 @@ snapshots: http-proxy@1.18.1(debug@4.4.3(supports-color@8.1.1)): dependencies: eventemitter3: 4.0.7 - follow-redirects: 1.16.0(debug@4.4.3(supports-color@8.1.1)) + follow-redirects: 1.16.1(debug@4.4.3(supports-color@8.1.1)) requires-port: 1.0.0 transitivePeerDependencies: - debug @@ -10330,10 +10344,10 @@ snapshots: dependencies: package-json: 8.1.1 - launch-editor@2.14.1: + launch-editor@2.14.2: dependencies: picocolors: 1.1.1 - shell-quote: 1.10.0 + shell-quote: 1.11.0 layout-base@1.0.2: {} @@ -10620,7 +10634,7 @@ snapshots: d3-sankey: 0.12.3 dagre-d3-es: 7.0.14 dayjs: 1.11.23 - dompurify: 3.4.14 + dompurify: 3.4.17 es-toolkit: 1.51.0 fastdom: 1.0.12 katex: 0.16.47 @@ -11649,7 +11663,7 @@ snapshots: dependencies: nanoid: 3.3.18 picocolors: 1.1.1 - source-map-js: 1.2.1 + source-map-js: 1.2.2 pretty-error@4.0.0: dependencies: @@ -11683,7 +11697,7 @@ snapshots: proto-list@1.2.4: {} - proxy-addr@2.0.7: + proxy-addr@2.0.8: dependencies: forwarded: 0.2.0 ipaddr.js: 1.9.1 @@ -11705,6 +11719,11 @@ snapshots: es-define-property: 1.0.1 side-channel: 1.1.1 + qs@6.16.0: + dependencies: + es-define-property: 1.0.1 + side-channel: 1.1.1 + queue-microtask@1.2.3: {} quick-lru@5.1.1: {} @@ -12123,7 +12142,7 @@ snapshots: shebang-regex@3.0.0: {} - shell-quote@1.10.0: {} + shell-quote@1.11.0: {} side-channel-list@1.0.1: dependencies: @@ -12191,7 +12210,7 @@ snapshots: sort-css-media-queries@2.2.0: {} - source-map-js@1.2.1: {} + source-map-js@1.2.2: {} source-map-support@0.5.21: dependencies: @@ -12355,7 +12374,7 @@ snapshots: tinyexec@1.3.0: {} - tinypool@1.1.1: {} + tinypool@2.1.2: {} to-regex-range@5.0.1: dependencies: @@ -12578,13 +12597,13 @@ snapshots: bonjour-service: 1.4.4 chokidar: 3.6.0 colorette: 2.0.20 - compression: 1.8.1(supports-color@8.1.1) + compression: 1.8.2(supports-color@8.1.1) connect-history-api-fallback: 2.0.0 express: 4.22.2(supports-color@8.1.1) graceful-fs: 4.2.11 http-proxy-middleware: 2.0.10(@types/express@4.17.25)(debug@4.4.3(supports-color@8.1.1)) ipaddr.js: 2.5.0 - launch-editor: 2.14.1 + launch-editor: 2.14.2 open: 10.2.0 p-retry: 6.2.1 schema-utils: 4.3.3 diff --git a/website/pnpm-workspace.yaml b/website/pnpm-workspace.yaml index e86219f..73257af 100644 --- a/website/pnpm-workspace.yaml +++ b/website/pnpm-workspace.yaml @@ -3,6 +3,15 @@ allowBuilds: minimumReleaseAgeExclude: - http-cache-semantics@4.3.0 overrides: + body-parser: 1.20.9 + compression: 1.8.2 + dompurify: 3.4.17 + follow-redirects: 1.16.1 + launch-editor: 2.14.2 + proxy-addr: 2.0.8 + shell-quote: 1.11.0 + source-map-js: 1.2.2 + tinypool: 2.1.2 js-yaml: 4.3.2 serialize-javascript: 7.0.3 image-size: 2.0.3 From 8053af3a6e66601d145ed46353028df51c67f97c Mon Sep 17 00:00:00 2001 From: DanliaQwerty20 Date: Mon, 26 Oct 2026 23:42:36 +0300 Subject: [PATCH 3/3] Clarify safe action status view --- docs/adr/0017-action-result-delivery.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/adr/0017-action-result-delivery.md b/docs/adr/0017-action-result-delivery.md index c248533..90acb79 100644 --- a/docs/adr/0017-action-result-delivery.md +++ b/docs/adr/0017-action-result-delivery.md @@ -14,12 +14,13 @@ 1. `Action Service` остаётся источником статуса и результата. Чтение действия проверяет и `tenantId`, и пользователя, который его создал. 2. `Channel Gateway` даёт защищённый `GET /api/v1/actions/{actionId}/status`. Ответ содержит только - `actionId`, `status`, `kind` и безопасный итог. Gateway не хранит подписки и не знает Telegram chat id. + `actionId`, `status`, `kind` и короткий `title` из сохранённого действия. В нём нет полного payload, + `payloadHash` или токенов. Gateway не хранит подписки и не знает Telegram chat id. 3. Канал сам хранит адрес ответа. Telegram Adapter сохраняет ожидающий `actionId` вместе с chat id после подтверждения, проверяет общий статус в фоне и отправляет постоянное сообщение при `SUCCEEDED`, `FAILED` или `CANCELLED`. После перезапуска незавершённые проверки остаются в PostgreSQL. -4. Текст сообщения строится из общего результата действия. Адаптер переводит его в формат Telegram; - правила выполнения календаря в нём не появляются. Web-клиент может читать тот же статус без Telegram. +4. Канал показывает короткий итог по статусу и `title`: выполнено, не удалось или отменено. + Правила выполнения календаря в адаптере не появляются. Web-клиент может читать тот же статус без Telegram. 5. Повтор проверки не создаёт повторное действие. Отправка сообщения в Telegram и отметка в нашей БД не образуют одну транзакцию, поэтому после сбоя возможна повторная доставка. Этот предел виден в документации и тестах.