Borda HTTP e erros

Sequência de responsabilidades entre entrada, regra e adaptação HTTP.

A fronteira HTTP preserva a regra e o erro: o handler traduz HTTP para dados de entrada e converte erros conhecidos em respostas; a regra de negócio não depende de status HTTP, bibliotecas de transporte ou detalhes do banco.

Use os controles do diagrama para comparar as composições e seguir as relações.

Sequência: entrada, decisão e falha segura

Participantes
Cliente HTTP        (entrada externa)
Handler              (valida e traduz)
Checkout              (regra de negócio)
OrderSaver            (porta de saída)
Observabilidade       (log seguro)
ENTRADA
Cliente HTTP  → Handler       POST /orders + JSON
DECISÃO
Handler       → Checkout      Place(ctx, pedido validado)
Checkout      → OrderSaver    Save(ctx, pedido)
FALHA SEGURA
OrderSaver    → Checkout      erro interno            (retorno)
Checkout      → Handler       erro da regra            (retorno)
Handler       → Observabilidade  registra contexto seguro
Handler       → Cliente HTTP  500 + mensagem genérica