be-api-review

Run the audit against a router, handler, or controller file, or against the whole codebase when no argument is given. It checks HTTP method usage, expected status codes, URL patterns, exception mappings, and pagination, then reports each issue with severity and file:line location.

RouterFunction/HandlerFunction is the functional web style using ServerRequest and ServerResponse, while @RestController is the annotated style using @GetMapping and @RequestBody. The audit enforces one style per domain package based on the configured webLayer setting.

Yes, it scans both RouterFunction @Bean definitions and @RestController classes. It reads the webLayer value from the plugin config and flags mixed styles within the same domain package as warnings.

Without an .onErrorResume mapping or @ExceptionHandler, domain exceptions fall through to WebFlux's default error handling and surface as 500 Internal Server Error. The audit flags each unmapped domain exception as critical and suggests the correct status mapping.

Versioning is only flagged when the codebase already uses version segments like /v1/ inconsistently within a domain. If no route uses versioning at all, its absence is not flagged since there is no established convention to violate.