docs: align current pages with hourly freshness model (WealthLedger/docs#34)

2026-10-14 13:18:18 +03:00
parent cad0f31615
commit ffe29c58f9
6 changed files with 35 additions and 27 deletions
@@ -71,9 +71,10 @@
 ## Свежесть и границы

 Обычное открытие использует query owner и локальный server snapshot.
-«Обновить» запрашивает membership и сводки доступных счетов; активная работа
-наблюдается без нового импорта. Истечение TTL само не запускает запрос.
-Membership имеет пятиминутную свежесть, portfolio — минутную. Время списка
+«Обновить» перечитывает сохранённые membership и сводки доступных счетов;
+активная работа наблюдается без нового импорта. Истечение TTL само не
+запускает запрос: обновлением личных данных владеет часовой обход.
+Membership и portfolio source имеют часовую свежесть. Время списка
 не подменяет время каждой сводки. Список не заменяет полный
 [портфель](../portfolio/overview.md), [журнал](../operations/overview.md)
 или историю закрытых счетов. Для общего результата доступен
@@ -121,8 +121,8 @@ HTML-источник, общий кэш и поведение при измен
 portfolio; они не попадают в общие источники.

 BondBy переиспользуется зависимостями выпуска. Discovery принадлежит query,
-свежесть — конкретному source/range. Missing/stale зависимости запрашиваются
-в фоне через прежний limiter; обычный HTTP-ответ не ждёт брокера.
+свежесть — конкретному source/range. Missing/stale зависимости ставятся
+в фоновую очередь через прежний limiter; обычный HTTP-ответ не ждёт брокера.
 Покрытые завершённые свечи не перечитываются после restart. Открытый хвост
 остаётся изменяемым; ручной refresh охватывает показанный период.

@@ -150,6 +150,6 @@ BondBy переиспользуется зависимостями выпуск

 ## Online reference

-Bond detail, search, and ticker lookup are read from the upstream integration
-on each request. Saved quotes, candles, events, ratings, and portfolio labels
-retain their own freshness and failure boundaries.
+Страница облигации, поиск и переход по тикеру обращаются к онлайн-справочнику
+брокера; сохранённые quotes, свечи, события, ratings и метки портфеля
+сохраняют собственные границы свежести и ошибок.
@@ -159,9 +159,10 @@ TTM означает последние 12 месяцев, MRQ — послед
 источники переиспользуются между пользователями, но личные позиции и выплаты
 всегда проверяют доступ.

-Обычное чтение не ждёт RPC; missing/stale зависимости запрашиваются в фоне
-через существующий T-Bank limiter. Минутная свежесть применяется к quotes
-и открытому хвосту свечей, суточная — к metadata/company/календарям.
+Обычное чтение не ждёт RPC; missing/stale зависимости ставятся в фоновую
+очередь через существующий T-Bank limiter. Часовая свежесть применяется
+к quotes и открытому хвосту свечей; metadata/company/календари, будучи
+сохранёнными, не перечитываются обычным чтением.
 Закрытые полные свечные интервалы, включая пустые, сохраняются после restart.
 Новый день не делает прежнюю незавершённую свечу полной.

@@ -197,7 +198,6 @@ scope. Частичные строки видны с предупреждени

 ## Online reference

-Stock detail, company data, search, and ticker lookup are read from the
-upstream integration on each request. Saved positions, quotes, candles, and
-events remain independent local resources and are not replaced by a reference
-read failure.
+Страница акции, поиск и переход по тикеру обращаются к онлайн-справочнику
+брокера; сохранённые позиции, quotes, свечи и события остаются независимыми
+локальными ресурсами и не подменяются ошибкой справочника.
@@ -32,7 +32,7 @@
 | Cash Balance | Суммы из `GetPositions.money`, объединённые по валюте | Заблокированные деньги не прибавляются; торгуемый инструмент `CURRENCY` остаётся позицией |
 | `totalsByCurrency` | Стоимости позиций + доступные деньги той же валюты | Не включает невычислимую стоимость; не обещает полную оценку портфеля |
 | `lastSuccessfulAt` | Время формирования успешного снимка, UTC | Не является временем каждой котировки; запасной снимок сохраняет исходное время |
-| `isStale` | Истёк минутный срок свежести сохранённого portfolio source | Не описывает состояние клиентского кэша или ошибку фонового запроса |
+| `isStale` | Истёк часовой срок свежести сохранённого portfolio source | Не описывает состояние клиентского кэша или ошибку фонового запроса |

 Ненулевые денежные остатки одной валюты суммируются. Позиции одинаковых
 инструментов в ответе отдельного счёта не объединяются; визуальная группировка
@@ -79,18 +79,22 @@ Backend получает данные через серверную
 не содержат данных и не получают фокус. При обычном фоновом обновлении
 сохраняются предыдущие суммы и время успешного получения в UTC.

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

-В текущем решении нет долговременной истории снимков, графиков стоимости
-портфеля, валютной конвертации, учёта виртуальных позиций или заблокированных
-средств. Последний полный снимок сохраняется после перезапуска; выполнение
-синхронизации рассчитано на один экземпляр backend. Действие «Обновить»
-перечитывает зависимости открытого экрана независимо от их свежести.
+Отдельного чтения истории стоимости нет, но каждый полный снимок
+сохраняет точку оценки по счёту и валюте для будущих поддерживаемых
+представлений; публичного графика в текущем решении нет. Нет также
+валютной конвертации, учёта виртуальных позиций или заблокированных
+средств. Последний полный снимок сохраняется после перезапуска;
+обновлением личных данных владеет часовой обход, рассчитанный на один
+экземпляр backend. Действие «Обновить» выполняет только локальное
+перечитывание открытого экрана и не запускает работу с T-Bank.

 Для проверки конкретной суммы используйте
 [руководство по расхождениям](how-to/investigate-discrepancy.md).