qa-playwright-add-new-flow

name	qa-playwright-add-new-flow
description	Add a new test flow to the QA Playwright project: create tests and test-data folders for the flow, add inputs and optional builder, write specs from fixtures. Use when the user asks to add a flow, new flow, or test suite for a feature.

Add new flow

When adding a new test flow to the QA Playwright project, follow this checklist.

Checklist

1. Create flow folders in tests: tests/api/<fluxo>/ and/or tests/ui/<fluxo>/. Create at least one .spec.ts file in each folder you add.
2. Create flow folders in test-data (if there are inputs): test-data/api/<fluxo>/ and/or test-data/ui/<fluxo>/.
3. Define static inputs: Create inputs.json (or inputs.ts) with the cases needed; optionally add builder.ts that uses lib/data-factory.ts for varying data.
4. Write specs: Import test and expect from ../../../fixtures; use Arrange-Act-Assert; for data, import from test-data or use the builder.
5. baseURL: If the flow uses another domain, configure it in playwright.config.ts or via env (see docs/08-ambiente-e-configuração.md).

Naming

• Flow folder: short, clear name (e.g. login, pedido, relatorio).
• Spec files: *.spec.ts; name can describe the scenario (e.g. login.spec.ts, footer.spec.ts).

Run only this flow

npx playwright test tests/api/<fluxo>/
npx playwright test tests/ui/<fluxo>/

Full reference

docs/07-como-adicionar-novo-fluxo.md