ai-engineering-init 1.14.1 → 1.14.3

package/.cursor/hooks/cursor-skill-eval.js

@@ -87,10 +87,6 @@ const skillMap = [
     name: 'leniu-java-concurrent',
     keywords: ['leniu-并发', 'leniu-CompletableFuture', 'leniu-线程池', 'leniu-分布式锁']
   },
-  {
-    name: 'leniu-java-export',
-    keywords: ['leniu-导出', 'leniu-Export', 'leniu-Excel导出', 'leniu-异步导出', 'leniu-@ExcelProperty']
-  },
   {
     name: 'leniu-java-logging',
     keywords: ['leniu-日志', 'leniu-@Slf4j', 'leniu-log.info', 'leniu-log.error']
@@ -104,16 +100,10 @@ const skillMap = [
     keywords: ['leniu-定时任务', 'leniu-XXL-Job', 'leniu-@XxlJob', 'leniu-TenantLoader']
   },
   {
-    name: 'leniu-java-total-line',
-    keywords: ['leniu-合计行', 'leniu-totalLine', 'leniu-报表合计', 'leniu-SUM合计', 'leniu-ReportBaseTotalVO']
-  },
-  {
-    name: 'leniu-java-amount-handling',
-    keywords: ['leniu-金额', 'leniu-分转元', 'leniu-元转分', 'leniu-Long金额', 'amountFen', 'amountYuan']
-  },
-  {
-    name: 'leniu-java-report-query-param',
-    keywords: ['leniu-报表查询', 'leniu-Param类', 'leniu-分页参数', 'leniu-时间范围', 'ReportBaseParam']
+    name: 'leniu-report-scenario',
+    keywords: ['报表', '报表开发', '报表查询', '报表导出', '合计行', 'totalLine', '汇总报表', '定制报表',
+      'report_order_info', '金额处理', '分转元', '餐次', 'mealtime', 'ReportBaseTotalVO',
+      'CustomNumberConverter', 'ExcelProperty', 'ReportOrderConsumeService', 'ReportBaseParam']
   },
   {
     name: 'leniu-error-handler',
@@ -158,10 +148,6 @@ const skillMap = [
     name: 'leniu-marketing-recharge-rule-customizer',
     keywords: ['营销充值', '充值规则', 'recharge规则', '满赠规则']
   },
-  {
-    name: 'leniu-mealtime',
-    keywords: ['餐次', '早餐', '午餐', '下午茶', '晚餐', '夜宵', 'mealtimeTypes']
-  },
   {
     name: 'leniu-customization-location',
     keywords: ['定制开发', '定制代码位置', 'Dz前缀', 'leniu-yunshitang', 'dz_表名', '定制仓库',
@@ -367,17 +353,6 @@ const skillMap = [
     keywords: ['leniu-头脑风暴', '云食堂方案', '云食堂设计', '云食堂功能规划', 'leniu-方案设计',
       '云食堂怎么设计', '云食堂可行性']
   },
-  {
-    name: 'leniu-report-customization',
-    keywords: ['定制报表', 'report_order_info', 'report_order_detail', 'report_account_flow',
-      '退款汇总', '消费金额统计', '订单报表', '流水报表', '汇总报表']
-  },
-  {
-    name: 'leniu-report-standard-customization',
-    keywords: ['标准版报表', 'core-report', 'report_refund', 'report_refund_detail',
-      '经营分析', '营业额分析', '用户活跃度', '菜品排行', '操作员统计', '账户日结',
-      'ReportOrderConsumeService', 'ReportAccountConsumeService']
-  },
   {
     name: 'mysql-debug',
     keywords: ['mysql查询', '查数据库', '查表', '执行SQL', '数据库排查', '验证数据',

package/.cursor/rules/skill-activation.mdc

@@ -17,13 +17,10 @@ alwaysApply: true
 | leniu-Entity/leniu-VO/leniu-DTO/@TableName/@TableField | `.cursor/skills/leniu-java-entity/SKILL.md` |
 | leniu-MyBatis/leniu-Mapper/LambdaQueryWrapper/leniu-XML | `.cursor/skills/leniu-java-mybatis/SKILL.md` |
 | leniu-并发/CompletableFuture/leniu-线程池 | `.cursor/skills/leniu-java-concurrent/SKILL.md` |
-| leniu-导出/leniu-Excel导出/leniu-@ExcelProperty | `.cursor/skills/leniu-java-export/SKILL.md` |
 | leniu-日志/@Slf4j/leniu-log.info | `.cursor/skills/leniu-java-logging/SKILL.md` |
 | leniu-消息队列/leniu-MQ/MqUtil/@MqConsumer | `.cursor/skills/leniu-java-mq/SKILL.md` |
 | leniu-定时任务/leniu-XXL-Job/@XxlJob | `.cursor/skills/leniu-java-task/SKILL.md` |
-| leniu-合计行/totalLine/ReportBaseTotalVO | `.cursor/skills/leniu-java-total-line/SKILL.md` |
-| leniu-金额/leniu-分转元/leniu-元转分/amountFen | `.cursor/skills/leniu-java-amount-handling/SKILL.md` |
-| leniu-报表查询/ReportBaseParam/leniu-分页参数 | `.cursor/skills/leniu-java-report-query-param/SKILL.md` |
+| 报表/报表开发/报表查询/报表导出/合计行/totalLine/金额处理/分转元/餐次/mealtime/ReportBaseTotalVO/CustomNumberConverter | `.cursor/skills/leniu-report-scenario/SKILL.md` |
 | leniu-异常/LeException/leniu-全局异常/leniu-I18n | `.cursor/skills/leniu-error-handler/SKILL.md` |
 | leniu-注解/@RequiresAuthentication/@Validated | `.cursor/skills/leniu-backend-annotations/SKILL.md` |
 | leniu-工具类/leniu-BeanUtil/leniu-StrUtil/LeBeanUtil | `.cursor/skills/leniu-utils-toolkit/SKILL.md` |
@@ -34,9 +31,6 @@ alwaysApply: true
 | leniu-规范/leniu-禁止/leniu-命名/leniu-代码风格 | `.cursor/skills/leniu-code-patterns/SKILL.md` |
 | 营销计费/计费规则/RulePriceHandler | `.cursor/skills/leniu-marketing-price-rule-customizer/SKILL.md` |
 | 营销充值/充值规则/RuleRechargeHandler/满赠规则 | `.cursor/skills/leniu-marketing-recharge-rule-customizer/SKILL.md` |
-| 餐次/早餐/午餐/下午茶/晚餐/夜宵/mealtimeTypes | `.cursor/skills/leniu-mealtime/SKILL.md` |
-| 定制报表/汇总报表/report_order_info/v5.29报表/batchConsume/consumeType | `.cursor/skills/leniu-report-customization/SKILL.md` |
-| 标准版报表/core-report/report_refund/经营分析/fix重算/账户日结/菜品排行 | `.cursor/skills/leniu-report-standard-customization/SKILL.md` |
 
 ### OpenSpec 工作流技能
 

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

@@ -39,6 +39,7 @@ description: |
 | 架构 | Controller -> Business -> Service -> Mapper（四层） |
 | 无 DAO 层 | Service 直接注入 Mapper |
 | 对象转换 | `BeanUtil.copyProperties()` (Hutool) |
+| Service 模式 | **两种并存**：简单 CRUD 继承 `ServiceImpl`；业务聚合直接 `@Service` |
 | Entity 基类 | 无基类，自定义审计字段 |
 | 请求封装 | `LeRequest<T>` |
 | 响应封装 | `Page<T>` / `LeResponse<T>` / `void` |
@@ -110,19 +111,38 @@ private LocalDateTime uptime;
 private Integer delFlag;  // 1=删除, 2=正常
 ```
 
-### Service 注入模式
+### Service 两种模式
 
+项目中存在两种 Service 模式，根据业务复杂度选择：
+
+**模式 A：简单 CRUD Service**（适用于单表操作，利用 MyBatis-Plus 内置方法）
 ```java
+// 接口
+public interface XxxService extends IService<XxxEntity> { }
+
+// 实现
 @Slf4j
 @Service
-public class XxxServiceImpl implements XxxService {
-    @Resource
-    private XxxMapper xxxMapper;  // 直接注入 Mapper，无 DAO 层
+public class XxxServiceImpl extends ServiceImpl<XxxMapper, XxxEntity> implements XxxService {
+    // 继承 ServiceImpl 获得 save/updateById/removeById/page 等内置方法
+    // 通过 this.baseMapper 访问 Mapper（父类提供）
+}
+```
 
-    // 不继承 ServiceImpl，只实现接口
+**模式 B：业务聚合 Service**（适用于跨表操作、复杂业务编排）
+```java
+@Slf4j
+@Service
+public class XxxService {
+    @Autowired
+    private XxxMapper xxxMapper;  // 直接注入 Mapper，无 DAO 层
+    @Autowired
+    private YyyMapper yyyMapper;  // 可注入多个 Mapper
 }
 ```
 
+**选择建议**：新建简单单表 CRUD 用模式 A；涉及多表联查、报表、业务编排用模式 B。
+
 ### Controller 请求封装
 
 ```java
@@ -366,7 +386,6 @@ private String createBy;                  // -> crby
 entity.setDelFlag(0);                     // -> setDelFlag(2) 表示正常
 throw new ServiceException("...");        // -> throw new LeException("...")
 MapstructUtils.convert(src, Dst.class);   // -> BeanUtil.copyProperties(src, Dst.class)
-extends ServiceImpl<XxxMapper, Xxx>       // -> implements XxxService（不继承）
 @Resource private XxxDao xxxDao;          // -> @Resource private XxxMapper xxxMapper
 // XML 放 resources/mapper/              // -> 与 Java 同目录
 return null;                              // -> return Collections.emptyList()
@@ -377,7 +396,7 @@ return null;                              // -> return Collections.emptyList()
 ## 生成前检查清单
 
 - [ ] 包名 `net.xnzn.core.*`
-- [ ] Service 只实现接口，不继承基类
+- [ ] Service 模式选择：简单 CRUD 用模式 A（继承 ServiceImpl）；业务聚合用模式 B（直接 @Service）
 - [ ] Service 直接注入 Mapper（无 DAO）
 - [ ] 审计字段 crby/crtime/upby/uptime
 - [ ] delFlag: 1=删除, 2=正常

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

@@ -22,7 +22,7 @@ description: |
 | XML 位置 | **与 Mapper 接口同目录**（非 `resources/mapper/`） |
 | 分页 | PageHelper → `PageMethod.startPage(PageDTO)` → `PageVO.of(list)` |
 | 逻辑删除 | **1=删除，2=正常**（与 RuoYi 相反） |
-| Service | 无接口，直接 `@Service` 类，Mapper 字段名统一用 `baseMapper` |
+| Service | **两种模式并存**：简单 CRUD 继承 `ServiceImpl`（`this.baseMapper`）；业务聚合直接 `@Service`（`@Autowired XxxMapper xxxMapper`） |
 | 循环依赖 | 跨模块依赖用 `@Autowired @Lazy` |
 
 ## Mapper 接口模板
@@ -147,28 +147,36 @@ List<XxxEntity> list = mapper.selectList(
 
 ## Service 注入规范
 
+项目中 Service 有两种模式，Mapper 字段名也不统一——参考周围已有代码的风格即可。
+
+**模式 A：继承 ServiceImpl（简单 CRUD）**
+```java
+@Service
+public class XxxServiceImpl extends ServiceImpl<XxxMapper, XxxEntity> implements XxxService {
+    // 通过 this.baseMapper 访问 Mapper（父类自动注入）
+    public boolean exists(String macOrderId) {
+        return this.baseMapper.existsOne(
+            Wrappers.lambdaQuery(XxxEntity.class)
+                .eq(XxxEntity::getMacOrderId, macOrderId)
+                .eq(XxxEntity::getDelFlag, 2)
+        );
+    }
+}
+```
+
+**模式 B：直接 @Service（业务聚合）**
 ```java
 @Slf4j
 @Service
-@Validated
 public class XxxService {
-
     @Autowired
-    private XxxMapper baseMapper;        // ✅ 统一命名 baseMapper
+    private XxxMapper xxxMapper;  // 字段名跟随 Mapper 类名
 
     @Autowired @Lazy
-    private XxxDetailService xxxDetailService;  // ✅ 跨模块用 @Lazy
+    private YyyService yyyService;  // 跨模块用 @Lazy
 
     public XxxEntity getOne(Long id) {
-        return baseMapper.selectById(id);
-    }
-
-    public boolean exists(String macOrderId) {
-        return baseMapper.existsOne(
-            Wrappers.lambdaQuery(XxxEntity.class)
-                .eq(XxxEntity::getMacOrderId, macOrderId)
-                .eq(XxxEntity::getDelFlag, 2)
-        );
+        return xxxMapper.selectById(id);
     }
 }
 ```
@@ -250,8 +258,9 @@ wrapper.eq(XxxEntity::getDelFlag, 0);
 // ❌ MapstructUtils（用 BeanUtil.copyProperties）
 MapstructUtils.convert(source, Target.class);
 
-// ❌ Service 继承 IService / ServiceImpl
-public interface IXxxService extends IService<XxxEntity> {}
+// ❌ 业务聚合 Service 不要继承 IService / ServiceImpl（简单 CRUD Service 可以继承）
+// 错误：在报表/业务编排 Service 中继承 ServiceImpl
+// 正确：简单单表 CRUD 可以继承 ServiceImpl，复杂业务直接 @Service
 ```
 
 ## XML 文件位置