Plugin REST
Controllers, DTOs et dérivation HTTP automatique.

@RestController
@RequestMapping("/api/orders")
@Tag(name = "Orders", description = "Order management operations")
public class OrderController {

    private final OrderUseCases orderUseCases;

    public OrderController(OrderUseCases orderUseCases) {
        this.orderUseCases = orderUseCases;
    }

    @PostMapping
    @Operation(summary = "Create order")
    public ResponseEntity<Object> createOrder(
            @Valid @RequestBody CreateOrderRequest request) {
        var result = orderUseCases.createOrder(request.customerId(), ...);
        return ResponseEntity.status(201).body(OrderResponse.from(result));
    }

    @GetMapping("/{id}")
    @Operation(summary = "Get order")
    public ResponseEntity<Object> getOrder(@PathVariable UUID id) {
        var result = orderUseCases.getOrder(OrderId.of(id));
        return ResponseEntity.ok(OrderResponse.from(result));
    }
}

// Request DTO : validation automatique depuis les types du domaine
public record CreateOrderRequest(
    @NotNull UUID customerId,
    @NotBlank String productName,
    @Positive int quantity
) {}

// Response DTO : factory from() pour la projection domaine → REST
public record OrderResponse(
    UUID id,
    UUID customerId,
    String productName,
    String status
) {
    public static OrderResponse from(Order source) {
        return new OrderResponse(
            source.getId().value(),
            source.getCustomerId().value(),
            source.getProductName(),
            source.getStatus().name());
    }
}

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(IllegalArgumentException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Map<String, Object> handleIllegalArgument(
            IllegalArgumentException ex) {
        return Map.of(
            "error", "BAD_REQUEST",
            "message", ex.getMessage(),
            "status", 400);
    }

    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public Map<String, Object> handleException(Exception ex) {
        return Map.of(
            "error", "INTERNAL_SERVER_ERROR",
            "message", ex.getMessage(),
            "status", 500);
    }
}

@Configuration
public class RestConfiguration {

    @Bean
    public OrderUseCases orderUseCases(OrderService orderService) {
        return orderService;
    }
}