biellts/universidade-automatiza / .claude/skills/backend-criar-erro-dominio
backend-criar-erro-dominio
VerifiedCria 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
SKILL.md
View on GitHub---
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`.
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 |