提交修改

api-web/api-interface/src/main/java/com/heyu/api/controller/objectdet/DetectKitchenAnimalsController.java

@@ -20,25 +20,47 @@ import org.springframework.web.bind.annotation.RestController;
 import java.util.ArrayList;
 import java.util.List;
 
-/***
- * https://next.api.aliyun.com/api/objectdet/2019-12-30/DetectKitchenAnimals?tab=DOC&lang=JAVA&RegionId=cn-shanghai
- *
- * 猫鼠识别
- *
- * DetectKitchenAnimals
- *
- * 功能描述
- * 猫鼠识别能力基于视觉 AI 算法、物联网和大数据分析技术，可以检测出场景中是否有猫、老鼠等动物，实现实时预警。
- *应用场景
- * 餐饮后厨或仓库：针对后厨操作间、食材存储仓库等场地，实时检测是否有猫、老鼠等动物，并进行实时预警，提醒工作人员进行相应处理防范。
- *
- * 特色优势
- * 识别准确：基于大量场景样本的基础上，对不同环境、光线、角度、目标状态等进行针对性的训练学习，算法模型识别精度高。
- * 适应性强：算法模型场景适应性强，可直接用于不同空间布局的场景、各类餐厅后厨及用餐前场。
- * 自研算法：通过多端多场景风险发现互通，形成检测、预警、整改、优化全链路闭环，结合数据分析、规则提取实现反哺生产，进而优化模型性能。
+/**
+ * 厨房猫鼠识别控制器
+ * <p>
+ * 基于阿里云物体检测 API，专门针对餐饮后厨场景进行猫鼠等动物检测。
+ * 利用视觉 AI 算法、物联网和大数据分析技术，实时检测场景中是否有猫、老鼠等动物，实现预警功能。
+ * </p>
+ * <p>
+ * 检测能力：
+ * <ul>
+ *   <li>动物识别：检测猫、老鼠等常见动物</li>
+ *   <li>位置定位：返回动物在图像中的位置坐标</li>
+ *   <li>置信度评分：返回识别结果的置信度</li>
+ * </ul>
+ * </p>
+ * <p>
+ * 核心优势：
+ * <ul>
+ *   <li>识别准确：基于大量场景样本训练，适应不同环境、光线、角度</li>
+ *   <li>适应性强：可直接用于不同空间布局的餐厅后厨及用餐场所</li>
+ *   <li>自研算法：形成检测、预警、整改、优化全链路闭环</li>
+ * </ul>
+ * </p>
+ * <p>
+ * 适用场景：
+ * <ul>
+ *   <li>餐饮后厨：实时监测操作间、食材存储仓库</li>
+ *   <li>食品加工厂：防范动物侵入污染食品</li>
+ *   <li>超市仓库：保护存储食材安全</li>
+ *   <li>食品监管：卫生监督辅助工具</li>
+ * </ul>
+ * </p>
+ * <p>
+ * 阿里云 API 文档：<a href="https://next.api.aliyun.com/api/objectdet/2019-12-30/DetectKitchenAnimals?tab=DOC">DetectKitchenAnimals</a>
+ * </p>
+ * <p>
+ * 接口路径：/object/detectKitchen
+ * </p>
  *
+ * @author heyu
+ * @since 1.0.0
  */
-
 @Slf4j
 @RestController
 @RequestMapping("/object")
@@ -50,6 +72,24 @@ public class DetectKitchenAnimalsController  extends BaseController {
     private ADetectKitchenAnimalsHandle aDetectKitchenAnimalsHandle;
 
 
+    /**
+     * 厨房猫鼠识别接口
+     * <p>
+     * 接收厨房场景图片（URL 或 Base64），调用阿里云 API 进行猫鼠等动物检测。
+     * 返回检测到的动物类型、置信度和位置坐标信息，用于实时预警和防范。
+     * </p>
+     * <p>
+     * 检测结果可能包括：
+     * <ul>
+     *   <li>猫（Cat）</li>
+     *   <li>老鼠（Mouse/Rat）</li>
+     *   <li>其他目标动物</li>
+     * </ul>
+     * </p>
+     *
+     * @param req 检测请求参数，包含 imageUrl 或 imageBase64（二选一）
+     * @return 动物检测结果列表，每个元素包含 type（动物类型）、score（置信度）、rectangles（位置坐标）
+     */
     @RequestMapping("/detectKitchen")
     public R detectKitchen(ADetectKitchenAnimalsRequest req) {