publico/.agent
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(testes): padronizar uso de --session <modulo>_<contexto?> no agent-browser para isolamento de tokens

Browse source
This commit is contained in:
Luiz Silva 2026-10-08 14:47:46 -03:00
parent 29e5bc979e
commit 1a8adfc2dc
23 changed files with 320 additions and 206 deletions
Download patch file Download diff file Expand all files Collapse all files

16
DOCUMENTACAO/templates/modulo.yml.template
View file

@ -2,7 +2,7 @@
# Este arquivo é obrigatório na raiz de todos os projetos que utilizam .agent.
# Ele define a identidade oficial e as configurações de rota do módulo.
# Identificador único do módulo (utilizado para pacotes, wikis <modulo-wiki>/<modulo-id>/, regras de negócio e sessão isolada do agent-browser --session <modulo-id>)
# Identificador único do módulo (utilizado para pacotes, wikis <modulo-wiki>/<modulo-id>/, regras de negócio e sessão isolada do agent-browser --session <modulo-id>_<contexto?>)
modulo-id: nome-do-modulo.submodulo
# Rota/prefixo utilizado na URL e navegação do módulo (com barras inicial e final)
@ -15,9 +15,23 @@ modulo-descricao: Descrição detalhada do módulo para contextualização opera
modulo-tipo: aplicação web com back e front nas tecnologias bun e vue 3 com banco postgres
# Credenciais padrão para autenticação em testes (agent-browser, E2E, QA)
# Suporta formato direto (contexto padrão/único) ou subdividido por contexto de acesso:
modulo-acesso:
# Formato direto (quando contexto único ou padrão):
usuario: usuario@exemplo.com.br
senha: "123"
# OU agrupado por contextos específicos (descomente e adeque conforme os perfis da aplicação):
# interno:
# usuario: admin@gov.br
# senha: "123"
# externo:
# usuario: cidadao@empresa.com.br
# senha: "123"
# cliente:
# usuario: cliente@empresa.com.br
# senha: "123"
# Nota: o perfil 'anonimo' atua sempre sem login na sessão limpa <modulo>_anonimo
# Caminho para a Wiki do projeto (quando omitido ou vazio, o padrão adotado é ../wiki/)
modulo-wiki: ../wiki

14
DOCUMENTACAO/templates/plano.md.template
View file

@ -90,12 +90,14 @@ executor: null
- Qualidade/Lint: `biome check --write <arquivos>`
- Governança: `sh .agent/verificar-linhas.sh`
### 5.2 Roteiro de Teste Manual / `agent-browser` (Sempre em Modo Visível `--headed` e com `--session <modulo-id>`)
1. Abrir aplicação: `agent-browser --session <modulo-id> open --headed <url>`
2. Mapear interações: `agent-browser --session <modulo-id> snapshot -i`
3. Executar ações: `agent-browser --session <modulo-id> fill @ref "..." && agent-browser --session <modulo-id> click @ref`
4. Capturar evidência: `agent-browser --session <modulo-id> screenshot evidencias/<slug>.png`
5. Encerrar: `agent-browser --session <modulo-id> close`
### 5.2 Roteiro de Teste Manual / `agent-browser` (Sempre em Modo Visível `--headed` e com `--session <modulo-id>_<contexto?>`)
> 💡 **Nota de Contexto:** Caso a aplicação possua múltiplos acessos (interno, externo, anonimo, cliente), utilize obrigatoriamente o sufixo correspondente (ex: `<modulo-id>_interno`, `<modulo-id>_externo`, `<modulo-id>_anonimo`, `<modulo-id>_cliente`) para prevenir mistura de cookies e tokens de autenticação.
1. Abrir aplicação: `agent-browser --session <modulo-id>_<contexto> open --headed <url>`
2. Mapear interações: `agent-browser --session <modulo-id>_<contexto> snapshot -i`
3. Executar ações: `agent-browser --session <modulo-id>_<contexto> fill @ref "..." && agent-browser --session <modulo-id>_<contexto> click @ref`
4. Capturar evidência: `agent-browser --session <modulo-id>_<contexto> screenshot evidencias/<slug>.png`
5. Encerrar: `agent-browser --session <modulo-id>_<contexto> close`
---