docs: explain persisted T-Bank reads and synchronization

Document local data ownership, coverage and freshness, refresh behavior, failure recovery and additive migration rollback. Record ADR 017.
2026-09-26 21:22:50 +03:00
parent 55610ea2b4
commit 07de062ebb
19 changed files with 459 additions and 432 deletions
@@ -62,7 +62,7 @@ sequenceDiagram
  B->>T: GetAccounts OPEN по gRPC over TLS
  alt Проверка успешна, в том числе при пустом списке счетов
    T-->>B: Доступные открытые счета
-    B->>D: Создать или заменить шифротекст AES-256-GCM
+    B->>D: Атомарно сохранить token, новую revision и membership
    B-->>F: Подключено и время сохранения
    F->>F: Обновить статус и сбросить финансовые выборки
    F-->>U: Показать подтверждённое подключение
@@ -92,8 +92,9 @@ sequenceDiagram
 `INVALID_TBANK_TOKEN` означает отказ внешней аутентификации или прав доступа.
 `TBANK_UNAVAILABLE` сообщает о временной или иной upstream-ошибке, включая
 исчерпание очереди. Ответы и ошибки не содержат token. Удаление подключения
-идемпотентно: удаляется локальный секрет и прекращается его использование
-для последующих запросов. Оно не описывает отзыв token на стороне T-Bank.
+идемпотентно: удаляются локальный секрет, личные datasets и work; поздняя
+публикация прежней revision запрещена. Общие неперсональные источники могут
+сохраняться. Оно не описывает отзыв token на стороне T-Bank.

 Согласованное поведение сохранено в workspace-спецификации
 [T-Bank connection](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/tbank-connection/spec.md).
@@ -106,7 +107,7 @@ sequenceDiagram
 использования финансовых данных. Это относится и к сохранению того же самого
 token: предыдущее подключение не становится источником данных нового.
 Неуспешная операция сохраняет прежнее подключение и его доступные данные.
-Механизм generation, поздние ответы и сброс клиентских выборок объясняет
+Механизм внутренней revision, поздние ответы и сброс клиентских выборок объясняет
 [свежесть данных](../architecture/cross-cutting/data-freshness.md#смена-подключения).

 ## Конфигурация и ограничения