用途：在 Micronaut HTTP 应用中应用 REST 设计原则，用于设计、审查或改进 @Controller REST API，添加校验、错误处理，或让控制器与 OpenAPI 契约对齐。
主要能力：语义化 HTTP（@Get/@Post/@Put/@Patch/@Delete 与 HttpResponse 状态控制）；面向资源的路径与稳定 DTO 契约；请求体 @Valid 与 Bean Validation；集中式错误映射（ExceptionHandler，适用时使用 problem JSON）；基于 Pageable 且大小受限的分页；OpenAPI 契约文件（API-first）与 OpenAPI Generator 生成服务端桩；敏感路由的 @Secured 安全注解；重试写入的 Idempotency-Key；乐观并发的 ETag / If-Match；Cache-Control 规范；API 版本化模式；DTO 中的 ISO-8601 时间类型。
使用方式：先阅读 references/502-frameworks-micronaut-rest.md 并检查项目现状，再确定范围与最小安全改动集，按参考模式与项目约定实现或重构，最后运行构建与测试并汇报结果。约束：应用任何改动前必须运行 ./mvnw compile 或 mvn compile；编译失败立即停止；改进后运行 ./mvnw clean verify 或 mvn clean verify 验证。若请求范围不明确，先停止并提问；若缺少必要输入、文件或工具，报告缺失项并询问是否继续。
适用场景：审查或改进 Micronaut @Controller REST API；在 Micronaut HTTP 层添加校验、错误处理或对齐 OpenAPI 契约；设计控制器与 DTO 校验；添加异常处理器与 Problem Details 响应；改进分页过滤或 OpenAPI 对齐。
限制：具体规则与示例以参考文件为准；未提供收费、价格、平台或效果信息。