Merge remote-tracking branch 'origin/dev' into dev

# Conflicts:
#	CLAUDE.md

Author: TrueNine

.augment/rules/all-convention.md

@@ -2,41 +2,50 @@
 type: "always_apply"
 ---
 
-**框架概述：** Compose Server 是现代化、模块化的 Kotlin 企业级开发框架（非脚手架），通过 Gradle 多模块提供企业级 SDK。所有模块可独立集成到任意 Spring Boot 或其他 JVM 项目中。
+**技术栈：** Kotlin 2.2.0, Spring Boot 3.5.4, Spring Framework 6.2.6, Jimmer 0.9.105, Gradle 9.0.0, Java 24, PostgreSQL, Redis, Caffeine, MinIO, LangChain4j。
 
-**技术栈：** Kotlin 2.2.0, Spring Boot 3.5.3, Spring Framework 6.2.6, Jimmer 0.9.101, Gradle 9.0.0-rc-4, Java 24, PostgreSQL, Redis, Caffeine, MinIO, LangChain4j。
+**项目特点：**
+
+- 现代化企业级Kotlin服务端框架库，已发布至Maven中央仓库
+- 15+核心模块的模块化设计，支持按需集成到现有项目
+- 采用LGPL 2.1开源协议
 
 ## 模块结构与导航
+
 **包格式：** `io.github.truenine.composeserver.{模块名}`
 
 **核心基础模块：**
+
 - `shared/` - 核心组件、工具类、异常处理、统一响应、分页、类型定义
 - `testtoolkit/` - 测试工具包、TestContainers集成
 - `version-catalog/` - 版本目录管理
 - `bom/` - 依赖管理清单
 - `gradle-plugin/` - Gradle插件和约定
 
 **业务能力模块：**
+
 - `cacheable/` - 多级缓存（Redis、Caffeine）
 - `ai/` - AI服务
-  - `ai:shared` - AI共享组件
-  - `ai:langchain4j` - LangChain4j集成
+  - `ai-shared` - AI共享组件
+  - `ai-langchain4j` - LangChain4j集成
 - `pay/` - 支付服务
-  - `pay:shared` - 支付共享组件
-  - `pay:wechat` - 微信支付V3
+  - `pay-shared` - 支付共享组件
+  - `pay-wechat` - 微信支付V3
 - `oss/` - 对象存储
-  - `oss:shared` - OSS共享组件
-  - `oss:minio` - MinIO集成
-  - `oss:aliyun-oss` - 阿里云OSS
-  - `oss:huawei-obs` - 华为云OBS
-  - `oss:volcengine-tos` - 火山引擎TOS
+  - `oss-shared` - OSS共享组件
+  - `oss-minio` - MinIO集成
+  - `oss-aliyun-oss` - 阿里云OSS
+  - `oss-huawei-obs` - 华为云OBS
+  - `oss-volcengine-tos` - 火山引擎TOS
 - `rds/` - 关系型数据库
-  - `rds:shared` - RDS共享组件
-  - `rds:crud` - CRUD操作
-  - `rds:jimmer-ext-postgres` - Jimmer PostgreSQL扩展
-  - `rds:flyway-migration-postgresql` - Flyway PostgreSQL迁移
+  - `rds-shared` - RDS共享组件
+  - `rds-crud` - CRUD操作
+  - `rds-jimmer-ext-postgres` - Jimmer PostgreSQL扩展
+  - `rds-flyway-migration-postgresql` - Flyway PostgreSQL迁移
+  - `rds-flyway-migration-mysql8` - Flyway MySQL8迁移
 
 **系统服务模块：**
+
 - `security/` - 安全服务
   - `security:spring` - Spring Security集成
   - `security:oauth2` - OAuth2支持
@@ -49,6 +58,7 @@ type: "always_apply"
   - `surveillance:hikvision` - 海康威视集成
 
 **数据处理模块：**
+
 - `data/` - 数据处理
   - `data:crawler` - 网络爬虫
   - `data:extract` - 数据提取
@@ -61,28 +71,48 @@ type: "always_apply"
   - `depend:xxl-job` - XXL-Job集成
 
 **代码生成模块：**
+
 - `ksp/` - Kotlin符号处理
   - `ksp:plugin` - KSP插件
   - `ksp:shared` - KSP共享组件
   - `ksp:meta` - 元数据定义
 
 **常用路径：**
+
 - 构建文件：`{模块}/build.gradle.kts`
 - 源码：`{模块}/src/main/kotlin/io/github/truenine/composeserver/{模块}/`
 - 测试：`{模块}/src/test/kotlin/`
 - 资源：`{模块}/src/main/resources/`
 
 ## 构建命令
+
+**基础构建：**
+
 - `./gradlew build` - 构建项目
 - `./gradlew clean` - 清理输出
 - `./gradlew publishToMavenLocal` - 本地发布
-- `./gradlew test` - 运行所有测试
-- `./gradlew :{模块}:test` - 模块特定测试
+- `./gradlew check` - 运行所有测试
+
+**模块化操作：**
+
+- `./gradlew :{模块}:check` - 模块特定测试
+- `./gradlew :{模块}:build` - 构建单个模块
+- `./gradlew :{模块}:publishToMavenLocal` - 本地发布单个模块
+
+**代码质量：**
+
 - `./gradlew spotlessApply` - 修复格式（提交前必须运行）
-- `./gradlew versionCatalogFormat` - 修复 `libs.versions.toml` 格式（提交前必须运行）
+- `./gradlew versionCatalogFormat` - 修复 `libs.versions.toml` 格式
+
+**性能优化配置：**
+
+- JVM配置：`-Xmx4g -XX:MaxMetaspaceSize=1g -XX:+UseG1GC`
+- 启用并行构建、缓存、配置缓存
 
 ## 构建约定与插件
+
 **build-logic 约定插件体系：**
+
 - `buildlogic.jacoco-conventions` - 代码覆盖率约定
 - `buildlogic.java-conventions` - Java约定
 - `buildlogic.javaspring-conventions` - Java Spring约定
@@ -91,42 +121,66 @@ type: "always_apply"
 - `buildlogic.publish-conventions` - 发布约定
 - `buildlogic.repositories-conventions` - 仓库约定
 - `buildlogic.spotless-conventions` - 代码格式化约定
+- `buildlogic.spotless-sql-conventions` - SQL 代码格式化约定
 
 ## 开发标准
+
+**依赖和构建：**
+
 - **依赖管理：** Gradle Version Catalog (`gradle/libs.versions.toml`) 统一版本管理
 - **插件约定：** 所有Kotlin模块使用 `kotlinspring-conventions`，Java模块使用相应约定
 - **代码格式：** Spotless自动化格式检查（提交前必须运行 `./gradlew spotlessApply`）
-- **测试规范：** 测试类与被测试类同名，使用@Nested组织测试，禁用@DisplayName注解
-- **模块集成：** `implementation("io.github.truenine:composeserver-{模块}:0.0.10")`
-- **Java版本：** 支持Java 24最新特性，无向下兼容，积极使用新特性
-- **Kotlin约定：** 优先使用val、避免!!操作符、积极使用lambda和新特性
-
-## 框架特定开发指导
-
-**Spring Boot 3.x 约定：**
-- 使用 `@Resource` 替代 `@Autowired` 进行依赖注入
-- 配置类使用 `@EnableConfigurationProperties` 启用属性绑定
-- 自动配置类命名为 `AutoConfigEntrance` 并使用 `@ComponentScan`
-- 异常处理使用统一的 `ErrorResponseEntity` 响应格式
-- 日志记录使用 `slf4j(ClassName::class)` 获取logger实例
-
-**Jimmer ORM 约定：**
-- 实体类使用 `@Entity` 注解，遵循 Jimmer 规范
-- 查询使用 KSP 生成的类型安全查询 API
-- 分页查询统一使用 `fetchPq()` 扩展函数
-- 数据库函数扩展放在对应的 `*Fns.kt` 文件中
-- 使用 `View` 接口定义 DTO 投影，通过 `toFetcher()` 获取 Fetcher
-
-**Kotlin 2.2.0 特性使用：**
-- 积极使用 `data class` 替代多参数函数
-- 扩展函数命名使用动词形式，如 `hasText()`, `isNotEmptyRun()`
-- 使用 `@OptIn(ExperimentalContracts::class)` 启用契约功能
-- 运算符重载使用 `infix` 函数，如 `Pair.and()`
-- 字符串模板优先使用 `${}` 语法
-
-**测试框架约定：**
-- 使用 TestContainers 进行集成测试
-- 测试方法命名使用反引号中文描述：`fun \`测试用户创建成功\`()`
-- 使用 `@Nested inner class` 组织测试场景
-- 测试日志使用 `testtoolkit.log` 实例
-- Mock 对象使用 `every { } returns` 语法
+- **版本发布：** 发布至Maven中央仓库 `io.github.truenine:composeserver-*`
+
+**测试规范：**
+
+- 测试类与被测试类同名，使用@Nested组织测试
+- 禁用@DisplayName注解，使用反引号中文方法名
+- TestContainers集成测试支持 PostgreSQL/MySQL/Redis/MinIO
+- 测试组织：正常用例、异常用例、边界用例分组
+
+**架构约定：**
+
+- 包命名：`io.github.truenine.composeserver.{模块名}`
+- 自动配置：Spring Boot AutoConfiguration + @ConditionalOn* 条件化配置
+- 资源管理：ResourceHolder统一管理配置文件和静态资源
+
+## 架构特点
+
+**模块化设计：**
+
+- 每个模块独立打包发布到Maven中央仓库，支持按需集成
+- build-logic 约定插件统一管理构建配置和代码质量标准
+
+**测试架构：**
+
+- TestContainers集成测试：PostgreSQL、MySQL、Redis、MinIO容器化测试
+- @Nested内部类组织测试场景：正常用例、异常用例、边界用例
+- 测试幂等性验证：数据库迁移和存储过程多次执行安全性保证
+
+**自动配置体系：**
+
+- Spring Boot AutoConfiguration自动装配各模块功能
+- 条件化配置：通过Properties类和@ConditionalOn*注解控制组件启用
+- 资源管理：ResourceHolder统一管理配置文件和静态资源加载
+
+## 重要开发指南
+
+**构建环境要求：**
+
+- Java 24+
+- Kotlin 2.2.0
+- Gradle 9.x（使用included builds和版本目录管理）
+
+**开发流程：**
+
+1. 提交前必须运行 `./gradlew spotlessApply` 修复代码格式
+2. 确保所有测试通过 `./gradlew check`
+3. 使用@Nested组织测试，禁用@DisplayName，采用反引号中文方法名
+4. 新模块需在 `settings.gradle.kts` 中声明并应用相应的构建约定
+
+**版本管理：**
+
+- 依赖版本统一在 `gradle/libs.versions.toml` 中管理
+- 使用 `./gradlew versionCatalogUpdate` 检查依赖更新
+- 版本发布通过Maven中央仓库，命名规则：`io.github.truenine:composeserver-{模块名}`

.augment/rules/global-convention.md

@@ -6,19 +6,22 @@ type: "always_apply"
 
 **强制规则**
 
-1. 始终使用**简体中文**回复，即使用户输入大量英文提示，也应返回简体中文
-2. 禁止编写任何供用户使用的示例代码，即使需要临时测试，任务完成后也必须立即删除
-3. 严禁通过简化问题来解决问题
-4. 严禁通过降级依赖版本来解决问题
-5. 严禁通过减少测试断言来解决问题
-6. 严禁忽略异常或任何隐藏异常的行为
-7. 应当积极按照规则来重构修复上下文中出现的代码
-8. 严禁在代码中暴露 API 密钥、密码和令牌
-9. 应积极使用日志完善记录，主动补充缺失的日志
-10. 允许在单元测试调试期间添加日志以协助解决问题
-11. 必须最大化使用 `early return` 技术来减少代码嵌套层级
-12. 严禁在对话或任务完成后生成总结文档文件和其他不必要的操作
-13. 严禁出现 `util`,`utils`,`tool` 等的让我恶心的命名方式以及命名空间
+1.
+在开始实现任何功能之前，请将任务拆解为更小的模块，并逐步编写代码。每写一小部分代码后，务必进行单元测试验证，确保其正确性和稳定性。即使用户给出的需求很复杂，也请始终保持渐进式开发，逐步完成，并通过测试及时发现并解决问题。避免一次性编写大量代码，以便尽早识别潜在的错误和问题。保持代码的高质量和稳定性，逐步积累完成整个任务。
+2. 始终使用**简体中文**回复，即使用户输入大量英文提示，也应返回简体中文
+3. 禁止编写任何供用户使用的示例代码，即使需要临时测试，任务完成后也必须立即删除
+4. 严禁通过简化问题来解决问题
+5. 严禁通过降级依赖版本来解决问题
+6. 严禁通过减少测试断言来解决问题
+7. 严禁忽略异常或任何隐藏异常的行为
+8. 应当积极按照规则来重构修复上下文中出现的代码
+9. 严禁在代码中暴露 API 密钥、密码和令牌
+10. 应积极使用日志完善记录，主动补充缺失的日志
+11. 允许在单元测试调试期间添加日志以协助解决问题
+12. 必须最大化使用 `early return` 技术来减少代码嵌套层级
+13. 严禁在对话或任务完成后生成总结文档文件和其他不必要的操作
+14. 严禁出现 `util`,`utils`,`tool` 等的让我恶心的命名方式以及命名空间
+15. 严禁使用 `@Suppress` 注解压制警告
 
 **输出规则**
 
@@ -87,96 +90,3 @@ type: "always_apply"
 **SCSS 标准**
 
 - 禁止使用 `@import`，使用 `@use` 代替
-
-# Git 提交规范
-
-## 提交消息格式
-
-**基本格式：** `emoji [scope] description`
-
-- **emoji**: 表示变更类型的表情符号
-- **scope**: 影响范围（模块名称），使用方括号包围
-- **description**: 简洁的变更描述
-
-**复杂变更格式：** 当单次提交包含多个变更时，使用列表格式
-
-## 表情符号规范
-
-| 表情符号 | 类型        | 描述       | 使用场景               |
-|------|-----------|----------|--------------------|
-| 🎉   | feat      | 重大功能/初始化 | 新功能、重大更新、项目初始化     |
-| ✨    | feat      | 新功能/增强   | 添加功能、增强、文档更新       |
-| 🐛   | fix       | Bug 修复   | 修复错误、解决问题          |
-| 🔧   | config    | 配置修改     | 配置文件、CI/CD、构建配置    |
-| 📝   | docs      | 文档更新     | 更新文档、README、注释     |
-| 🎨   | style     | 代码风格/格式化 | 代码格式化、样式、结构优化      |
-| ♻️   | refactor  | 重构       | 代码重构、包结构调整         |
-| ⚡    | perf      | 性能优化     | 性能优化、算法改进          |
-| 🔥   | remove    | 删除代码/文件  | 删除无用代码、移除功能        |
-| 🧪   | test      | 测试相关     | 添加测试、修复测试、测试配置     |
-| 👷   | ci        | CI/CD    | 持续集成、构建脚本          |
-| 📦   | build     | 构建系统     | 依赖管理、构建配置          |
-| ⬆️   | upgrade   | 升级依赖     | 升级库版本              |
-| ⬇️   | downgrade | 降级依赖     | 降级库版本              |
-| 🚀   | release   | 发布版本     | 版本发布、标签创建          |
-| 🔀   | merge     | 合并分支     | 分支合并、冲突解决          |
-| 🤖   | ai        | AI 工具配置  | AI 助手配置、自动化        |
-| 💄   | optimize  | 优化       | 性能优化、代码改进          |
-| 🌐   | network   | 网络相关     | 网络配置、API 调用、远程服务   |
-| 🔐   | security  | 安全/验证    | 安全修复、权限控制、验证       |
-| 🚑   | hotfix    | 紧急修复     | 紧急修复、临时解决方案        |
-| 📈   | analytics | 分析/监控    | 性能监控、数据分析          |
-| 🍱   | assets    | 资源文件     | 图片、字体、静态资源         |
-| 🚨   | lint      | 代码检查     | 修复 linting 警告、代码质量 |
-| 💡   | comment   | 注释       | 添加/更新注释、文档字符串      |
-| 🔊   | log       | 日志       | 添加日志、调试信息          |
-| 🔇   | log       | 移除日志     | 删除日志、静默输出          |
-
-## 提交示例
-
-### 简单格式示例
-
-```bash
-✨ [shared] 添加统一异常处理
-
-🐛 [rds] 修复连接池配置问题
-
-♻️ [security] 重构JWT验证逻辑
-```
-
-### 复杂格式示例
-
-```bash
-✨ [ai] LangChain4j集成优化
-
-- 🚑 修复模型加载超时问题
-- 🐛 解决依赖冲突问题
-- 💄 优化AI服务性能
-- 🧪 补充集成测试用例
-```
-
-## 提交规范要求
-
-1. **必须使用表情符号**: 每个提交消息必须以对应的表情符号开头
-2. **明确作用域**: 使用方括号明确标识影响的模块或组件
-3. **描述简洁明了**: 使用动词开头，简洁描述变更内容
-4. **单一职责**: 每个提交应专注于单一变更类型
-5. **中文描述**: 提交描述使用中文，便于团队理解
-
-
-# Code Practices
-- 永远不要在测试代码以外的任何地方编写 mock 代码，可以使用 todo 标记但不能实现半成品
-- 永远不要隐藏异常要向外抛出
-- 重用项目已有代码
-- 不要行尾注释
-- 日志不用表情符号
-- 多划分任务增量完成
-- `log.info` 等等的方法，在 kotlin 当中禁止使用字符串模板直接进行插值，而是使用 `{}` 占位符
-- slf4j 的日志格式应当是：a: {} , b: {} 而不是 a={},b={}，即冒号后有空格，逗号后有空格
-
-# Problem Solving
-- 遇到不懂的API错误时应该使用工具查询文档而不是主动尝试，永远不要简化问题来完成任务，要尊重事实
-- 不能通过 try catch 这种自欺欺人的方式来隐藏第三方错误，应该积极暴露错误而非隐藏错误，这是绝不允许的。
-
-# Thinking
-- 英文思考中文总结