docs: describe quiet reading and visible source state (#51)
ADR 021 фиксирует решение: автоматическое чтение клиента не сообщает о себе, состояние источника из meta остаётся видимым, ошибки явных действий пользователя сохраняются. Приведены к AS-IS: ui-resilience, accounts, income, bonds, stocks, portfolio overview и how-to. ADR 017 не правился — он помечен историческим и заменён ADR 019/021.
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user