补充添加接口描述

src/main/java/com/ycwl/basic/controller/pc/DeviceController.java

@@ -22,32 +22,32 @@ public class DeviceController {
     @Autowired
     private DeviceService deviceService;
 
-    @ApiOperation("分页查询")
+    @ApiOperation("设备分页查询")
     @PostMapping("/page")
     public ApiResponse<PageInfo<DeviceRespVO>> pageQuery(@RequestBody DeviceReqQuery deviceReqQuery) {
         return deviceService.pageQuery(deviceReqQuery);
     }
-    @ApiOperation("列表查询")
+    @ApiOperation("设备列表查询")
     @PostMapping("/list")
     public ApiResponse list(@RequestBody DeviceReqQuery deviceReqQuery) {
         return deviceService.list(deviceReqQuery);
     }
-    @ApiOperation("详情查询")
+    @ApiOperation("设备详情查询")
     @GetMapping("/getDetails/{id}")
     public ApiResponse<DeviceRespVO> getDetails(@PathVariable("id") Long id) {
         return deviceService.getById(id);
     }
-    @ApiOperation("新增或修改")
+    @ApiOperation("新增或修改设备")
     @PostMapping("/addOrUpdate")
     public ApiResponse addOrUpdate(@RequestBody DeviceAddOrUpdateReq deviceReqQuery) {
         return deviceService.addOrUpdate(deviceReqQuery);
     }
-    @ApiOperation("删除")
+    @ApiOperation("删除设备")
     @DeleteMapping("/delete/{id}")
     public ApiResponse delete(@PathVariable("id") Long id) {
         return deviceService.deleteById(id);
     }
-    @ApiOperation("修改状态")
+    @ApiOperation("修改设备状态")
     @PutMapping("/updateStatus/{id}")
     public ApiResponse updateStatus(@PathVariable("id") Long id) {
         return deviceService.updateStatus(id);

src/main/java/com/ycwl/basic/controller/pc/FaceController.java

@@ -24,37 +24,37 @@ public class FaceController {
     @Autowired
     private FaceService faceService;
 
-    @ApiOperation("分页查询")
+    @ApiOperation("分页查询用户人脸")
     @PostMapping("/page")
     public ApiResponse<PageInfo<FaceRespVO>> pageQuery(@RequestBody FaceReqQuery faceReqQuery) {
         return faceService.pageQuery(faceReqQuery);
     }
-    @ApiOperation("列表查询")
+    @ApiOperation("用户人脸列表查询")
     @PostMapping("/list")
     public ApiResponse<List<FaceRespVO>> list(@RequestBody FaceReqQuery faceReqQuery) {
         return faceService.list(faceReqQuery);
     }
-    @ApiOperation("详情查询")
+    @ApiOperation("用户人脸详情查询")
     @GetMapping("/getDetail/{id}")
     public ApiResponse<FaceRespVO> getDetail(@PathVariable("id") Long id) {
         return faceService.getById(id);
     }
-    @ApiOperation("添加")
+    @ApiOperation("添加用户人脸信息")
     @PostMapping("/add")
     public ApiResponse<Integer> add(@RequestBody FaceEntity face) {
         return faceService.add(face);
     }
-    @ApiOperation("删除")
+    @ApiOperation("删除用户人脸信息")
     @PostMapping("/deleteById/{id}")
     public ApiResponse<Integer> deleteById(@PathVariable Long id) {
         return faceService.deleteById(id);
     }
-    @ApiOperation("批量删除")
+    @ApiOperation("批量删除用户人脸")
     @PostMapping("/deleteByIds")
     public ApiResponse<Integer> deleteByIds(@RequestBody List<Long> ids) {
         return faceService.deleteByIds(ids);
     }
-    @ApiOperation("修改")
+    @ApiOperation("修改用户人脸信息")
     @PostMapping("/update")
     public ApiResponse<Integer> update(@RequestBody FaceEntity face) {
         return faceService.update(face);

src/main/java/com/ycwl/basic/controller/pc/FaceSampleController.java

@@ -24,37 +24,37 @@ public class FaceSampleController {
     @Autowired
     private FaceSampleService FaceSampleService;
 
-    @ApiOperation("分页查询")
+    @ApiOperation("分页查询人脸样本")
     @PostMapping("/page")
     public ApiResponse<PageInfo<FaceSampleRespVO>> pageQuery(@RequestBody FaceSampleReqQuery FaceSampleReqQuery) {
         return FaceSampleService.pageQuery(FaceSampleReqQuery);
     }
-    @ApiOperation("列表查询")
+    @ApiOperation("人脸样本列表查询")
     @PostMapping("/list")
     public ApiResponse<List<FaceSampleRespVO>> list(@RequestBody FaceSampleReqQuery FaceSampleReqQuery) {
         return FaceSampleService.list(FaceSampleReqQuery);
     }
-    @ApiOperation("详情查询")
+    @ApiOperation("人脸样本详情查询")
     @GetMapping("/getDetail/{id}")
     public ApiResponse<FaceSampleRespVO> getDetail(@PathVariable("id") Long id) {
         return FaceSampleService.getById(id);
     }
-    @ApiOperation("添加")
+    @ApiOperation("添加人脸样本")
     @PostMapping("/add")
     public ApiResponse<Integer> add(@RequestBody FaceSampleEntity FaceSample) {
         return FaceSampleService.add(FaceSample);
     }
-    @ApiOperation("删除")
+    @ApiOperation("删除人脸样本")
     @PostMapping("/deleteById/{id}")
     public ApiResponse<Integer> deleteById(@PathVariable Long id) {
         return FaceSampleService.deleteById(id);
     }
-    @ApiOperation("批量删除")
+    @ApiOperation("批量删除人脸样本")
     @PostMapping("/deleteByIds")
     public ApiResponse<Integer> deleteByIds(@RequestBody List<Long> ids) {
         return FaceSampleService.deleteByIds(ids);
     }
-    @ApiOperation("修改")
+    @ApiOperation("修改人脸样本信息")
     @PostMapping("/update")
     public ApiResponse<Integer> update(@RequestBody FaceSampleEntity FaceSample) {
         return FaceSampleService.update(FaceSample);

src/main/java/com/ycwl/basic/controller/pc/OrderController.java

@@ -6,6 +6,7 @@ import com.ycwl.basic.model.pc.order.resp.OrderRespVO;
 import com.ycwl.basic.service.pc.OrderService;
 import com.ycwl.basic.utils.ApiResponse;
 import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
@@ -23,15 +24,18 @@ public class OrderController {
     @Autowired
     private OrderService orderService;
 
+    @ApiOperation("分页查询订单")
     @PostMapping("page")
     public ApiResponse<PageInfo<OrderRespVO>> pageQuery(@RequestBody OrderReqQuery query) {
         return orderService.pageQuery(query);
     }
 
+    @ApiOperation("订单列表查询")
     @PostMapping("list")
     public ApiResponse<List<OrderRespVO>> list(@RequestBody OrderReqQuery query) {
         return orderService.list(query);
     }
+    @ApiOperation("订单详情查询")
     @GetMapping("detail/{id}")
     public ApiResponse<OrderRespVO> detail(@PathVariable("id") Long orderId) {
         return orderService.detail(orderId);

src/main/java/com/ycwl/basic/controller/pc/RenderWorkerController.java

@@ -5,6 +5,7 @@ import com.ycwl.basic.model.pc.renderWorker.req.RenderWorkerReqQuery;
 import com.ycwl.basic.service.pc.RenderWorkerService;
 import com.ycwl.basic.utils.ApiResponse;
 import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
@@ -20,30 +21,41 @@ public class RenderWorkerController {
     @Autowired
     private RenderWorkerService renderWorkerService;
 
+    @ApiOperation("分页查询渲染机")
     @PostMapping("/page")
     public ApiResponse pageQuery(@RequestBody RenderWorkerReqQuery renderWorkerReqQuery){
         return renderWorkerService.pageQuery(renderWorkerReqQuery);
     }
+    @ApiOperation("渲染机列表查询")
     @PostMapping("/list")
     public ApiResponse list(@RequestBody RenderWorkerReqQuery renderWorkerReqQuery){
         return renderWorkerService.list(renderWorkerReqQuery);
     }
+    @ApiOperation("渲染机详情查询")
     @GetMapping("/detail/{id}")
     public ApiResponse detail(@PathVariable Long id){
         return renderWorkerService.detail(id);
     }
+
+    @ApiOperation("渲染机新增")
     @PostMapping("/add")
     public ApiResponse add(@RequestBody RenderWorkerEntity renderWorker){
         return renderWorkerService.add(renderWorker);
     }
+
+    @ApiOperation("渲染机删除")
     @DeleteMapping("/delete/{id}")
     public ApiResponse deleteById(@PathVariable Long id){
         return renderWorkerService.deleteById(id);
     }
+
+    @ApiOperation("渲染机修改")
     @PostMapping("/update")
     public ApiResponse update(@RequestBody RenderWorkerEntity renderWorker){
         return renderWorkerService.update(renderWorker);
     }
+
+    @ApiOperation("渲染机修改状态")
     @PutMapping("/updateStatus/{id}")
     public ApiResponse updateStatus(@PathVariable Long id) {
         return renderWorkerService.updateStatus(id);

src/main/java/com/ycwl/basic/mapper/pc/OrderMapper.java

@@ -22,6 +22,11 @@ public interface OrderMapper {
 //    int deleteById(Long id);
     int update(OrderAddOrUpdateReq order);
 
+    /**
+     * 添加订单明细
+     * @param orderItems
+     * @return
+     */
     int addOrderItems(List<OrderItemEntity> orderItems);
 
 }

src/main/java/com/ycwl/basic/mapper/pc/RoleMapper.java

@@ -16,6 +16,11 @@ public interface RoleMapper {
     int add(AddOrUpdateRoleReqVO addOrUpdateRoleReqVO);
     int update(AddOrUpdateRoleReqVO addOrUpdateRoleReqVO);
 
+    /**
+     * 查询角色的菜单权限
+     * @param id
+     * @return
+     */
     List<MenuNode> getMenuById(@Param("id")String id);
 
     int updateStatus(@Param("id")String id);

src/main/java/com/ycwl/basic/mapper/pc/ScenicMapper.java

@@ -23,6 +23,11 @@ public interface ScenicMapper {
     int update(ScenicAddOrUpdateReq scenic);
     int updateStatus(Long id);
 
+    /**
+     * 添加景区配置
+     * @param scenicConfig
+     * @return
+     */
     int addConfig(ScenicConfigEntity scenicConfig);
     /**
      * 修改景区配置