docs: document skeleton loading states

2026-08-27 21:43:57 +03:00
parent 9f8280c567
commit 95fa815328
6 changed files with 25 additions and 2 deletions
@@ -28,6 +28,11 @@ sequenceDiagram

 ## Поведение и ограничения

+При первом открытии полного журнала frontend показывает structural skeleton
+ожидаемых filters и rows вместо отдельного spinner. После появления response
+filters и данные сохраняют существующую семантику; уже показанный контент не
+заменяется skeleton во время pending action или фонового обновления.
+
 - Запрашиваются только исполненные операции T-Bank.
 - Полный журнал фильтруется по периоду (два DateInput «С»/«По» с форматом DD.MM.YYYY и min/max-ограничением, русская локаль календаря) и категориям (MultiSelect с мультивыбором из trade, income, tax, fee, transfer, other). Фильтры имеют черновик в контролах и применённое состояние: изменение черновика не вызывает новый запрос к серверу; «Применить» коммитит черновик и сбрасывает cursor-пагинацию на первую страницу; «Сбросить» очищает черновик и немедленно применяет пустой фильтр (период по умолчанию и все категории). Cursor-пагинация («Назад»/«Далее») работает по последнему применённому фильтру, не по черновику.
 - В полном журнале и пяти последних записях обзора одна и та же компактная строка показывает логотип инструмента либо буквенный fallback, описание операции, дату, инструмент и денежное движение. Денежная метка строки показывает подпись конкретного типа события: для income-записи — «Купон» или «Дивиденд» (по upstream-типу купона или дивиденда), для остальных — подпись категории («Сделка», «Налог», «Комиссия», «Перевод», «Прочее»). Подпись типа выводится один раз и не повторяется во вторичной метадате (дата · инструмент); направление передаётся знаком «+» / «−` и семантическим цветом, а не текстом. Записи без движения денег остаются нейтральными («Без движения денег»).