docs: explain persisted T-Bank reads and synchronization
Conventional commits / commits (pull_request) Successful in 14s
Docs security / security (pull_request) Successful in 8s
Docs verify / verify (pull_request) Successful in 13s
Docs security / security (push) Successful in 8s
Docs verify / verify (push) Successful in 12s
Conventional commits / commits (pull_request) Successful in 14s
Docs security / security (pull_request) Successful in 8s
Docs verify / verify (pull_request) Successful in 13s
Docs security / security (push) Successful in 8s
Docs verify / verify (push) Successful in 12s
Document local data ownership, coverage and freshness, refresh behavior, failure recovery and additive migration rollback. Record ADR 017.
This commit was merged in pull request #22.
This commit is contained in:
@@ -60,39 +60,23 @@ API принимает необязательные `from` и `to` в форма
|
||||
`incomeTotalsByCurrency`, включающего только купоны и дивиденды.
|
||||
Итоги остаются в ответе API; полный экран показывает список без общего итога.
|
||||
|
||||
Текущие controller, сервис и экран поддерживают выбор периода, тогда как
|
||||
[основная спецификация](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-account-page-presents-an-upcoming-events-list)
|
||||
описывает фиксированные 30 дней и экран без фильтров. Документация отражает
|
||||
реализованный выбор периода, не изменяя это несогласованное требование.
|
||||
|
||||
## Получение и отказы
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant F as Frontend
|
||||
participant B as Backend
|
||||
participant T as T-Bank
|
||||
participant M as MOEX ISS
|
||||
F->>B: Счёт и выбранный период событий
|
||||
B->>B: Проверяет сессию и текущее подключение
|
||||
B->>T: Получает открытые счета и позиции доступного счёта
|
||||
par События акций
|
||||
B->>T: GetDividends за выбранный период
|
||||
T-->>B: Известные дивиденды
|
||||
and События облигаций
|
||||
B->>M: Календарь bondization
|
||||
M-->>B: Купоны, погашения и оферты
|
||||
end
|
||||
B->>B: Применяет период и текущее количество бумаг
|
||||
B-->>F: Полный список известных событий либо ошибка
|
||||
```
|
||||
Запрос требует сессии, подключения и локально подтверждённого membership.
|
||||
Прогноз строится из личного сохранённого portfolio и общих календарей: T-Bank для
|
||||
дивидендов, MOEX для bond events. Отдельного синхронного получения portfolio
|
||||
нет. Личные оценки сохраняются отдельно от общих календарей.
|
||||
|
||||
Запрос требует действующей сессии и подключения T-Bank. Получение
|
||||
необходимых финансовых данных брокера или календаря MOEX завершается ошибкой
|
||||
`503`, если источник недоступен: частичный список не выдаётся как полный.
|
||||
Доступные метаданные инструментов дополняют название и логотип; когда
|
||||
исходного тикера достаточно для календаря, ошибка дополнительного поиска
|
||||
метаданных не скрывает события.
|
||||
Последний полный forecast привязан к scope, периоду и membership.
|
||||
Если новый portfolio требует ещё недоступного календаря, прежний полный
|
||||
прогноз и его source times остаются, в том числе после рестарта. Новый
|
||||
полный результат заменяет его атомарно. Без fallback показывается
|
||||
missing/partial, а не подтверждённое отсутствие выплат. Другой период или
|
||||
изменившийся membership не получают старый прогноз под новым названием.
|
||||
Source failure сообщается в metadata и не изменяет успешное время.
|
||||
Успешный ответ MOEX без запрошенного блока означает отсутствие поддерживаемых
|
||||
событий этого источника; это отличается от transport failure и повреждённого
|
||||
формата ответа.
|
||||
|
||||
При первом открытии показан каркас заголовка и строк, без интерактивных
|
||||
заглушек. Пустой ответ сохраняет возможность изменить период.
|
||||
|
||||
Reference in New Issue
Block a user