docs: document hourly investment reads
This commit was merged in pull request #32.
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user