Add @Operation annotation to reorderItems() clarifying that itemIds must contain ALL item IDs for the journey in the desired order — a partial list returns 400 Bad Request. This surfaces the contract in the generated OpenAPI spec and Swagger UI. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>