Erros de domínio como Result, não como exceções. O domínio devolve um Error; o ASP.NET Core mapeia isso para Problem Details (RFC 7807). As mensagens ficam em catálogos JSON, não em C#.
| Página | O que cobre |
|---|---|
| Primeiros passos | Instalar, registrar e devolver a primeira resposta Problem Details |
| Conceitos | Error, ErrorKind, Result, erro primário, catálogos, escape hatch |
| Guia de domínio | Escrever código de domínio com Result<T>: factories, Custom, Bind/Map/Combine |
| Guia ASP.NET Core | ToHttpResult / ToActionResult, escolha do status, formato da resposta, tratamento de 500 |
| Mensagens e culturas | Formato do catálogo, fallback de cultura, interpolação de {token} |
| CLI | offside init — skills de agente e templates de catálogo |
| Referência de API | Todos os tipos e membros públicos, em uma página |
| FAQ | Decisões de design e armadilhas comuns |
// Domínio — não sabe nada sobre HTTP
public Result<Order> Get(string id)
{
var order = _orders.Find(id);
return order is null
? Result<Order>.Failure(Error.NotFound("order", id))
: Result<Order>.Success(order);
}
// Endpoint — uma linha
app.MapGet("/orders/{id}", (string id, HttpContext http) => _orders.Get(id).ToHttpResult(http));
// Resposta — 404, application/problem+json
{
"type": "https://httpstatuses.io/404",
"title": "NotFound",
"status": 404,
"detail": "order '42' was not found.",
"traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
"errors": [
{ "code": "not_found", "kind": "NotFound", "detail": "order '42' was not found.", "field": null }
]
}
| Pacote | Target frameworks | Papel |
|---|---|---|
Offside |
netstandard2.0, net8.0, net10.0 |
Error, ErrorKind, Result / Result<T>, resolver JSON, AddOffside |
Offside.AspNetCore |
net8.0, net10.0 |
ToHttpResult / ToActionResult, Problem Details, AddOffsideAspNetCore |
Offside.Tool |
net8.0 |
offside init — skills de agente e templates de catálogo |
O pacote core não tem dependência de ASP.NET, então projetos de domínio podem referenciá-lo livremente.