| name | test |
| description | Gera e orienta execução de testes para widgets TOTVS Fluig. Unit tests com Jasmine + Karma e E2E com Playwright. Sempre questiona a URL do servidor antes de gerar configurações E2E. O E2E requer build + deploy antes de executar. |
Você vai ajudar a criar e executar testes para widgets Fluig.
Existem dois tipos de teste:
- Unit (Jasmine + Karma): testa componentes, services e pipes isoladamente, sem servidor
- E2E (Playwright): testa o widget publicado no servidor Fluig real
HARD GATE — Antes de qualquer E2E
Antes de gerar qualquer configuração E2E ou executar testes E2E, você DEVE:
- Perguntar ao usuário a URL do servidor Fluig (ex:
https://fluig.empresa.com.br)
- Confirmar que o widget já foi publicado ou executar o fluxo de build + deploy agora
- Nunca usar
localhost como base URL — widgets Fluig só rodam no servidor Fluig
Use AskUserQuestion para coletar:
- URL do servidor Fluig
- Usuário e senha (ou confirmar que
FLUIG_USER/FLUIG_PASSWORD estão definidos)
- Página Fluig onde o widget está publicado (ex:
/portal/p/home)
Busca de Testes Existentes (Context Enrichment)
Após confirmar o widget/módulo, consulte testes similares antes de gerar:
listTests({ platform: "fluig", module: "<widget/módulo>", limit: 5 })
- Se retornar resultados: mostre os cenários existentes e pergunte se quer algo diferente ou complementar
- Se retornar vazio: prossiga normalmente
- Use os exemplos para manter consistência de page objects e seletores
Unit Tests — Jasmine + Karma
Estrutura esperada, configuração karma.conf.js com cobertura Istanbul, templates spec para componentes, serviços e execução.
Consulte a referência completa via MCP:
searchKnowledge({ skill: "fluig-test", keyword: "unit tests" })
Configuração de cobertura (obrigatória)
Se o projeto não tem karma.conf.js com coverageReporter.check, copie o template do
plugin — cobertura vira gate mecânico (npm test falha sozinho abaixo de 70%):
cp <plugin>/skills/test/assets/karma.conf.template.js ./karma.conf.js
npm test -- --watch=false --browsers=ChromeHeadless --code-coverage
E2E Tests — Playwright
Playwright é a engine oficial de E2E do plugin — visão computacional real da tela
(screenshots + snapshots), não automação cega de seletores.
HARD GATE: build + deploy obrigatório antes dos testes.
Restrições Fluig obrigatórias:
BASE_URL = URL do servidor Fluig real (ex: https://fluig.empresa.com.br) — nunca localhost- Confirmar que o widget está publicado antes de rodar qualquer teste E2E
- Credenciais via
FLUIG_USER / FLUIG_PASSWORD no .env.test — nunca hardcoded
- A página de teste deve ser a página Fluig onde o widget está publicado (ex:
/portal/p/home)
Para setup completo, playwright.config.ts, CLI commands, autenticação via storageState e templates, use o plugin playwright:
/playwright:playwright-cli
Regras Obrigatórias
coverage/ nunca commitado- Usuário e senha via variáveis de ambiente, nunca hardcoded
- Todos os specs devem cobrir casos de erro
- E2E requer deploy prévio
Consulta de Conhecimento
Se precisar de informação não disponível no MCP, consulte o RAG:
searchKnowledge({ keyword: "<termo relevante>" })
Gravar Teste no MCP (após validação)
Após confirmação que o teste E2E passou no servidor Fluig real:
"Teste validado. Quer salvar na base de conhecimento para outros devs reutilizarem?"
Apresente o rascunho para revisão antes de persistir:
platform: fluig
module: <nome do widget/módulo>
title: <título descritivo>
scenario: <o que o teste valida>
script: <código Playwright completo>
tags: <CSV, ex: "widget,formulario,aprovacao">
Somente após confirmação explícita do dev, chame:
saveTest({
platform: "fluig",
module: "<módulo>",
title: "<título>",
scenario: "<cenário>",
script: "<script>",
tags: "<tags>",
submitted_by: "<email via FLUIG_USER ou ~/.config/tbc/dev-config.json>"
})
Resposta de sucesso: "✅ Teste #<id> salvo na base de conhecimento."
Em caso de erro: preserve o rascunho para o dev salvar manualmente.
