风控管理添加注释

alien-second/src/main/java/shop/alien/second/platform/PlatformRiskControlController.java

@@ -28,9 +28,10 @@ public class PlatformRiskControlController {
     private final RiskControlService riskControlService;
 
     /**
-     * 风控数据
+     * 查询风控数据记录列表
      *
-     * @param vo
+     * @param vo 风控记录查询条件
+     * @return 分页的风控记录列表
      */
     @ApiOperation("风控数据")
     @PostMapping("/queryRiskControlRecords")
@@ -39,12 +40,26 @@ public class PlatformRiskControlController {
     }
 
 
+    /**
+     * 查询风控数据详情
+     *
+     * @param vo 风控记录查询条件
+     * @return 风控记录详细信息
+     * @throws Exception 查询过程中可能抛出的异常
+     */
     @ApiOperation("风控数据")
     @PostMapping("/queryRiskControlRecordsDetail")
     public R<SecondRiskRecordVo> queryRiskControlRecordsDetail(@RequestBody SecondRiskRecordVo vo) throws Exception {
         return R.data(riskControlService.queryRiskControlRecordsDetail(vo));
     }
 
+    /**
+     * 账号封禁处理
+     *
+     * @param vo 封禁处理参数，包含被封禁账号相关信息
+     * @return 封禁操作结果，成功返回"封禁成功"，失败返回"封禁失败"或系统异常信息
+     * @throws Exception 封禁过程中可能抛出的异常
+     */
     @ApiOperation("账号封禁处理")
     @PostMapping("/accountBan")
     public R<SecondRiskRecordVo> accountBan(@RequestBody SecondRiskRecordVo vo) throws Exception {

alien-second/src/main/java/shop/alien/second/service/RiskControlService.java

@@ -10,6 +10,7 @@ import java.util.List;
 
 /**
  * 风控服务接口
+ * 提供风控数据记录、查询、账号封禁等相关功能
  */
 public interface RiskControlService extends IService<SecondRiskControlRecord> {
     
@@ -39,24 +40,34 @@ public interface RiskControlService extends IService<SecondRiskControlRecord> {
 
     /**
      * 发送封禁通知
+     * 
+     * @param userId 用户ID
      */
     void sendNotice(Integer userId);
 
     /**
-     * 获取相同类型的风控数据
+     * 查询风控记录列表
      *
-     * @param vo
-     * @return 查询风控列表
+     * @param vo 风控记录查询条件
+     * @return 分页的风控记录列表
      */
     IPage<SecondRiskControlRecordVo> queryRiskControlRecords(SecondRiskControlRecordVo vo);
 
     /**
      * 账号封禁详细查询
+     * 
+     * @param vo 查询条件
+     * @return 账号封禁详细信息
+     * @throws Exception 查询过程中可能抛出的异常
      */
     SecondRiskRecordVo queryRiskControlRecordsDetail(SecondRiskRecordVo vo) throws Exception;
 
     /**
      * 账号封禁处理
+     * 
+     * @param vo 封禁处理参数
+     * @return 处理结果，true表示封禁成功，false表示封禁失败
+     * @throws Exception 处理过程中可能抛出的异常
      */
     boolean accountBan(SecondRiskRecordVo vo) throws Exception;
 

alien-second/src/main/java/shop/alien/second/service/impl/RiskControlServiceImpl.java

@@ -34,6 +34,7 @@ import java.util.stream.Collectors;
 
 /**
  * 风控服务实现类
+ * 实现风控数据记录、查询、账号封禁等核心业务逻辑
  */
 @Slf4j
 @Service
@@ -53,6 +54,7 @@ public class RiskControlServiceImpl extends ServiceImpl<SecondRiskControlRecordM
     @Lazy
     @Autowired
     private SecondGoodsServiceImpl secondGoodsService;
+    
     /**
      * 记录风控数据
      *
@@ -104,6 +106,12 @@ public class RiskControlServiceImpl extends ServiceImpl<SecondRiskControlRecordM
         return secondRiskControlRecordMapper.selectList(queryWrapper);
     }
 
+    /**
+     * 查询风控记录列表
+     *
+     * @param vo 风控记录查询条件
+     * @return 分页的风控记录列表
+     */
     @Override
     public IPage<SecondRiskControlRecordVo> queryRiskControlRecords(SecondRiskControlRecordVo vo) {
         try {
@@ -124,6 +132,8 @@ public class RiskControlServiceImpl extends ServiceImpl<SecondRiskControlRecordM
 
     /**
      * 发送封禁通知
+     * 
+     * @param userId 用户ID
      */
     public void sendNotice(Integer userId) {
         LifeUser lifeUser = lifeUserMapper.selectById(userId);
@@ -156,6 +166,18 @@ public class RiskControlServiceImpl extends ServiceImpl<SecondRiskControlRecordM
     }
 
 
+    /**
+     * 查询风控记录详情
+     * 根据规则类型不同，查询不同的详细信息：
+     * 1: 洗钱嫌疑 - 查询交易记录列表
+     * 2: 账号异常 - 查询用户列表
+     * 3: 交易欺诈 - 查询商品信息记录列表
+     * 4: 异常发布 - 查询商品列表
+     *
+     * @param vo 查询条件，包含规则类型和详细信息
+     * @return 风控记录详细信息
+     * @throws Exception 查询过程中可能发生的异常
+     */
     @Override
     public SecondRiskRecordVo queryRiskControlRecordsDetail(SecondRiskRecordVo vo) throws Exception {
         // 返回实体
@@ -191,6 +213,17 @@ public class RiskControlServiceImpl extends ServiceImpl<SecondRiskControlRecordM
     }
 
 
+    /**
+     * 账号封禁处理
+     * 根据规则类型执行不同的封禁操作：
+     * 1: 洗钱嫌疑 - 取消相关交易
+     * 2: 账号异常 - 批量封禁多个账号
+     * 3/4: 交易欺诈/异常发布 - 扣减积分并下架商品
+     *
+     * @param vo 封禁处理参数，包含规则类型、业务ID、是否执行等信息
+     * @return 处理结果，true表示处理成功
+     * @throws Exception 处理过程中可能发生的异常
+     */
     @Override
     public boolean accountBan(SecondRiskRecordVo vo) throws Exception {
         if (1 == vo.getIsExecute()) {