@Operation(summary = "Cria um novo item",
    description = "Cria um item a partir de nome e descrição")
@ApiResponses({
  @ApiResponse(responseCode = "201",
      description = "Item criado com sucesso"),
  @ApiResponse(responseCode = "400",
      description = "Dados inválidos")
})
@PostMapping
public ResponseEntity<ItemResponse> create(
    @Valid @RequestBody CreateItemRequest request) { ... }

### Fluxo de Checkout
1. API Gateway recebe o pedido do carrinho.
2. CheckoutService valida itens e preços.
3. InventoryService reserva estoque
   (timeout 2s, retry 1x).
4. ShippingService calcula o frete
   (fallback: tabela padrão).
5. PaymentGateway autoriza o pagamento
   (idempotency key).
6. OrderService confirma o pedido e
   publica o evento OrderCreated.
7. Falha em qualquer etapa aciona
   compensação (padrão saga).

@Test
void deveLancarItemNotFoundExceptionQuandoIdNaoExiste() {
  UUID id = UUID.randomUUID();
  when(itemRepository.existsById(id))
      .thenReturn(false);

  assertThatThrownBy(() ->
      itemService.deleteById(id))
    .isInstanceOf(ItemNotFoundException.class);

  verify(itemRepository, never())
      .deleteById(id);
}