会员管理代码

baqing-shop/src/main/java/com/ruoyi/web/modules/cart/service/impl/CartAppServiceImpl.java

@@ -6,9 +6,7 @@ import java.util.ArrayList;
 import java.util.Collections;
 import java.util.Comparator;
 import java.util.Date;
-import java.util.HashMap;
 import java.util.List;
-import java.util.Map;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
@@ -33,8 +31,8 @@ import com.ruoyi.web.modules.cart.vo.CartCheckoutPrepareVO;
 import com.ruoyi.web.modules.cart.vo.CartCleanInvalidResultVO;
 import com.ruoyi.web.modules.cart.vo.CartItemAddResultVO;
 import com.ruoyi.web.modules.cart.vo.CartItemVO;
+import com.ruoyi.web.modules.cart.vo.CartItemVO;
 import com.ruoyi.web.modules.cart.vo.CartListVO;
-import com.ruoyi.web.modules.cart.vo.CartShopGroupVO;
 import com.ruoyi.web.modules.category.facade.ICategoryFacade;
 import com.ruoyi.web.modules.goods.domain.BizGoods;
 import com.ruoyi.web.modules.goods.domain.BizGoodsAttr;
@@ -76,61 +74,18 @@ public class CartAppServiceImpl implements ICartAppService
         if (rows == null || rows.isEmpty())
         {
             CartListVO empty = new CartListVO();
-            empty.setGroups(Collections.emptyList());
+            empty.setItems(Collections.emptyList());
             empty.setCheckedSummary(emptySummary());
             return empty;
         }
-        Map<Long, CartShopGroupVO> groupMap = new HashMap<>();
-        Map<Long, Date> shopLastUpdate = new HashMap<>();
-        List<CartItemVO> allItems = new ArrayList<>();
+        List<CartItemVO> items = new ArrayList<>();
         for (CartItemRowDTO row : rows)
         {
-            CartItemVO item = toCartItemVO(row);
-            allItems.add(item);
-            CartShopGroupVO group = groupMap.get(row.getShopId());
-            if (group == null)
-            {
-                group = new CartShopGroupVO();
-                group.setShopId(row.getShopId());
-                group.setShopName(StringUtils.isNotEmpty(row.getShopName()) ? row.getShopName() : "");
-                group.setShopAvatar(row.getShopAvatar());
-                group.setShopStatus(row.getShopStatus());
-                groupMap.put(row.getShopId(), group);
-            }
-            group.getItems().add(item);
-            Date updateTime = row.getUpdateTime();
-            Date last = shopLastUpdate.get(row.getShopId());
-            if (updateTime != null && (last == null || updateTime.after(last)))
-            {
-                shopLastUpdate.put(row.getShopId(), updateTime);
-            }
-        }
-        List<Long> shopIds = new ArrayList<>(groupMap.keySet());
-        shopIds.sort((a, b) -> {
-            Date da = shopLastUpdate.get(a);
-            Date db = shopLastUpdate.get(b);
-            if (da == null && db == null)
-            {
-                return 0;
-            }
-            if (da == null)
-            {
-                return 1;
-            }
-            if (db == null)
-            {
-                return -1;
-            }
-            return db.compareTo(da);
-        });
-        List<CartShopGroupVO> groups = new ArrayList<>();
-        for (Long shopId : shopIds)
-        {
-            groups.add(groupMap.get(shopId));
+            items.add(toCartItemVO(row));
         }
         CartListVO vo = new CartListVO();
-        vo.setGroups(groups);
-        vo.setCheckedSummary(buildCheckedSummary(allItems));
+        vo.setItems(items);
+        vo.setCheckedSummary(buildCheckedSummary(items));
         return vo;
     }
 
@@ -365,6 +320,10 @@ public class CartAppServiceImpl implements ICartAppService
         vo.setPurchasable(purchasable);
         vo.setInvalidType(invalidType);
         vo.setInvalidMsg(CartInvalidSupport.resolveInvalidMsg(invalidType, null));
+        vo.setShopId(row.getShopId());
+        vo.setShopName(StringUtils.isNotEmpty(row.getShopName()) ? row.getShopName() : "");
+        vo.setShopAvatar(row.getShopAvatar());
+        vo.setShopStatus(row.getShopStatus());
         return vo;
     }
 

