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.

FileKindSize
SKILL.mdskill md6.7 KB
---
name: backend-criar-teste-unitario
description: 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`):

```csharp
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`):

```csharp
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

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