Critérios de aceitação: dados quando os testadores de exemplos podem realmente executar
Os critérios de aceitação são as condições que uma história de usuário deve atender antes que alguém a conclua. Aprenda os dois formatos comuns, como escrever critérios específicos e testáveis e como um exemplo de código de desconto funcional se transformou em testes automatizados que detectaram um bug de limite.
- Critérios de aceitação descrevem resultados observáveis para uma história de usuário, escrita antes do início do desenvolvimento.
- Use o formato Dado Quando Então para comportamento com etapas claras e uma lista de regras para restrições simples.
- Cada critério deve ser específico o suficiente para se tornar um teste sem fazer perguntas a ninguém.
- Transformamos seis critérios para um código de desconto em seis testes pytest. Um bug plantado por um passou por cinco deles e falhou no critério de limite.
Um desenvolvedor termina uma história e a move para “concluído”. O testador descobre que os códigos expirados ainda funcionam. O proprietário do produto diz que “códigos obviamente expirados devem falhar”. O desenvolvedor diz que “isso nunca foi escrito”. Cada equipe viveu alguma versão desse argumento. Os critérios de aceitação evitam isso, afirmando, antes do início do trabalho, exatamente o que deve ser verdade para que a história seja aceita.
Este guia explica como escrever critérios que não deixem espaço para esse argumento. Usamos uma história realista e transformamos seus critérios em testes automatizados com pytest 9.2.0 em Python 3.13.6 para mostrar como bons critérios são diretamente mapeados para testes.
Quais são os critérios de aceitação?
Os critérios de aceitação são uma pequena lista de condições associadas a uma história de usuário. Eles descrevem o que o usuário pode observar quando a história funciona: o que ele vê, o que é salvo, o que é recusado. Eles respondem à pergunta “como saberemos que esta história acabou?” em termos com os quais o proprietário do produto, o desenvolvedor e o testador concordam.
Eles descrevem o que, e não como. “O total mostra 72,00” é um critério. “Armazenar o desconto em uma coluna decimal” é uma decisão de projeto que pertence às notas técnicas.
Por que eles são importantes
- Entendimento compartilhado: escrevê-los juntos expõe diferentes suposições antes de qualquer código existir.
- Estimativa: uma história com oito critérios é claramente maior do que uma com dois.
- Design de teste: cada critério é um caso de teste pronto, o que economiza tempo na escrita de casos de teste.
- Controle de escopo: qualquer coisa que não esteja nos critérios é uma nova história, não um requisito oculto.
- Aprovação: eles fornecem aos testes de aceitação do usuário um objetivo claro.
Critérios de aceitação versus definição de casos concluídos versus casos de teste
| Artigo | Aplica-se a | Exemplo |
|---|---|---|
| Critérios de aceitação | Uma história específica | Um código expirado mostra “Código expirado” e o total não muda |
| Definição de feito | Cada história da equipe | Código revisado, testes de unidade aprovados, implantados no teste |
| Casos de teste | Verificações detalhadas de um critério | Etapas, dados e resultados esperados, incluindo casos extremos |
Um critério geralmente produz vários casos de teste. “Os códigos não diferenciam maiúsculas de minúsculas” podem se tornar testes para letras minúsculas, maiúsculas e minúsculas e espaços ao redor do código.
Os dois formatos comuns
Orientado a regras (lista de verificação)
Uma lista simples de afirmações, cada uma delas verdadeira ou falsa:
- O campo de código aceita até 20 caracteres.
- Os códigos não diferenciam maiúsculas de minúsculas e ignoram os espaços ao seu redor.
- Apenas um código pode ser aplicado por pedido.
Bom para restrições simples, regras de validação e detalhes de UI.
Orientado para cenário (dado quando então)
Cada critério é um cenário curto com um contexto inicial, uma ação e um resultado observável:
Given a cart total of 80.00 and the active code SAVE10
When the shopper applies SAVE10
Then the total shows 72.00
And the message "Code applied" is displayed
Bom para comportamento que depende do estado ou sequência. Ele vem do desenvolvimento baseado em comportamento e é mapeado diretamente para ferramentas como Cucumber, SpecFlow e pytest-bdd. Nosso guia TDD vs BDD aborda a origem do formato.
Regras para o bem dadas quando então
- Dado é estado, não ações. “Dado um carrinho total de 80,00”, e não “Dado que o usuário adiciona um livro e uma caneta”.
- Quando é um evento. Se precisar de dois, provavelmente você terá dois cenários.
- Então é observável pelo usuário ou outro sistema: uma mensagem, um total, um registro, um e-mail. Evite detalhes internos como “o sinalizador está definido”.
- Use valores concretos. “Uma quantia válida” força o leitor a adivinhar; “80,00” não.
- Limite cada cenário a cerca de três a seis linhas. Cenários longos escondem vários comportamentos.
- Escreva no idioma da empresa, para que o proprietário do produto possa ler e aprovar.
Dica: leia cada linha do Then e pergunte “um testador poderia verificar isso sem perguntar a ninguém?” Se a resposta for não, o critério ainda não está concluído.
Exemplo resolvido: um código de desconto
História do usuário: Como comprador, quero aplicar um código de desconto na finalização da compra para pagar menos pelo meu pedido.
As regras do proprietário do produto: SAVE10 dá 10% de desconto, precisa de um carrinho total mínimo de 50,00 e expira no final de 31 de dezembro de 2026. Aqui estão os critérios que combinamos:
- AC1, código válido: Dado um total de carrinho de 80,00 e o código ativo SAVE10, quando o comprador aplica SAVE10, então o total mostra 72,00 e a mensagem “Código aplicado”.
- AC2, abaixo do mínimo: Dado um total de 45,00 no carrinho, quando o comprador aplica SAVE10, o total permanece 45,00 e a mensagem diz “Adicione mais 5,00 para usar este código”.
- AC3, expirado: Dado que hoje é 1º de janeiro de 2027, quando o comprador aplica SAVE10, o total permanece inalterado e a mensagem diz “Código expirado”.
- AC4, tolerância de entrada: Dado que o comprador digita ” save10 ” com espaços e letras minúsculas, quando aplicado, então é aceito.
- AC5, código desconhecido: Dado que o código FREE100 não existe, quando é aplicado, então o total permanece inalterado e a mensagem diz “Código não reconhecido”.
- AC6, limite: Dado um total de carrinho de exatamente 50,00, quando o comprador aplica SAVE10, o total mostra 45,00.
AC2 é um bom exemplo de critério que melhora o produto: em vez de um vago “mínimo não atendido”, ele diz ao comprador exatamente o que fazer. AC6 existe porque a frase “mínimo de 50,00” é ambígua até que alguém pergunte se 50,00 em si se qualifica. Essa questão é pura análise de valor limite.
Transformando critérios em testes automatizados
Como todo critério tem valores concretos, cada um se tornou um teste quase palavra por palavra. Mantivemos o texto Dado Quando Então como comentários para que o link permanecesse visível:
TODAY = date(2026, 11, 18)
def test_ac1_valid_code_reduces_total():
# Given a cart total of 80.00 and the active code SAVE10
# When the shopper applies SAVE10
# Then the total shows 72.00 and the message "Code applied"
assert apply_code(80.00, "SAVE10", TODAY) == (72.00, "Code applied")
def test_ac2_below_minimum_explains_gap():
assert apply_code(45.00, "SAVE10", TODAY) == (45.00, "Add 5.00 more to use this code")
def test_ac3_expired_code_rejected():
assert apply_code(80.00, "SAVE10", date(2027, 1, 1)) == (80.00, "Code expired")
def test_ac6_exactly_minimum_qualifies():
assert apply_code(50.00, "SAVE10", TODAY) == (45.00, "Code applied")
AC4 e AC5 seguem a mesma forma. Executando o arquivo:
test_promo_ac.py::test_ac1_valid_code_reduces_total PASSED
test_promo_ac.py::test_ac2_below_minimum_explains_gap PASSED
test_promo_ac.py::test_ac3_expired_code_rejected PASSED
test_promo_ac.py::test_ac4_code_is_case_and_space_insensitive PASSED
test_promo_ac.py::test_ac5_unknown_code PASSED
test_promo_ac.py::test_ac6_exactly_minimum_qualifies PASSED
6 passed in 0.13s
Nomear os testes após o ID do critério torna o relatório legível por não desenvolvedores: uma falha test_ac3 informa imediatamente ao proprietário do produto qual promessa foi quebrada.
O bug que um critério detectou
Em seguida, alteramos um caractere na implementação, de total < minimum para total <= minimum, um erro muito comum. O resultado:
FAILED t_bug.py::test_ac6_exactly_minimum_qualifies - AssertionError
1 failed, 5 passed in 0.16s
Cinco critérios ainda foram aprovados. Sem o AC6, esse bug teria sido enviado, e cada comprador com um carrinho de exatamente 50,00 teria sido informado para “adicionar mais 0,00”. Uma linha extra na história, escrita em uma conversa de cinco minutos, evitou um bug confuso na produção.
Mais exemplos de critérios de aceitação
Redefinição de senha
Given a registered email address
When the user requests a password reset
Then a reset link is emailed within 1 minute
And the link expires after 30 minutes
Given an email address that is not registered
When the user requests a password reset
Then the same confirmation message is shown
And no email is sent
O segundo cenário protege a privacidade: mostrar uma mensagem diferente revelaria quais e-mails possuem contas.
Filtro de pesquisa (formato de regra)
- Selecionar “Em estoque” oculta produtos com estoque zero.
- Os filtros combinam com AND: “Em estoque” mais “Menos de 20 anos” mostra apenas os itens que correspondem a ambos.
- A contagem de resultados é atualizada sem recarregar a página.
- A limpeza dos filtros restaura a contagem de resultados original.
Critérios de aceitação não funcionais
Os critérios não se referem apenas a recursos. As necessidades de desempenho, segurança e acessibilidade também pertencem a eles, desde que sejam mensuráveis:
- A página de resultados da pesquisa carrega em menos de 2 segundos para 95% das solicitações com 1.000 produtos.
- O campo do código de desconto pode ser acessado e enviado apenas pelo teclado.
- Aplicar mais de 10 códigos inválidos em um minuto mostra uma mensagem de limite de taxa.
Os requisitos que se aplicam a todas as histórias, como “todas as páginas funcionam em dispositivos móveis”, geralmente pertencem à definição de concluído.
Quem os escreve e quando
O proprietário do produto geralmente possui critérios de aceitação, mas os melhores vêm de uma breve conversa entre o proprietário do produto, um desenvolvedor e um testador, geralmente chamados de “três amigos”. Escreva-os durante o refinamento do backlog, antes que a história entre em um sprint, e atualize-os se a conversa durante o desenvolvimento mudar o escopo. Os critérios adicionados após o término do desenvolvimento são um sinal de que a história não estava pronta.
Lista de verificação de qualidade
- Cada critério é testável com aprovação ou reprovação clara?
- Cada um usa valores concretos em vez de palavras como “rápido”, “válido” ou “fácil de usar”?
- Os caminhos de erro estão cobertos, e não apenas o caminho feliz? Nosso guia para testes positivos versus negativos ajuda aqui.
- Os limites são declarados explicitamente, como “50,00 ou mais”?
- Cada critério descreve um resultado que o usuário ou outro sistema pode observar?
- A lista é curta o suficiente? Mais de oito critérios geralmente significam que a história deve ser dividida.
- O proprietário do produto concordou com todas as linhas?
Erros comuns
- Palavras vagas: “A página deve ser rápida” não pode falhar. Dê um número.
- Detalhes da implementação: “Usar Redis para o cache” restringe o design sem descrever o valor do usuário.
- Somente caminho feliz: a maioria dos bugs de produção reside nos casos de erro e extremos.
- Escrevê-los após a codificação: eles descrevem o que foi construído e não o que era necessário.
- Várias ações em uma Quando: divida-as de forma que uma falha aponte para um comportamento.
- Copiando a história: “O usuário pode aplicar um desconto” repete a história e não acrescenta nada testável.
Considerações finais
Bons critérios de aceitação são curtos, concretos e testáveis. Escreva-os antes do desenvolvimento, use Dado Quando Então para comportamento e uma lista de regras para restrições e sempre inclua os casos de erro e limite. Nosso exemplo de desconto de seis critérios se transformou diretamente em seis testes, e o critério de limite único foi o único que detectou um bug realista de divisão por um. Esse é o retorno de gastar dez minutos nos critérios antes de escrever o código.
Perguntas frequentes
Quais são os critérios de aceitação no Agile?
São as condições específicas e testáveis que uma história de usuário deve atender para ser aceita como concluída. Descrevem resultados observáveis e são acordados antes do início do desenvolvimento.
Qual é o formato Dado Quando Então?
É um formato de cenário onde Dado define o estado inicial, Quando descreve uma ação e Depois declara o resultado observável. Ela vem do desenvolvimento orientado ao comportamento.
Quem escreve os critérios de aceitação?
O proprietário do produto é o proprietário deles, mas eles funcionam melhor quando escritos em conjunto com um desenvolvedor e um testador durante o refinamento do backlog, antes do início da história.
Quantos critérios de aceitação uma história de usuário deve ter?
Geralmente entre três e oito. Menos frequentemente significa que faltam casos de erro, e muito mais geralmente significa que a história é muito grande e deve ser dividida.
Qual é a diferença entre critérios de aceitação e definição de concluído?
Os critérios de aceitação são específicos para uma história. A definição de pronto é uma lista de verificação compartilhada que se aplica a todas as histórias, como revisão de código e aprovação em testes.
Continue aprendendo
Precisa de ajuda com testes, WordPress ou SEO?
Ajudamos as equipes a fornecer software melhor e a expandir seus sites. Conte-nos no que você está trabalhando e sugeriremos um próximo passo claro.
Mais guias sobre testes, IA e desenvolvimento moderno
Gostou deste artigo? Escolha um tópico e vá direto para nossos tutoriais mais recentes.
Cookies HTTP explicados: seguros, HttpOnly, SameSite e escopo
Cookies HTTP explicados: Set-Cookie, Path, Domain, expiration, Secure, HttpOnly, SameSite, prefixos, exclusão de cookies e uma receita de sessão seg…
Leia o artigo →DevOpsGit Rebase Interactive: Squash, Fixup, Reword e Autosquash
Git rebase interativo explicado passo a passo: escolher, reformular, esmagar, consertar, editar, descartar, autosquash, conflitos e desfazer um reba…
Leia o artigo →Teste de softwareTeste Alfa vs Beta: Principais diferenças, critérios de saída e lista de verificação
Testes alfa e beta comparados: quem testa, o que cada fase encontra, critérios de entrada e saída, como executar um beta e um exemplo prático de dad…
Leia o artigo →Automação de testesPytest Monkeypatch: 10 exemplos testados para Env Vars, Time e APIs
Pytest monkeypatch explicado com 10 testes de aprovação: variáveis de ambiente, funções, configuração, tempo, suspensão, caminhos, bloqueio de rede …
Leia o artigo →Bancos de dados e SQLIncremento automático de SQL: MySQL, PostgreSQL, SQL Server e SQLite
Incremento automático de SQL em MySQL, PostgreSQL, SQL Server e SQLite: sintaxe, leitura do novo ID, porque aparecem lacunas, reutilização de ID, re…
Leia o artigo →Bancos de dados e SQLSQL BETWEEN: intervalos inclusivos e a armadilha de data explicada
SQL BETWEEN explicado com consultas testadas: intervalos inclusivos, limites invertidos, NULLs, armadilha de data do último dia, intervalos semiaber…
Leia o artigo →Desenvolvimento de softwareLiterais de modelo JavaScript: 10 exemplos, incluindo modelos marcados
Literais de modelo JavaScript explicados com 10 exemplos testados: interpolação, strings multilinha, escape, modelos marcados para HTML e SQL seguro…
Leia o artigo →Desenvolvimento de softwareHeapq Python: filas prioritárias, N principais e heaps explicados
Python heapq explicou: heappush, heappop, heapify, filas de prioridade com desempates, max heaps, nlargest e merge, com tempos reais em relação à cl…
Leia o artigo →Desenvolvimento de softwareOperador Python Walrus (:=) explicado com 8 exemplos reais
O operador Python walrus := explicado com 8 exemplos testados: if checks, regex matches, while loops, compreensões, regras de escopo, precedência e …
Leia o artigo →Inteligência artificialFunção Softmax explicada: fórmula, código Python e versão estável
A função softmax explicada: fórmula, exemplo resolvido, código NumPy, a versão estável que evita NaN, temperatura, entropia cruzada e softmax vs sig…
Leia o artigo →Desenvolvimento de softwareCORS explicado: solicitações de comprovação, cabeçalhos e como corrigir erros de CORS
CORS explicado: origens, solicitações simples e de simulação, os cabeçalhos de resposta que seu servidor deve enviar, credenciais e como corrigir er…
Leia o artigo →DevOpsGit Diff explicado: mudanças faseadas, ramificações e commits
Git diff explicado: leia a saída, compare alterações não preparadas e preparadas, commits e ramificações, dois pontos versus três pontos e sinalizad…
Leia o artigo →Automação de testesPytest Xdist: execute testes em paralelo e reduza o tempo de teste
Execute testes pytest em paralelo com pytest-xdist: instalação, a opção -n, modos de distribuição, tempos reais e como corrigir falhas de estado com…
Leia o artigo →Teste de softwareVerificação vs Validação em Teste de Software: Exemplo e Tabela
Verificação versus validação em testes de software explicada com uma tabela de comparação e um exemplo de cupom testado onde todos os testes de espe…
Leia o artigo →Bancos de dados e SQLSQL CAST explicado: converta tipos de dados com exemplos testados
SQL CAST explicado com exemplos testados: texto para número, truncamento, divisão inteira, números armazenados como texto, datas, entradas incorreta…
Leia o artigo →Bancos de dados e SQLSQL DISTINCT: Como remover linhas duplicadas (e suas armadilhas)
SQL DISTINCT explicado com consultas testadas: uma e muitas colunas, NULLs, COUNT DISTINCT, DISTINCT vs GROUP BY, SUM DISTINCT e traps de junção e d…
Leia o artigo →Teste de softwareCritérios de aceitação: dados quando então, exemplos e lista de verificação
Como escrever critérios de aceitação que os testadores podem executar: formatos baseados em regras e Dado quando então, um exemplo de código de desc…
Leia o artigo →Teste de softwareTeste de Transição de Estado: Diagrama, Tabela e Exemplo
Teste de transição de estado explicado com um exemplo de bloqueio de login: estados, eventos, diagrama, tabela de estados, transições válidas e invá…
Leia o artigo →Bancos de dados e SQLSQL ROW_NUMBER: N principais por grupo, desduplicação e paginação
SQL ROW_NUMBER explicado com consultas testadas: PARTITION BY, N principais por grupo, exclusão de duplicatas, paginação, tie trap e como ele difere…
Leia o artigo →Desenvolvimento de softwareConjunto JavaScript: União, Interseção e Remoção de Duplicatas
JavaScript Set explicado com exemplos testados: adicionar, has, delete, desduplicar arrays, os novos métodos de união e interseção, regras de iguald…
Leia o artigo →Inteligência artificialBM25 explicado: como a pesquisa por palavra-chave classifica os resultados, com código Python e pesquisa híbrida
BM25 explicou com uma implementação Python pura que executamos: a fórmula, IDF, saturação de termo, os parâmetros k1 e b, por que supera a contagem …
Leia o artigo →Desenvolvimento de softwareMétodos HTTP explicados: GET, POST, PUT, PATCH, DELETE, testados em um servidor Live
Métodos HTTP explicados com um pequeno servidor que executamos: GET, POST, PUT, PATCH, DELETE, HEAD e OPTIONS, seguro vs idempotente, PUT vs PATCH, …
Leia o artigo →DevOpsGit Bisect explicado: encontre o commit que quebrou seu código, manual ou automaticamente
Git bisect explicado com um repositório testado: encontre o commit incorreto entre 41 em 5 execuções de teste, automatize-o com git bisect run, pule…
Leia o artigo →Automação de testesMarcadores pytest explicados: marcas personalizadas, filtros skip, skipif, xfail e -m
marcadores pytest explicados com um conjunto testado: registre marcas personalizadas, execute apenas testes de fumaça com -m, combine filtros com e,…
Leia o artigo →Teste de softwareTestes Positivos vs Negativos: Diferenças, 24 Casos de Teste Reais e uma Lista de Verificação
Testes positivos versus negativos explicados com um formulário de inscrição real: 6 casos de teste positivos e 18 negativos executados em pytest, a …
Leia o artigo →Bancos de dados e SQLSQL ORDER BY Várias Colunas: ASC, DESC, NULLS LAST, Case e Ordem Personalizada
SQL ORDER BY com múltiplas colunas explicadas com consultas testadas: ASC e DESC mistos, desempates, NULLS FIRST e LAST, classificação sem distinção…
Leia o artigo →Bancos de dados e SQLTotal em execução do SQL: SUM OVER, totais por grupo, somas móveis e armadilha RANGE
Como calcular um total de execução SQL com SUM() OVER: totais por grupo, somas cumulativas diárias, somas móveis, porcentagem do total, armadilha de…
Leia o artigo →Desenvolvimento de softwareMatriz de classificação JavaScript: números, objetos, strings e por que 10 vem antes de 5
Como classificar um array em JavaScript corretamente: números com função de comparação, objetos por um ou mais campos, strings com localeCompare, da…
Leia o artigo →Desenvolvimento de softwareMétodos de string Python: folha de dicas, exemplos reais e a armadilha strip()
Métodos de string Python com exemplos testados: split, join, strip, replace, find, startupswith, is-methods, casefold, partition e translate, além d…
Leia o artigo →Inteligência artificialExplicação da similaridade de cossenos: fórmula, exemplo resolvido e código Python
A similaridade de cosseno é explicada de forma simples: a fórmula, um exemplo trabalhado à mão, código Python e NumPy puro, cosseno versus distância…
Leia o artigo →Desenvolvimento de softwareCodificação UTF-8 explicada: como o texto se transforma em bytes e como corrigir texto ilegível
Codificação UTF-8 explicada com exemplos em nível de byte que executamos em Python: como os caracteres se tornam de 1 a 4 bytes, por que café se tra…
Leia o artigo →Automação de testesparametrização pytest explicada: 7 padrões com exemplos testados
parametrização pytest explicada com 7 padrões testados: casos básicos, ids legíveis, decoradores empilhados, pytest.param com xfail e skip, fixtures…
Leia o artigo →Teste de softwareReteste versus teste de regressão: 8 diferenças principais com um exemplo real de correção de bug
Reteste versus teste de regressão explicado com uma correção de bug real executada em pytest: o reteste confirmou a correção, a execução de regressã…
Leia o artigo →Bancos de dados e SQLExcluir linhas duplicadas em SQL: 5 métodos seguros, testados passo a passo
Como excluir linhas duplicadas no SQL com segurança: encontre-as, visualize-as e remova-as com ROW_NUMBER, MIN(id), EXISTS, rowid ou uma nova tabela…
Leia o artigo →Bancos de dados e SQLSQL RANK vs DENSE_RANK vs ROW_NUMBER: diferenças com exemplos testados
SQL RANK vs DENSE_RANK vs ROW_NUMBER em uma tabela: como cada um lida com empates, N principais por grupo, a segunda armadilha salarial mais alta e …
Leia o artigo →Desenvolvimento de softwareEncadeamento opcional de JavaScript (?.) Explicado: 8 exemplos, ?? Padrões e armadilhas
O encadeamento opcional de JavaScript interrompe erros “Não é possível ler propriedades de indefinidos”. 8 exemplos testados para propriedades, arra…
Leia o artigo →Desenvolvimento de softwarePython enumerate() explicado: 7 exemplos, start=1 e erros a evitar
Python enumerate() fornece o índice e o valor em um loop limpo. 7 exemplos testados, o truque start=1, dicionários, arquivos, números rápidos e 3 er…
Leia o artigo →Inteligência artificialEstratégias de chunking RAG explicadas: fixo, sobreposição, frase, recursivo e títulos, medidos
Estratégias de chunking RAG comparadas em um documento com tiktoken 0.14: tamanho fixo, sobreposição, empacotamento de frases, divisão recursiva e p…
Leia o artigo →Desenvolvimento de softwareExplicação da idempotência da API: chaves de idempotência e novas tentativas seguras, testadas
A idempotência da API explicada com um servidor e cliente Python que executamos: uma resposta perdida causava uma cobrança dupla sem uma chave e uma…
Leia o artigo →DevOpsGit Stash explicado: salvar, aplicar, abrir e não rastrear arquivos, testado
Git stash explicado com comandos que executamos no Git 2.56: push com uma mensagem, arquivos não rastreados, listar e mostrar, aplicar vs pop, mante…
Leia o artigo →Teste de softwareExplicação do teste em pares: como todos os pares reduzem 216 testes para 13, testados
Testes em pares explicados com um gerador que executamos em Python 3.13: um checkout com 216 combinações cobertas por 13 testes, cobertura verificad…
Leia o artigo →Automação de testesDuplas de teste explicadas: Dummy, Stub, Spy, Mock e Fake, com código Python testado
O teste duplo é explicado com um exemplo de Python executado no pytest 9.2: dummy, stub, spy, mock e fake, quando usar cada um, verificações de esta…
Leia o artigo →Bancos de dados e SQLSQL COALESCE explicado: padrões, NULLIF, IFNULL vs ISNULL e traps, testados
SQL COALESCE explicado com consultas que executamos no SQLite 3.50: primeiros valores não nulos, strings vazias, NULL em matemática, NULLIF para div…
Leia o artigo →Bancos de dados e SQLSQL Self Join explicado: funcionário-gerente, comparações de pares e linhas, testado
Auto-junção SQL explicada com consultas que executamos no SQLite 3.50: funcionário e gerente, ganhando mais que o gerente, pares únicos, alterações …
Leia o artigo →Desenvolvimento de softwareExplicação do operador JavaScript Spread: Spread vs Rest, cópias e pegadinhas, testado
O operador de propagação JavaScript explicado com o código que executamos no Nó 24: arrays, objetos, cópias superficiais, parâmetros restantes, o li…
Leia o artigo →Desenvolvimento de softwareFunctools Python explicado: lru_cache, parcial, redução, wraps e muito mais, testado
Functools do Python explicados com código que executamos no Python 3.13: lru_cache e cache, parcial, redução, wraps, cached_property, singledispatch…
Leia o artigo →Desenvolvimento de softwareMódulo de coleções Python explicado: contador, defaultdict, deque e mais, testado
Coleções Python explicadas com código que executamos em Python 3.13: Counter, defaultdict, deque, nomeadotuple, OrderedDict e ChainMap, além de um t…
Leia o artigo →Inteligência artificialJanela de contexto LLM explicada: tokens, limites e como ajustar mais, medidos
A janela de contexto do LLM explicada com contagens de tokens que medimos usando tiktoken: palavras versus tokens para prosa, código e hindi, orçame…
Leia o artigo →Desenvolvimento de softwareWebhooks explicados: como funcionam e como recebê-los com segurança
Webhooks explicados com um receptor e remetente que executamos em Python: push vs polling, assinaturas HMAC-SHA256, rejeição de solicitações adulter…
Leia o artigo →DevOpsGit Cherry-Pick explicado: copie o commit que você precisa, com segurança e testado
Git cherry-pick explicado com comandos que executamos no Git 2.56: copiar um hotfix para um branch de lançamento, novos hashes e patch-ids, -x, -n, …
Leia o artigo →Automação de testesExplicação do teste instantâneo: como funciona, quando ajuda e quando dói
O teste de instantâneo foi explicado com uma demonstração pytest e xaroposa que executamos: criação de instantâneos, leitura da diferença após uma a…
Leia o artigo →Teste de softwareExplicação do teste de mutação: por que a cobertura de 100% ainda não percebeu nosso bug
Os testes de mutação explicados com uma pequena ferramenta de mutação que construímos e executamos: 14 mutantes, um conjunto de testes com 100% de c…
Leia o artigo →Bancos de dados e SQLFunções SQL JSON explicadas: consulta, atualização e indexação JSON em SQL, testadas
Funções SQL JSON explicadas com consultas que executamos no SQLite 3.50: json_extract, os operadores -> e ->>, json_each, json_set, json_pa…
Leia o artigo →Bancos de dados e SQLSQL Pivot explicado: transforme linhas em colunas com CASE, FILTER e PIVOT
SQL pivot explicado com consultas que executamos no SQLite 3.50: agregação condicional com CASE e SUM, FILTER, NULL vs zero, totais, colunas dinâmic…
Leia o artigo →Desenvolvimento de softwareJavaScript esta palavra-chave explicada: cada regra de ligação, testada no nó
A palavra-chave JavaScript explicada com 17 casos que executamos no Nó 24: chamadas de método, perdeu isso em retornos de chamada, modo estrito, fun…
Leia o artigo →Desenvolvimento de softwarePython pathlib explicado: caminhos, arquivos e pastas da maneira moderna, testados
Python pathlib explicado com exemplos que executamos no Python 3.13: juntando caminhos com /, nome, radical e sufixo, lendo e gravando arquivos, mkd…
Leia o artigo →Desenvolvimento de softwareItertools Python explicados: loops preguiçosos, combinações e agrupamentos, testados
Itertools do Python explicados com exemplos que executamos no Python 3.13: contagem, ciclo, acumulação, cadeia, agrupamento, produto, combinações, p…
Leia o artigo →Inteligência artificialExplicação da injeção imediata: como os aplicativos de IA são enganados e como defendê-los
Injeção imediata explicada para construtores: ataques diretos e indiretos, por que os filtros de palavras-chave falham (nosso teste bloqueou 1 de 4)…
Leia o artigo →DevOpsRegistros DNS explicados: A, AAAA, CNAME, MX, TXT e TTL com pesquisas reais
Registros DNS explicados com pesquisas que executamos: como funciona a resolução, A e AAAA, regras CNAME, MX e MX nulo, TXT para SPF e verificação, …
Leia o artigo →DevOpsSinalizadores de recursos explicados: lançamentos seguros, lançamentos graduais e higiene de sinalizadores
Sinalizadores de recursos explicados com uma simulação de implementação que executamos: tipos de sinalizadores, implementações percentuais com hashi…
Leia o artigo →Automação de testesGeração de dados de teste com Python Faker: dados realistas, repetíveis e seguros
Teste a geração de dados com Python Faker, execute e meça: propagação de dados repetíveis, localidades, valores exclusivos, registros em formato de …
Leia o artigo →Teste de softwareExplicação do teste Shift-Left: Encontre bugs mais cedo, sem atrasar a equipe
O teste shift-left explicou: o que significa, por que os defeitos iniciais são mais baratos, práticas desde revisões de requisitos até verificações …
Leia o artigo →Bancos de dados e SQLFunções de string SQL explicadas: TRIM, SUBSTR, REPLACE, CONCAT e limpeza de dados
Funções de string SQL explicadas com consultas que executamos: concatenação e NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, preenchimento, com…
Leia o artigo →Bancos de dados e SQLExplicação dos gatilhos SQL: gatilhos ANTES e DEPOIS, registros de auditoria e armadilhas
Gatilhos SQL explicados com gatilhos que executamos: ANTES vs DEPOIS, ANTIGO e NOVO, logs de auditoria, validação, atualizações de estoque, condiçõe…
Leia o artigo →Desenvolvimento de softwareMódulo JSON Python explicado: dumps, carregamentos, tipos personalizados e erros comuns
O módulo Python JSON explicado com o código que executamos: dumps e carregamentos, arquivos, conversões de tipo, datas e decimais, codificadores per…
Leia o artigo →Desenvolvimento de softwareMódulos ES vs CommonJS: como funcionam as importações de JavaScript em Node.js, testado
Módulos ES vs CommonJS explicados com código que executamos em Node.js: sintaxe de importação e exportação, require, vinculações ativas, cache, espe…
Leia o artigo →Desenvolvimento de softwarePython Regex explicado: padrões, grupos, antecipações e armadilhas, testados
Regex Python explicado com padrões que executamos: pesquisa vs correspondência, findall, grupos e grupos nomeados, ganancioso vs preguiçoso, sub, lo…
Leia o artigo →Inteligência artificialExplicação da saída estruturada do LLM: obtendo JSON confiável de modelos de IA
Saída estruturada do LLM explicada com validação que executamos no Pydantic: modo JSON e esquemas, decodificação restrita, formas de quebra de saída…
Leia o artigo →DevOpsChaves SSH explicadas: como funcionam, ssh-keygen, Ed25519 e hábitos seguros
Chaves SSH explicadas com chaves que geramos: chaves públicas versus privadas, ssh-keygen, Ed25519 versus RSA, impressões digitais, senhas, agente s…
Leia o artigo →DevOpsCache HTTP explicado: controle de cache, ETag e respostas 304, com um teste ao vivo
Cache HTTP explicado com um pequeno servidor que executamos: diretivas Cache-Control, idade máxima, sem cache vs sem armazenamento, revalidação de E…
Leia o artigo →Automação de testesTeste de contrato de API explicado: detecte alterações importantes antes de serem enviadas
O teste de contrato de API foi explicado com uma verificação de esquema que executamos: o que é um contrato, contratos orientados ao consumidor, Pac…
Leia o artigo →Teste de softwareTestes baseados em riscos explicados: avalie os riscos, construa uma matriz e teste o que é importante
Testes baseados em riscos explicados passo a passo: identificação de riscos, pontuação de probabilidade e impacto, construção de uma matriz de risco…
Leia o artigo →Bancos de dados e SQLRestrições SQL explicadas: NOT NULL, UNIQUE, CHECK e FOREIGN KEY, testadas
Restrições SQL explicadas com testes que executamos: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY e FOREIGN KEY, as lacunas NULL, configuração de chave…
Leia o artigo →Bancos de dados e SQLFunções de data SQL explicadas: adicionando, comparando e agrupando datas sem bugs
Funções de data SQL explicadas com consultas que executamos: adição de intervalos, surpresas de final de mês, diferenças de data, armadilha BETWEEN,…
Leia o artigo →Desenvolvimento de softwarePython assíncio explicado: assíncrono, espera, coleta e TaskGroup com Real Timings
Python asyncio explicado com código que cronometramos: corrotinas, espera, coleta, TaskGroup, tratamento de erros, tempos limite, limitação de simul…
Leia o artigo →Desenvolvimento de softwareDebounce vs Throttle em JavaScript: como funcionam, quando usar cada um, testado
Debounce vs. acelerador em JavaScript explicado com tempos que medimos em Node.js: como cada um funciona, implementações simples, chamadas iniciais …
Leia o artigo →Desenvolvimento de softwareGerenciadores de contexto Python explicados: a instrução with, contextlib e usos reais
Os gerenciadores de contexto Python explicados com o código que executamos: como funciona, __enter__ e __exit__, contextlib.contextmanager, supressã…
Leia o artigo →Inteligência artificialTemperatura LLM e Top-p explicados: como os modelos de IA escolhem sua próxima palavra
Temperatura LLM e top-p explicados com uma simulação que executamos: como as probabilidades são remodeladas, o que top-p mantém, configurações recom…
Leia o artigo →DevOpsYAML explicado: sintaxe, o problema da Noruega e outras armadilhas que testamos
YAML explicado com um teste de analisador: sintaxe básica, listas e mapas, o problema da Noruega, versões que se transformam em carros flutuantes, c…
Leia o artigo →DevOpsCron Jobs explicado: sintaxe, programações reais e os erros que os quebram
Cron jobs explicados com cronogramas que verificamos: os cinco campos, operadores, exemplos reais, a armadilha do dia do mês OU do dia da semana, pr…
Leia o artigo →Teste de softwareCiclo de vida de bugs em testes de software: cada status, quem é o proprietário e erros comuns
O ciclo de vida do bug explicado: cada status de defeito, de Novo a Fechado, quem é o proprietário de cada etapa, bugs rejeitados, adiados e reabert…
Leia o artigo →Automação de testesTeste baseado em propriedades em Python: a hipótese encontra os bugs que seus exemplos não percebem
Testes baseados em propriedades explicados com testes de hipóteses que executamos: propriedades versus exemplos, estratégias, redução, os bugs reais…
Leia o artigo →Bancos de dados e SQLPaginação SQL explicada: OFFSET vs Keyset, com um teste de um milhão de linhas
Paginação SQL explicada com um teste de um milhão de linhas que executamos: LIMIT e OFFSET, por que páginas profundas ficam lentas, paginação de con…
Leia o artigo →Inteligência artificialExplicação das alucinações de IA: por que os modelos de linguagem inventam as coisas e como reduzi-las
Explicação das alucinações de IA: o que são, por que os modelos de linguagem as produzem, tipos comuns, como reduzi-las com aterramento e instruções…
Leia o artigo →DevOpsVariáveis de ambiente explicadas: arquivos .env, segredos e configuração bem feitos
Variáveis de ambiente explicadas com exemplos de Python que executamos: leitura e configuração, por que cada valor é uma string, arquivos .env, hera…
Leia o artigo →Desenvolvimento de softwareExplicação da limitação de taxa de API: algoritmos, cabeçalhos e tratamento de erros 429
Limitação de taxa de API explicada com uma simulação que executamos: token bucket, janela fixa, janela deslizante, 429 respostas, cabeçalhos de limi…
Leia o artigo →Automação de testesZombando em Python: unittest.mock, patch e os erros que fazem os testes mentirem
Zombaria em Python com unittest.mock, testado: Mock e return_value, side_effect, patch onde um nome é usado, especificação e autospec, zombaria de d…
Leia o artigo →Teste de softwareCobertura de código explicada: cobertura de linha versus filial e o que 100% realmente significa
Cobertura de código explicada com uma execução cobertura.py real: cobertura de linha, ramal e condição, leitura de um relatório, por que 100% de cob…
Leia o artigo →Bancos de dados e SQLDELETE vs TRUNCATE vs DROP em SQL: diferenças, reversão e quando usar cada um
DELETE vs TRUNCATE vs DROP explicado com SQL testado: o que cada um remove, rollback, aciona, redefinição de identidade, velocidade e como PostgreSQ…
Leia o artigo →Bancos de dados e SQLExibições SQL explicadas: crie, use e evite as armadilhas, com exemplos
Visualizações SQL explicadas com consultas que executamos: criação de uma visualização, resultados ao vivo, ocultação de colunas, desempenho, visual…
Leia o artigo →Desenvolvimento de softwareInterface TypeScript vs tipo: diferenças reais, testadas com o compilador
Interface TypeScript versus tipo, verificada com o compilador real: o que ambos podem fazer, o que apenas um pode fazer, mesclagem de declarações, e…
Leia o artigo →Desenvolvimento de softwarePython *args e **kwargs explicados: funções flexíveis com exemplos claros
Python *args e **kwargs explicados com o código que executamos: empacotamento e descompactação, ordem dos parâmetros, argumentos somente de palavras…
Leia o artigo →Desenvolvimento de softwareFunções Python Lambda: sintaxe, usos reais e quando não usá-los
Funções lambda do Python explicadas com o código que executamos: sintaxe, classificação com chave, mapa e filtro, fechamentos, armadilha de ligação …
Leia o artigo →Inteligência artificialO que são agentes de IA? Como eles funcionam, com um loop de agente simples que você pode executar
O que são agentes de IA? Um guia simples para o loop do agente, ferramentas, memória e proteções, com um pequeno loop Python que executamos, riscos …
Leia o artigo →DevOpsMonitoramento versus observabilidade: a verdadeira diferença, com logs, métricas e rastreamentos
Explicação do monitoramento versus observabilidade: falhas conhecidas e desconhecidas, logs, métricas e rastreamentos, um passo a passo do incidente…
Leia o artigo →DevOpsDocker Volumes vs Bind Mounts: persista os dados do contêiner da maneira certa
Volumes Docker versus montagens de ligação explicadas: por que os dados do contêiner desaparecem, volumes nomeados, montagens de ligação, tmpfs, exe…
Leia o artigo →Automação de testesTDD vs BDD: principais diferenças, um recurso criado de ambas as maneiras e quando usar cada um
TDD vs BDD explicado com um recurso de desconto construído em ambos os sentidos: refatoração vermelho-verde com o código que executamos, cenários da…
Leia o artigo →Teste de softwareTeste de aceitação do usuário (UAT): processo, lista de verificação e exemplos reais
Explicação do teste de aceitação do usuário: quem o executa, como ele difere do controle de qualidade, um processo de sete etapas, um modelo de caso…
Leia o artigo →Bancos de dados e SQLValores SQL NULL explicados: IS NULL, COALESCE, NULLIF e as armadilhas a serem evitadas
Valores SQL NULL explicados com consultas que executamos: lógica de três valores, IS NULL, COALESCE, NULLIF, como agregações, junções e classificaçã…
Leia o artigo →Bancos de dados e SQLInstrução SQL CASE WHEN: sintaxe, exemplos reais e erros comuns
SQL CASE WHEN explicado com consultas que executamos: formulários simples e pesquisados, ordem de condição, pivôs com SUM, truques COUNT, classifica…
Leia o artigo →Desenvolvimento de softwareO que é JWT? JSON Web Tokens explicados com um exemplo prático
O que é JWT? JSON Web Tokens explicados: as três partes, um token construído e adulterado no código que executamos, JWT vs sessões, armazenamento, t…
Leia o artigo →Desenvolvimento de softwareLoop de eventos JavaScript explicado: pilha de chamadas, microtarefas e temporizadores com exemplos
O loop de eventos JavaScript explicado com o código que executamos: pilha de chamadas, filas de tarefas e microtarefas, por que setTimeout 0 não é i…
Leia o artigo →Desenvolvimento de softwareGeradores Python e rendimento explicado: economize memória com exemplos reais
Geradores Python e rendimento explicados com o código que executamos: como eles pausam e reiniciam, medem economia de memória, pipelines, sequências…
Leia o artigo →Inteligência artificialO que são incorporações? Similaridade de vetores e cossenos explicada de forma simples
O que são incorporações? Um guia em linguagem simples para vetores, similaridade de cossenos e pesquisa semântica, com um pequeno exemplo que execut…
Leia o artigo →DevOpsImplantação azul-verde vs canário: diferenças, compensações e como escolher
Explicação da implantação azul-verde versus canário: como cada um funciona, custo, risco e reversão, agrupamento estável de usuários que testamos, m…
Leia o artigo →Automação de testesTestes instáveis: o que os causa e como corrigi-los para sempre
Testes instáveis explicados com demonstrações que executamos: as principais causas, como confirmar e diagnosticar uma, soluções adequadas para tempo…
Leia o artigo →Teste de softwareTeste de carga versus teste de estresse: diferenças, métricas e exemplos k6
Teste de carga versus teste de estresse explicado: o que cada um prova, testes de pico e absorção, as métricas que importam, por que as médias engan…
Leia o artigo →Teste de softwareCaso de teste versus cenário de teste: principais diferenças, exemplos e quando usar cada um
Caso de teste vs cenário de teste explicado: definições claras, uma tabela lado a lado, um recurso de redefinição de senha retirado de cenários para…
Leia o artigo →Bancos de dados e SQLOtimização de consultas SQL: leia planos de execução e corrija consultas lentas, com intervalos
Otimização de consulta SQL testada em um milhão de linhas: leia planos de execução, adicione os índices corretos, corrija filtros não sargáveis, use…
Leia o artigo →Bancos de dados e SQLSQL UNION vs UNION ALL: diferenças, exemplos e desempenho testado
SQL UNION vs UNION ALL explicado com consultas que executamos: duplicatas, as regras que ambos seguem, um bug de dados real, desempenho medido, INTE…
Leia o artigo →Desenvolvimento de softwareTutorial da API JavaScript Fetch: GET, POST, tratamento de erros e tempos limite
Um tutorial da API JavaScript Fetch testado em um servidor local: GET e POST, por que 404 não lança, um auxiliar reutilizável, strings de consulta, …
Leia o artigo →Desenvolvimento de softwareManipulação de arquivos Python: leitura, gravação, CSV, JSON e pathlib com exemplos
Manipulação de arquivos Python explicada com código que executamos: modos abertos, com, leitura de arquivos grandes, CSV, JSON, pathlib, arquivos bi…
Leia o artigo →Desenvolvimento de softwareClasses e objetos Python: tutorial OOP com exemplos reais
Classes e objetos Python explicados com código que executamos: __init__, métodos, atributos de classe vs instância, herança, propriedades, métodos d…
Leia o artigo →Inteligência artificialO que é um modelo de linguagem grande? Como funcionam os LLMs, explicado sem exageros
O que é um modelo de linguagem grande? LLMs explicados em linguagem simples: tokens, incorporações, atenção, treinamento, temperatura e janelas de c…
Leia o artigo →DevOpsComandos Linux para iniciantes: o guia essencial do terminal com exemplos
Comandos Linux para iniciantes, agrupados por tarefa: navegação, arquivos, visualização de logs, grep, pipes, permissões, processos e arquivos, com …
Leia o artigo →Automação de testesSelenium vs Playwright: principais diferenças, código comparado e qual escolher
Selenium vs Playwright comparado: arquitetura, espera, suporte a navegador e linguagem, depuração, o mesmo teste em ambas as ferramentas, conselhos …
Leia o artigo →Teste de softwareParticionamento de equivalência: técnica de design de teste explicada com exemplos resolvidos
Explicação do particionamento de equivalência: como encontrar partições válidas e inválidas, exemplos resolvidos para idades, senhas e cupons, teste…
Leia o artigo →Teste de softwareGravidade vs Prioridade em Testes de Software: Diferenças, Matriz e Exemplos Reais
Explicação da gravidade versus prioridade em testes de software: definições claras, uma matriz de quatro vias com exemplos, escalas de nível, quem d…
Leia o artigo →Bancos de dados e SQLTutorial de subconsultas SQL: tipos, subconsultas correlacionadas e EXISTS com exemplos
Um tutorial de subconsultas SQL com consultas que executamos: subconsultas escalares, IN, FROM e SELECT, subconsultas correlacionadas, EXISTS, a arm…
Leia o artigo →Bancos de dados e SQLTransações SQL e ACID explicados: COMMIT, ROLLBACK e níveis de isolamento
Transações SQL e ACID explicadas com uma transferência bancária que executamos: COMMIT, ROLLBACK, savepoints, locks, níveis de isolamento, leituras …
Leia o artigo →Desenvolvimento de softwareFolha de dicas dos comandos do Git: os comandos que você realmente usa, com exemplos
Uma folha de dicas de comandos Git agrupada por tarefa: configuração, preparação, ramificações, controles remotos, stash, histórico e desfazer erros…
Leia o artigo →Desenvolvimento de softwareExplicação das promessas de JavaScript: então, catch, Promise.all e erros comuns
Promessas JavaScript explicadas com o código que executamos: estados, cadeias then e catch, tratamento de erros, Promise.all, allSettled, race e any…
Leia o artigo →Desenvolvimento de softwareTutorial do dicionário Python: métodos, exemplos e padrões comuns
Um tutorial de dicionário Python com código que executamos: criar, ler e atualizar dictos, métodos-chave, mesclagem, compreensão, padrões de contage…
Leia o artigo →Inteligência artificialO que é RAG? Geração aumentada de recuperação explicada com um exemplo prático
O que é RAG? Geração aumentada de recuperação explicada passo a passo: indexação, chunking, embeddings, recuperação, um pequeno exemplo funcional de…
Leia o artigo →DevOpsTutorial Terraform para iniciantes: infraestrutura como código do primeiro arquivo aos módulos
Um tutorial do Terraform para iniciantes: comece sem conta na nuvem, aprenda como iniciar, planejar e aplicar, depois variáveis, saídas, estado, mód…
Leia o artigo →DevOpsDocker vs Kubernetes: principais diferenças, como eles funcionam juntos e o que você precisa
Docker vs Kubernetes explicado: o que cada um faz, o mesmo aplicativo rodando com ambos, Docker Compose e Swarm comparados, a mudança do dockershim …
Leia o artigo →Automação de testesTutorial Pytest para iniciantes: luminárias, parametrização e exemplos reais
Um tutorial pytest para iniciantes com testes que executamos no pytest 9.2: asserções, fixtures, parametrizar, conftest, marcadores, tmp_path, monke…
Leia o artigo →Teste de softwareCiclo de vida de teste de software (STLC): 6 fases, critérios de entrada e saída, exemplo
O ciclo de vida de teste de software explicou: seis fases do STLC com critérios de entrada e saída, resultados, um exemplo de recurso de login funci…
Leia o artigo →Desenvolvimento de softwareGit merge vs rebase: diferenças, exemplos e quando usar cada um
Git merge vs rebase explicado com saída real do log, uma tabela comparativa, a regra de ouro do rebase e um fluxo de trabalho seguro para equipes.
Leia o artigo →Desenvolvimento de softwareList comprehension em Python: sintaxe, exemplos e quando evitar
List comprehension em Python explicada: sintaxe, filtros, if-else, laços aninhados, tempos medidos e quando um laço for comum é a melhor escolha.
Leia o artigo →Bancos de dados e SQLSQL JOIN explicado com exemplos (Inner, Left, Right, Full)
Entenda os joins SQL passo a passo com tabelas e consultas de exemplo: INNER, LEFT, RIGHT, FULL, CROSS e SELF, além de erros comuns e dicas de desem…
Leia o artigo →