baqing-shop/src/main/java/com/ruoyi/web/modules/cart/vo/CartItemVO.java

@@ -31,6 +31,14 @@ public class CartItemVO
 
     private String invalidMsg;
 
+    private Long shopId;
+
+    private String shopName;
+
+    private String shopAvatar;
+
+    private String shopStatus;
+
     public Long getCartItemId()
     {
         return cartItemId;
@@ -150,4 +158,44 @@ public class CartItemVO
     {
         this.invalidMsg = invalidMsg;
     }
+
+    public Long getShopId()
+    {
+        return shopId;
+    }
+
+    public void setShopId(Long shopId)
+    {
+        this.shopId = shopId;
+    }
+
+    public String getShopName()
+    {
+        return shopName;
+    }
+
+    public void setShopName(String shopName)
+    {
+        this.shopName = shopName;
+    }
+
+    public String getShopAvatar()
+    {
+        return shopAvatar;
+    }
+
+    public void setShopAvatar(String shopAvatar)
+    {
+        this.shopAvatar = shopAvatar;
+    }
+
+    public String getShopStatus()
+    {
+        return shopStatus;
+    }
+
+    public void setShopStatus(String shopStatus)
+    {
+        this.shopStatus = shopStatus;
+    }
 }

baqing-shop/src/main/java/com/ruoyi/web/modules/cart/vo/CartListVO.java

@@ -8,18 +8,19 @@ import java.util.List;
  */
 public class CartListVO
 {
-    private List<CartShopGroupVO> groups;
+    /** 购物车条目列表（按 cartItemId 倒序；每条含店铺信息） */
+    private List<CartItemVO> items;
 
     private CartCheckedSummaryVO checkedSummary;
 
-    public List<CartShopGroupVO> getGroups()
+    public List<CartItemVO> getItems()
     {
-        return groups;
+        return items;
     }
 
-    public void setGroups(List<CartShopGroupVO> groups)
+    public void setItems(List<CartItemVO> items)
     {
-        this.groups = groups;
+        this.items = items;
     }
 
     public CartCheckedSummaryVO getCheckedSummary()

baqing-shop/src/main/java/com/ruoyi/web/modules/order/service/impl/SellerAftersaleServiceImpl.java

@@ -17,6 +17,7 @@ import com.ruoyi.web.modules.order.mapper.BizOrderAftersaleMapper;
 import com.ruoyi.web.modules.order.mapper.BizOrderMapper;
 import com.ruoyi.web.modules.order.service.ISellerAftersaleService;
 import com.ruoyi.web.modules.order.support.OrderAppSupport;
+import com.ruoyi.web.modules.pay.service.IOrderAftersaleRefundService;
 import com.ruoyi.web.modules.order.vo.SellerAftersaleDetailVO;
 import com.ruoyi.web.modules.order.vo.SellerAftersaleListRowVO;
 
@@ -32,6 +33,9 @@ public class SellerAftersaleServiceImpl implements ISellerAftersaleService
     @Autowired
     private OrderAppSupport orderAppSupport;
 
+    @Autowired
+    private IOrderAftersaleRefundService orderAftersaleRefundService;
+
     @Override
     public List<SellerAftersaleListRowVO> selectSellerList(Long shopId, SellerAftersaleQuery query)
     {
@@ -90,6 +94,7 @@ public class SellerAftersaleServiceImpl implements ISellerAftersaleService
             throw new ServiceException(OrderAppConstants.MSG_AFTERSALE_ALREADY_FINISHED);
         }
         orderMapper.updateForAftersaleClose(aftersale.getOrderId(), shopId, OrderConstants.CLOSE_TYPE_REFUND, operator);
+        orderAftersaleRefundService.refundOnAftersaleFinish(aftersale);
     }
 
     private void enrichListRow(SellerAftersaleListRowVO row)

baqing-shop/src/main/java/com/ruoyi/web/modules/pay/constant/PayConstants.java

@@ -53,4 +53,22 @@ public final class PayConstants
     public static final String MSG_APPLY_NOT_PENDING = "当前申请不在审核中";
 
     public static final String MSG_APPLY_REJECT_REMARK_REQUIRED = "请填写驳回原因";
