Instruction file imported from qianhou0627/Communityweb (
.cursor/rules/rules/java/rules/base.mdc). Copyright stays with the author.
description: 代码生成前业务服务检查规则 ruleType: always alwaysApply: true
业务代码生成检查规则
核心原则
严格要求：在生成任何业务代码之前，AI必须主动使用read_file工具查看 func.md 文档，全面确认是否已有相关的业务服务或功能。
强制检查流程
第一步：必须主动查看func.md
- 强制要求：使用read_file工具查看完整的func.md文档
- 检查范围：Service层、Manager层、Mapper层、枚举类、引擎组件层
- 检查目的：确认是否已有相关功能或类似方法
第二步：逐层分析现有功能
- 服务层检查: 查看
Service层部分，确认是否已有类似的业务服务 - Manager层检查: 查看
Manager层部分，确认是否已有相关的数据管理器 - Mapper层检查: 查看
Mapper层部分，确认是否已有相关的数据访问接口 - 枚举类检查: 查看
枚举类部分，确认是否已有相关的枚举定义 - 引擎组件检查: 查看
引擎组件层部分，确认是否已有相关的计算引擎
第三步：代码复用决策
- 优先级1：如果发现已有完全匹配的功能，直接复用现有代码
- 优先级2：如果发现已有类似功能，在现有类中扩展方法
- 优先级3：如果发现相关但不完全匹配的功能，评估是否可以重构复用
- 最后选择：只有在确认没有任何相关功能时，才创建新的类或服务
具体检查示例
用户相关功能开发
- 必查项目：AdminUserService、MallUserService的所有方法
- 检查内容：用户登录、注册、信息管理、密码管理等
- 复用策略：优先使用现有用户服务，避免创建新的用户管理功能
门店相关功能开发
- 必查项目：ShopService、ShopManagerImpl的所有方法
- 检查内容：门店CRUD、状态管理、关联查询等
- 复用策略：门店相关操作必须使用现有服务
商品相关功能开发
- 必查项目：SupplierGoodsService、GylSkuManagerImpl、GylSsuManagerImpl等
- 检查内容：商品管理、SKU/SSU操作、包规管理等
- 复用策略：商品相关功能必须基于现有服务扩展
订单相关功能开发
- 必查项目：OrderService、OrderManagerImpl、CartService等
- 检查内容：订单创建、状态管理、购物车操作等
- 复用策略：订单流程必须使用现有服务
计算相关功能开发
- 必查项目：PriceCalculationEngine、AmountAllocationEngine、OrderValidationEngine
- 检查内容：价格计算、金额分摊、订单验证等
- 复用策略：计算逻辑优先使用现有引擎
违规检查机制
发现重复开发的处理
- 立即停止：一旦发现已有相关功能，立即停止新开发
- 重新分析：分析现有功能是否满足需求
- 选择策略：确定是复用、扩展还是重构
- 重新实施：基于选定策略重新实施
检查不充分的后果
- 代码冗余：造成系统中存在重复功能
- 维护困难：增加后续维护和bug修复的复杂度
- 性能问题：重复的数据库查询和业务逻辑
- 团队效率下降：浪费开发时间和资源
命名规范参考
参考func.md中现有服务的命名模式：
- Service层：
{业务域}Service - Manager层：
{业务域}ManagerImpl - Mapper层：
{业务域}Mapper - 引擎层：
{功能}Engine
文档同步要求
- 每次新增服务：必须同步更新func.md文档
- 每次修改方法：必须同步更新相关服务的功能描述
- 每次重构：必须更新相关的文档说明
执行检查清单
在开始任何代码开发前，请确认：
- 已使用read_file工具查看完整的func.md文档
- 已逐层检查Service、Manager、Mapper、枚举、引擎层
- 已确认没有重复或类似的现有功能
- 已选择合适的复用或扩展策略
- 已准备在完成后更新func.md文档
重要提醒：违反此检查流程将导致代码重复、系统冗余和维护困难，必须严格遵守！