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.

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

ElementoRegra
CodeSCREAMING_SNAKE_CASE, prefixado pela entidade (TRILHA_TITULO_VAZIO) — único no domínio
Classe{Entidade}Errors estática
PropriedadeNome descritivo em PascalCase
MensagemPortuguê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çãoCódigo (ErrorPrefix = "TRILHA_TITULO")
Vazio/nulo (obrigatório)TRILHA_TITULO_VAZIO
Abaixo de MinLengthTRILHA_TITULO_CURTO
Acima de MaxLengthTRILHA_TITULO_LONGO
Fora do PatternTRILHA_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.

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