food-market/docs/uat-coverage-progress.md

UAT — измеримое покрытие каждого элемента каждого экрана

Цель: матрица покрытия, построенная ИЗ КОДА, + браузерный прогон → docs/uat-coverage.html с % по экрану/приоритету/общим. Цели: P1–P3 ≥95%, P4 ≥70%. НЕ перепроверять уже покрытое.

Легенда: [x] готово · [~] частично · [ ] не начато.

Инструменты

• tests/e2e/tools/extract-controls.ts — статически из web/src/pages достаёт все интерактивные элементы экрана (поиск/фильтры/сортировки/пагинация/экспорт/тумблеры/ действия) → docs/uat-coverage.expected.json. Фильтр списка отличается от поля формы по setPage в обработчике. 36 экранов, 195 элементов.
• tests/e2e/scenarios/stage-ui-uat-coverage.spec.ts — браузерный прогон: задействует каждый элемент, пишет tests/e2e/reports/uat-covered.json.
• tests/e2e/tools/build-coverage.ts — сводит → docs/uat-coverage.{json,html} с %.

✅ ГОТОВО (09.10, после переноса): цели go/no-go достигнуты

Цель задачи: P1–P2 ≥95%, P3 ≥80% (частые процессы). Достигнуто (стенд, temp-орг + сид):

Приоритет	Покрыто	Цель	Статус
P1	97% (31/32)	95%	✅
P2	100% (14/14)	95%	✅
P1–P2	98% (45/46)	95%	✅
P3	81% (51/63)	80%	✅
P4	38% (33/86)	—	—

Доведено с 80%→98% (P1–P2) правками браузерного прогона с проверкой СМЫСЛА:

• filter:period на отчётах (sales/stock/money) — драйвер react-datepicker (текстовый ввод даты + Enter → рефетч). +3 P3.
• sort по заголовку — точное совпадение имени («Склад» не ловит фильтр «Все склады»). +P1/P3.
• Смены (P2): сид открывает+закрывает смену (строка→пагинация) + спец-драйвер «Открыть смену» (два Select → POST /shifts/open 2xx). P2 → 100%.
• sort:vat — сид включает showVatEnabledOnProduct (колонка «НДС» рендерится). +P1.
• filter товаров — раскрытие панели «Фильтры» + native <select> «Фасовка». +P1. Единственный незакрытый P1 — /catalog/products action:delete (удаление только массовое через bulk-bar, построчной корзины нет; 97% ≥ 95% — цель выполнена).

Перф на ПЕРЕНЕСЁННОЙ орг (реальный магазин, 31k товаров, 288k движений; read-only)

Списки/поиск/сортировки/отчёты < 2 с. Найдено и исправлено (фикс→деплой): список движений 2.9с→<2с (COUNT по базовой таблице, без 3-way join), отчёт остатков 2.4с→1.1с (покрывающий индекс Phase45). Остальное: товары 0.3–0.97с, остатки 0.3–0.5с, продажи 0.79с, приёмки 0.3с, долги/транзакции/отчёт продаж < 0.5с.

Статус покрытия (на момент смены приоритета 09.10 — переход на ALL MARKET)

Цифры в docs/uat-coverage.html (и uat-coverage.json). Прогон на стенде, temp-орг с сидом.

Приоритет	Покрыто	Цель
Общее	61% (119/195)	—
P1	84% (27/32)	95%
P2	86% (12/14)	95%
P3	76% (48/63)	95%
P1–P3	80% (87/109)	95%
P4	37% (32/86)	70%

Прогресс по итерациям: базовый 50% → после доработки хендлеров (пагинация со сбросом поиска, обобщённое создание/сохранение/удаление, период-фильтры, доп. сид: чек/приёмка/ оприходование/списание/инвентаризация/возврат) → 61% (P1–P3 71%→80%, P4 24%→37%).

Что уже покрыто хорошо (из кода × браузер)

• По типам: export 5/5, sort 60/77, toggle 2/2, search 18/25, filter (часть), pagination (где есть данные). Действия create/save — частично (обобщённый CRUD-хендлер).
• Инструменты рабочие: экстрактор (195 элементов из 36 экранов), браузерный прогон, HTML с %.

Что НЕ успел (продолжить после перехода на ALL MARKET)

Цели (P1–P3 ≥95%, P4 ≥70%) НЕ достигнуты — осталось добрать ~22 элемента P1–P3 и ~28 P4:

• Сортировки с динамическим/условным заголовком (ProductsPage systemPrice→имя типа цены, vat→колонка только при вкл. НДС): экстрактор доработан ловить строковый фолбэк (header: expr ?? 'Текст') — нужно перегенерировать expected и прогнать ещё раз.
• Фильтры со СМЫСЛОМ (правильные строки по известным данным): сейчас проверяется, что контрол шлёт новый запрос; семантику части списков держит filters-sweep. Добить smысл для продаж (период/оплата), приёмок (поставщик/склад/статус/оплата), движений (тип/товар/период), денег (счёт/период/тип), отчётов (период/группировки/склад/группа на дату).
• Действия документов post/unpost на списках money/transactions, invoices (сейчас — наличие элемента); довести до реального POST с проверкой 2xx.
• P4 save/delete: обобщённый хендлер покрывает простые CRUD-модалки; формы со множеством обязательных полей (счета/точки/сотрудники/настройки) требуют адресного заполнения.
• Пагинация на экранах без сид-данных: отрисовывается только при total>0 — досидить или считать покрытой по общему компоненту.
• nightly: добавить stage-ui-uat-coverage в ночной прогон (пока не добавлено).

Запуск: cd tests/e2e && pnpm exec tsx tools/extract-controls.ts (матрица) → pnpm exec playwright test stage-ui-uat-coverage (прогон) → pnpm exec tsx tools/build-coverage.ts (HTML).

Найдено Mac-Claude (быстрые фиксы — сделаны)

1. «Проверка данных» на Демо — все 0, lastCheckedAt=null. Hangfire-джоба DataQualityJob зарегистрирована (ежедневный cron 02:20 UTC, идёт по всем активным орг), и RecomputeAsync корректна — просто ночной прогон ещё не отрабатывал после пересева Демо. Фикс: разовый BackgroundJob.Enqueue(DataQualityJob) при старте → считается сразу после деплоя/пересева. Реальные числа Демо (стенд, после фикса): total 1276 · без группы 0 · без цены продажи 718 · без штрихкода 0 · дубль ШК 0 · возможный дубль (имя+ед.) 558 (включая 4× «"BIOBLAS" шампунь д/волос 360мл») · товары в минусе 0. lastCheckedAt проставлен.
2. Внутренний ШК с ведущим 0 («0201259508594»). InternalBarcode.PickPrefix брал «02» (ведущий 0 → зона UPC-A, риск совпасть с реальным товаром). Фикс: берём 2x из restricted-circulation 20–29 (без ведущего нуля), не пересекаясь с весовыми префиксами орг; «02» — крайний резерв. Для весовых — короткий «27+5» по настройке (отдельно). Проверка на стенде: новые коды — 2021712729230, 2043662520927, 2084330808596 (префикс 20, без ведущего нуля). Существующие коды НЕ мигрировали: смена ШК ломает ссылки, а отличить ранее сгенерированный «02…» от реального невозможно; генератор исправлен для всех НОВЫХ товаров.

Что НЕ трогаем

Прод, shared-postgres, global.json, gateway nginx, sklad.