Skip to content

biellts/universidade-automatiza / .claude/skills/backend-criar-teste-unitario

backend-criar-teste-unitario

Verified

Cria 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:

  1. Caminho feliz — parâmetros válidos, retorna sucesso (e Id novo, quando cria).
  2. Falhas de invariante — cada campo obrigatório ausente/inválido, enum fora do intervalo.
  3. Casos de borda — limites (mínimo, máximo, máximo + 1), nulo, vazio, só espaços, normalização (Trim).
  4. Regras compostas — vários campos inválidos devolvem todos os erros de uma vez.
  5. 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. Use decimal.
  6. Tempo — regra que depende de data recebe o instante como parâmetro (ou um TimeProvider falso); 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 use Assert.Throws para 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.

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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall