Skip to content

biellts/universidade-automatiza / .claude/skills/backend-criar-erro-dominio

backend-criar-erro-dominio

Verified

Cria erros de domínio tipados para um agregado ou feature. Use este skill quando solicitado a criar novos erros de domínio, códigos de erro, Error records ou mensagens de validação de negócio.

FileKindSize
SKILL.mdskill md3.5 KB
---
name: backend-criar-erro-dominio
description: Cria erros de domínio tipados para um agregado ou feature. Use este skill quando solicitado a criar novos erros de domínio, códigos de erro, Error records ou mensagens de validação de negócio.
---

Para criar erros de domínio neste projeto, siga o processo abaixo:

## 1. Localização

Crie o arquivo em:
```
src/apps/Automatiza.Modules.{Modulo}/Domain/Entities/{Entidade}/Errors/{Entidade}Errors.cs
```
Namespace: `Automatiza.Modules.{Modulo}.Domain.Entities.{Entidade}` — `Errors/` não entra no namespace. Os exemplos usam o módulo Catálogo.

## 2. Estrutura da classe de erros

Classe real `TrilhaErrors`:

```csharp
namespace Automatiza.Modules.Catalogo.Domain.Entities.Trilha;

public static class TrilhaErrors
{
    public static Error TrilhaNaoEncontrada => new("TRILHA_NAO_ENCONTRADA", "Trilha {0} não encontrada.");
    public static Error PublicoInvalido => new("TRILHA_PUBLICO_INVALIDO", "Público da trilha inválido. Use Colaborador ou Cliente.");
    public static Error DescricaoMuitoLonga => new("TRILHA_DESCRICAO_LONGA", "Descrição da trilha não pode exceder {0} caracteres.");
    public static Error FuncaoAlvoMuitoLonga => new("TRILHA_FUNCAO_ALVO_LONGA", "Função-alvo da trilha não pode exceder {0} caracteres.");
}
```

`Error` é um `record(string Code, string Message)` em `Automatiza.SeedWork.DomainObjects`; por ser record, dois erros com o mesmo código e mensagem são iguais (útil em `ShouldContain`).

## 3. Convenções de nomenclatura

| Elemento | Regra |
|---|---|
| Code | `SCREAMING_SNAKE_CASE`, **prefixado pela entidade** (`TRILHA_TITULO_VAZIO`) — único no domínio |
| Classe | `{Entidade}Errors` estática |
| Propriedade | Nome descritivo em PascalCase |
| Mensagem | Português, clara e específica; placeholders `{0}`, `{1}` para valores dinâmicos |

## 4. Uso nos agregados, VOs e handlers

```csharp
// Retorno direto (conversão implícita Error → Result<T>)
if (!Enum.IsDefined(publico))
    erros.Add(TrilhaErrors.PublicoInvalido);

// Com formatação de parâmetro (Error.Format devolve um novo Error)
erros.Add(TrilhaErrors.DescricaoMuitoLonga.Format(DescricaoTamanhoMaximo.ToString()));

// No QueryHandler, quando o registro não existe
if (trilha is null)
    return TrilhaErrors.TrilhaNaoEncontrada.Format(request.Id.ToString());
```

## 5. Erros gerados pelo `TextValueObject`

VOs de texto que herdam `TextValueObject` geram os códigos a partir do `ErrorPrefix` das `Options` — não os declare de novo na classe de erros:

| Situação | Código (`ErrorPrefix = "TRILHA_TITULO"`) |
|---|---|
| Vazio/nulo (obrigatório) | `TRILHA_TITULO_VAZIO` |
| Abaixo de `MinLength` | `TRILHA_TITULO_CURTO` |
| Acima de `MaxLength` | `TRILHA_TITULO_LONGO` |
| Fora do `Pattern` | `TRILHA_TITULO_FORMATO_INVALIDO` |

## 6. Erros gerais reutilizáveis

`Automatiza.SeedWork.Validations.GeneralErrors` tem erros genéricos (`RegistroNaoEncontrado`, `OperacaoNaoPermitida`, `ValorInformadoParaCampoEhInvalido` etc.). Prefira o erro da entidade, com o prefixo dela; use o geral só quando não houver entidade dona, e então ajuste a mensagem com `with { Message = "..." }`.

## 7. Erros agrupados por contexto

Para entidades com muitos erros, organize em classes aninhadas, mantendo o prefixo da entidade no código:

```csharp
public static class {Entidade}Errors
{
    public static class {Contexto}
    {
        public static Error {Erro} => new("{ENTIDADE}_{CONTEXTO}_{ERRO}", "Mensagem em português.");
    }
}
```

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