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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.7 KB |
SKILL.md
View on GitHub---
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`.
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: 323k | 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: 323k | 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: 323k | Updated | Claude CodeCodex | Verified | Install |