维护表标注 9-员工评价点赞

alien-entity/src/main/java/shop/alien/entity/store/LifeLikeRecord.java

@@ -23,7 +23,7 @@ public class LifeLikeRecord {
 
     private String huifuId;
 
-    @ApiModelProperty(value = "1-评论 2-社区动态 3-活动 4-推荐菜 5-店铺打卡 6-二手商品 7-律师评分 8-点赞员工")
+    @ApiModelProperty(value = "1-评论 2-社区动态 3-活动 4-推荐菜 5-店铺打卡 6-二手商品 7-律师评分 8-点赞员工 9-员工评价点赞")
     private String type;
 
     private Integer dianzanCount;

alien-store/src/main/java/shop/alien/store/controller/StoreStaffCommentController.java

@@ -32,6 +32,15 @@ public class StoreStaffCommentController {
 
     @ApiOperation("创建评论（用户对评价的评论，支持普通用户和员工）")
     @ApiOperationSupport(order = 1)
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "sendUserId", value = "发送用户ID（评论用户ID，如果传入userId则自动映射到sendUserId）", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID（登录用户ID，会自动映射到sendUserId，如果sendUserId已存在则优先使用sendUserId）", dataTypeClass = Integer.class, paramType = "body", required = false),
+            @ApiImplicitParam(name = "receiveUserId", value = "接收用户ID（可选，不填时默认为评价的创建者）", dataTypeClass = Integer.class, paramType = "body", required = false),
+            @ApiImplicitParam(name = "sendUserType", value = "发送用户类型：1-普通用户，2-员工（必填）", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "receiveUserType", value = "接收用户类型：1-普通用户，2-员工（必填）", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "commentContent", value = "评论内容", dataTypeClass = String.class, paramType = "body", required = true)
+    })
     @PostMapping("/create")
     public R<StoreStaffComment> createComment(@RequestBody StoreStaffComment comment) {
         log.info("创建评论, comment={}", comment);
@@ -58,8 +67,8 @@ public class StoreStaffCommentController {
     @ApiOperation("根据评价ID查询评论列表")
     @ApiOperationSupport(order = 2)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataType = "int", paramType = "query")
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataTypeClass = Integer.class, paramType = "query", required = false)
     })
     @GetMapping("/list/reviewId")
     public R<List<StoreStaffCommentVo>> getCommentListByReviewId(
@@ -75,8 +84,8 @@ public class StoreStaffCommentController {
     @ApiOperation("点赞评论")
     @ApiOperationSupport(order = 3)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "commentId", value = "评论ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "userId", value = "用户ID", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "commentId", value = "评论ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/like")
     public R<Boolean> likeComment(@RequestParam Integer commentId,
@@ -97,8 +106,8 @@ public class StoreStaffCommentController {
     @ApiOperation("取消点赞评论")
     @ApiOperationSupport(order = 4)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "commentId", value = "评论ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "userId", value = "用户ID", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "commentId", value = "评论ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/cancelLike")
     public R<Boolean> cancelLikeComment(@RequestParam Integer commentId,
@@ -118,6 +127,14 @@ public class StoreStaffCommentController {
 
     @ApiOperation("创建回复（用户对评论的回复）")
     @ApiOperationSupport(order = 5)
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "commentId", value = "首评ID", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID（发送用户ID）", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "replyToUserId", value = "被回复用户ID（可选，不填时默认为首评的发送用户）", dataTypeClass = Integer.class, paramType = "body", required = false),
+            @ApiImplicitParam(name = "sendUserType", value = "发送用户类型：1-普通用户，2-员工（必填）", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "receiveUserType", value = "接收用户类型：1-普通用户，2-员工（必填）", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "replyContent", value = "回复内容", dataTypeClass = String.class, paramType = "body", required = true)
+    })
     @PostMapping("/reply/create")
     public R<StoreStaffComment> createReply(@RequestBody StoreStaffReplyDto replyDto) {
         log.info("创建回复, replyDto={}", replyDto);
@@ -140,8 +157,8 @@ public class StoreStaffCommentController {
     @ApiOperation("根据首评ID查询回复列表")
     @ApiOperationSupport(order = 6)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "headId", value = "首评ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataType = "int", paramType = "query")
+            @ApiImplicitParam(name = "headId", value = "首评ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataTypeClass = Integer.class, paramType = "query", required = false)
     })
     @GetMapping("/reply/list/headId")
     public R<List<StoreStaffCommentVo>> getReplyListByHeadId(
@@ -157,8 +174,8 @@ public class StoreStaffCommentController {
     @ApiOperation("删除回复")
     @ApiOperationSupport(order = 7)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "replyId", value = "回复ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "userId", value = "用户ID", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "replyId", value = "回复ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/reply/delete")
     public R<Boolean> deleteReply(@RequestParam Integer replyId,
@@ -175,6 +192,10 @@ public class StoreStaffCommentController {
 
     @ApiOperation(value = "删除评论（根据ID）", notes = "根据评论ID删除评论，userId有值时只能删除自己发布的评论，userId为空时允许删除任何评论（管理员删除）")
     @ApiOperationSupport(order = 8)
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "id", value = "评论ID", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID（可选，有值时只能删除自己的评论，为空时允许删除任何评论）", dataTypeClass = Integer.class, paramType = "body", required = false)
+    })
     @PostMapping("/deleteReviewComment")
     public R<Boolean> deleteReviewComment(@RequestBody StoreStaffComment storeStaffComment) {
         log.info("删除评论, storeStaffComment={}", storeStaffComment);

alien-store/src/main/java/shop/alien/store/controller/StoreStaffReviewController.java

@@ -31,6 +31,17 @@ public class StoreStaffReviewController {
 
     @ApiOperation("创建员工评价")
     @ApiOperationSupport(order = 1)
+    @ApiImplicitParams({
+            @ApiImplicitParam(name = "staffUserId", value = "员工用户ID", dataTypeClass = Integer.class, paramType = "body", required = true),
+            @ApiImplicitParam(name = "overallRating", value = "总体评分（1-5星，支持0.5星）", dataTypeClass = java.math.BigDecimal.class, paramType = "body"),
+            @ApiImplicitParam(name = "serviceAttitudeRating", value = "服务态度评分（1-5星，支持0.5星）", dataTypeClass = java.math.BigDecimal.class, paramType = "body"),
+            @ApiImplicitParam(name = "responseTimeRating", value = "响应时间评分（1-5星，支持0.5星）", dataTypeClass = java.math.BigDecimal.class, paramType = "body"),
+            @ApiImplicitParam(name = "professionalAbilityRating", value = "专业能力评分（1-5星，支持0.5星）", dataTypeClass = java.math.BigDecimal.class, paramType = "body"),
+            @ApiImplicitParam(name = "reviewContent", value = "评价内容", dataTypeClass = String.class, paramType = "body"),
+            @ApiImplicitParam(name = "reviewImages", value = "评价图片列表", dataTypeClass = java.util.List.class, paramType = "body"),
+            @ApiImplicitParam(name = "isAnonymous", value = "是否匿名评价，0:否，1:是", dataTypeClass = Integer.class, paramType = "body"),
+            @ApiImplicitParam(name = "userId", value = "用户ID（必填）", dataTypeClass = Integer.class, paramType = "body", required = true)
+    })
     @PostMapping("/create")
     public R<StoreStaffReview> createReview(@RequestBody StoreStaffReviewDto reviewDto) {
         log.info("创建员工评价, reviewDto={}", reviewDto);
@@ -43,8 +54,8 @@ public class StoreStaffReviewController {
     @ApiOperation("获取评价详情（包含评论和回复）")
     @ApiOperationSupport(order = 2)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataType = "int", paramType = "query")
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataTypeClass = Integer.class, paramType = "query", required = false)
     })
     @GetMapping("/detail/reviewId")
     public R<StoreStaffReviewDetailVo> getReviewDetail(
@@ -60,8 +71,8 @@ public class StoreStaffReviewController {
     @ApiOperation("点赞评价")
     @ApiOperationSupport(order = 3)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "userId", value = "用户ID", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/like")
     public R<Boolean> likeReview(@RequestParam Integer reviewId,
@@ -79,8 +90,8 @@ public class StoreStaffReviewController {
     @ApiOperation("取消点赞评价")
     @ApiOperationSupport(order = 4)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "userId", value = "用户ID", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/cancelLike")
     public R<Boolean> cancelLikeReview(@RequestParam Integer reviewId,
@@ -98,11 +109,11 @@ public class StoreStaffReviewController {
     @ApiOperation("分页查询评价列表")
     @ApiOperationSupport(order = 5)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "page", value = "页数（默认1）", dataType = "int", paramType = "query"),
-            @ApiImplicitParam(name = "size", value = "页容（默认10）", dataType = "int", paramType = "query"),
-            @ApiImplicitParam(name = "staffUserId", value = "员工用户ID", dataType = "int", paramType = "query"),
-            @ApiImplicitParam(name = "userId", value = "评价用户ID", dataType = "int", paramType = "query"),
-            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataType = "int", paramType = "query")
+            @ApiImplicitParam(name = "page", value = "页数（默认1）", dataTypeClass = Integer.class, paramType = "query", required = false),
+            @ApiImplicitParam(name = "size", value = "页容（默认10）", dataTypeClass = Integer.class, paramType = "query", required = false),
+            @ApiImplicitParam(name = "staffUserId", value = "员工用户ID", dataTypeClass = Integer.class, paramType = "query", required = false),
+            @ApiImplicitParam(name = "userId", value = "评价用户ID", dataTypeClass = Integer.class, paramType = "query", required = false),
+            @ApiImplicitParam(name = "currentUserId", value = "当前用户ID（用于判断是否已点赞）", dataTypeClass = Integer.class, paramType = "query", required = false)
     })
     @GetMapping("/list")
     public R<IPage<StoreStaffReviewVo>> getReviewList(
@@ -116,11 +127,11 @@ public class StoreStaffReviewController {
         return storeStaffReviewService.getReviewList(page, size, staffUserId, userId, currentUserId);
     }
 
-    @ApiOperation("用户删除评价（只能删除自己的评价，删除评价时，会级联删除该评价下的所有评论和回复）")
+    @ApiOperation(value = "用户删除评价", notes = "只能删除自己的评价，删除评价时，会级联删除该评价下的所有评论和回复")
     @ApiOperationSupport(order = 6)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataType = "int", paramType = "query", required = true),
-            @ApiImplicitParam(name = "userId", value = "用户ID（必填，只能删除自己的评价）", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "query", required = true),
+            @ApiImplicitParam(name = "userId", value = "用户ID（必填，只能删除自己的评价）", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/delete/reviewId")
     public R<Boolean> deleteReview(@RequestParam Integer reviewId,
@@ -135,10 +146,10 @@ public class StoreStaffReviewController {
         return storeStaffReviewService.deleteReview(reviewId, userId);
     }
 
-    @ApiOperation("管理员删除评价（可以删除任何评价，删除评价时，会级联删除该评价下的所有评论和回复）")
+    @ApiOperation(value = "管理员删除评价", notes = "可以删除任何评价，删除评价时，会级联删除该评价下的所有评论和回复")
     @ApiOperationSupport(order = 7)
     @ApiImplicitParams({
-            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataType = "int", paramType = "query", required = true)
+            @ApiImplicitParam(name = "reviewId", value = "评价ID", dataTypeClass = Integer.class, paramType = "query", required = true)
     })
     @PostMapping("/admin/delete/reviewId")
     public R<Boolean> deleteReviewByAdmin(@RequestParam Integer reviewId) {