# Sprint 10 — расширенный seed + UX-полировка

Цель: реалистичные год-данные для отчётов + дашборд-виджеты +
глобальный Cmd+K-поиск + dark-mode полировка.

Старт: 2026-06-06. Исполнитель: Claude Opus 4.7 (автономный режим).

## Принципы

- Multi-tenant обязателен.
- Каждый пункт: build + локальные тесты + `~/deploy-stage.sh` + retest
  на `https://test.admin.food-market.kz`.
- НЕ трогать: `global.json`, прод-стек, POS WPF.

## Чек-лист

- [x] **1. Расширенный SeedDemoData --years=1** — `YearDemoSeeder.cs`,
  POST `/api/admin/seed-demo?years=1`. Маркер `Y1-`, идемпотентен,
  жёсткий гард «tenant has activity» когда уже есть Supply/RetailSale.
  Реально создаёт: 8 групп / 200 товаров (25 на группу) / 30 контрагентов
  (15 поставщиков + 15 покупателей) / 80 приёмок равномерно по году /
  **1500 розничных продаж с месячной сезонностью** (Dec пик ×1.6,
  Jul-Aug спад ×0.7..0.75) / 20 customer-returns / 8 wholesale-demands /
  10 списаний / 3 перемещения / 5 инвентаризаций. Stocks пересчитываются
  bulk'ом из StockMovement (5535 шт.). 16.5s на dev-vm. Проверено:
  Sales-stats показывает «revenuePrevMonth 789750», ABC даёт top
  «Колбаса сервелат» класс A с 3.1% доли.
- [x] **2. Dashboard виджеты** — новый `DashboardController` с 4 endpoint'ами:
  `/api/dashboard/top-products`, `/low-stock`, `/recent-sales`, `/margin`.
  `SalesStatsResponse` расширен `revenueThisWeek/transactionsThisWeek`.
  UI: `components/DashboardWidgets.tsx` — TopProductsWidget, LowStockWidget,
  RecentSalesWidget, MarginWidget; все 4 lazy через `React.lazy` + Suspense
  с Skeleton-плейсхолдером. SignalR `SalePosted` инвалидирует все 4 виджета
  + sales-stats. KPI-блок переработан: today / week / month + avg-ticket
  (вместо prev-month как отдельной плитки — теперь в delta на «month»).
  Каталог-плитки (товары/контрагенты/склады/точки) остаются ниже.
- [ ] **3. Глобальный search Cmd+K** — палитра команд: товары/контрагенты/
  документы/страницы, подсветка совпадений, recent items.
- [ ] **4. Dark mode полировка** — найти страницы без `dark:`, добавить
  Tailwind dark-префиксы, скрин до/после на топ-10 страниц.

## Журнал

### 2026-06-06 старт
Прошёл verify-sprint (78/78 stage-ui specs ✓), `~/.fm-watchdog/DONE` снят.
Поехали по чек-листу.

### 2026-06-06 п.1
`YearDemoSeeder` создан. Идемпотентен через маркер `Y1-`, жёсткий гард на
свежем tenant'е. Bulk stock-agg вместо per-document SaveChanges — 16.5s.

### 2026-06-06 п.2
4 dashboard endpoint'a + lazy виджеты + week-stats в существующем
`/api/sales/retail/stats`. Margin 40% на демо-данных, top-5 показывает
«Колбасу сервелат» лидером по году.