Under-Utils 使用文档

文档站聚焦接入、配置、失败语义、资源边界和维护约束。当前收录 24 份仓库 Markdown，构建时从 README、docs 和模块 README 自动生成索引。

Under-Utils 是一组面向 Java 21 / Spring Boot 项目的工程模式工具包，用来沉淀业务系统里反复出现、实现细节多、容易写散的基础设施代码。

快速开始

当前稳定版本为 1.0.2，主分支处于 1.0.3-SNAPSHOT 开发周期。普通 Spring Boot 服务优先从轻量 starter 开始。

under:
  utils:
    web:
      operation-context:
        enabled: true
        task-decorator-enabled: true
      rate-limit:
        enabled: true
        store: local
      repeat-submit:
        enabled: true
        store: local

项目边界

适合进入本项目的能力，应有清晰复用边界，并能封装足够多的重复复杂度。JDK、Spring、Hutool、Apache Commons、Guava 已成熟覆盖的小工具方法不作为新增方向。

模块文档

兼容性

public API 范围包括 Maven 坐标、public/protected Java API、注解属性、`under.utils.*` 配置 key、starter 自动装配 Bean、SPI 接口和已文档化的失败语义。

API Review

API Review 用于持续收敛命名、配置 key、异常语义和模块边界。API 文档中的 deprecated 状态需要和审计结论互链。

工程成熟度

成熟度清单覆盖生命周期结束、缓存指标、Bug 回归测试、CHANGELOG 可追溯性和 API 兼容性门禁。

发布指南

发布流程面向 Maven Central Portal，默认跳过上传以避免误发布。真正 release 前需要完成测试、release profile、签名和 Central Portal 校验。

文档源

以下页面直接由仓库 Markdown 渲染，保留代码块、表格和标题锚点，避免前台文案与工程文档分叉。