docs: describe quiet reading and visible source state (#51)

ADR 021 фиксирует решение о тихом чтении и видимом состоянии источника; ui-resilience и затронутые domains приведены к AS-IS.
2026-10-17 22:11:49 +03:00
parent 11f819ed31
commit e8e3ef6285
9 changed files with 120 additions and 30 deletions
@@ -80,11 +80,12 @@ Backend получает данные через серверную
 сохраняются предыдущие суммы и время успешного получения в UTC.

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

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