tfs-test-runner¶

Converte exports xlsx de test cases do Azure DevOps / TFS em um kit HTML auto-contido com captura de screenshots, controle de status, anotações e exportação de evidências em PDF. Sem servidor, funciona offline, zero configuração. Tradução opcional via GPT pra qualquer idioma.

O que faz¶

graph LR
    A[xlsx export<br/>do ADO/TFS] --> B[parse]
    B --> C[traduzir<br/>passthrough ou LLM]
    C --> D[agrupar por fases<br/>YAML ou default]
    D --> E[render]
    E --> F[plano.html<br/>single-file]
    F --> G[Tester:<br/>cola screenshots,<br/>marca PASS/FAIL,<br/>adiciona notas]
    G --> H[PDF por caso<br/>ou plano completo]

Cada estágio é função pura sobre dicts. JSON intermediário dumpável via --dump-json.

Por quê¶

Se seu time usa Azure DevOps Test Plans ou TFS (ex. *.tfs.<empresa>.net), você já consegue exportar test cases pra xlsx. Mas executar manualmente e juntar evidências — screenshots por step, status, notas, empacotar como PDF entregável — é tedioso e propenso a erro.

tfs-test-runner pega esse xlsx e gera um arquivo HTML único pra abrir em qualquer navegador. Os testers colam screenshots step-a-step (Ctrl+V), marcam PASS / FAIL / N/A, escrevem notas, depois clicam um botão pra imprimir um PDF de evidência limpo.

State persiste em localStorage (texto/status) e IndexedDB (imagens). Backup/restore como JSON. Sem servidor, sem auth.

Comece aqui¶

Início rápido

Instale em 30 segundos, gere seu primeiro kit HTML do sample sintético.

Início rápido
Uso

Walkthrough end-to-end pro tester rodando planos reais.

Guia de uso
Configuração

Agrupamento YAML, glossários, logo customizado, modelos LLM.

Configuração
Arquitetura

Pipeline, formatos, decisões de design e trade-offs.

Arquitetura

Screenshots¶

Visão geral + filtros	Caso com evidências

Mais screenshots

Filtro "Com falha"	PDF de evidências (default)

PDF com selos de status (toggle LIGADO)	Mobile / viewport estreito

Estado vazio	Plano completo (screenshot longa)
	03-full-plan.png

Não tem xlsx ainda?¶

Duas opções:

Sample sintético embutido — python examples/generate_sample.py cria plano fake pra brincar.
Template em branco — baixa blank-template.xlsx e preenche manualmente. Mesmo schema do export Azure DevOps.

Baixar template em branco Ver no GitHub