e2e

Imported from mavkasgit/ktm2000 (frontend/e2e/AGENTS.md). Install upstream with npx skills add mavkasgit/ktm2000 --skill e2e. Copyright stays with the author.

E2E Tests (Playwright)

Каноническое руководство по E2E в KTM-2000. Каталог: frontend/e2e/.

Слои тестов

npm --prefix frontend run test:e2e:ui      # канон — только @ui
npm --prefix frontend run test:e2e:smoke   # smoke — API-assisted
npm --prefix frontend run test:e2e         # оба проекта

@ui (канон)

• Спеки: full-cycle.spec.ts (канонический полный цикл ЮП-009), route-workflow.spec.ts, sawing-four-lengths-cycle.spec.ts (пила в полном цикле: раскрой 2,75 м на четыре длины), single-line-cycle.spec.ts (одна строка плана: сквозной маршрут передачи ↔ участки до «Отправлено»), sawing-multi-length-split.spec.ts (распил задачи на разные длины), yup460-shared-raw-pile.spec.ts (три варианта ЮП-460 делят одну кучу сырья)
• Хелперы: ui-helpers.ts — seed через /settings/dev, approve, take-to-work, чтение журнала передач; api-helpers.ts — бесфайловый сетап.
• Сетап данных — обычно через API (api-helpers.ts): артикул (apiEnsureCatalogProduct), остаток (apiAddRemainder), план (apiSimulatePlanImport → POST /api/imports/excel/simulate, без xlsx). В кадре — бизнес-действия UI (approve, запуск, передачи, завершение задач).
• Запрещено в бизнес-шагах: прямые fetch к бизнес-API (approve, take-to-work, передачи).
• Живые xlsx-импорты — только в full-cycle.spec.ts (каталог + остатки) и route-workflow.spec.ts (план); остальные сетапятся бесфайлово (см. «xlsx-фикстуры»).

xlsx-фикстуры

По одному основному варианту на вид импорта, всё в testdata/:

Остальные сценарии эти виды данных не хранят: план — apiSimulatePlanImport (строки в теле запроса, workbook собирается на бэкенде в памяти и идёт обычным change-set); каталог/остатки — прямые вызовы API (apiEnsureCatalogProduct, apiAddRemainder). Отдельные e2e-xlsx под ЮП-2083/ЮП-4610 удалены — не плодим файлы.

Файлы в testdata/ остаются локальными (*.xlsx в .gitignore) — как и прежние фикстуры.

@smoke

• Спеки: transfers-auto-accept, final-release, catalog-dimensions, dimensions-sawing, reversal-journal
• Хелперы: api-helpers.ts — ускоренный setup через API
• Основные проверки — через UI; setup может идти через API

@tmp (временные, разовые)

• Инструмент отладки/разовой проверки, а не часть набора: файл называется *.tmp.spec.ts, тег @tmp, в шапке — что и зачем проверяем и с чем удалять.
• Проекта tmp нет, пока не задан E2E_TMP → test:e2e, test:e2e:ui, test:e2e:smoke такие спеки не трогают.
• Запуск разово:

  cd frontend && E2E_TMP=1 npx playwright test --project=tmp e2e/<file>.tmp.spec.ts

• Задача закрыта → спека и её фикстуры удаляются (одноразовый артефакт).

Guard изоляции от прод-хостов

playwright.config.ts при старте отклоняет прогон, если PLAYWRIGHT_TEST_BASE_URL или E2E_API_URL указывают на публичный (боевой) хост: проверка isPrivateHost (src/shared/lib/hostGuard.ts) разрешает только localhost/127.x/10.x/172.16-31.x/192.168.x/*.local. Любой приватный адрес/порт — свободно; прод-сервер в E2E исключён.

Шлюз перед боевым стартом

Перед первым деплоем на боевой сервер прогнать на dev зелёными: npm --prefix frontend run test:e2e:ui (полный цикл ЮП-009) и npm --prefix frontend run test:e2e:smoke e2e/transfers-auto-accept.spec.ts (передача: Send → auto-accept → in_progress). Это минимально достаточный уровень уверенности для флоу, который операторы используют ежедневно.

Предусловия

E2E ходят в уже запущенное dev-окружение (webServer в playwright.config.ts закомментирован):

# из корня проекта
npm run dev

Отдельный терминал:

npm --prefix frontend run test:e2e:ui
npm --prefix frontend run test:e2e:smoke
npm --prefix frontend run test:e2e:playwright-ui   # Playwright UI mode (отладка)
npm --prefix frontend run test:e2e:report

Переменные окружения

set E2E_API_URL=http://localhost:8012/api
set PLAYWRIGHT_TEST_BASE_URL=http://localhost:5172

Конфигурация

playwright.config.ts:

• testDir: ./e2e
• workers: 1, fullyParallel: false
• Проекты: ui-e2e (grep: /@ui/), smoke (grep: /@smoke/)
• retries: 2 в CI

Фикстуры

fixtures.ts:

• authenticatedPage, loginAsAdmin
• seedTestData — legacy; в @ui используйте seedReferenceDataViaUI

Существующие спеки

Отладка

npx playwright test --project=ui-e2e -g "import wizard" --debug
npx playwright test --project=smoke e2e/reversal-journal.spec.ts --headed

Отчёт: frontend/playwright-report/ после прогона с failures.