Arquitetura e Capacidades

Visão da solução

EverShop + PostgreSQL
        ↓
Playwright (Web, API e segurança) + k6 (performance)
        ↓
GitHub Actions (barreiras antes e depois do merge)
        ↓
HTML técnico + attachments + métricas + PDF executivo

Componentes e responsabilidades

Componente	Responsabilidade	Fonte técnica
Ambiente de referência	Disponibilizar EverShop 2.2.1 e dados reproduzíveis	SUT
Automação Playwright	Validar Web, API, integração e autorização em Chromium	quality
Performance k6	Observar disponibilidade, comportamento e tempo de resposta	performance
GitHub Actions	Executar barreiras e publicar evidências	workflows
Experimentos	Inserir regressões locais, temporárias e reversíveis	experiments
IA assistiva	Analisar impacto sem decidir ou alterar o produto	documentação de IA

Escolhas de simplicidade

• Chromium único enquanto não houver risco concreto de compatibilidade entre navegadores;
• recursos nativos do Playwright para relatório, trace e screenshot;
• k6 em perfis pequenos, sem plataforma externa de observabilidade;
• Docker Compose para reproduzir o ambiente local e de CI;
• GitHub Actions e controles nativos do GitHub para decisão e segurança do repositório.

As justificativas e alternativas estão nas Decisões de Arquitetura.

Próximo passo: Controles e Evidências.