Просмотр исходного кода

feat(shop.review.my): S-cfc-404 我的评价/待评价入口 R5 实现使绿

- ProductReviewService/Impl 新增 my(Long userId, int page, int size): Map
  (reviews[] 按 review_at 倒序分页 + reviewableOrders[] + reviewableCount,
   待评价口径复用 findReviewableOrderIds:completed 且 90 天内且未评且非 activity)
- ProductReviewController 新增 POST /api/product/review/my,@RequestAttribute("userId") 登录买家
- API_REFERENCE.md 同步登记 R5 接口
- ProductReviewMyContractTest 10/10 全绿(此前红 3:controller my 路由/鉴权参数、service 契约)
zxyj-langgraph 1 день назад
Родитель
Сommit
3f80f84630

+ 13 - 4
cfc-backend/src/main/java/com/etotem/cfc/controller/product/ProductReviewController.java

@@ -10,13 +10,14 @@ import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import javax.annotation.Resource;
+import java.util.Map;
 
 /**
- * 普通商品评价控制器(能力键 {@code shop.review.create},R1)。
+ * 普通商品评价控制器(能力键 {@code shop.review.create} / {@code shop.review.my})。
  *
- * <p>设计 {@code docs/superpowers/specs/2026-11-14-product-order-gap-arch-design.md} §3.1 R1:
- * {@code POST /api/product/review/create},鉴权=登录(买家本人),入参
- * {@code {orderId, rating(1-5), reviewText(≤500), images[]≤3}},出参 {@code Result<String>}。
+ * <p>设计 {@code docs/superpowers/specs/2026-11-14-product-order-gap-arch-design.md} §3.1:
+ * R1 {@code POST /api/product/review/create}(鉴权=登录买家本人)、
+ * R5 {@code POST /api/product/review/my}(鉴权=登录买家)。
  * 对齐 {@code ProductOrderController} 同点位 {@code @RequestAttribute("userId")} 写法。</p>
  */
 @RestController
@@ -32,4 +33,12 @@ public class ProductReviewController {
         String result = reviewService.createReview(request, userId);
         return Result.success(result);
     }
+
+    @PostMapping("/my")
+    public Result<Map<String, Object>> my(@RequestBody Map<String, Object> params,
+                                          @RequestAttribute("userId") Long userId) {
+        int page = params.get("page") instanceof Number ? ((Number) params.get("page")).intValue() : 1;
+        int size = params.get("size") instanceof Number ? ((Number) params.get("size")).intValue() : 10;
+        return Result.success(reviewService.my(userId, page, size));
+    }
 }

+ 19 - 1
cfc-backend/src/main/java/com/etotem/cfc/service/ProductReviewService.java

@@ -2,8 +2,10 @@ package com.etotem.cfc.service;
 
 import com.etotem.cfc.dto.ProductReviewRequest;
 
+import java.util.Map;
+
 /**
- * 普通商品评价服务(能力键 {@code shop.review.create})。
+ * 普通商品评价服务(能力键 {@code shop.review.create} / {@code shop.review.my})。
  *
  * <p>独立于活动评价 {@link ReviewOrderService}(PRD P0-A:活动链路零改动,不走复用)。
  * 设计 {@code docs/superpowers/specs/2026-11-14-product-order-gap-arch-design.md} §5.3 类图。</p>
@@ -18,4 +20,20 @@ public interface ProductReviewService {
      * @return 成功消息;校验不通过抛 {@link RuntimeException}
      */
     String createReview(ProductReviewRequest request, Long reviewerId);
+
+    /**
+     * 我的评价 + 待评价入口(R5,能力键 {@code shop.review.my})。
+     *
+     * <p>设计 §3.1 R5:出参 {@code {reviews[], reviewableOrders[], reviewableCount}}。
+     * {@code reviews[]} 为当前买家按 {@code review_at} 倒序分页的我的评价列表;
+     * {@code reviewableOrders[]} 为待评价订单(completed 且 90 天窗口内且未评且
+     * 非 activity 的买家本人订单,见 {@code ProductReviewMapper.findReviewableOrderIds}),
+     * {@code reviewableCount} = 待评价条数。</p>
+     *
+     * @param userId 登录买家 userId(鉴权=登录买家,本人数据)
+     * @param page   页码(从 1 开始)
+     * @param size   每页条数
+     * @return Map:{reviews[], reviewableOrders[], reviewableCount}
+     */
+    Map<String, Object> my(Long userId, int page, int size);
 }

+ 51 - 1
cfc-backend/src/main/java/com/etotem/cfc/service/ProductReviewServiceImpl.java

@@ -11,12 +11,16 @@ import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
 import javax.annotation.Resource;
