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.
2026-10-17 22:09:38 +03:00
parent 11f819ed31
commit 174fbf01c3
9 changed files with 120 additions and 30 deletions
@@ -80,11 +80,12 @@ Backend получает данные через серверную
 сохраняются предыдущие суммы и время успешного получения в UTC.

 Серверный `isStale` обозначает возраст снимка старше часа: обновлением
-владеет часовой обход, а не запрос экрана.
-Клиентское предупреждение означает неудачную попытку обновить уже показанный
-ответ. Эти состояния независимы и могут появиться одновременно.
-Успешный повторный запрос обновляет суммы и время, снимает клиентскую ошибку;
-серверное предупреждение определяется новым `isStale`.
+владеет часовой обход, а не запрос экрана. Он показывается рядом с суммами
+вместе с временем последнего успешного результата и исходом последней часовой
+попытки. Неудачная попытка клиента обновить уже показанный ответ о себе не
+сообщает: эти состояния независимы, но пользователю видимо только состояние
+источника. Успешное автоматическое перечитывание обновляет суммы и время;
+обозначение устаревания определяется новым `isStale`.
 Правила времени и ошибок приведены в [потоке загрузки](flows/portfolio-loading.md).

 Отдельного чтения истории стоимости нет, но каждый полный снимок