docs: document hourly investment reads

2026-10-09 19:56:40 +03:00
parent 3a272681c5
commit a45d3e77b9
6 changed files with 154 additions and 121 deletions
@@ -1,6 +1,8 @@
 # 017. Локальное чтение данных T-Bank и фоновая синхронизация

-**Status:** Accepted — архитектурное направление согласовано.
+**Status:** Accepted — историческое архитектурное направление. Решения ниже о
+request-driven запуске, ручном обновлении и отсутствии периодического обхода
+заменены [ADR 019](019-hourly-reads-and-online-instrument-reference.md).

 Prefetch policy ниже заменена [ADR 018](018-minimal-runtime-coordination.md):
 свечи загружаются по запрошенному диапазону, без предварительной загрузки
@@ -1,25 +1,37 @@
 # 019. Часовой обход и онлайн-справочник инструментов

-**Status:** Accepted. Дополняет [ADR 017](017-local-tbank-reads-and-background-sync.md)
-и [ADR 018](018-minimal-runtime-coordination.md).
+**Status:** Accepted. Заменяет request-driven, manual-refresh и
+no-periodic-walk части [ADR 017](017-local-tbank-reads-and-background-sync.md)
+и дополняет [ADR 018](018-minimal-runtime-coordination.md).

 ## Decision

- Личные T-Bank данные обновляются владельцами источников через durable hourly
-  walk; обычные GET не запускают screen import.
- Quotes, candles, operations, forecasts и события сохраняют собственные
-  локальные состояния и время последнего успешного чтения.
+- Личные T-Bank данные текущего подключения обновляются владельцами источников
+  через durable hourly walk; его результат ограничен этой connection boundary.
+  Обычный GET и retry читают только сохранённый результат и не запускают
+  personal work.
+- Только первое открытие неподтверждённого исторического интервала operations
+  и первого неоткрытого диапазона candles может получить соответственно этот
+  интервал или диапазон. Это не manual sync; повторное чтение не расширяет и не
+  запускает такую работу заново.
+- Portfolio, operations, forecasts и события сохраняют собственные complete
+  результаты и время последнего успешного чтения. Результат ресурса
+  (freshness, completeness, `lastSuccessfulAt`, availability) независим от
+  resource-relevant последней часовой попытки: поздняя partial/failed попытка
+  не заменяет сохранённый complete result. При его отсутствии `data: null`.
 - Detail, company, catalog search и ticker lookup получают ответ онлайн через
  существующие integration clients. Их ошибки не заменяют сохранённые
  финансовые данные или подписи snapshot.
 - Старые справочные строки не являются источником актуальности и удаляются
  только отдельной совместимой миграцией после проверки FK и свечей.
 - Клиент повторяет открытые инвестиционные GET не чаще одного раза в 30 минут;
-  retry повторяет чтение и не создаёт screen sync work.
+  retry повторяет чтение и не создаёт screen sync work. Наблюдение последней
+  попытки, включая Accounts `sync`, не является командой.

 ## Consequences

 Карточки инструментов зависят от доступности публичного upstream в момент
 чтения. Финансовые экраны сохраняют последний успешный snapshot, а статус
-последнего hourly walk показывается отдельно. OpenAPI backend остаётся единственным
-источником HTTP-контракта; frontend использует опубликованный snapshot.
+последнего hourly walk показывается отдельно. OpenAPI backend остаётся
+единственным исполняемым источником HTTP-контракта; frontend использует
+опубликованный snapshot.