VEU.WathBody/1-docs/4-modules/m08-admin-web/api_specs/06-flutter-ui.md

Спецификация 06: Flutter Web UI (3-app\3-web\admin-web)

Источники: решение владельца 2026-10-17 (Flutter Web), UI/UX-стандарт (tech-req разд. 6: тёмная тема, ≥16pt, цвет дублируется текстом).

1. Каркас

• flutter create --platforms web (SDK 3.47.7, C:\tools\flutter); Material 3, тёмная тема; без внешних pub-пакетов (только SDK: dart:io/http из dart:io? web → package:http входит в SDK как dart:io нет — используется HttpRequest/fetch через package:http из SDK-зависимостей flutter (входит в flutter create) — внешних добавок нет);
• состояние — ChangeNotifier (AdminState: токен, текущий экран); токен — sessionStorage['adminToken'];
• ApiClient(baseUrl, token): GET/POST JSON; 401 → очистка токена, экран логина; все запросы /api/admin/* относительно origin.

2. Экраны (навигация — NavigationRail слева)

1. Логин: логин/пароль → POST login → токен в sessionStorage.
2. Атлеты: таблица (id, имя, блок, создан); «+ Атлет» — диалог (имя) → показать ключ в диалоге с кнопкой «Скопировать» и предупреждением «показывается один раз»; смена ключа — то же; блокировка — Switch.
3. Тренировки: фильтры (атлет-дропдаун, дата с/по), таблица (дата, атлет, мин, ср. пульс, подходы, adherence), пагинация (limit 50); строка → карточка: план/факт по упражнениям, таймлайн подходов (старт/длит./пульс/отдых), пульсограмма (CustomPaint, линия по hrCurve); кнопка «CSV» — ссылка workouts.csv с текущими фильтрами (+ токен через ?token= не поддерживается — CSV открывается через fetch c Bearer и Blob-download).
4. Программы: выбор атлета → версии (номер, статус, автор, rationale, дата); просмотр body (formatted JSON, сворачиваемое); активация draft (подтверждение); rules-draft — кнопка «Применить предложение» (подтверждение с rationale).
5. Метрики: атлет + период; таблица тренировок; недельный график — столбики тоннажа + линия adherence (CustomPaint, значения подписаны текстом).
6. План/факт: атлет → сводка недель (запланировано/выполнено/ пропущено, adherence), отклонение цветом + текстом.

3. Сборка и хостинг

• flutter build web --release → build/web;
• копия в Server.WatchBody.Web\wwwroot\admin\ (скрипт build.ps1 в проекте UI); Kestrel отдаёт статику: /admin → index.html (fallback-маршрут), ассеты — как файлы;
• базовый URL API = origin страницы (консоль на том же сервере).

4. Проверки

• flutter analyze — чисто; flutter build web — без ошибок;
• ручной смок по чек-листу: логин/401-редирект, CRUD атлетов, список/карточка/CSV, активация/применение, метрики, план/факт (данные — тестовые атлеты docker-БД).