feat(portal): add loading refresh status

2026-06-04 19:35:31 +03:00
parent a672941cc7
commit dfecc637b5
5 changed files with 406 additions and 32 deletions
@@ -19,6 +19,28 @@
 - `Отчеты` - Markdown/PDF/JSON и управленческий текст.
 - `Настройки` - read-only параметры расчета.

+## Загрузка и актуальность данных
+
+В верхней части портала есть глобальная полоса `Data Loading & Refresh
+Status`. Она показывает, что сейчас происходит с данными, и не смешивает
+состояния `нет данных` и `данные еще загружаются`.
+
+Статусы:
+
+- `LOADING` - портал загружает сводку, отчеты или выбранный раздел;
+- `READY` - данные успешно загружены и экран актуален;
+- `EMPTY` - источники ответили, но полезных записей для выбранного раздела
+  или периода нет;
+- `STALE` - показаны ранее загруженные данные, новое фоновое обновление не
+  завершилось;
+- `ERROR` - первичная загрузка не удалась, актуальных данных на экране нет.
+
+Во время `LOADING` портал показывает skeleton placeholders и текст `Данные
+загружаются`; пустые таблицы и сообщения `Нет данных` не выводятся до
+завершения загрузки. После успешного обновления отображается время последнего
+обновления. При `STALE` старый экран остается доступным, но сверху появляется
+предупреждение о неудачном обновлении.
+
 ## Executive Dashboard

 Показывает: