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.
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:
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
// 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:
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: 322k | 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: 322k | 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: 322k | Updated | Claude CodeCodex | Verified | Install |