diff --git a/docs/uat-coverage.expected.json b/docs/uat-coverage.expected.json new file mode 100644 index 0000000..4be43ef --- /dev/null +++ b/docs/uat-coverage.expected.json @@ -0,0 +1,1341 @@ +{ + "generatedAt": "2026-10-09T07:24:13.680Z", + "totalElements": 195, + "screens": [ + { + "route": "/catalog/products", + "page": "ProductsPage", + "file": "pages/ProductsPage.tsx", + "priority": "P1", + "title": "Здесь пока пусто", + "listUrl": "/api/catalog/products", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "export", + "label": "экспорт (/api/catalog/products/export)", + "type": "export" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "sort:packaging", + "label": "сортировка: Фасовка", + "type": "sort" + }, + { + "key": "sort:cost", + "label": "сортировка: Себестоимость", + "type": "sort" + }, + { + "key": "sort:systemPrice", + "label": "сортировка: systemPrice", + "type": "sort" + }, + { + "key": "sort:vat", + "label": "сортировка: НДС", + "type": "sort" + }, + { + "key": "filter:все", + "label": "фильтр: все", + "type": "filter" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/inventory/stock", + "page": "StockPage", + "file": "pages/StockPage.tsx", + "priority": "P1", + "title": "Остатки", + "listUrl": "/api/inventory/stock", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "export", + "label": "экспорт (/api/inventory/stock/export)", + "type": "export" + }, + { + "key": "sort:name", + "label": "сортировка: Товар", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Склад", + "type": "sort" + }, + { + "key": "sort:unit", + "label": "сортировка: Ед.", + "type": "sort" + }, + { + "key": "sort:quantity", + "label": "сортировка: Остаток", + "type": "sort" + }, + { + "key": "sort:reserved", + "label": "сортировка: Резерв", + "type": "sort" + }, + { + "key": "sort:available", + "label": "сортировка: Доступно", + "type": "sort" + }, + { + "key": "filter:все-склады", + "label": "фильтр: Все склады", + "type": "filter" + }, + { + "key": "toggle:показать-нулевые", + "label": "переключатель: Показать нулевые", + "type": "toggle" + }, + { + "key": "toggle:только-минусы", + "label": "переключатель: Только минусы", + "type": "toggle" + } + ] + }, + { + "route": "/sales/retail", + "page": "RetailSalesPage", + "file": "pages/RetailSalesPage.tsx", + "priority": "P1", + "title": "Розничные продажи", + "listUrl": "/api/sales/retail", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "export", + "label": "экспорт (/api/sales/retail/export)", + "type": "export" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата/время", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Магазин", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/money/shifts", + "page": "CashShiftsPage", + "file": "pages/money/CashShiftsPage.tsx", + "priority": "P2", + "title": "Смены кассы", + "listUrl": "/api/money/shifts", + "elements": [ + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "action:print", + "label": "действие: печать", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/purchases/supplies", + "page": "SuppliesPage", + "file": "pages/SuppliesPage.tsx", + "priority": "P2", + "title": "Приёмки от поставщиков", + "listUrl": "/api/purchases/supplies", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "export", + "label": "экспорт (/api/purchases/supplies/export)", + "type": "export" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:supplier", + "label": "сортировка: Поставщик", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Склад", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "filter:оплата-все", + "label": "фильтр: Оплата: все", + "type": "filter" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/catalog/counterparties", + "page": "CounterpartiesPage", + "file": "pages/CounterpartiesPage.tsx", + "priority": "P3", + "title": "Контрагенты", + "listUrl": "/api/catalog/counterparties", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "export", + "label": "экспорт (/api/catalog/counterparties/export)", + "type": "export" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "sort:type", + "label": "сортировка: Тип", + "type": "sort" + }, + { + "key": "sort:phone", + "label": "сортировка: Телефон", + "type": "sort" + }, + { + "key": "sort:country", + "label": "сортировка: Страна", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/catalog/data-quality", + "page": "DataQualityPage", + "file": "pages/DataQualityPage.tsx", + "priority": "P3", + "title": "Проверка данных", + "listUrl": "", + "elements": [ + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + } + ] + }, + { + "route": "/inventory/enters", + "page": "EntersPage", + "file": "pages/EntersPage.tsx", + "priority": "P3", + "title": "Оприходования", + "listUrl": "/api/inventory/enters", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Склад", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/inventory/inventories", + "page": "InventoriesPage", + "file": "pages/InventoriesPage.tsx", + "priority": "P3", + "title": "Инвентаризации", + "listUrl": "/api/inventory/inventories", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/inventory/losses", + "page": "LossesPage", + "file": "pages/LossesPage.tsx", + "priority": "P3", + "title": "Списания", + "listUrl": "/api/inventory/losses", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:reason", + "label": "сортировка: Причина", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Склад", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/inventory/movements", + "page": "StockMovementsPage", + "file": "pages/StockMovementsPage.tsx", + "priority": "P3", + "title": "Движения", + "listUrl": "/api/inventory/movements", + "elements": [ + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:occurredAt", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:type", + "label": "сортировка: Операция", + "type": "sort" + }, + { + "key": "sort:product", + "label": "сортировка: Товар", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Склад", + "type": "sort" + }, + { + "key": "sort:quantity", + "label": "сортировка: Количество", + "type": "sort" + }, + { + "key": "sort:documentType", + "label": "сортировка: Документ", + "type": "sort" + }, + { + "key": "filter:все-склады", + "label": "фильтр: Все склады", + "type": "filter" + } + ] + }, + { + "route": "/money/report", + "page": "MoneyReportPage", + "file": "pages/money/MoneyReportPage.tsx", + "priority": "P3", + "title": "Отчёт «Деньги»", + "listUrl": "/api/money/reports/balances", + "elements": [ + { + "key": "filter:period", + "label": "фильтр: период/дата", + "type": "filter" + } + ] + }, + { + "route": "/money/supplier-debts", + "page": "SupplierDebtsPage", + "file": "pages/money/SupplierDebtsPage.tsx", + "priority": "P3", + "title": "Долги поставщикам", + "listUrl": "/api/money/reports/supplier-debts", + "elements": [ + { + "key": "action:post", + "label": "действие: провести", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/money/transactions", + "page": "MoneyTransactionsPage", + "file": "pages/money/MoneyTransactionsPage.tsx", + "priority": "P3", + "title": "Платежи и ордера", + "listUrl": "/api/money/transactions", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "filter:все-статусы", + "label": "фильтр: Все статусы", + "type": "filter" + }, + { + "key": "filter:все-типы", + "label": "фильтр: Все типы", + "type": "filter" + }, + { + "key": "action:post", + "label": "действие: провести", + "type": "action" + }, + { + "key": "action:unpost", + "label": "действие: снять проведение", + "type": "action" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/purchases/invoices", + "page": "InvoicesPage", + "file": "pages/InvoicesPage.tsx", + "priority": "P3", + "title": "Накладные", + "listUrl": "/api/purchases/invoices", + "elements": [ + { + "key": "action:unpost", + "label": "действие: снять проведение", + "type": "action" + } + ] + }, + { + "route": "/purchases/supplier-returns", + "page": "SupplierReturnsPage", + "file": "pages/SupplierReturnsPage.tsx", + "priority": "P3", + "title": "Возвраты поставщикам", + "listUrl": "/api/purchases/supplier-returns", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:supplier", + "label": "сортировка: Поставщик", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/reports/sales", + "page": "SalesReportPage", + "file": "pages/SalesReportPage.tsx", + "priority": "P3", + "title": "Данных для отчёта нет", + "listUrl": "/api/reports/sales", + "elements": [ + { + "key": "filter:period", + "label": "фильтр: период/дата", + "type": "filter" + } + ] + }, + { + "route": "/reports/stock", + "page": "StockReportPage", + "file": "pages/StockReportPage.tsx", + "priority": "P3", + "title": "Остатки пусты", + "listUrl": "/api/reports/stock", + "elements": [ + { + "key": "filter:period", + "label": "фильтр: период/дата", + "type": "filter" + } + ] + }, + { + "route": "/admin/import/moysklad", + "page": "MoySkladImportPage", + "file": "pages/MoySkladImportPage.tsx", + "priority": "P4", + "title": "Импорт из МойСклад", + "listUrl": "/api/admin/jobs/", + "elements": [ + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + } + ] + }, + { + "route": "/audit-log", + "page": "OrgAuditLogPage", + "file": "pages/OrgAuditLogPage.tsx", + "priority": "P4", + "title": "Журнал изменений", + "listUrl": "/api/organization/employees", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "filter:sel1", + "label": "фильтр: фильтр 1", + "type": "filter" + }, + { + "key": "filter:sel2", + "label": "фильтр: фильтр 2", + "type": "filter" + }, + { + "key": "filter:все", + "label": "фильтр: Все", + "type": "filter" + }, + { + "key": "filter:period", + "label": "фильтр: период/дата", + "type": "filter" + } + ] + }, + { + "route": "/catalog/price-types", + "page": "PriceTypesPage", + "file": "pages/PriceTypesPage.tsx", + "priority": "P4", + "title": "Типы цен", + "listUrl": "/api/catalog/price-types", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "sort:isRequired", + "label": "сортировка: Обязательно", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/catalog/product-groups", + "page": "ProductGroupsPage", + "file": "pages/ProductGroupsPage.tsx", + "priority": "P4", + "title": "Группы товаров", + "listUrl": "/api/catalog/product-groups", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "sort:path", + "label": "сортировка: Путь", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/catalog/retail-points", + "page": "RetailPointsPage", + "file": "pages/RetailPointsPage.tsx", + "priority": "P4", + "title": "Кассы", + "listUrl": "/api/catalog/retail-points", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "sort:code", + "label": "сортировка: Код", + "type": "sort" + }, + { + "key": "sort:store", + "label": "сортировка: Склад", + "type": "sort" + }, + { + "key": "sort:address", + "label": "сортировка: Адрес", + "type": "sort" + }, + { + "key": "sort:isActive", + "label": "сортировка: Активна", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/catalog/stores", + "page": "StoresPage", + "file": "pages/StoresPage.tsx", + "priority": "P4", + "title": "Склады", + "listUrl": "/api/catalog/stores", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "sort:code", + "label": "сортировка: Код", + "type": "sort" + }, + { + "key": "sort:address", + "label": "сортировка: Адрес", + "type": "sort" + }, + { + "key": "sort:isMain", + "label": "сортировка: Основной", + "type": "sort" + }, + { + "key": "sort:isActive", + "label": "сортировка: Активен", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/catalog/units", + "page": "UnitsOfMeasurePage", + "file": "pages/UnitsOfMeasurePage.tsx", + "priority": "P4", + "title": "Единицы измерения", + "listUrl": "/api/catalog/units-of-measure", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + } + ] + }, + { + "route": "/inventory/mobile", + "page": "InventoryMobilePage", + "file": "pages/InventoryMobilePage.tsx", + "priority": "P4", + "title": "Инвентаризация с телефона", + "listUrl": "/api/catalog/stores", + "elements": [ + { + "key": "action:post", + "label": "действие: провести", + "type": "action" + } + ] + }, + { + "route": "/inventory/transfers", + "page": "TransfersPage", + "file": "pages/TransfersPage.tsx", + "priority": "P4", + "title": "Перемещения", + "listUrl": "/api/inventory/transfers", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/loyalty/cards", + "page": "LoyaltyCardsPage", + "file": "pages/LoyaltyCardsPage.tsx", + "priority": "P4", + "title": "Карты лояльности", + "listUrl": "/api/loyalty/cards", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:cardNumber", + "label": "сортировка: Номер", + "type": "sort" + } + ] + }, + { + "route": "/loyalty/programs", + "page": "LoyaltyProgramsPage", + "file": "pages/LoyaltyProgramsPage.tsx", + "priority": "P4", + "title": "Программы лояльности", + "listUrl": "/api/loyalty/programs", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:name", + "label": "сортировка: Название", + "type": "sort" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/money/accounts", + "page": "MoneyAccountsPage", + "file": "pages/money/MoneyAccountsPage.tsx", + "priority": "P4", + "title": "Счета и кассы", + "listUrl": "/api/money/accounts", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/money/expense-items", + "page": "ExpenseItemsPage", + "file": "pages/money/ExpenseItemsPage.tsx", + "priority": "P4", + "title": "Статьи расходов", + "listUrl": "/api/money/expense-items", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/promotions", + "page": "PromotionsPage", + "file": "pages/PromotionsPage.tsx", + "priority": "P4", + "title": "Акции и промокоды", + "listUrl": "/api/promotions", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/sales/demands", + "page": "DemandsPage", + "file": "pages/DemandsPage.tsx", + "priority": "P4", + "title": "Оптовые отгрузки", + "listUrl": "/api/sales/demands", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "sort:number", + "label": "сортировка: №", + "type": "sort" + }, + { + "key": "sort:date", + "label": "сортировка: Дата", + "type": "sort" + }, + { + "key": "sort:status", + "label": "сортировка: Статус", + "type": "sort" + }, + { + "key": "sort:customer", + "label": "сортировка: Контрагент", + "type": "sort" + }, + { + "key": "sort:total", + "label": "сортировка: Сумма", + "type": "sort" + }, + { + "key": "action:create", + "label": "действие: создать", + "type": "action" + } + ] + }, + { + "route": "/settings/employee-roles", + "page": "EmployeeRolesPage", + "file": "pages/EmployeeRolesPage.tsx", + "priority": "P4", + "title": "Роли сотрудников", + "listUrl": "/api/organization/employee-roles", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/settings/employees", + "page": "EmployeesPage", + "file": "pages/EmployeesPage.tsx", + "priority": "P4", + "title": "Сотрудники", + "listUrl": "/api/organization/employees", + "elements": [ + { + "key": "search", + "label": "поиск", + "type": "search" + }, + { + "key": "pagination", + "label": "пагинация", + "type": "pagination" + }, + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + }, + { + "key": "action:save", + "label": "действие: сохранить", + "type": "action" + } + ] + }, + { + "route": "/settings/organization", + "page": "OrganizationSettingsPage", + "file": "pages/OrganizationSettingsPage.tsx", + "priority": "P4", + "title": "Настройки организации", + "listUrl": "/api/organization/telegram/status", + "elements": [ + { + "key": "action:delete", + "label": "действие: удалить", + "type": "action" + } + ] + } + ] +} \ No newline at end of file diff --git a/tests/e2e/scenarios/stage-ui-uat-coverage.spec.ts b/tests/e2e/scenarios/stage-ui-uat-coverage.spec.ts new file mode 100644 index 0000000..2bb061a --- /dev/null +++ b/tests/e2e/scenarios/stage-ui-uat-coverage.spec.ts @@ -0,0 +1,193 @@ +/** + * Измеримое per-control покрытие: читает docs/uat-coverage.expected.json (экстракт из + * кода — все интерактивные элементы каждого экрана) и в РЕАЛЬНОМ браузере на стенде + * пытается «задействовать» каждый элемент (поиск/сортировка/пагинация/экспорт/фильтр/ + * тумблер/действие), записывая в reports/uat-covered.json, что реально покрыто. Цифры + * покрытия считает tools/build-coverage.ts → docs/uat-coverage.html. + * + * Семантику «параметр→правильные строки» независимо держит filters-sweep; здесь — + * что UI-элемент в браузере действительно управляет выдачей/запускает действие. + */ +import { test, expect, type Page } from '@playwright/test' +import { apiSignup, attachSession } from '../lib/ui.js' +import { request as apiRequest, type APIRequestContext } from '@playwright/test' +import { readFileSync, writeFileSync, mkdirSync } from 'node:fs' +import { resolve, dirname } from 'node:path' +import { fileURLToPath } from 'node:url' + +const HERE = dirname(fileURLToPath(import.meta.url)) +const EXPECTED = resolve(HERE, '../../../docs/uat-coverage.expected.json') +const OUT = resolve(HERE, '../reports/uat-covered.json') +const BASE = process.env.E2E_ADMIN_URL ?? 'https://test.admin.food-market.kz' + +type El = { key: string; label: string; type: string } +type Screen = { route: string; page: string; priority: string; title: string; listUrl: string; elements: El[] } + +test.describe('UAT coverage (измеримое)', () => { + test('задействовать каждый элемент каждого экрана', async ({ page }) => { + test.setTimeout(1_200_000) + const expected = JSON.parse(readFileSync(EXPECTED, 'utf8')) as { screens: Screen[] } + + const sess = await apiSignup('uatcov') + const ctx = await apiRequest.newContext({ + baseURL: BASE, ignoreHTTPSErrors: true, timeout: 60_000, + extraHTTPHeaders: { Authorization: `Bearer ${sess.accessToken}` }, + }) + await seed(ctx) + await ctx.dispose() + + const covered: Record> = {} + const mark = (route: string, key: string, ok: boolean, how: string) => { + ;(covered[route] ??= {})[key] = { covered: ok, how } + } + + // Ждём GET на list-URL (опц. с параметром) в ответ на действие. + const fires = async (action: () => Promise, listUrl: string, param?: string) => { + try { + const [resp] = await Promise.all([ + page.waitForResponse((r) => r.request().method() === 'GET' && r.url().includes(listUrl) + && (!param || r.url().includes(param)), { timeout: 12_000 }), + action(), + ]) + return resp.status() < 400 + } catch { return false } + } + const clickExport = async () => { + await page.getByRole('button', { name: /экспорт/i }).first().click() + await page.waitForTimeout(400) + const item = page.getByText(/^CSV|Excel|xlsx/i).first() + if (await item.count() > 0) await item.click() + } + const searchBox = () => page.locator('input[type="text"], input:not([type])').first() + + for (const s of expected.screens) { + // Навигация; пропускаем экраны, что требуют advanced-режим (в temp-орг простой). + let loaded = true + try { + await attachSession(page, sess, s.route) + await page.waitForTimeout(1200) + if (await page.getByRole('heading', { name: /Нет доступа|расширенн/i }).count() > 0) loaded = false + } catch { loaded = false } + + const list = s.listUrl || '/api/' + // Форсим таблицу: вводим поиск (многие экраны прячут DataTable до поиска). + const hasSearch = s.elements.some((e) => e.key === 'search') + if (loaded && hasSearch) { + try { await searchBox().fill('a'); await page.waitForTimeout(900) } catch { /* no search box */ } + } + + for (const el of s.elements) { + if (!loaded) { mark(s.route, el.key, false, 'экран недоступен (advanced/нет доступа)'); continue } + try { + if (el.key === 'search') { + mark(s.route, el.key, await fires(() => searchBox().fill('zz' + Date.now()), list, 'search='), 'поиск→search=') + } else if (el.type === 'sort') { + const sortKey = el.key.slice('sort:'.length) + const header = el.label.replace(/^сортировка:\s*/, '') + const btn = page.getByRole('button', { name: header }).first() + if (await btn.count() === 0) { mark(s.route, el.key, false, `нет заголовка «${header}»`); continue } + mark(s.route, el.key, await fires(() => btn.click(), list, `sort=${sortKey}`), `клик «${header}»→sort=${sortKey}`) + } else if (el.key === 'pagination') { + const pager = page.getByText(/из \d+/).first() + const present = await pager.count() > 0 + const next = page.getByRole('button', { name: '→' }).first() + let ok = present + if (present && await next.count() > 0 && await next.isEnabled().catch(() => false)) { + ok = await fires(() => next.click(), list, 'page=2') || present + } + mark(s.route, el.key, ok, present ? 'пагинация отрисована' : 'нет пагинации') + } else if (el.key === 'export') { + mark(s.route, el.key, await fires(clickExport, '/export', 'format='), 'экспорт→/export&format=') + } else if (el.type === 'filter') { + // Кастомный Select: открыть по тексту первого варианта из метки, выбрать 2-й пункт. + const cur = el.label.replace(/^фильтр:\s*/, '') + const ok = await fires(async () => { + const trigger = page.getByText(cur, { exact: true }).first() + if (await trigger.count() > 0) await trigger.click() + else await page.locator('select, [role="combobox"]').first().click() + await page.waitForTimeout(300) + const opt = page.getByRole('button').filter({ hasNotText: cur }) + // выбрать любой пункт выпадающего списка (li>button) + const li = page.locator('li button, [role="option"]') + if (await li.count() > 1) await li.nth(1).click() + else if (await li.count() === 1) await li.first().click() + else await page.keyboard.press('Enter') + }, list) + mark(s.route, el.key, ok, 'смена фильтра→новый запрос списка') + } else if (el.type === 'toggle') { + const lbl = el.label.replace(/^переключатель:\s*/, '') + const ok = await fires(() => page.getByText(new RegExp(lbl.slice(0, 10), 'i')).first().click(), list) + mark(s.route, el.key, ok, 'тумблер→новый запрос списка') + } else if (el.key === 'action:create') { + // Клик по созданию → переход на */new ИЛИ открытие модалки. + const before = page.url() + const btn = page.getByRole('button', { name: /Создать|Новый|Новая|Добавить|Пригласить/ }).first() + const link = page.getByRole('link', { name: /Создать|Новый|Новая|Добавить/ }).first() + if (await btn.count() > 0) await btn.click().catch(() => {}) + else if (await link.count() > 0) await link.click().catch(() => {}) + await page.waitForTimeout(900) + const navigated = page.url() !== before && /\/new|\//.test(page.url()) + const dialog = await page.locator('[role="dialog"], .modal').count() > 0 + || await page.getByText(/^(Новый|Новая|Создать)/).count() > 0 + mark(s.route, el.key, navigated || dialog, navigated ? 'переход на создание' : dialog ? 'открылась форма' : 'не открылось') + // вернёмся на список + if (page.url() !== before) await attachSession(page, sess, s.route).catch(() => {}) + await page.waitForTimeout(500) + } else { + // action:delete/save/post/unpost/print — покрываются спец-спеком controls; + // здесь отметим наличие кнопки (presence), полноценное действие — отдельно. + const names: Record = { + 'action:delete': /Удалить/, 'action:save': /Сохранить|Создать/, + 'action:post': /Провести|Проведено/, 'action:unpost': /Снять|Отменить проведение/, + 'action:print': /Печать|Z-отчёт|Печатать/, + } + const re = names[el.key] + const present = re ? (await page.getByRole('button', { name: re }).count() > 0 + || await page.getByText(re).count() > 0) : false + mark(s.route, el.key, present, present ? 'кнопка присутствует' : 'кнопка не найдена здесь') + } + } catch (e: any) { + mark(s.route, el.key, false, (e?.message ?? '').split('\n')[0].slice(0, 80)) + } + } + console.log(`${s.priority} ${s.route}: ${Object.values(covered[s.route] ?? {}).filter((x) => x.covered).length}/${s.elements.length}`) + } + + mkdirSync(dirname(OUT), { recursive: true }) + writeFileSync(OUT, JSON.stringify({ generatedAt: new Date().toISOString(), covered }, null, 2)) + console.log(`\n[coverage] → ${OUT}`) + }) +}) + +// Минимальный сид: 55 товаров (пагинация/сортировка), поставщик, приёмка (проведённая + +// черновик), оприходование/списание проведённые, розничный чек, платёж, смена. +async function seed(ctx: APIRequestContext) { + const first = async (url: string, pred?: (x: any) => boolean) => { + const j = await (await ctx.get(url)).json(); const items = Array.isArray(j) ? j : (j.items ?? []) + return (pred ? items.find(pred) : items[0]).id as string + } + const unitId = await first('/api/catalog/units-of-measure?pageSize=50') + const storeId = await first('/api/catalog/stores?pageSize=50') + const currencyId = await first('/api/catalog/currencies?pageSize=50', (c: any) => c.code === 'KZT') + const priceTypeId = await first('/api/catalog/price-types?pageSize=50') + const groupId = await first('/api/catalog/product-groups?pageSize=50') + const supplier = (await (await ctx.post('/api/catalog/counterparties', { + data: { name: `Поставщик COV ${Date.now()}`, kind: 1, isSupplier: true, isCustomer: false }, + })).json()).id + const mk = async (name: string, article: string, price: number) => (await (await ctx.post('/api/catalog/products', { + data: { name, article, unitOfMeasureId: unitId, vat: 12, vatEnabled: true, productGroupId: groupId, + isService: false, packaging: 0, isMarked: false, referencePrice: price * 0.7, purchaseCurrencyId: currencyId, + prices: [{ priceTypeId, amount: price, currencyId }], barcodes: [] }, + })).json()).id + const p = await mk('COVTOVAR поиск', 'COV999', 1234) + for (let i = 0; i < 54; i++) await mk(`COV товар ${String(i).padStart(2, '0')}`, `C${1000 + i}`, 100 + i) + // приёмка (проведённая) + черновик + const sup = await (await ctx.post('/api/purchases/supplies', { data: { date: new Date().toISOString(), supplierId: supplier, storeId, currencyId, lines: [{ productId: p, quantity: 20, unitPrice: 800 }] } })).json() + await ctx.post(`/api/purchases/supplies/${sup.id}/post`) + await ctx.post('/api/purchases/supplies', { data: { date: new Date().toISOString(), supplierId: supplier, storeId, currencyId, lines: [{ productId: p, quantity: 3, unitPrice: 810 }] } }) + // оприходование и списание (проведённые) — чтобы таблицы были не пустые + const ent = await (await ctx.post('/api/inventory/enters', { data: { date: new Date().toISOString(), storeId, currencyId, lines: [{ productId: p, quantity: 5, unitCost: 50 }] } })).json() + if (ent?.id) await ctx.post(`/api/inventory/enters/${ent.id}/post`) + const loss = await (await ctx.post('/api/inventory/losses', { data: { date: new Date().toISOString(), storeId, currencyId, reason: 0, lines: [{ productId: p, quantity: 1, unitCost: 50 }] } })).json() + if (loss?.id) await ctx.post(`/api/inventory/losses/${loss.id}/post`) +} diff --git a/tests/e2e/tools/build-coverage.ts b/tests/e2e/tools/build-coverage.ts new file mode 100644 index 0000000..0cf6d97 --- /dev/null +++ b/tests/e2e/tools/build-coverage.ts @@ -0,0 +1,87 @@ +/** + * Сводит экстракт элементов (docs/uat-coverage.expected.json) и результат браузерного + * прогона (reports/uat-covered.json) → docs/uat-coverage.json + docs/uat-coverage.html + * с процентами покрытия по экрану, по приоритету и общим. Цель: P1–P3 ≥95%, P4 ≥70%. + */ +import { readFileSync, writeFileSync, existsSync } from 'node:fs' +import { resolve, dirname } from 'node:path' +import { fileURLToPath } from 'node:url' + +const HERE = dirname(fileURLToPath(import.meta.url)) +const EXP = resolve(HERE, '../../../docs/uat-coverage.expected.json') +const COV = resolve(HERE, '../reports/uat-covered.json') +const OUTJSON = resolve(HERE, '../../../docs/uat-coverage.json') +const OUTHTML = resolve(HERE, '../../../docs/uat-coverage.html') + +const exp = JSON.parse(readFileSync(EXP, 'utf8')) +const cov = existsSync(COV) ? JSON.parse(readFileSync(COV, 'utf8')).covered : {} + +const rows: any[] = [] +const byPrio: Record = {} +let total = 0, done = 0 +for (const s of exp.screens) { + const c = cov[s.route] ?? {} + const els = s.elements.map((e: any) => { + const hit = c[e.key]?.covered === true + if (hit) done++ + total++ + ;(byPrio[s.priority] ??= { total: 0, done: 0 }).total++ + if (hit) byPrio[s.priority].done++ + return { ...e, covered: hit, how: c[e.key]?.how ?? '' } + }) + const scDone = els.filter((e: any) => e.covered).length + rows.push({ ...s, elements: els, pct: s.elements.length ? Math.round((scDone / s.elements.length) * 100) : 100, done: scDone }) +} +const pct = (d: number, t: number) => (t ? Math.round((d / t) * 100) : 100) +const summary = { + overall: pct(done, total), total, done, + byPriority: Object.fromEntries(Object.entries(byPrio).map(([k, v]) => [k, { pct: pct(v.done, v.total), ...v }])), + targets: { P1: 95, P2: 95, P3: 95, P4: 70 }, +} +writeFileSync(OUTJSON, JSON.stringify({ generatedAt: new Date().toISOString(), summary, screens: rows }, null, 2)) + +const p13 = ['P1', 'P2', 'P3'].reduce((a, k) => ({ total: a.total + (byPrio[k]?.total ?? 0), done: a.done + (byPrio[k]?.done ?? 0) }), { total: 0, done: 0 }) +const badge = (p: number, target: number) => `${p}%` +const html = `UAT coverage — ALL MARKET + +

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

+
Сгенерировано ${new Date().toISOString()} · элементы извлечены из кода (web/src/pages), покрытие — браузерный прогон на стенде.
+
+
Всего элементов
${total}
+
Покрыто
${done}
+
Общее
${summary.overall}%
+
P1–P3 (цель 95%)
${badge(pct(p13.done, p13.total), 95)}
${p13.done}/${p13.total}
+
P4 (цель 70%)
${badge(summary.byPriority.P4?.pct ?? 0, 70)}
${summary.byPriority.P4?.done ?? 0}/${summary.byPriority.P4?.total ?? 0}
+
+ + + +${rows.map((s) => ` + + + + + +`).join('\n')} + +
Пр.Экран%Элементы (зелёные покрыты)
${s.priority}${s.title}
${s.route}		${badge(s.pct, s.priority === 'P4' ? 70 : 95)}
${s.done}/${s.elements.length}
${s.elements.map((e: any) => `${e.covered ? '✓' : '✗'} ${e.key}`).join(' ')}
` +writeFileSync(OUTHTML, html) + +console.log(`[coverage] overall ${summary.overall}% (${done}/${total})`) +for (const [k, v] of Object.entries(summary.byPriority)) console.log(` ${k}: ${(v as any).pct}% (${(v as any).done}/${(v as any).total})`) +console.log(` P1-P3: ${pct(p13.done, p13.total)}% (${p13.done}/${p13.total}) · цель 95`) +console.log(`→ ${OUTHTML}`) diff --git a/tests/e2e/tools/extract-controls.ts b/tests/e2e/tools/extract-controls.ts new file mode 100644 index 0000000..550930f --- /dev/null +++ b/tests/e2e/tools/extract-controls.ts @@ -0,0 +1,158 @@ +/** + * Статический экстрактор интерактивных элементов web-страниц → denominator для + * измеримого UAT-покрытия. Читает web/src/App.tsx (route → компонент → файл) и + * каждый pages/*.tsx, достаёт: поиск, фильтры (Select/даты/тумблеры), сортируемые + * колонки, пагинацию, экспорт, кнопки действий. Пишет docs/uat-coverage.expected.json. + * + * Запуск: pnpm exec tsx tools/extract-controls.ts (из tests/e2e) + */ +import { readFileSync, writeFileSync, existsSync, readdirSync, statSync } from 'node:fs' +import { resolve, dirname, join } from 'node:path' +import { fileURLToPath } from 'node:url' + +const HERE = dirname(fileURLToPath(import.meta.url)) +const WEB = resolve(HERE, '../../../src/food-market.web/src') +const APP = resolve(WEB, 'App.tsx') +const PAGES = resolve(WEB, 'pages') +const OUT = resolve(HERE, '../../../docs/uat-coverage.expected.json') + +// Рекурсивно: имя компонента (без .tsx) → путь файла (pages и подпапки, напр. money/). +function buildFileMap(dir: string, map: Record = {}): Record { + for (const name of readdirSync(dir)) { + const p = join(dir, name) + if (statSync(p).isDirectory()) buildFileMap(p, map) + else if (name.endsWith('.tsx')) map[name.replace(/\.tsx$/, '')] = p + } + return map +} +const FILES = buildFileMap(PAGES) + +type El = { key: string; label: string; type: string } +type Screen = { route: string; page: string; file: string; priority: string; title: string; listUrl: string; elements: El[] } + +// Приоритеты по категоризации владельца (UAT P1–P4). +const PRIORITY: Record = { + '/catalog/products': 'P1', '/inventory/stock': 'P1', '/sales/retail': 'P1', + '/purchases/supplies': 'P2', '/money/shifts': 'P2', + '/inventory/enters': 'P3', '/inventory/losses': 'P3', '/inventory/inventories': 'P3', + '/inventory/movements': 'P3', '/purchases/supplier-returns': 'P3', '/purchases/invoices': 'P3', + '/money/transactions': 'P3', '/money/supplier-debts': 'P3', '/money/report': 'P3', + '/reports/sales': 'P3', '/reports/stock': 'P3', '/reports/profit': 'P3', + '/catalog/counterparties': 'P3', '/catalog/data-quality': 'P3', + '/settings/employees': 'P4', '/settings/employee-roles': 'P4', '/catalog/stores': 'P4', + '/catalog/retail-points': 'P4', '/money/accounts': 'P4', '/settings/organization': 'P4', + '/money/expense-items': 'P4', +} + +// Карта: route (список) → компонент. Парсим App.tsx. element={...} может содержать +// вложенные {} (RoleGuard roles={[…]}, AdvancedModeGuard) — балансируем скобки. +function routeComponentMap(): Record { + const src = readFileSync(APP, 'utf8') + const map: Record = {} + const re = / 0) { const ch = src[i]; if (ch === '{') depth++; else if (ch === '}') depth--; i++ } + const element = src.slice(re.lastIndex, i - 1) + // Только app-списки: абсолютный путь, без параметров/new, не super-admin/онбординг. + if (!path.startsWith('/') || path.includes(':') || path.endsWith('/new') || path === '*') continue + if (path.startsWith('/super-admin') || path === '/' || path.startsWith('/onboarding') || path === '/help' || path === '/whats-new') continue + if (['/login', '/forgot-password', '/reset-password', '/auth-bridge', '/no-organization'].includes(path)) continue + const comp = [...element.matchAll(/([A-Z][A-Za-z0-9]+Page)\b/g)].map((x) => x[1]) + .find((c) => !/Guard|Layout|Protected/.test(c)) + if (comp) map[path] = comp + } + return map +} + +function slug(s: string): string { + return s.toLowerCase().replace(/[^a-zа-я0-9]+/gi, '-').replace(/^-+|-+$/g, '').slice(0, 24) +} + +function extract(route: string, comp: string): Screen | null { + const file = FILES[comp] + if (!file || !existsSync(file)) return null + const src = readFileSync(file, 'utf8') + const els: El[] = [] + const add = (key: string, label: string, type: string) => { + if (!els.some((e) => e.key === key)) els.push({ key, label, type }) + } + + if (/]*?url=["']([^"']+)["']/g)) + add('export', `экспорт (${m[1]})`, 'export') + if (!els.some((e) => e.key === 'export') && //