docs: describe quiet reading and visible source state (#51)
Docs security / security (push) Successful in 8s
Docs verify / verify (push) Successful in 13s

ADR 021 фиксирует решение о тихом чтении и видимом состоянии источника; ui-resilience и затронутые domains приведены к AS-IS.
This commit was merged in pull request #52.
This commit is contained in:
2026-10-17 22:11:49 +03:00
parent 11f819ed31
commit e8e3ef6285
9 changed files with 120 additions and 30 deletions
+26 -10
View File
@@ -16,11 +16,17 @@
пока неизвестно, доступен public или protected маршрут. При загрузке
отложенного маршрута уже доступный каркас остаётся видимым.
Фоновое обновление и действие пользователя сохраняют видимые данные или
элемент управления с компактной индикацией процесса. В частности,
Фоновое чтение не сообщает о себе: оно сохраняет видимые данные без индикации
процесса и без технического предупреждения. В частности,
[клиентский снимок](data-freshness.md#клиентский-и-серверный-снимки) счетов или
портфеля остаётся доступным после ошибки refetch; сообщение и повтор
относятся к обновлению, а не к отсутствию инвестиций.
портфеля остаётся доступным после ошибки refetch, и эта ошибка не означает
отсутствие инвестиций. Действие пользователя сохраняет видимые данные или
элемент управления и сообщает свой результат, включая неуспешный.
Первичное ожидание ограничено по времени. По его истечении область переходит
в спокойную локальную недоступность вместо бесконечной загрузки и сама
заменяет её содержимым после восстановления. Решение принято в
[ADR 021](../../adr/021-quiet-reading-and-rare-confirmations.md).
Серверная полнота не выводится из query lifecycle. Missing показывает
skeleton только отсутствующих секций, partial — подтверждённые строки и
@@ -28,20 +34,30 @@ skeleton только отсутствующих секций, partial — по
готовятся независимо. Только complete empty означает отсутствие операций.
Время источника не заменяется временем получения HTTP-ответа.
Ручное обновление сохраняет показанный результат и applied filters; кнопка
недоступна во время уже запрошенной работы. Ошибка transport отличается от
Экраны просмотра не предлагают ручное обновление или повтор чтения: временные
сбои GET восстанавливаются сами ограниченным числом повторов, сохраняя
показанный результат и applied filters. Ошибка transport отличается от
ошибки source work. Status observation прекращается после terminal outcome
или ухода; само истечение TTL не запускает импорт. Известный access loss
очищает personal view, включая защиту от позднего ответа.
Состояние источника при этом видимо: время последнего успешного результата,
устаревание, исход последней часовой попытки и неполнота показаны текстом либо
доступно именованным элементом рядом с данными, к которым относятся. Это
свойство данных, а не отчёт о техническом процессе, и оно не требует действия.
## Известная ошибка сценария
Ошибки счетов, портфеля и подключения T-Bank остаются локальными: рядом
с затронутыми данными доступны предусмотренные сценарием retry и navigation
actions. Устаревший серверный Portfolio Snapshot показывает сохранённый
портфель с предупреждением. Он не превращается в глобальный fallback.
Ошибки счетов, портфеля и подключения T-Bank остаются локальными: затронутый
блок показывает собственное состояние и не скрывает успешно отображённые
соседние блоки. Устаревший серверный Portfolio Snapshot показывает сохранённый
портфель с обозначением устаревания. Он не превращается в глобальный fallback.
Ошибка источника не означает нулевой баланс или отсутствие операций.
Предусмотренные сценарием navigation actions сохраняются: подтверждённая потеря
доступа предлагает восстановить подключение, а `404` — вернуться к списку
счетов. Это навигация и явные действия пользователя, а не повтор чтения.
## Непойманная ошибка маршрута
Непойманная runtime-ошибка при отображении public или protected route