+
+    public static final String REFUND_STATUS_PENDING = "0";
+
+    public static final String REFUND_STATUS_SUCCESS = "1";
+
+    public static final String REFUND_STATUS_FAILED = "2";
+
+    public static final String REFUND_STATUS_PROCESSING = "3";
+
+    public static final String REFUND_NO_PREFIX = "RF";
+
+    public static final String MSG_REFUND_PAY_NOT_FOUND = "未找到可退款的支付记录";
+
+    public static final String MSG_REFUND_AMOUNT_INVALID = "退款金额无效";
+
+    public static final String MSG_REFUND_EXCEED = "退款金额超出可退余额";
+
+    public static final String MSG_REFUND_FAILED = "微信退款失败，请稍后重试";
 }

baqing-shop/src/main/java/com/ruoyi/web/modules/pay/support/WeChatPaySupport.java

@@ -44,6 +44,8 @@ public class WeChatPaySupport
 {
     private static final String JSAPI_URL = "https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi";
 
+    private static final String REFUND_URL = "https://api.mch.weixin.qq.com/v3/refund/domestic/refunds";
+
     private static final String CODE2SESSION_URL = "https://api.weixin.qq.com/sns/jscode2session";
 
     private final WeChatPayProperties payProperties;
@@ -109,6 +111,49 @@ public class WeChatPaySupport
         return result.getString("prepay_id");
     }
 
+    /**
+     * 微信 V3 境内退款（同步返回 SUCCESS / PROCESSING 视为受理成功）
+     *
+     * @return 微信 refund_id
+     */
+    public String createDomesticRefund(String transactionId, String outRefundNo, BigDecimal totalAmount,
+            BigDecimal refundAmount, String reason, String mchId)
+    {
+        assertPayConfigReady();
+        if (StringUtils.isEmpty(transactionId) || StringUtils.isEmpty(outRefundNo))
+        {
+            throw new ServiceException(PayConstants.MSG_REFUND_FAILED);
+        }
+        int totalFen = totalAmount.multiply(BigDecimal.valueOf(100)).setScale(0, RoundingMode.HALF_UP).intValueExact();
+        int refundFen = refundAmount.multiply(BigDecimal.valueOf(100)).setScale(0, RoundingMode.HALF_UP).intValueExact();
+        if (refundFen <= 0 || refundFen > totalFen)
+        {
+            throw new ServiceException(PayConstants.MSG_REFUND_AMOUNT_INVALID);
+        }
+        JSONObject amount = new JSONObject();
+        amount.put("refund", refundFen);
+        amount.put("total", totalFen);
+        amount.put("currency", "CNY");
+        JSONObject payload = new JSONObject();
+        payload.put("transaction_id", transactionId);
+        payload.put("out_refund_no", outRefundNo);
+        payload.put("reason", StringUtils.isEmpty(reason) ? "售后退款" : reason);
+        payload.put("amount", amount);
+        String body = payload.toJSONString();
+        String response = postSigned(REFUND_URL, body, mchId);
+        JSONObject result = JSON.parseObject(response);
+        if (result == null || StringUtils.isEmpty(result.getString("refund_id")))
+        {
+            throw new ServiceException(PayConstants.MSG_REFUND_FAILED);
+        }
+        String status = result.getString("status");
+        if (!"SUCCESS".equals(status) && !"PROCESSING".equals(status))
+        {
+            throw new ServiceException(PayConstants.MSG_REFUND_FAILED);
+        }
+        return result.getString("refund_id");
+    }
+
     public Map<String, String> buildJsapiPayParams(String prepayId)
     {
         String timeStamp = String.valueOf(System.currentTimeMillis() / 1000);

baqing-shop/src/main/resources/mapper/cart/CartAppMapper.xml

@@ -29,7 +29,7 @@
     <select id="selectItemRowsByMemberId" resultType="com.ruoyi.web.modules.cart.dto.CartItemRowDTO">
         <include refid="cartItemSelect"/>
         where c.member_id = #{memberId}
-        order by c.update_time desc, c.cart_item_id desc
+        order by c.cart_item_id desc
     </select>
 
     <select id="selectItemRowsByIdsAndMember" resultType="com.ruoyi.web.modules.cart.dto.CartItemRowDTO">

baqing-shop/src/test/java/com/ruoyi/web/modules/cart/controller/CartAppControllerTest.java

@@ -78,7 +78,7 @@ class CartAppControllerTest
     {
         MemberContext.setMemberId(MEMBER_ID);
         CartListVO list = new CartListVO();
-        list.setGroups(Collections.emptyList());
+        list.setItems(Collections.emptyList());
         CartCheckedSummaryVO summary = new CartCheckedSummaryVO();
         summary.setCheckedCount(0);
         summary.setCheckedQuantity(0);
@@ -89,7 +89,7 @@ class CartAppControllerTest
         mockMvc.perform(get("/api/cart"))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.code").value(200))
-                .andExpect(jsonPath("$.data.groups").isArray());
+                .andExpect(jsonPath("$.data.items").isArray());
 
         verify(cartAppService).list(MEMBER_ID);
     }

baqing-shop/src/test/java/com/ruoyi/web/modules/cart/service/CartAppServiceImplTest.java

@@ -76,21 +76,24 @@ class CartAppServiceImplTest
 
         CartListVO vo = cartAppService.list(MEMBER_ID);
 
-        assertEquals(0, vo.getGroups().size());
+        assertEquals(0, vo.getItems().size());
         assertEquals(0, vo.getCheckedSummary().getCheckedCount());
     }
 
     @Test
-    void list_groupsByShop()
+    void list_returnsFlatItemsWithShop()
     {
         when(memberFacade.isMemberEnabled(MEMBER_ID)).thenReturn(true);
-        when(cartAppMapper.selectItemRowsByMemberId(MEMBER_ID)).thenReturn(Arrays.asList(cartRow(1L, 101L),
-                cartRow(2L, 102L)));
+        when(cartAppMapper.selectItemRowsByMemberId(MEMBER_ID)).thenReturn(Arrays.asList(cartRow(2L, 102L),
+                cartRow(1L, 101L)));
         when(categoryFacade.isCategoryVisible(10L)).thenReturn(true);
 
         CartListVO vo = cartAppService.list(MEMBER_ID);
 
-        assertEquals(2, vo.getGroups().size());
+        assertEquals(2, vo.getItems().size());
+        assertEquals(2L, vo.getItems().get(0).getCartItemId().longValue());
+        assertEquals(102L, vo.getItems().get(0).getShopId().longValue());
+        assertEquals("测试店", vo.getItems().get(0).getShopName());
         assertEquals(2, vo.getCheckedSummary().getCheckedCount());
     }
 

baqing-shop/src/test/java/com/ruoyi/web/modules/order/service/SellerAftersaleServiceImplTest.java

@@ -23,6 +23,7 @@ import com.ruoyi.web.modules.order.mapper.BizOrderAftersaleMapper;
 import com.ruoyi.web.modules.order.mapper.BizOrderMapper;
 import com.ruoyi.web.modules.order.service.impl.SellerAftersaleServiceImpl;
 import com.ruoyi.web.modules.order.support.OrderAppSupport;
+import com.ruoyi.web.modules.pay.service.IOrderAftersaleRefundService;
 import com.ruoyi.web.modules.order.vo.SellerAftersaleDetailVO;
 import com.ruoyi.web.modules.order.vo.SellerAftersaleListRowVO;
 
@@ -42,6 +43,9 @@ class SellerAftersaleServiceImplTest
     @Mock
     private OrderAppSupport orderAppSupport;
 
+    @Mock
+    private IOrderAftersaleRefundService orderAftersaleRefundService;
+
     @InjectMocks
     private SellerAftersaleServiceImpl sellerAftersaleService;
 
@@ -93,6 +97,7 @@ class SellerAftersaleServiceImplTest
 
         verify(aftersaleMapper).updateForFinish(any(BizOrderAftersale.class));
         verify(orderMapper).updateForAftersaleClose(500L, SHOP_ID, OrderConstants.CLOSE_TYPE_REFUND, "seller01");
+        verify(orderAftersaleRefundService).refundOnAftersaleFinish(aftersale);
     }
 
     @Test

doc/店铺后台/售后管理/售后管理技术方案.md

@@ -2,8 +2,8 @@
 
 > **依据：** 《售后管理功能需求.md》v1.0  
 > **关联：** C 端《我的订单技术方案》v1.2；平台《订单管理技术方案》v1.0.2、《订单管理功能需求.md》v1.0.1、《关联需求分析.md》v1.6；商家《全部订单技术方案》v1.0.2、《发货管理技术方案》v1.0、《商家端店铺上下文接口说明》  
-> **范围：** 商家端 **订单管理 · 售后管理** — 当前店铺售后列表、检索、详情、**处理完结**；**不含** C 端提交售后（已有 `OrderAftersaleAppController`）、退款原路退回、平台仲裁。  
-> **原则：** **无新建表**；读写 **`biz_order_aftersale`**；`shop_id = X-Shop-Id` 隔离；与 C 端 **同表同源**；完结 **仅更新** `process_result / aftersale_status / finish_time`；**不** 改订单主状态、**不** 自动退款/回库存。
+> **范围：** 商家端 **订单管理 · 售后管理** — 当前店铺售后列表、检索、详情、**处理完结**；**不含** C 端提交售后（已有 `OrderAftersaleAppController`）、平台仲裁。**退款** 在商家 **处理完结** 时 **自动原路退回**（见 §8.5）。
+> **原则：** 读写 **`biz_order_aftersale`**、**`biz_refund_record`**；`shop_id = X-Shop-Id` 隔离；与 C 端 **同表同源**；完结 **更新** `process_result / aftersale_status / finish_time` 并 **关单**、**触发退款**。
 
 ---
 
@@ -246,19 +246,32 @@ LEFT JOIN biz_order_item oi ON a.order_item_id = oi.item_id
 |------|------|
 | 前置 | `shop_id` 匹配；`aftersale_status = '1'` |
 | 校验 | `processResult` 非空；长度 ≤1000 |
-| 效果 | `UPDATE` `process_result, aftersale_status='2', finish_time=NOW(), update_time=NOW()` |
+| 效果 | `UPDATE` 售后完结；订单 **关单**（`order_status→4`，`close_type=4`）；**自动退款** |
 | 幂等 | 已完结再次调用 → 业务错误「售后已完结，不可重复处理」 |
-| 订单/库存/退款 | **不** 触发 |
+| 退款 | 调用 `OrderAftersaleRefundServiceImpl.refundOnAftersaleFinish`；金额=`apply_amount`；Mock 模式直成功；真实模式调微信 V3 `/v3/refund/domestic/refunds` |
+| 库存 | **不** 自动回滚 |
 
 ```text
 商家点击「处理售后」
     → PUT /finish
     → SellerAftersaleServiceImpl.finish
     → BizOrderAftersaleMapper.updateForFinish
+    → BizOrderMapper.updateForAftersaleClose
+    → OrderAftersaleRefundServiceImpl.refundOnAftersaleFinish
     → C 端 GET detail 自动读到 processResult + FINISHED
 ```
 
-### 3.5 业务错误 msg
+### 3.5 自动退款（`biz_refund_record`）
+
+| 项 | 说明 |
+|----|------|
+| 触发 | 商家 **处理完结** 成功后 **同步** 发起 |
+| 金额 | 售后 `apply_amount`；须 ≤ 支付成功金额且 ≤ 订单可退余额 |
+| 幂等 | `uk_aftersale_id`；同一售后仅退款一次 |
+| Mock | `wechat.pay.mock=true` 或 `enabled=false` 时写入 `MOCK_RF{aftersale_no}` |
+| 失败 | 抛业务异常，**整笔 finish 事务回滚**（售后/关单/退款均不生效） |
+
+### 3.6 业务错误 msg
 
 | 场景 | msg |
 |------|-----|
@@ -266,6 +279,8 @@ LEFT JOIN biz_order_item oi ON a.order_item_id = oi.item_id
 | 越权/不存在 | 售后单不存在或无权访问（`OrderAppConstants.MSG_AFTERSALE_NOT_FOUND`） |
 | 非进行中 | 售后已完结，不可重复处理 |
 | 处理结果为空 | 请填写处理结果 |
+| 无可退支付 | 未找到可退款的支付记录 |
+| 退款失败 | 微信退款失败，请稍后重试 |
 
 ---
 

doc/消费者APP/我的订单/我的订单前端技术方案.md

@@ -152,6 +152,7 @@ onShow → getOrderBadges()
 onLoad(query.tab)
     → listOrders({ tab, pageNum, pageSize })
     → mapOrderListRow(row)
+        → card.statusText：有 aftersaleStatus 时展示「售后处理中/售后已完成」，否则 orderStatusText
         → card.items[] 逐行渲染 OrderGoodsRow
         → 已完成：行内 reviewStatus=PENDING →「评价」；DONE →「查看评价」
     → 底部 OrderActionBar：过滤 REVIEW / VIEW_REVIEW，仅 PAY / 确认收货 / 售后 / 再买一单
@@ -206,9 +207,14 @@ review-edit?orderId=&orderItemId=
 ## 6. 展示映射 `orderDisplay.js`
 
 - `mapOrderListRow`：`items[]` 全量映射；`firstItem = items[0]` 兼容
+- **列表状态文案：**
+  - 透传 `orderStatusText`（订单主状态）
+  - 透传 `aftersaleStatus`（`null` / `1` / `2`）
+  - `statusText`（卡片展示）：`aftersaleStatus === '1'` → **售后处理中**；`'2'` → **售后已完成**；否则 **orderStatusText**
 - 单行含 `reviewStatus`（`PENDING` / `DONE` / `NONE`）、`orderItemId`
 - `footerActions(actions)`：过滤 `REVIEW`、`VIEW_REVIEW`
 - `showItemReview(orderId, orderItemId)`：弹窗展示已评内容（`orderAction.js`）
+- 售后专区列表/详情仍用 `mapAftersaleStatusText`（商家处理中 / 售后完结），与 **订单列表** 文案区分
 
 ---
 
@@ -234,6 +240,7 @@ review-edit?orderId=&orderItemId=
 | F6 | 底部无整单「评价」按钮 |
 | F7 | 评价提交后该行变「查看评价」 |
 | F8 | 售后提交后进进行中列表 |
+| F9 | 列表存在 aftersaleStatus=1 → 卡片状态「售后处理中」；=2 →「售后已完成」；null → orderStatusText |
 
 ---
 
@@ -241,10 +248,11 @@ review-edit?orderId=&orderItemId=
 
 | 版本 | 说明 |
 |------|------|
+| **v1.3** | 订单列表 `aftersaleStatus` 前端映射 statusText；与后端 orderStatusText 分离 |
 | **v1.2** | 列表/详情/评价列表：`items[]` 全量；行内评价；底部 actions 去评价 |
 | **v1.0** | 首版：路由、API、页面流程、与后端接口对齐 |
 | **v1.1** | 落地 list/detail/review/aftersale 分包页、个人中心订单入口与角标、公共组件 |
 
 ---
 
-*文档版本：v1.2 · 关联《我的订单功能需求.md》v1.1、《我的订单技术方案.md》v1.2*
+*文档版本：v1.3 · 关联《我的订单功能需求.md》v1.2、《我的订单技术方案.md》v1.3*

doc/消费者APP/我的订单/我的订单功能需求.md

@@ -220,7 +220,7 @@
 |------|------|
 | 店铺 | **店铺头像、名称**（可读实时档或下单快照，以前台为准） |
 | 商品摘要 | **全部商品行**：主图、名称、规格、单价、数量；已完成订单 **行内**「评价/查看评价」 |
-| 订单状态 | 待付款 / 待发货 / 待收货 / 交易成功 / 已关闭 等 **C 端文案** |
+| 订单状态 | **主状态**（待付款/待发货/待收货/交易成功/已关闭）；**存在售后时** 卡片状态区优先展示 **售后处理中**（进行中）或 **售后已完成**（已完结），以前台映射为准 |
 | 应付/实付 | **实付金额**（含运费）；待支付展示 **应付总额** |
 | 下单时间 | |
 | 操作按钮 | 卡片底部：**去支付、确认收货、申请售后、再次购买**；**评价在行内**（非底部整单按钮） |
@@ -232,6 +232,7 @@
 | **MO-L1** | 默认 **不展示** 他人订单、平台已删除订单 |
 | **MO-L2** | 支持下拉 **刷新**；分页加载（交互以前台为准） |
 | **MO-L3** | 空列表展示 **空态提示** 与 **去逛逛** 引导 |
+| **MO-L4** | 接口返回 `aftersaleStatus` 时，列表卡片 **优先展示售后状态文案**（处理中/已完成）；**不改变** 订单主状态字段语义 |
 
 ---
 
@@ -575,8 +576,9 @@
 | 版本 | 说明 |
 |------|------|
 | **v1.1** | 列表全量商品行；评价改 **一行一评**；行内评价按钮；底部不含整单评价 |
+| **v1.2** | 列表返回售后状态 `aftersaleStatus`；卡片 **售后文案由 C 端前台展示**（MO-L4） |
 | **v1.0** | 首版定稿：订单列表/详情、角标、待支付续付、确认收货、评价、售后；与平台订单 O3/O7/O8/O13 及确认订单/会员/商品边界对齐；草稿保持不变 |
 
 ---
 
-*文档版本：v1.1（定稿）· 关联《我的订单功能需求-草稿.md》、《订单管理功能需求.md》v1.0.1、《会员管理功能需求.md》v1.1、《确认订单页（多商品）功能需求.md》v1.1、《确认订单页（单商品）功能需求.md》v1.0、《购物车功能需求.md》v1.0、《商品详情内页功能需求.md》v1.0、《我的服务功能需求.md》v1.1、《关联需求分析.md》v1.6 · 草稿保持不变。*
+*文档版本：v1.2（定稿）· 关联《我的订单功能需求-草稿.md》、《订单管理功能需求.md》v1.0.1、《会员管理功能需求.md》v1.1、《确认订单页（多商品）功能需求.md》v1.1、《确认订单页（单商品）功能需求.md》v1.0、《购物车功能需求.md》v1.0、《商品详情内页功能需求.md》v1.0、《我的服务功能需求.md》v1.1、《关联需求分析.md》v1.6 · 草稿保持不变。*

doc/消费者APP/购物车/购物车前端技术方案.md

@@ -12,7 +12,7 @@
 | 项 | 说明 |
 |----|------|
 | 框架 | uni-app **Vue 3** + **uview-plus** |
-| 请求 | `@/utils/request`；列表为 `AjaxResult.data`（`groups` + `checkedSummary`） |
+| 请求 | `@/utils/request`；列表为 `AjaxResult.data`（`items` + `checkedSummary`） |
 | 鉴权 | **全部** `/api/cart/**` 须会员 Token |
 | 页面位置 | **主包 Tab** `pages/cart/index`（与 `pages.json` tabBar 一致） |
 | 规格 v1 | 统一规格；加购 `specKey` 不传， `specText` 由详情拼接或「默认」 |
@@ -143,7 +143,7 @@ onShow
 
 | 函数 | 用途 |
 |------|------|
-| `mapCartList` | `data` → `groups` + `checkedSummary` |
+| `mapCartList` | `data.items` → 页面 `items`；`groupCartItemsByShop` 生成 UI 用 `groups` + `checkedSummary` |
 | `hasInvalidCartItems` | 是否显示「清理失效」 |
 | `getCheckedPurchasableIds` | 去结算入参 |
 | `getCheckedShopIds` | 跨店校验 |

doc/消费者APP/购物车/购物车技术方案.md

@@ -68,7 +68,7 @@ category/（已有 · 协作）
         → 四条件校验 + 同规格合并累加
 
 【本模块】
-    GET  /api/cart                         → 按店分组列表 + 失效标签
+    GET  /api/cart                         → 条目列表（cartItemId 倒序，含店铺）+ 勾选合计
     PUT  /api/cart/items/{id}/quantity     → 改数量（≤库存）
     PUT  /api/cart/items/checked           → 批量更新勾选
     DELETE /api/cart/items/{id}            → 移出
@@ -201,7 +201,7 @@ CREATE TABLE IF NOT EXISTS `biz_member_cart_item` (
 
 | 方法 | 路径 | 说明 |
 |------|------|------|
-| GET | `/api/cart` | 购物车列表（按店分组） |
+| GET | `/api/cart` | 购物车条目列表 |
 | POST | `/api/cart/items` | **加购**（详情页调用） |
 | PUT | `/api/cart/items/{cartItemId}/quantity` | 修改数量 |
 | PUT | `/api/cart/items/checked` | 批量更新勾选 |
@@ -229,18 +229,9 @@ CREATE TABLE IF NOT EXISTS `biz_member_cart_item` (
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
-| groups | array | 按店分组，见下 |
+| items | array | **购物车条目列表**（主结构），见下 |
 | checkedSummary | object | 当前 **已勾选且可购** 行合计（前端底栏参考） |
 
-**`groups[]` → `CartShopGroupVO`：**
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| shopId | long | 进店参数 |
-| shopName | string | 实时 |
-| shopStatus | string | `0` 开业 / `1` 停业 |
-| items | array | `CartItemVO[]` |
-
 **`items[]` → `CartItemVO`：**
 
 | 字段 | 类型 | 说明 |
@@ -257,15 +248,14 @@ CREATE TABLE IF NOT EXISTS `biz_member_cart_item` (
 | purchasable | boolean | 是否可勾选结算 |
 | invalidType | string | §2.4 枚举；可购时为 `NONE` |
 | invalidMsg | string | 前端 Toast/标签；可购时 null |
+| shopId | long | 所属店铺 |
+| shopName | string | 店铺名称（实时） |
+| shopAvatar | string | 店铺头像 |
+| shopStatus | string | `0` 开业 / `1` 停业 |
 
-**排序：**
-
-| 维度 | 规则 |
-|------|------|
-| 店组 | `MAX(update_time) DESC` |
-| 组内 | `update_time DESC` |
+**排序：** `cart_item_id DESC`（最新加购/合并行在前）。
 
-**空态：** `groups=[]` → 前端「购物车是空的」。
+**空态：** `items=[]` → 前端「购物车是空的」。
 
 **`checkedSummary`：**
 

sql/biz_refund_record.sql

@@ -0,0 +1,29 @@
+-- =============================================================================
+-- 退款流水 biz_refund_record
+-- 用途：售后完结后原路退款（微信 V3）；幂等键 aftersale_id
+-- 前置：biz_order_aftersale.sql、biz_pay_record.sql
+-- =============================================================================
+
+CREATE TABLE IF NOT EXISTS `biz_refund_record` (
+  `refund_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '退款记录ID',
+  `aftersale_id` bigint(20) NOT NULL COMMENT '售后ID（biz_order_aftersale.aftersale_id）',
+  `aftersale_no` varchar(32) NOT NULL COMMENT '售后编号',
+  `order_id` bigint(20) NOT NULL COMMENT '订单ID',
+  `order_no` varchar(32) NOT NULL COMMENT '订单编号',
+  `pay_id` bigint(20) NOT NULL COMMENT '支付流水ID（biz_pay_record.pay_id）',
+  `member_id` bigint(20) NOT NULL COMMENT '会员ID',
+  `shop_id` bigint(20) NOT NULL COMMENT '店铺ID',
+  `out_refund_no` varchar(64) NOT NULL COMMENT '商户退款单号（RF+售后编号）',
+  `wx_refund_id` varchar(64) DEFAULT NULL COMMENT '微信退款单号',
+  `refund_amount` decimal(12,2) NOT NULL COMMENT '退款金额（元）',
+  `refund_status` char(1) NOT NULL DEFAULT '0' COMMENT '0待退款 1成功 2失败 3处理中',
+  `fail_reason` varchar(256) DEFAULT NULL COMMENT '失败原因',
+  `notify_time` datetime DEFAULT NULL COMMENT '退款完成时间',
+  `create_time` datetime NOT NULL COMMENT '创建时间',
+  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
+  PRIMARY KEY (`refund_id`),
+  UNIQUE KEY `uk_aftersale_id` (`aftersale_id`),
+  UNIQUE KEY `uk_out_refund_no` (`out_refund_no`),
+  KEY `idx_order_id` (`order_id`),
+  KEY `idx_refund_status` (`refund_status`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='售后退款流水';