03 · Arquitetura e engenharia

Professional Playwright Framework

O terceiro nível da trilha. O foco deixa de ser apenas escrever e organizar testes e passa a ser projetar uma solução de automação sustentável.

NívelAvançado
StackPlaywright + TypeScript
ValidaçãoAPI + E2E + Smoke
Visão arquitetural

Projetar um framework é decidir onde cada responsabilidade pertence.

O projeto separa testes, Page Objects, Services, API Client, fixtures, test data, configuração e autenticação. A arquitetura existe para controlar acoplamento e manutenção.

tests
  ├── api/       → comportamento da API
  ├── e2e/       → comportamento pela UI
  └── setup/     → preparação do estado

pages/            → interação com a UI
services/         → operações de domínio/API
fixtures/         → composição de dependências
data/             → dados de teste
auth/             → preparação do estado autenticado
config/           → ambiente e execução
utils/            → tipos e assertions
Decisões de engenharia

O que o projeto deliberadamente faz — e não faz.

DecisãoMotivo
API separada de E2EUsar a camada adequada para cada tipo de validação.
storageState apenas em testes autenticadosEvitar que cenários públicos comecem implicitamente autenticados.
CreateUserRequest como contratoReduzir divergência entre dados, services e Page Objects.
Fixtures com responsabilidade específicaCompor dependências sem transformar toda reutilização em fixture.
Sem abstrações artificiaisUma arquitetura maior não é automaticamente uma arquitetura melhor.

API

23 testes de API validados na versão atual.

E2E + Smoke

6 testes validados na versão atual usando Chromium.