+import java.util.ArrayList;
 import java.util.Calendar;
+import java.util.Collections;
 import java.util.Date;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
 
 /**
- * 普通商品评价服务实现(能力键 {@code shop.review.create},R1)。
+ * 普通商品评价服务实现(能力键 {@code shop.review.create} / {@code shop.review.my})。
  *
  * <p>设计 {@code docs/superpowers/specs/2026-11-14-product-order-gap-arch-design.md} §3.1 R1 校验链:
  * 订单存在 / {@code productType != 'activity'}(活动评价零污染)/ {@code status=completed} /
@@ -104,4 +108,50 @@ public class ProductReviewServiceImpl extends ServiceImpl<ProductReviewMapper, P
         reviewMapper.insert(review);
         return "评价提交成功";
     }
+
+    @Override
+    public Map<String, Object> my(Long userId, int page, int size) {
+        int pageNum = Math.max(page, 1);
+        int pageSize = Math.max(size, 1);
+
+        Map<String, Object> result = new HashMap<>();
+
+        // 1) 我的评价列表:按 reviewer_id 查,review_at 倒序分页(只取首屏页规模,不做总数统计——
+        //    小程序「我的评价」为简单列表,翻页按 offset 拉取即可)
+        List<ProductReview> reviews = lambdaQuery()
+                .eq(ProductReview::getReviewerId, userId)
+                .orderByDesc(ProductReview::getReviewAt)
+                .last("LIMIT " + ((long) (pageNum - 1) * pageSize) + "," + pageSize)
+                .list();
+        result.put("reviews", reviews == null ? Collections.emptyList() : reviews);
+
+        // 2) 待评价订单:completed 且 90 天窗口内、且未评、且非 activity 的买家本人订单
+        Calendar cal = Calendar.getInstance();
+        cal.add(Calendar.DAY_OF_MONTH, -REVIEW_WINDOW_DAYS);
+        List<Long> reviewableOrderIds = reviewMapper.findReviewableOrderIds(userId, cal.getTime());
+        if (reviewableOrderIds == null || reviewableOrderIds.isEmpty()) {
+            result.put("reviewableOrders", Collections.emptyList());
+            result.put("reviewableCount", 0);
+            return result;
+        }
+
+        // selectBatchIds 不保序,按 findReviewableOrderIds 返回的 confirm_time 倒序顺序重组
+        List<ProductOrder> fetched = productOrderMapper.selectBatchIds(reviewableOrderIds);
+        Map<Long, ProductOrder> byId = new HashMap<>();
+        if (fetched != null) {
+            for (ProductOrder o : fetched) {
+                byId.put(o.getId(), o);
+            }
+        }
+        List<ProductOrder> reviewableOrders = new ArrayList<>();
+        for (Long id : reviewableOrderIds) {
+            ProductOrder o = byId.get(id);
+            if (o != null) {
+                reviewableOrders.add(o);
+            }
+        }
+        result.put("reviewableOrders", reviewableOrders);
+        result.put("reviewableCount", reviewableOrders.size());
+        return result;
+    }
 }

+ 1 - 0
docs/superpowers/api/API_REFERENCE.md

@@ -670,6 +670,7 @@ find cfc-backend/src/main/java -name "*XxxService.java" -o -name "*XxxController
 | `POST /api/product/order/ship` | 服务商/管理端发货(填物流单号+快递公司)。发货成功后自动调用微信「小程序交易管理服务」`upload_shipping_info` 同步物流到微信订单管理(用户在微信侧收发货通知/查物流/确认收货);自提订单或无单号跳过;失败只记日志不阻塞(fail-open);`wechat.test-mode=true` 或 `wechat.fulfillment-enabled=false`(环境变量 `WECHAT_FULFILLMENT_ENABLED`)时跳过 |
 | `POST /api/product/order/review/update` | 供应商审核修改待支付订单(修改价格/配送方式/添加优惠券/赠品) |
 | `POST /api/product/review/create` | 创建商品订单评价(能力键 `shop.review.create`;普通商品订单 completed 后一单一评:综合星级1-5+文字≤500字+晒图≤3张、确认收货90天内,独立表 product_reviews,活动评价零污染) |
+| `POST /api/product/review/my` | 我的评价 + 待评价入口(能力键 `shop.review.my`;登录买家本人:`{reviews[], reviewableOrders[], reviewableCount}`,reviews=按评价时间倒序分页的我的评价列表,reviewableOrders=待评价订单(completed 且 90 天内且未评且非 activity 的买家本人订单),reviewableCount=待评价条数) |
 | `POST /api/cart/add` | 加入购物车 |
 | `POST /api/cart/list` | 购物车列表 |
 | `POST /api/cart/update` | 更新数量 |