biellts/universidade-automatiza / .claude/skills/backend-criar-teste-unitario
backend-criar-teste-unitario
VerifiedCria testes unitários de domínio no padrão xUnit + Shouldly + AAA + Builder do projeto. Use este skill quando solicitado a criar testes unitários, testes de domínio ou cobertura de testes para um agregado, Value Object ou regra de negócio.
Para criar testes unitários de domínio neste projeto, siga o processo abaixo:
1. Localização
Crie o arquivo em:
src/tests/Automatiza.WebApi.UnitTests/{Modulo}/{Entidade}/{Entidade}Tests.cs
O Builder de dados de teste fica no mesmo diretório:
src/tests/Automatiza.WebApi.UnitTests/{Modulo}/{Entidade}/{Entidade}TestBuilder.cs
Namespace: Automatiza.WebApi.UnitTests.{Modulo}.{Entidade}. Os exemplos são os testes reais do Catálogo (Catalogo/Trilha/). O projeto de testes unitários precisa referenciar o csproj do módulo (ver a skill backend-criar-modulo). Xunit já é using global (<Using Include="Xunit" />).
2. Builder de dados de teste
Builder fluente com valores válidos por padrão e um Com{Campo} por campo; Criar() chama o factory do agregado. Real (TrilhaTestBuilder):
using Automatiza.Modules.Catalogo.Domain.Entities.Trilha;
using Automatiza.SeedWork.DomainObjects;
namespace Automatiza.WebApi.UnitTests.Catalogo.Trilha;
public class TrilhaTestBuilder
{
private string? _titulo = "Trilha do Operador de Caixa";
private string? _descricao = "Abertura, venda, sangria e fechamento de caixa.";
private PublicoTrilha _publico = PublicoTrilha.Cliente;
private string? _funcaoAlvo = "Operador de Caixa";
public TrilhaTestBuilder ComTitulo(string? titulo) { _titulo = titulo; return this; }
public TrilhaTestBuilder ComDescricao(string? descricao) { _descricao = descricao; return this; }
public TrilhaTestBuilder ComPublico(PublicoTrilha publico) { _publico = publico; return this; }
public TrilhaTestBuilder ComFuncaoAlvo(string? funcaoAlvo) { _funcaoAlvo = funcaoAlvo; return this; }
public Result<Modules.Catalogo.Domain.Entities.Trilha.Trilha> Criar() =>
Modules.Catalogo.Domain.Entities.Trilha.Trilha.Criar(_titulo, _descricao, _publico, _funcaoAlvo);
}
O namespace do teste termina em
.Trilha, igual ao nome da classe: por isso o tipo é qualificado (Modules.Catalogo.Domain.Entities.Trilha.Trilha). Faça o mesmo quando houver colisão.
3. Estrutura do teste
Padrão AAA (Arrange / Act / Assert), com as três partes separadas por linha em branco. Teste de domínio não compartilha estado: não use [Collection] nem fixture. Real (TrilhaTests):
using Automatiza.Modules.Catalogo.Domain.Entities.Trilha;
using Shouldly;
namespace Automatiza.WebApi.UnitTests.Catalogo.Trilha;
public class TrilhaTests
{
[Fact]
public void Criar_ComDadosValidos_RetornaTrilhaComIdNovo()
{
var result = new TrilhaTestBuilder().Criar();
result.TryGetValue(out var trilha).ShouldBeTrue();
trilha.Id.ShouldNotBe(Guid.Empty);
trilha.Titulo.Text.ShouldBe("Trilha do Operador de Caixa");
trilha.Publico.ShouldBe(PublicoTrilha.Cliente);
trilha.FuncaoAlvo.ShouldBe("Operador de Caixa");
}
[Theory]
[InlineData(null, "TRILHA_TITULO_VAZIO")]
[InlineData(" ", "TRILHA_TITULO_VAZIO")]
[InlineData("ab", "TRILHA_TITULO_CURTO")]
public void Criar_ComTituloInvalido_RetornaErro(string? titulo, string codigoEsperado)
{
var result = new TrilhaTestBuilder().ComTitulo(titulo).Criar();
result.Success.ShouldBeFalse();
result.Errors.Select(e => e.Code).ShouldContain(codigoEsperado);
}
[Fact]
public void Criar_ComPublicoInexistente_RetornaErro()
{
var result = new TrilhaTestBuilder().ComPublico((PublicoTrilha)99).Criar();
result.Errors.ShouldContain(TrilhaErrors.PublicoInvalido);
}
[Fact]
public void Criar_ComVariosCamposInvalidos_RetornaTodosOsErros()
{
var result = new TrilhaTestBuilder()
.ComTitulo("")
.ComDescricao(new string('d', Modules.Catalogo.Domain.Entities.Trilha.Trilha.DescricaoTamanhoMaximo + 1))
.ComFuncaoAlvo(new string('f', Modules.Catalogo.Domain.Entities.Trilha.Trilha.FuncaoAlvoTamanhoMaximo + 1))
.Criar();
result.Errors.Select(e => e.Code).ShouldBe(
["TRILHA_TITULO_VAZIO", "TRILHA_DESCRICAO_LONGA", "TRILHA_FUNCAO_ALVO_LONGA"],
ignoreOrder: true);
}
}
4. Assertions com Shouldly
// Sucesso — extraia o valor com TryGetValue
result.TryGetValue(out var trilha).ShouldBeTrue();
trilha.Titulo.Text.ShouldBe("Onboarding Automatiza"); // VO: compare pelo campo interno (Text)
trilha.Descricao.ShouldBeNull();
// Falha
result.Success.ShouldBeFalse();
result.Errors.ShouldContain(TrilhaErrors.PublicoInvalido); // Error é record: igualdade por valor
result.Errors.Select(e => e.Code).ShouldContain("TRILHA_TITULO_LONGO");
result.Errors.Count().ShouldBe(2); // Errors é IEnumerable<Error>
Use as constantes do domínio para limites (TituloTrilha.TamanhoMaximo + 1), nunca números mágicos.
5. Cenários obrigatórios a cobrir
Para cada agregado ou método de domínio, cubra:
- Caminho feliz — parâmetros válidos, retorna sucesso (e Id novo, quando cria).
- Falhas de invariante — cada campo obrigatório ausente/inválido, enum fora do intervalo.
- Casos de borda — limites (mínimo, máximo, máximo + 1), nulo, vazio, só espaços, normalização (
Trim). - Regras compostas — vários campos inválidos devolvem todos os erros de uma vez.
- Regras oficiais de pontuação, ranking e certificado (
AGENTS.md) — com os exemplos da arquitetura. Ex.: 90% na 2ª tentativa = 72 XP; nota 69,99% reprova e 70% aprova; só a primeira aprovação gera XP. Usedecimal. - Tempo — regra que depende de data recebe o instante como parâmetro (ou um
TimeProviderfalso); nunca dependa do relógio real. Períodos de ranking são calculados no horário de Brasília (America/Sao_Paulo): teste as viradas de semana/mês perto da meia-noite.
6. Regras obrigatórias
- Testes de domínio são independentes de infraestrutura — sem banco, sem DI, sem
DbContext. - Use o builder para montar o estado — não chame o factory com todos os parâmetros espalhados pelo teste.
- Um cenário por
[Fact]; variações do mesmo cenário em[Theory]+[InlineData]. - Nomes de teste:
{Metodo}_{Cenario}_{ResultadoEsperado}(ex.:Criar_ComTituloInvalido_RetornaErro). - Erro de negócio é
Result, nunca exceção: não useAssert.Throwspara regra de negócio.
Testes de integração (endpoint + banco) são outra coisa: ApplicationFactory em src/tests/Automatiza.WebApi.IntegrationTests/{Modulo}/. Regras gerais: AGENTS.md.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |