ai-engineering-init 1.2.3 → 1.2.4

package/.cursor/skills/leniu-code-patterns/SKILL.md

@@ -10,8 +10,7 @@ description: |
   - 避免过度工程
   - 代码风格检查
 
-  触发词：规范、禁止、命名、Git提交、代码风格、不能用、不允许、包名、架构、leniu、pigx
-  注意：leniu CRUD 开发规范请激活 leniu-crud-development，API 开发规范请激活 leniu-api-development。
+  触发词：代码禁令、代码规范、命名规范、代码风格、Git提交规范、包结构、禁止写法、审计字段规范、delFlag、crby/crtime
 ---
 
 # leniu-tengyun-core 代码规范速查
@@ -348,6 +347,53 @@ Target target = BeanUtil.copyProperties(source, Target.class);
 List<Target> targets = BeanUtil.copyToList(sources, Target.class);
 ```
 
+## 包结构规范
+
+```
+net.xnzn.core
+├── [module]/
+│   ├── controller/         # 控制器层（按端分：web/mobile/android）
+│   ├── business/impl/      # 业务编排层
+│   ├── service/impl/       # 服务层
+│   ├── mapper/             # 数据访问层（含 XML 同目录）
+│   ├── model/              # 数据模型（Entity）
+│   ├── vo/                 # 视图对象（返回前端）
+│   ├── dto/                # 数据传输对象（服务间/MQ）
+│   ├── param/              # 请求参数对象
+│   ├── constants/          # 常量和枚举
+│   ├── config/             # 配置类
+│   ├── mq/                 # 消息队列监听器
+│   ├── task/               # 定时任务
+│   ├── handle/             # 业务处理器（策略模式）
+│   └── util/               # 工具类
+```
+
+## 依赖注入规范
+
+```java
+// 推荐：字段注入
+@Autowired
+private OrderService orderService;
+
+// 解决循环依赖
+@Resource
+@Lazy
+private ProductService productService;
+```
+
+## 类注释规范
+
+```java
+/**
+ * 类功能描述
+ *
+ * @author xujiajun
+ * @date 2026-02-20
+ */
+public class OrderService {
+}
+```
+
 ## 通用代码规范
 
 无论使用哪种项目架构，以下规范都是通用的：

package/.cursor/skills/leniu-crud-development/SKILL.md

@@ -17,7 +17,7 @@ description: |
   - leniu-tengyun-core（云食堂核心服务）
   - leniu-yunshitang（云食堂业务服务）
 
-  触发词：leniu-CRUD、leniu-增删改查、leniu-新建模块、leniu-Entity、leniu-DTO、leniu-VO、leniu-Service、leniu-Mapper、leniu-Controller、leniu-分页查询、LeRequest、PageDTO、net.xnzn、leniu-yunshitang、云食堂CRUD、leniu-事务、leniu-并发、leniu-代码质量、leniu-空指针、leniu-ServiceImpl
+  触发词：CRUD、增删改查、新建模块、Business层、Service、Mapper、Controller、分页查询、LeRequest、PageDTO、PageVO、事务管理
 ---
 
 # leniu CRUD 开发规范

package/.cursor/skills/leniu-data-permission/SKILL.md

@@ -1,3 +1,18 @@
+---
+name: leniu-data-permission
+description: |
+  leniu-tengyun-core 项目多租户数据权限控制规范。基于物理数据库隔离的双库架构，包含数据源切换、租户上下文、跨租户操作。
+
+  触发场景：
+  - 使用 @UseSystem 切换系统库操作
+  - 使用 Executors.doInTenant/readInTenant 跨租户查询
+  - 使用 TenantContextHolder 获取租户上下文
+  - 配置双库数据源路由
+  - 跨租户数据初始化
+
+  触发词：多租户、数据权限、@UseSystem、Executors.doInTenant、readInSystem、TenantContextHolder、MERCHANT-ID、双库隔离、数据源切换
+---
+
 # leniu-data-permission
 
 适用于 leniu-tengyun-core 项目的多租户数据权限控制。

package/.cursor/skills/leniu-database-ops/SKILL.md

@@ -12,7 +12,7 @@ description: |
 
   适用项目：leniu-tengyun-core（云食堂项目）
 
-  触发词：leniu-数据库、leniu-SQL、leniu-建表、leniu-Entity、leniu-双库、leniu-商户库、leniu-系统库、net.xnzn、leniu-yunshitang、云食堂数据库
+  触发词：数据库、SQL、建表、双库、商户库、系统库、审计字段、crby、crtime、del_flag
 ---
 
 # leniu-yunshitang-core 数据库操作规范

package/.cursor/skills/leniu-error-handler/SKILL.md

@@ -13,7 +13,7 @@ description: |
 
   适用项目：leniu-tengyun-core（云食堂项目）
 
-  触发词：leniu-异常、leniu-LeException、leniu-throw、leniu-错误处理、leniu-全局异常、leniu-@Validated、leniu-参数校验、leniu-日志、leniu-log、leniu-错误码、leniu-事务、leniu-I18n、net.xnzn、leniu-yunshitang、云食堂异常
+  触发词：异常处理、LeException、全局异常、参数校验、错误码、I18n、国际化、throw
 ---
 
 # leniu-yunshitang-core 异常处理指南

package/.cursor/skills/leniu-java-amount-handling/SKILL.md

@@ -9,7 +9,7 @@ description: |
   - Excel 导出含金额列，需分转元
   - 报表合计查询含金额汇总
 
-  触发词：金额、分转元、元转分、Long 金额、money、fen、cents、金额字段、金额处理、AmountConverter、AmountUtil
+  触发词：金额处理、分转元、元转分、Long金额、money、fen、BigDecimal金额、金额字段
 ---
 
 # leniu-tengyun-core 金额处理规范

package/.cursor/skills/leniu-java-concurrent/SKILL.md

@@ -13,7 +13,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：并发、CompletableFuture、线程池、ThreadPool、并发安全、锁、synchronized、volatile、原子类、异步处理、leniu并发、leniu-yunshitang并发、net.xnzn并发
+  触发词：并发、CompletableFuture、线程池、ThreadPool、并发安全、异步处理、synchronized
 ---
 
 # leniu-tengyun-core 并发处理规范

package/.cursor/skills/leniu-java-entity/SKILL.md

@@ -10,7 +10,7 @@ description: |
   - 配置时间格式化和参数校验
   - 使用 Jakarta Validation 注解
 
-  触发词：Entity、VO、DTO、Param、实体类、@TableName、@TableField、@JsonFormat、字段映射、数据对象、@NotNull、@NotBlank、jakarta.validation
+  触发词：Entity实体类、VO视图对象、DTO数据传输、Param参数类、@TableName、@TableField、审计字段、字段映射
 ---
 
 # leniu-tengyun-core Entity/VO/DTO 规范

package/.cursor/skills/leniu-java-export/SKILL.md

@@ -13,7 +13,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：导出、Export、Excel导出、异步导出、分页导出、@ExcelProperty、exportApi、数据导出、导出接口、leniu导出、leniu-yunshitang导出、net.xnzn导出
+  触发词：导出、Excel导出、异步导出、分页导出、@ExcelProperty、exportApi、数据导出
 ---
 
 # leniu-tengyun-core 数据导出规范
@@ -251,29 +251,30 @@ public PageVO<XxxVO> pageList(XxxPageParam param) {
 ### 带合计行的导出
 
 ```java
+// ⚠️ 系统默认在商户库执行，业务查询无需 Executors.readInSystem()
+// Executors.readInSystem() 仅用于需要访问系统库的场景（如全局配置、商户管理）
+
 public ReportBaseTotalVO<XxxVO> pageWithTotal(XxxPageParam param) {
-    return Executors.readInSystem(() -> {
-        ReportBaseTotalVO<XxxVO> result = new ReportBaseTotalVO<>();
-
-        // 1. 导出时不查询合计行（避免不必要的性能开销）
-        if (CollUtil.isEmpty(param.getExportCols())) {
-            XxxVO totalLine = mapper.getSummaryTotal(param);
-            result.setTotalLine(totalLine);
-        }
-
-        // 2. 导出时不分页
-        if (CollUtil.isNotEmpty(param.getExportCols())) {
-            List<XxxVO> list = mapper.getSummaryList(param);
-            result.setResultPage(PageVO.of(list));
-        } else {
-            // 正常分页查询
-            PageMethod.startPage(param);
-            List<XxxVO> list = mapper.getSummaryList(param);
-            result.setResultPage(PageVO.of(list));
-        }
-
-        return result;
-    });
+    ReportBaseTotalVO<XxxVO> result = new ReportBaseTotalVO<>();
+
+    // 1. 导出时不查询合计行（避免不必要的性能开销）
+    if (CollUtil.isEmpty(param.getExportCols())) {
+        XxxVO totalLine = mapper.getSummaryTotal(param);
+        result.setTotalLine(totalLine);
+    }
+
+    // 2. 导出时不分页
+    if (CollUtil.isNotEmpty(param.getExportCols())) {
+        List<XxxVO> list = mapper.getSummaryList(param);
+        result.setResultPage(PageVO.of(list));
+    } else {
+        // 正常分页查询
+        PageMethod.startPage(param);
+        List<XxxVO> list = mapper.getSummaryList(param);
+        result.setResultPage(PageVO.of(list));
+    }
+
+    return result;
 }
 ```
 

package/.cursor/skills/leniu-java-logging/SKILL.md

@@ -10,7 +10,7 @@ description: |
   - 业务关键路径日志埋点
   - 日志文件管理和保留策略
 
-  触发词：日志、@Slf4j、log.info、log.error、log.debug、log.warn、日志级别、日志格式、日志记录、logging、logback、leniu-yunshitang、leniu-tengyun-core、net.xnzn
+  触发词：日志、@Slf4j、log.info、log.error、log.debug、日志级别、logback、日志格式
 ---
 
 # leniu-tengyun-core / leniu-yunshitang 日志规范

package/.cursor/skills/leniu-java-mq/SKILL.md

@@ -13,7 +13,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：leniu-消息队列、leniu-MQ、leniu-MqUtil、leniu-@MqConsumer、leniu-延迟消息、leniu-消息重试、leniu-事务消息、net.xnzn、leniu-yunshitang
+  触发词：消息队列、MQ、MqUtil、@MqConsumer、延迟消息、消息重试、事务消息
 ---
 
 # leniu-tengyun-core 消息队列规范

package/.cursor/skills/leniu-java-mybatis/SKILL.md

@@ -10,7 +10,7 @@ description: |
   - 使用 MyBatis Plus 分页查询
   - 处理租户隔离（@InterceptorIgnore）
 
-  触发词：MyBatis、MyBatisPlus、Mapper、LambdaQueryWrapper、LambdaQuery、XML映射、动态SQL、selectPage、BaseMapper、@Select、resultMap、租户隔离、delFlag
+  触发词：MyBatis、MyBatisPlus、Mapper、LambdaQueryWrapper、XML映射、动态SQL、BaseMapper、@Select、resultMap
 ---
 
 # leniu-tengyun-core MyBatis 规范

package/.cursor/skills/leniu-java-report-query-param/SKILL.md

@@ -13,7 +13,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：leniu-报表查询、leniu-Param类、leniu-查询入参、leniu-分页参数、leniu-时间范围、leniu-ReportBaseParam、leniu-exportCols、net.xnzn、leniu-yunshitang
+  触发词：报表查询入参、Param类、分页参数、时间范围查询、ReportBaseParam、exportCols
 ---
 
 # leniu-tengyun-core 报表查询入参规范

package/.cursor/skills/leniu-java-task/SKILL.md

@@ -13,7 +13,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：leniu-定时任务、leniu-XXL-Job、leniu-@XxlJob、leniu-TenantLoader、leniu-TenantContextHolder、leniu-分布式锁、net.xnzn、leniu-yunshitang
+  触发词：定时任务、XXL-Job、@XxlJob、TenantLoader、任务调度、分布式定时
 ---
 
 # leniu-tengyun-core 定时任务规范

package/.cursor/skills/leniu-java-total-line/SKILL.md

@@ -13,7 +13,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：leniu-合计行、leniu-totalLine、leniu-报表合计、leniu-合计查询、leniu-SUM合计、leniu-ReportBaseTotalVO、net.xnzn、leniu-yunshitang
+  触发词：合计行、totalLine、报表合计、SUM合计、ReportBaseTotalVO、合计查询
 ---
 
 # leniu-tengyun-core 合计行(Total Line)规范
@@ -24,7 +24,7 @@ description: |
 |------|------|
 | **包名前缀** | `net.xnzn.core.*` |
 | **JDK 版本** | 21 |
-| **跨租户工具** | `Executors.readInSystem()` |
+| **双库切换** | 默认商户库，`Executors.doInSystem()` 切换系统库 |
 | **分页工具** | `PageMethod.startPage()` |
 | **结果封装** | `ReportBaseTotalVO<T>` |
 | **分页封装** | `PageVO.of()` |
@@ -38,32 +38,32 @@ description: |
 ### 带合计行的分页查询
 
 ```java
-import net.xnzn.framework.data.executor.Executors;
 import net.xnzn.core.common.page.PageMethod;
 import net.xnzn.core.common.page.PageVO;
 import net.xnzn.core.common.vo.ReportBaseTotalVO;
 import cn.hutool.core.collection.CollUtil;
 
+// ⚠️ 系统默认在商户库执行，业务查询无需 Executors.readInSystem()
+// Executors.readInSystem() 仅用于需要访问系统库的场景（如全局配置、商户管理）
+
 public ReportBaseTotalVO<XxxVO> pageWithTotal(XxxPageParam param) {
-    return Executors.readInSystem(() -> {
-        ReportBaseTotalVO<XxxVO> result = new ReportBaseTotalVO<>();
+    ReportBaseTotalVO<XxxVO> result = new ReportBaseTotalVO<>();
 
-        // 1. 导出时不查询合计行(避免不必要的性能开销)
-        if (CollUtil.isEmpty(param.getExportCols())) {
-            XxxVO totalLine = mapper.getSummaryTotal(param);
-            result.setTotalLine(totalLine);
-        }
+    // 1. 导出时不查询合计行(避免不必要的性能开销)
+    if (CollUtil.isEmpty(param.getExportCols())) {
+        XxxVO totalLine = mapper.getSummaryTotal(param);
+        result.setTotalLine(totalLine);
+    }
 
-        // 2. 开启分页
-        PageMethod.startPage(param.getPage());
+    // 2. 开启分页
+    PageMethod.startPage(param.getPage());
 
-        // 3. 查询数据
-        List<XxxVO> list = mapper.getSummaryList(param);
+    // 3. 查询数据
+    List<XxxVO> list = mapper.getSummaryList(param);
 
-        // 4. 封装分页结果
-        result.setResultPage(PageVO.of(list));
-        return result;
-    });
+    // 4. 封装分页结果
+    result.setResultPage(PageVO.of(list));
+    return result;
 }
 ```
 
@@ -71,7 +71,8 @@ public ReportBaseTotalVO<XxxVO> pageWithTotal(XxxPageParam param) {
 
 ```java
 public XxxVO getSummaryTotal(XxxPageParam param) {
-    return Executors.readInSystem(() -> mapper.getSummaryTotal(param));
+    // 默认在商户库执行，无需 Executors 包装
+    return mapper.getSummaryTotal(param);
 }
 ```
 
@@ -190,6 +191,6 @@ public void exportExcel(XxxParam param, HttpServletResponse response) {
 ## 注意事项
 
 - 合计SQL只返回数值字段，不返回字符串、ID、名称等
-- 使用 `Executors.readInSystem()` 跨租户查询
+- 业务查询默认在商户库执行，无需 `Executors` 包装；仅访问系统库数据时才使用 `Executors.doInSystem()`
 - 导出时通过 `exportCols` 判断是否需要合计行
 - 金额字段类型与 Entity 保持一致：订单模块用 `BigDecimal`，钱包模块用 `Long`（详见 leniu-java-amount-handling）

package/.cursor/skills/leniu-marketing-price-rule-customizer/SKILL.md

@@ -14,7 +14,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：营销计费、price规则、计价规则、RulePriceHandler、RulePriceEnum、折扣规则、满减规则、限额规则、补贴规则、营销规则定制、leniu营销、leniu-yunshitang、net.xnzn
+  触发词：营销计费、计价规则、RulePriceHandler、RulePriceEnum、折扣规则、满减规则、限额规则、补贴规则
 ---
 
 # leniu-tengyun-core 营销计费规则定制

package/.cursor/skills/leniu-marketing-recharge-rule-customizer/SKILL.md

@@ -14,7 +14,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：营销充值、recharge规则、充值规则、RuleRechargeHandler、RuleRechargeEnum、满赠规则、充值赠送、充值限额、管理费规则、充值规则定制、leniu营销、leniu-yunshitang、net.xnzn
+  触发词：营销充值、充值规则、RuleRechargeHandler、RuleRechargeEnum、满赠规则、充值赠送、管理费规则
 ---
 
 # leniu-tengyun-core 营销充值规则定制

package/.cursor/skills/leniu-mealtime/SKILL.md

@@ -14,7 +14,7 @@ description: |
   - leniu-tengyun-core：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun-core
   - leniu-yunshitang：/Users/xujiajun/Developer/gongsi_proj/leniu-api/leniu-tengyun/leniu-yunshitang
 
-  触发词：餐次、mealtime、mealtimeType、早餐、午餐、晚餐、下午茶、夜宵、AllocMealtimeTypeEnum、MealtimeTypeConverter、正餐、leniu餐次、leniu-yunshitang、net.xnzn
+  触发词：餐次、mealtime、mealtimeType、早餐、午餐、晚餐、下午茶、夜宵、AllocMealtimeTypeEnum
 ---
 
 # leniu-tengyun-core 餐次处理规范

package/.cursor/skills/leniu-redis-cache/SKILL.md

@@ -1,3 +1,18 @@
+---
+name: leniu-redis-cache
+description: |
+  leniu-tengyun-core 项目 Redis 缓存和分布式锁操作规范。包含 RedisUtil 工具类、分布式锁、ZSet 排行榜、缓存 Key 命名规范。
+
+  触发场景：
+  - 使用 RedisUtil 进行缓存操作（setString/setObj/getObj）
+  - 实现分布式锁（getLock/lock/unlock）
+  - 使用 Redis 自增自减计数器（incr/decr）
+  - 实现缓存击穿保护
+  - ZSet 排行榜操作
+
+  触发词：Redis、缓存、RedisUtil、分布式锁、RLock、getLock、setNx、ZSet、限流、缓存击穿
+---
+
 # leniu-redis-cache
 
 适用于 leniu-tengyun-core 项目的 Redis 缓存和分布式锁操作。