Suíte de testes automatizados End-to-End (E2E) para a aplicação de gerenciamento de tarefas Mark Tasks (Frontend Web + API REST Express/TypeORM/SQLite), construída com Playwright e TypeScript.
O projeto combina Page Object Model (POM), preparação híbrida de massa via API (APIRequestContext), matriz multi-browser desktop/mobile (30 execuções por suíte), especificações BDD em Gherkin, contrato OpenAPI 3.0, coleção Postman e execução contínua via GitHub Actions.
| Artefato | Objetivo | Caminho |
|---|---|---|
| Plano de Testes | Escopo, decisão híbrida API+UI, controle de concorrência SQLite e rastreabilidade | docs/qa/TEST_PLAN.md |
| Casos de Teste | Inventário dos 6 fluxos E2E (30 execuções cross-browser) + 7 contratos de API |
docs/qa/TEST_CASES.md |
| Cenários BDD (Gherkin) | Critérios de aceite em sintaxe Given / When / Then |
specs/features/tasks.feature |
| Relatório de Bug | Evidência de payload desatualizado retornado pelo PUT /tasks/:id |
BUG-001 |
| OpenAPI / Swagger | Especificação 3.0.3 dos endpoints /tasks e /helper/tasks |
docs/swagger/openapi.yaml |
| Postman Collection | Coleção v2.1 com asserções pm.test e captura automática de taskId |
docs/postman/MarkTasks.postman_collection.json |
- Page Object Model (
TasksPage): Elementos, localizadores CSS/XPath e asserções de tela encapsulados emtests/support/pages/tasks/index.ts. - Setup Híbrido via API (
APIRequestContext): Os helpersdeleteTaskByHelperepostTaskpreparam e limpam o estado do SQLite diretamente via HTTP (/helper/tasks/:task_nameePOST /tasks) antes da interação na interface, mantendo os testes independentes e rápidos. - Dados Tipados: Massa isolada em
tests/fixtures/tasks.jsoncom contratoTaskModel. - Cobertura Cross-Browser & Responsiva: Configurada em
playwright.config.tsparachromium,firefox,webkit,Mobile Chrome(Pixel 5) eMobile Safari(iPhone 12). - Isolamento em CI: Como os 5 projetos compartilham o mesmo arquivo
database.sqlitee massa fixa,workers: 1emCI=trueevita condições de corrida de escrita.
.
├── .github/workflows/
│ └── ci.yml # Pipeline CI: SQLite init + API + Web + Playwright (5 projetos)
├── app/
│ ├── api/ # Backend Node.js (Express + TypeORM + SQLite) - porta 3333
│ └── web/ # Frontend Web estático - porta 8080
├── docs/
│ ├── postman/ # Collection v2.1 e Environment local do Postman
│ ├── qa/
│ │ ├── bug-reports/ # Exemplo real de bug report identificado na API
│ │ ├── TEST_CASES.md # Matriz de casos UI e API
│ │ └── TEST_PLAN.md # Plano de testes e decisões arquiteturais
│ └── swagger/
│ └── openapi.yaml # Contrato OpenAPI 3.0.3
├── specs/features/
│ └── tasks.feature # Especificação BDD em Gherkin
├── tests/
│ ├── fixtures/
│ │ ├── task.model.ts # Tipagem TypeScript da entidade Task
│ │ └── tasks.json # Massa de dados dos cenários
│ ├── support/
│ │ ├── helpers.ts # Helpers HTTP (APIRequestContext)
│ │ └── pages/tasks/index.ts # Page Object TasksPage
│ ├── home.spec.ts # Disponibilidade da aplicação web
│ └── tasks.spec.ts # Cadastro, duplicidade, validação HTML5, toggle e exclusão
├── .env.example # Template de variáveis de ambiente
├── Insomnia_markL.json # Workspace original do Insomnia
├── playwright.config.ts # Configuração dos 5 projetos, trace e screenshot on-failure
└── package.json
- Node.js
>= 22.x(better-sqlite3@13requer Node 22+) - Navegadores do Playwright (
npx playwright install)
cp .env.example .env
npm ci
npx playwright installnpm --prefix app/api ci
npm --prefix app/api run db:init
NODE_ENV=development npm --prefix app/api start
NODE_ENV=developmenthabilita as rotas/helper/tasksusadas para limpeza determinística de massa antes dos testes. Em caso de incompatibilidade de binário nativo dobetter-sqlite3em versões mais novas do Node.js, executenpm --prefix app/api install better-sqlite3@latest.
Em um segundo terminal:
npm --prefix app/web install
npm --prefix app/web startEm um terceiro terminal:
# Todos os testes em modo headless (30 execuções nos 5 projetos)
npm test
# Modo interativo (UI Mode)
npm run test:ui
# Navegador visível (Headed Mode)
npm run test:headed
# Abrir relatório HTML
npm run test:reportO workflow ci.yml é disparado em push e pull_request para main:
- Instala dependências da raiz,
app/apieapp/web, além dos binárioschromium,firefoxewebkit. - Inicializa o banco SQLite (
db:init), inicia o backend (NODE_ENV=development) e o servidor web (http-server). - Valida a integridade JSON dos arquivos Postman e executa os
30testes E2E sequencialmente. - Salva o diretório
playwright-report/como artefato por 14 dias.
Luis Fernando Brandão
QA Automation Engineer