docs: document hourly sync history

2026-10-09 09:05:08 +03:00
parent 9a9b0409cc
commit e0bceea936
7 changed files with 99 additions and 5 deletions
@@ -0,0 +1,25 @@
+# 019. Часовой обход и онлайн-справочник инструментов
+
+**Status:** Accepted. Дополняет [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 и события сохраняют собственные
+  локальные состояния и время последнего успешного чтения.
+- Detail, company, catalog search и ticker lookup получают ответ онлайн через
+  существующие integration clients. Их ошибки не заменяют сохранённые
+  финансовые данные или подписи snapshot.
+- Старые справочные строки не являются источником актуальности и удаляются
+  только отдельной совместимой миграцией после проверки FK и свечей.
+- Клиент повторяет открытые инвестиционные GET не чаще одного раза в 30 минут;
+  retry повторяет чтение и не создаёт screen sync work.
+
+## Consequences
+
+Карточки инструментов зависят от доступности публичного upstream в момент
+чтения. Финансовые экраны сохраняют последний успешный snapshot, а статус
+последнего hourly walk показывается отдельно. OpenAPI backend остаётся единственным
+источником HTTP-контракта; frontend использует опубликованный snapshot.