售后

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

@@ -1,9 +1,9 @@
 # 我的订单 — 前端技术方案（C 端 · shop-app）
 
-> **依据：** 《我的订单功能需求.md》v1.1、《我的订单技术方案.md》v1.2  
-> **关联：** 《确认订单页（多商品）前端技术方案》、《确认订单页（单商品）前端技术方案》  
+> **依据：** 《我的订单功能需求.md》v1.2、《我的订单技术方案.md》v1.3  
+> **关联：** 《确认订单页（多商品）前端技术方案》、《确认订单页（单商品）前端技术方案》、《购物车前端技术方案》  
 > **范围：** 消费者 APP **`shop-app`** 个人中心订单入口、订单列表/详情、续付、确认收货、评价、售后。  
-> **实现状态：** v1.2 — 列表展示 **全部商品行**；评价在 **行内按钮**；底部 **无** 整单评价按钮。
+> **实现状态：** v1.4 — 列表 **售后状态优先展示**（MO-L4）、待付款 **应付** 文案、全量商品行 + 行内评价已落地。
 
 ---
 
@@ -16,6 +16,7 @@
 | 鉴权 | 进入页 **`ensureApiToken()`**；无 Token → 引导登录 |
 | 分页 | 列表 `pageNum` / `pageSize`；下拉刷新 + 上拉加载 |
 | 支付 v1 | **Mock 弹窗** + `payOrder`；与确认订单共用 |
+| 防抖 | 列表/详情操作 `useActionGuard` |
 | 再买一单 | 跳转 `subpackage/goods/detail?id={goodsId}` |
 
 ---
@@ -27,7 +28,8 @@
 | 个人中心订单区 | `pages/mine/index`（区块） | 角标 + 快捷入口 |
 | 订单列表 | `subpackage/order/list` | tab + 分页列表 |
 | 订单详情 | `subpackage/order/detail` | 分状态展示与操作 |
-| 评价列表 | `subpackage/order/review-list` | 待评价/已评价 |
+| 评价列表 | `subpackage/order/review-list` | 待评价/已评价（展平商品行） |
+| 评价查看 | `subpackage/order/review-view` | 全页查看评价 |
 | 评价编辑 | `subpackage/order/review-edit` | 打星+图文 |
 | 售后列表 | `subpackage/order/aftersale-list` | 进行中/已完结 |
 | 售后详情 | `subpackage/order/aftersale-detail` | 进度+处理结果 |
@@ -39,23 +41,13 @@
 |------|------|
 | 订单列表 | `tab=PENDING_PAY`（可选，默认 ALL） |
 | 订单详情 | `orderId=900` |
+| 评价列表 | `tab=PENDING` / `tab=DONE` |
 | 评价编辑 | `orderId=900&orderItemId=10` |
-| 提交售后 | `orderId=900&itemId=10` |
+| 提交售后 | `orderId=900`（整单，无需 itemId） |
 
-**路径常量：**
+**路径常量：** `utils/pageRoute.js`（`PAGE_ORDER_*`）
 
-```javascript
-// utils/pageRoute.js
-export const PAGE_ORDER_LIST = '/subpackage/order/list'
-export const PAGE_ORDER_DETAIL = '/subpackage/order/detail'
-export const PAGE_ORDER_REVIEW_LIST = '/subpackage/order/review-list'
-export const PAGE_ORDER_REVIEW_EDIT = '/subpackage/order/review-edit'
-export const PAGE_ORDER_AFTERSALE_LIST = '/subpackage/order/aftersale-list'
-export const PAGE_ORDER_AFTERSALE_DETAIL = '/subpackage/order/aftersale-detail'
-export const PAGE_ORDER_AFTERSALE_SUBMIT = '/subpackage/order/aftersale-submit'
-```
-
-**分包：** `pages.json` → `pkg-order` 注册上述页面；个人中心预加载 `pkg-order`（可选）。
+**分包：** `pages.json` → `pkg-order`；`pages/mine/index` 预加载 `pkg-order`。
 
 ---
 
@@ -63,17 +55,20 @@ export const PAGE_ORDER_AFTERSALE_SUBMIT = '/subpackage/order/aftersale-submit'
 
 | 类型 | 路径 | 说明 |
 |------|------|------|
-| API | `shop-app/api/order.js` | 扩展 badges/list/detail/pay/confirm |
+| API | `shop-app/api/order.js` | badges/list/detail/pay/confirm |
 | API | `shop-app/api/orderReview.js` | 评价 list/submit/get |
 | API | `shop-app/api/orderAftersale.js` | 售后 list/detail/submit |
-| 常量 | `shop-app/constants/order.js` | tab 枚举、状态文案 |
-| 映射 | `shop-app/utils/orderDisplay.js` | VO → 页面模型、actions 按钮 |
+| 常量 | `shop-app/constants/order.js` | tab、主状态、售后卡片文案 |
+| 映射 | `shop-app/utils/orderDisplay.js` | VO → 页面模型、actions、MO-L4 |
+| 操作 | `shop-app/utils/orderAction.js` | 支付弹窗、确认收货、售后入口 |
+| 导航 | `shop-app/utils/orderNav.js` | 列表/详情/评价/售后跳转 |
 | 列表页 | `subpackage/order/list.vue` | |
 | 详情页 | `subpackage/order/detail.vue` | |
 | 评价/售后页 | `subpackage/order/*.vue` | |
-| 组件 | `components/order/OrderGoodsRow.vue` | 商品行摘要 + **行内评价/查看评价** |
-| 组件 | `components/order/OrderStatusBar.vue` | 状态+倒计时 |
-| 组件 | `components/order/OrderActionBar.vue` | 底部操作按钮 |
+| 组件 | `components/order/OrderGoodsRow.vue` | 商品行 + **行内评价** |
+| 组件 | `components/order/OrderStatusBar.vue` | 详情状态+倒计时 |
+| 组件 | `components/order/OrderActionBar.vue` | 底部操作（无整单评价） |
+| 组件 | `components/order/ReviewDoneSummaryCard.vue` | 已评价紧凑卡 |
 
 ---
 
@@ -96,20 +91,13 @@ export const PAGE_ORDER_AFTERSALE_SUBMIT = '/subpackage/order/aftersale-submit'
 { tab: 'ALL', pageNum: 1, pageSize: 10 }
 ```
 
-**tab 枚举（与后端 `OrderAppConstants` 一致）：**
+**列表行新增字段（v1.2）：**
 
-```javascript
-export const ORDER_TAB = {
-  ALL: 'ALL',
-  PENDING_PAY: 'PENDING_PAY',
-  PENDING_SHIP: 'PENDING_SHIP',
-  PENDING_RECEIVE: 'PENDING_RECEIVE',
-  COMPLETED: 'COMPLETED',
-  CLOSED: 'CLOSED',
-  REVIEW_PENDING: 'REVIEW_PENDING',
-  REVIEW_DONE: 'REVIEW_DONE'
-}
-```
+| 字段 | 说明 |
+|------|------|
+| `aftersaleStatus` | `null` / `1` 进行中 / `2` 已完结 |
+| `orderStatusText` | 订单主状态文案（待付款/待发货…） |
+| `items[]` | 全部商品行 |
 
 ### 4.2 评价 `api/orderReview.js`
 
@@ -119,11 +107,6 @@ export const ORDER_TAB = {
 | `getOrderReview(orderId, orderItemId)` | GET | `/api/order/{orderId}/review?orderItemId=` |
 | `submitReview(orderId, data)` | POST | `/api/order/{orderId}/review` |
 
-```javascript
-// submitReview body
-{ orderItemId: 10, score: 5, content: '很好', pics: ['https://.../1.jpg'] }
-```
-
 ### 4.3 售后 `api/orderAftersale.js`
 
 | 方法 | HTTP | 路径 |
@@ -134,125 +117,184 @@ export const ORDER_TAB = {
 
 ---
 
-## 5. 页面逻辑
+## 5. 订单列表（`list.vue`）
 
-### 5.1 个人中心 · 订单入口
+### 5.1 页签与入口
 
-```text
-onShow → getOrderBadges()
-    → 展示 pendingPayCount / pendingShipCount / pendingReceiveCount / aftersaleInProgressCount
-    → 点击「全部」→ list?tab=ALL
-    → 点击「待付款」→ list?tab=PENDING_PAY
-    …
-```
+| 页签 | `ORDER_TAB` | 说明 |
+|------|-------------|------|
+| 全部 | `ALL` | |
+| 待付款 | `PENDING_PAY` | 续付入口 |
+| 待发货 | `PENDING_SHIP` | |
+| 待收货 | `PENDING_RECEIVE` | 平台已发货 |
+| 已完成 | `COMPLETED` | 交易成功 |
+| 已关闭 | `CLOSED` | |
+
+顶栏链接：**评价** → `review-list`；**退款/售后** → `aftersale-list`。
 
-### 5.2 订单列表
+### 5.2 卡片结构
 
 ```text
-onLoad(query.tab)
-    → listOrders({ tab, pageNum, pageSize })
-    → mapOrderListRow(row)
-        → card.statusText：有 aftersaleStatus 时展示「售后处理中/售后已完成」，否则 orderStatusText
-        → card.items[] 逐行渲染 OrderGoodsRow
-        → 已完成：行内 reviewStatus=PENDING →「评价」；DONE →「查看评价」
-    → 底部 OrderActionBar：过滤 REVIEW / VIEW_REVIEW，仅 PAY / 确认收货 / 售后 / 再买一单
-    → 行内 @review → goReviewEdit(orderId, orderItemId) 或 showItemReview(...)
+order-card
+├── 店头：头像 + 店名 + statusText（MO-L4）
+├── 商品区：OrderGoodsRow × items.length（全量）
+│   └── 已完成：行内「评价」/「查看评价」
+├── 下单时间 + amountLabel + payAmountText
+├── 待付款：支付倒计时 payRemainSeconds
+└── OrderActionBar（无 REVIEW / VIEW_REVIEW）
 ```
 
-### 5.3 订单详情
+### 5.3 列表状态文案（MO-L4）
 
-```text
-onLoad(orderId) → getOrderDetail(orderId)
-    → items[] 全量展示；行内评价按钮（同列表）
-    → 底部 actions 不含整单评价
-```
+`mapOrderCardStatusText(orderStatusText, aftersaleStatus)`：
+
+| aftersaleStatus | 卡片 statusText |
+|-----------------|-----------------|
+| `1` | **售后处理中** |
+| `2` | **售后已完成** |
+| `null` / 无 | **orderStatusText**（待付款/待发货/交易成功…） |
+
+- 保留字段 `orderStatusText`、`aftersaleStatus` 供调试；**展示用 `statusText`**
+- 有售后态时 `statusIsAftersale=true`，样式蓝色区分
+- **详情页**仍展示订单主状态（不套用 MO-L4）
+
+### 5.4 金额文案
+
+| orderStatus | amountLabel |
+|-------------|-------------|
+| `0` 待支付 | **应付** |
+| 其它 | **实付** |
+
+---
+
+## 6. 订单详情（`detail.vue`）
 
-### 5.4 续付（待付款）
+- `OrderStatusBar`：主状态 + 待付款倒计时 / 关闭原因 / 最新物流摘要
+- 收货快照、全部 `items[]`（含服务保障、行小计、行备注）
+- 行内评价按钮（同列表）
+- 底部 `OrderActionBar`：过滤整单评价按钮
+- 分状态字段：支付时间、成交时间、关闭原因、物流节点（无地图）
+
+---
+
+## 7. 评价模块
+
+### 7.1 评价列表 `review-list.vue`
+
+| Tab | 展示 | 点击 |
+|-----|------|------|
+| 待评价 | 展平 `PENDING` 商品行 +「评价」 | 商品区→订单详情；评价→`review-edit` |
+| 已评价 | `ReviewDoneSummaryCard` 紧凑卡 | → `review-view` |
+
+### 7.2 评价编辑 `review-edit.vue`
+
+`orderId` + `orderItemId` → `submitReview`；顶部展示评价商品。
+
+### 7.3 一行一评
+
+- `reviewStatus` per `orderItemId`：`PENDING` / `DONE` / `NONE`
+- 底部 actions **不含** `REVIEW`、`VIEW_REVIEW`
+
+---
+
+## 8. 售后模块
+
+- 列表：`aftersale-list` 进行中/已完结（文案：商家处理中/售后完结）
+- 详情：`aftersale-detail` 进度 + 凭证图（`normalizePicList`）
+- 提交：`aftersale-submit` 类型/原因/凭证
+
+**与订单列表文案区分：** 订单卡片用「售后处理中/售后已完成」；售后专区用「商家处理中/售后完结」。
+
+---
+
+## 9. 页面流程
+
+### 9.1 个人中心角标
 
 ```text
-点击「继续支付」
-    → payOrder(orderId)
-        ├── 成功 → toast + 刷新详情 / 跳转待发货 tab
-        └── 失败（超时等）→ 提示 + 刷新
+onShow → getOrderBadges()
+    → pendingPayCount / pendingShipCount / pendingReceiveCount / aftersaleInProgressCount
+    → 点击快捷入口带 tab 进 list 或 aftersale-list
 ```
 
-### 5.5 确认收货
+### 9.2 续付（待付款）
 
 ```text
-uni.showModal 二次确认
-    → confirmReceive(orderId)
-    → 可选 navigateTo review-edit?orderId=
+「去支付」→ openPayModal → payOrder
+    ├── 成功 → 刷新列表/详情
+    └── 失败/超时 → Toast + 刷新
 ```
 
-### 5.6 评价编辑
+### 9.3 确认收货
 
 ```text
-review-edit?orderId=&orderItemId=
-    → submitReview(orderId, { orderItemId, score, content, pics })
-    → 返回列表/详情并刷新
+showModal → confirmReceive → 可选 goReviewEdit
 ```
 
-### 5.7 提交售后
+### 9.4 提交售后（整单）
 
 ```text
-从详情带 orderId + itemId 进入
-    → 选 applyType → 动态展示原因选项、是否填 returnQuantity
-    → 凭证图 upload
-    → submitAftersale({ orderId, orderItemId, applyType, ... })
-    → 跳转 aftersale-detail 或 aftersale-list?tab=IN_PROGRESS
+详情/列表「申请售后」
+    → goAftersaleSubmit(orderId)（不选商品、不弹 ActionSheet）
+    → aftersale-submit 展示订单全部 items[]
+    → 申请金额默认订单实付；退货数量上限为整单件数之和
+    → submitAftersale({ orderId, orderItemId: 首行ID, ... })
+         ※ orderItemId 为接口兼容字段，业务口径为整单售后
+    → aftersale-detail 或 aftersale-list
 ```
 
 ---
 
-## 6. 展示映射 `orderDisplay.js`
+## 10. 展示映射 `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`（商家处理中 / 售后完结），与 **订单列表** 文案区分
+| 函数 | 用途 |
+|------|------|
+| `mapOrderListRow` | 列表卡片；`items[]` 全量；MO-L4 `statusText`；`amountLabel` |
+| `mapOrderCardStatusText` | 列表售后态优先 |
+| `mapOrderDetail` | 详情；主状态 `orderStatusText` |
+| `getItemReviewAction` | 行内评价按钮 |
+| `mapActions` | 过滤整单评价 |
+| `flattenPendingReviewItems` / `mapReviewDoneRow` | 评价列表 |
+| `mapAftersaleListRow` / `mapAftersaleDetail` | 售后专区 |
 
 ---
 
-## 7. 与确认订单衔接
+## 11. 与确认订单衔接
 
 | 场景 | 行为 |
 |------|------|
-| 支付成功页 | 可 `redirectTo` list?tab=PENDING_SHIP 或 detail |
-| 取消支付 | list?tab=CLOSED 或 detail 已关闭 |
-| pay/cancel API | **共用** `api/order.js` |
+| 支付成功 | `pay-result` 或进 `list?tab=PENDING_SHIP` |
+| 取消支付 | `list?tab=CLOSED` 或详情已关闭 |
+| 购物车结算 | `checkout-cart` → 支付后进订单列表 |
 
 ---
 
-## 8. 测试要点（前端）
+## 12. 联调检查清单
 
-| 编号 | 场景 |
-|------|------|
-| F1 | 未登录进入列表 → 引导登录 |
-| F2 | 角标与列表 tab 数量一致 |
-| F3 | 待付款倒计时展示与续付 |
-| F4 | 确认收货后状态变交易成功 |
-| F5 | 多商品订单列表展示全部 items；行内评价 |
-| F6 | 底部无整单「评价」按钮 |
-| F7 | 评价提交后该行变「查看评价」 |
-| F8 | 售后提交后进进行中列表 |
-| F9 | 列表存在 aftersaleStatus=1 → 卡片状态「售后处理中」；=2 →「售后已完成」；null → orderStatusText |
+- [ ] 未登录引导登录
+- [ ] 角标与列表 tab 一致
+- [ ] 多商品订单列表展示全部 items
+- [ ] 行内评价；底部无整单评价
+- [ ] `aftersaleStatus=1` → 列表「售后处理中」；`=2` →「售后已完成」
+- [ ] 无售后 → 显示 orderStatusText
+- [ ] 待付款显示「应付」+ 倒计时 + 去支付
+- [ ] 确认收货 → 交易成功 + 可评价
+- [ ] 评价列表待评价/已评价交互
+- [ ] 售后提交后进进行中列表
 
 ---
 
-## 9. 修订记录
+## 13. 修订记录
 
 | 版本 | 说明 |
 |------|------|
-| **v1.3** | 订单列表 `aftersaleStatus` 前端映射 statusText；与后端 orderStatusText 分离 |
-| **v1.2** | 列表/详情/评价列表：`items[]` 全量；行内评价；底部 actions 去评价 |
-| **v1.0** | 首版：路由、API、页面流程、与后端接口对齐 |
-| **v1.1** | 落地 list/detail/review/aftersale 分包页、个人中心订单入口与角标、公共组件 |
+| **v1.5** | 售后改为 **整单申请**：去掉多商品选择；`aftersale-submit` 展示全量商品；路由仅 `orderId` |
+| **v1.4** | 对齐需求 **v1.2**：`mapOrderCardStatusText`（MO-L4）、待付款「应付」、常量 `ORDER_AFTERSALE_CARD_*`；文档补全评价/售后/确认订单边界 |
+| **v1.3** | 文档规划 aftersaleStatus 映射（代码待落地） |
+| **v1.2** | 列表/详情全量 items；行内评价；底部去整单评价 |
+| **v1.1** | 落地分包页、个人中心角标、公共组件 |
+| **v1.0** | 首版路由与 API |
 
 ---
 
-*文档版本：v1.3 · 关联《我的订单功能需求.md》v1.2、《我的订单技术方案.md》v1.3*
+*文档版本：v1.5 · 关联《我的订单功能需求.md》v1.2、《我的订单技术方案.md》v1.3*

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

@@ -1,9 +1,9 @@
 # 购物车 — 前端技术方案（C 端 · shop-app）
 
 > **依据：** 《购物车功能需求.md》v1.0、《购物车技术方案.md》v1.0（仅作接口对照，**本文档独立维护**）  
-> **关联：** 《商品详情内页前端技术方案》、《店铺主页前端技术方案》、《我的服务前端技术方案》  
-> **范围：** C 端 **购物车 Tab 列表**、详情 **加购**、勾选/改量/删除/清理失效、**同店去结算预校验**；**不** 改后端、**不** 实现确认订单/支付完整页。  
-> **实现状态：** Tab 页与 API 已落地；确认订单页待建，prepare 结果已写入本地缓存。
+> **关联：** 《商品详情内页前端技术方案》、《确认订单页（多商品）前端技术方案》v1.0、《店铺主页前端技术方案》  
+> **范围：** C 端 **购物车 Tab 列表**、详情 **加购**、勾选/改量/删除/清理失效、**同店去结算**；确认订单 **多商品页** 见另册，本模块负责跳转与 prepare 门禁。  
+> **实现状态：** Tab 页、组件、API、`checkout-cart` 跳转链路 **已落地**。
 
 ---
 
@@ -12,11 +12,12 @@
 | 项 | 说明 |
 |----|------|
 | 框架 | uni-app **Vue 3** + **uview-plus** |
-| 请求 | `@/utils/request`；列表为 `AjaxResult.data`（`items` + `checkedSummary`） |
+| 请求 | `@/utils/request`；列表 `AjaxResult.data` 为 **`items[]` + `checkedSummary`** |
 | 鉴权 | **全部** `/api/cart/**` 须会员 Token |
 | 页面位置 | **主包 Tab** `pages/cart/index`（与 `pages.json` tabBar 一致） |
-| 规格 v1 | 统一规格；加购 `specKey` 不传， `specText` 由详情拼接或「默认」 |
-| 参考 | `components/search/ShopList` 卡片、`pages/mine` 未登录态 |
+| 规格 v1 | 统一规格；加购 `specKey` 不传，`specText` 由详情拼接或「默认」 |
+| 防抖 | 改量/勾选/去结算使用 `useActionGuard` |
+| 参考 | `subpackage/order/checkout-cart.vue`（去结算下游）、`pages/mine` 未登录态 |
 
 ---
 
@@ -25,10 +26,18 @@
 | 页面 | 需求代号 | 路径 | 入口 |
 |------|----------|------|------|
 | 购物车列表 | **A** | `pages/cart/index` | 底部 Tab「购物车」；详情加购后可自行切 Tab |
+| 确认订单（多商品） | — | `subpackage/order/checkout-cart` | 本页 **去结算**（另册维护） |
 
 **未登录：** 空态 +「去登录」→ `PAGE_LOGIN`（CT0）
 
-**路径常量：** `PAGE_CART`（`utils/pageRoute.js`）
+**路径常量：**
+
+| 常量 | 路径 |
+|------|------|
+| `PAGE_CART` | `/pages/cart/index` |
+| `PAGE_CHECKOUT_CART` | `/subpackage/order/checkout-cart` |
+
+**预加载：** `pages.json` → `preloadRule` 为 `pages/cart/index` 预加载 `pkg-order`。
 
 ---
 
@@ -36,13 +45,15 @@
 
 | 类型 | 路径 | 说明 |
 |------|------|------|
-| Tab 页 | `shop-app/pages/cart/index.vue` | 分组列表、底栏全选/合计/去结算 |
-| 店组 | `shop-app/components/cart/CartShopGroup.vue` | 店头全选、进店 |
-| 商品行 | `shop-app/components/cart/CartItemRow.vue` | 勾选、数量、删除、进详情 |
+| Tab 页 | `shop-app/pages/cart/index.vue` | 分组列表、工具栏、底栏全选/合计/去结算 |
+| 店组 | `shop-app/components/cart/CartShopGroup.vue` | 店头全选、进店、休息中标签 |
+| 商品行 | `shop-app/components/cart/CartItemRow.vue` | 勾选、数量、小计、失效标签、删除、进详情 |
 | 购物车 API | `shop-app/api/cart.js` | `/api/cart/**` |
-| 展示 | `shop-app/utils/cartDisplay.js` | 分组映射、失效文案、勾选统计辅助 |
-| 结算缓存 | `shop-app/utils/cartCheckout.js` | prepare 结果 `setStorageSync` |
-| 常量 | `shop-app/constants/cart.js` | 失效类型、空态、跨店提示、缓存键 |
+| 展示 | `shop-app/utils/cartDisplay.js` | 扁平 `items` 按店分组、失效文案、勾选统计 |
+| 结算导航 | `shop-app/utils/checkoutNav.js` | `goCartCheckout(cartItemIds)` |
+| 规格展示 | `shop-app/utils/cartSpec.js` | `parseCartSpecText`（`§` 分隔） |
+| 常量 | `shop-app/constants/cart.js` | 失效类型、空态、跨店提示 |
+| 常量 | `shop-app/constants/checkout.js` | `CART_CHECKOUT_IDS_KEY` |
 
 **已改上游：**
 
@@ -65,17 +76,26 @@
 | `removeCartItem` | DELETE | `/api/cart/items/{id}` | 单行删除 |
 | `removeCartItems` | DELETE | `/api/cart/items` | 删除选中 |
 | `cleanInvalidCart` | DELETE | `/api/cart/invalid` | 清理失效 |
-| `prepareCartCheckout` | POST | `/api/cart/checkout/prepare` | 去结算 |
+| `prepareCartCheckout` | POST | `/api/cart/checkout/prepare` | 去结算门禁 |
+
+### 4.1 列表响应 `CartListVO`
+
+| 字段 | 说明 |
+|------|------|
+| `items[]` | 扁平购物车行（含 `shopId/shopName/shopStatus`）；排序 `cart_item_id DESC` |
+| `checkedSummary` | 已勾选且 `purchasable` 行合计 |
+
+前端 **`mapCartList`** 将 `items[]` **按 `shopId` 分组** 为 UI 用 `groups[]`（后端不分组）。
 
-### 4.1 加购 Body（详情）
+### 4.2 加购 Body（详情）
 
 | 字段 | 说明 |
 |------|------|
 | goodsId | 必填 |
-| quantity | 必填，与详情数量弹窗一致 |
-| specText | 规格展示快照；无则「默认」 |
+| quantity | 必填 |
+| specText | 规格快照；无则「默认」 |
 
-### 4.2 批量勾选 Body
+### 4.3 批量勾选 Body
 
 ```json
 {
@@ -85,114 +105,182 @@
 }
 ```
 
-### 4.3 去结算 Body
+### 4.4 去结算 Body
 
 ```json
 { "cartItemIds": [1, 2] }
 ```
 
-成功 `data` 经 `saveCheckoutPrepare` 写入 `cart_checkout_prepare`，供 **确认订单页（待建）** 读取。
+成功后再跳转确认订单页；**不在购物车页缓存 prepare 结果**（确认页走 `POST /api/checkout/preview`）。
 
 ---
 
-## 5. 列表页逻辑（`pages/cart/index.vue`）
+## 5. 列表页结构（`pages/cart/index.vue`）
+
+```text
+购物车 Tab
+├── 未登录：空态 + 去登录
+├── 加载中 / 加载失败（重试）
+├── 空购物车：「购物车是空的」+ 去逛逛（首页 Tab）
+└── 有数据
+    ├── 顶栏工具条
+    │   ├── 清理失效商品（有失效行时显示）
+    │   └── 删除选中（有勾选时显示）
+    ├── scroll-view · CartShopGroup × N
+    └── 底栏
+        ├── 全选（仅可购行）
+        ├── 合计 ¥checkedSummary.checkedAmountText
+        └── 去结算(N)
+```
+
+---
+
+## 6. 列表页逻辑
 
 ```text
 onShow
   → 无 Token：访客空态
-  → 有 Token：GET /api/cart → mapCartList
+  → 有 Token：GET /api/cart → mapCartList（items 按店分组）
 
 店组头勾选
-  → 该店全部可购行 checked 同步
+  → 该店全部 purchasable 行 checked 同步 → PUT checked → 刷新
 
 行勾选 / 底栏全选
-  → PUT checked → 刷新列表（含 checkedSummary）
+  → PUT checked → 刷新（含 checkedSummary）
 
 数量 +/-
-  → PUT quantity → 刷新（库存不足由后端 400）
+  → PUT quantity → 刷新（库存不足后端 400）
+
+删除单行
+  → 二次确认 → DELETE 单行 → 刷新
 
-删除 / 删除选中 / 清理失效
-  → DELETE 对应接口 → 刷新
+删除选中
+  → 二次确认（展示件数）→ DELETE 批量 → 刷新
+
+清理失效
+  → countInvalidCartItems → 二次确认（展示件数）→ DELETE /invalid → Toast removedCount
 
 去结算
-  → 无勾选：提示
+  → 无勾选可购行：提示
   → 跨店勾选：Toast「请选择同一店铺的商品结算」
-  → POST prepare → 缓存 data → 暂 Toast「确认订单功能开发中」
+  → POST prepare 成功 → goCartCheckout(ids)
+  → prepare 失败：request 已 Toast，不跳转
 ```
 
 | 需求规则 | 实现 |
 |----------|------|
-| CT2 按店分组 | 渲染 `CartShopGroup` |
+| CT2 按店分组 | `groupCartItemsByShop` |
 | 失效不可勾选 | `purchasable=false` 置灰勾选 |
 | CT-S1 不跨店结算 | `getCheckedShopIds.size > 1` 拦截 |
-| CT7 清理失效 | 顶栏「清理失效商品」 |
-| 缺货/下架进详情 | 点击主图/名称区域 `goGoodsDetail` |
+| CT7 清理失效 | 顶栏按钮 + 件数确认 |
+| 缺货/下架进详情 | 点击主图/名称 `goGoodsDetail` |
 | 进店 | 点击店名 `goShopHome` |
+| 行小计 | `subtotalText` 展示 |
+
+### 6.1 底栏合计
+
+使用接口 **`checkedSummary`**（仅 **已勾选且可购** 行），与后端口径一致。
+
+### 6.2 失效标签
+
+`invalidType` → `getCartInvalidLabel`（`cartDisplay.js`）：
+
+| invalidType | 默认文案 |
+|-------------|----------|
+| OUT_OF_STOCK | 缺货 |
+| OFF_SHELF | 已下架 |
+| SHOP_CLOSED | 休息中 |
+| CATEGORY_HIDDEN | 不可购买 |
+| GOODS_DELETED | 已失效 |
+| SHOP_DELETED | 店铺失效 |
+
+优先使用后端 `invalidMsg`。
 
-### 5.1 底栏合计
+---
+
+## 7. 组件说明
 
-使用接口返回的 **`checkedSummary`**（仅 **已勾选且可购** 行），与后端口径一致。
+### 7.1 `CartShopGroup.vue`
 
-### 5.2 失效标签
+- 店头：勾选（仅当有可购行）、店名、停业「休息中」、进店箭头
+- 子组件 `CartItemRow` 列表
 
-`invalidType` → `getCartInvalidLabel`（`cartDisplay.js`），与后端 `CartConstants` 枚举对齐。
+### 7.2 `CartItemRow.vue`
+
+- 可购：勾选、+/- 改量、删除
+- 失效：勾选禁用、数量只读、失效标签、仍可删、可点进详情
+- 展示：主图、名称、规格列表、单价、**小计**
 
 ---
 
-## 6. 数据映射（`cartDisplay.js`）
+## 8. 数据映射（`cartDisplay.js`）
 
 | 函数 | 用途 |
 |------|------|
-| `mapCartList` | `data.items` → 页面 `items`；`groupCartItemsByShop` 生成 UI 用 `groups` + `checkedSummary` |
+| `mapCartList` | `items[]` → `groups[]` + `checkedSummary` |
+| `groupCartItemsByShop` | 内部：按 `shopId` 分组，保持行序 |
 | `hasInvalidCartItems` | 是否显示「清理失效」 |
-| `getCheckedPurchasableIds` | 去结算入参 |
+| `countInvalidCartItems` | 清理前展示件数 |
+| `getCheckedPurchasableIds` | 去结算 / prepare 入参 |
 | `getCheckedShopIds` | 跨店校验 |
 | `getAllPurchasableItems` | 全选逻辑 |
+| `getCartInvalidLabel` | 失效标签文案 |
 
-**行模型要点：** `displayPic`、`priceText`、`subtotalText`、`invalidLabel`、`purchasable`
+**行模型要点：** `displayPic`、`priceText`、`subtotalText`、`specList`、`invalidLabel`、`purchasable`
 
 ---
 
-## 7. 与确认订单边界
+## 9. 与确认订单（多商品）边界
 
-| 项 | 当前前端 |
+| 项 | 购物车侧 |
 |----|----------|
-| prepare 成功 | `saveCheckoutPrepare(res.data)` |
-| 跳转确认订单 | **待建**；`PAGE_ORDER_CONFIRM` 未注册 |
-| 下单成功删行 | 订单模块负责，购物车 **不处理** |
+| prepare | `POST /api/cart/checkout/prepare` 门禁（四条件、同店） |
+| 跳转 | `goCartCheckout` → `checkout-cart?cartItemIds=` + storage 兜底 |
+| 预览/提交 | **不在本页**；见《确认订单页（多商品）前端技术方案》 |
+| 支付成功删行 | **后端** 处理；返回 Tab 刷新可见 |
+
+```text
+去结算
+  → prepareCartCheckout(ids)
+  → goCartCheckout(ids)
+       → setStorage CART_CHECKOUT_IDS_KEY
+       → navigateTo PAGE_CHECKOUT_CART
+```
 
 ---
 
-## 8. 联调检查清单
+## 10. 联调检查清单
 
 - [ ] 未登录 Tab 仅引导登录
 - [ ] 详情加购后 Tab 刷新可见，同规格数量累加
-- [ ] 列表按店分组、失效标签与不可勾选
+- [ ] 列表 `items` 正确按店分组展示
+- [ ] 失效行不可勾选、标签与进店/进详情可用
 - [ ] 改量超过库存 → 400「库存不足」
-- [ ] 跨店勾选去结算 → 400/前端拦截文案一致
-- [ ] 同店 prepare 返回 `shopId`、`items`、`goodsAmount`
-- [ ] 清理失效、删除选中后列表刷新
+- [ ] 跨店勾选去结算 → 前端拦截文案
+- [ ] 同店 prepare 成功 → 跳转 `checkout-cart`
+- [ ] 清理失效展示件数；删除选中二次确认
 - [ ] 停业店可展示，prepare 拦截停业
 
 ---
 
-## 9. 非本期（前端不实现）
+## 11. 非本期（前端不实现）
 
 | 项 | 说明 |
 |------|------|
-| 确认订单、支付 UI | 另册；仅缓存 prepare |
 | 列表/搜索快捷加购 | 仅详情加购 |
 | 跨店一键多单 | CT-S1 不支持 |
 | 优惠券、凑单 | 未要求 |
+| 失效自动删除 | 用户触发「清理失效」 |
 
 ---
 
-## 10. 修订记录
+## 12. 修订记录
 
 | 版本 | 说明 |
 |------|------|
-| **v1.0** | 首版：Tab 购物车、详情加购、同店 prepare 与本地缓存 |
+| **v1.1** | 对齐需求 v1.0：**items 前端按店分组**、清理失效件数确认、行小计、去结算跳转 `checkout-cart`；更新与多商品确认页边界 |
+| **v1.0** | 首版：Tab 购物车、详情加购、同店 prepare |
 
 ---
 
-*文档版本：v1.0 · 不修改《购物车技术方案.md》（后端方案）。*
+*文档版本：v1.1 · 不修改《购物车技术方案.md》（后端方案）。*

shop-app/components/cart/CartItemRow.vue

@@ -22,6 +22,7 @@
 				</view>
 				<view class="cart-item__price-row">
 					<text class="cart-item__price">¥{{ item.priceText }}</text>
+					<text v-if="item.subtotalText" class="cart-item__subtotal">小计 ¥{{ item.subtotalText }}</text>
 					<text v-if="item.invalidLabel" class="cart-item__tag">{{ item.invalidLabel }}</text>
 				</view>
 			</view>
@@ -146,6 +147,10 @@ function onPlus() {
 	color: #e53935;
 	font-weight: 600;
 }
+.cart-item__subtotal {
+	font-size: 24rpx;
+	color: #666;
+}
 .cart-item__tag {
 	font-size: 22rpx;
 	color: #e65100;

shop-app/constants/order.js

@@ -1,3 +1,26 @@
+/** 订单主状态（与后端 OrderConstants 一致） */
+export const ORDER_STATUS = {
+  PENDING_PAY: '0',
+  PENDING_SHIP: '1',
+  SHIPPED: '2',
+  COMPLETED: '3',
+  CLOSED: '4'
+}
+
+/**
+ * 列表卡片售后态（与后端 OrderAppConstants 一致）
+ * MO-L4：有值时卡片状态区优先展示下列文案
+ */
+export const ORDER_AFTERSALE_CARD_STATUS = {
+  IN_PROGRESS: '1',
+  FINISHED: '2'
+}
+
+export const ORDER_AFTERSALE_CARD_LABEL = {
+  [ORDER_AFTERSALE_CARD_STATUS.IN_PROGRESS]: '售后处理中',
+  [ORDER_AFTERSALE_CARD_STATUS.FINISHED]: '售后已完成'
+}
+
 /** 订单列表 tab（与后端 OrderAppConstants 一致） */
 export const ORDER_TAB = {
   ALL: 'ALL',

shop-app/pages/cart/index.vue

@@ -80,6 +80,7 @@ import {
 import {
 	mapCartList,
 	hasInvalidCartItems,
+	countInvalidCartItems,
 	getCheckedShopIds,
 	getCheckedPurchasableIds,
 	getAllPurchasableItems
@@ -250,9 +251,14 @@ function onDeleteChecked() {
 }
 
 async function onCleanInvalid() {
+	const invalidCount = countInvalidCartItems(groups.value)
+	if (!invalidCount) {
+		uni.showToast({ title: '暂无失效商品', icon: 'none' })
+		return
+	}
 	uni.showModal({
 		title: '提示',
-		content: '确定清理全部失效商品吗？',
+		content: `确定清理 ${invalidCount} 件失效商品吗？`,
 		success: async (res) => {
 			if (!res.confirm) return
 			try {

shop-app/subpackage/account/profile.vue

@@ -1,10 +1,10 @@
 <template>
 	<view class="form-page">
 		<view class="form-card">
-			<view class="form-row">
+			<!-- <view class="form-row">
 				<text class="form-row__label">用户 ID</text>
 				<text class="form-row__readonly">{{ profile.memberId || '—' }}</text>
-			</view>
+			</view> -->
 			<view class="form-row">
 				<text class="form-row__label">会员名称</text>
 				<text class="form-row__readonly">{{ profile.memberCode || '—' }}</text>

shop-app/subpackage/order/aftersale-submit.vue

@@ -4,10 +4,18 @@
 			<u-loading-icon mode="circle" />
 		</view>
 
-		<template v-else-if="orderItem">
+		<template v-else-if="orderItems.length">
 			<view class="as-submit-card">
-				<text class="as-submit-card__title">商品信息</text>
-				<order-goods-row :item="orderItem" />
+				<text class="as-submit-card__title">订单商品</text>
+				<text class="as-submit-card__tip">本单共 {{ orderItems.length }} 件商品，售后按整单申请</text>
+				<view class="as-submit-goods">
+					<order-goods-row
+						v-for="item in orderItems"
+						:key="item.orderItemId"
+						:item="item"
+						show-subtotal
+					/>
+				</view>
 			</view>
 
 			<view class="as-submit-card">
@@ -43,6 +51,7 @@
 					<text class="as-qty-num">{{ returnQuantity }}</text>
 					<view class="as-qty-btn" @click="changeReturnQty(1)">+</view>
 				</view>
+				<text class="as-submit-card__tip">最多 {{ totalQuantity }} 件</text>
 			</view>
 
 			<view class="as-submit-card">
@@ -98,8 +107,8 @@ import ImageUploadGrid from '@/components/order/ImageUploadGrid.vue'
 const submitGuard = useActionGuard()
 
 const orderId = ref('')
-const orderItemId = ref('')
-const orderItem = ref(null)
+/** 整单商品行 */
+const orderItems = ref([])
 const payAmount = ref(0)
 const pageLoading = ref(true)
 const submitting = submitGuard.locked
@@ -117,6 +126,10 @@ const evidenceMax = AFTERSALE_EVIDENCE_MAX
 
 const reasonOptions = computed(() => AFTERSALE_REASON_MAP[applyType.value] || [])
 
+const totalQuantity = computed(() =>
+	orderItems.value.reduce((sum, item) => sum + (Number(item.quantity) || 0), 0)
+)
+
 const needReturnQty = computed(
 	() =>
 		applyType.value === AFTERSALE_APPLY_TYPE.REFUND_SHIPPED ||
@@ -129,26 +142,24 @@ function onApplyTypeChange(value) {
 }
 
 function changeReturnQty(delta) {
-	const max = orderItem.value ? orderItem.value.quantity : 1
+	const max = totalQuantity.value || 1
 	const next = returnQuantity.value + delta
 	returnQuantity.value = Math.max(1, Math.min(max, next))
 }
 
-async function loadOrderItem() {
+async function loadOrder() {
 	pageLoading.value = true
 	try {
 		const res = await getOrderDetail(orderId.value)
 		const mapped = mapOrderDetail(res.data)
-		const row = (mapped.items || []).find(
-			(item) => String(item.orderItemId) === String(orderItemId.value)
-		)
-		if (!row) {
+		const items = mapped.items || []
+		if (!items.length) {
 			throw new Error('订单商品不存在')
 		}
-		orderItem.value = row
+		orderItems.value = items
 		payAmount.value = mapped.payAmount
 		applyAmountInput.value = String(mapped.payAmount || '')
-		returnQuantity.value = 1
+		returnQuantity.value = totalQuantity.value || 1
 	} catch (e) {
 		uni.showToast({ title: (e && e.message) || '加载失败', icon: 'none' })
 		setTimeout(() => uni.navigateBack(), 800)
@@ -168,9 +179,15 @@ function onSubmit() {
 			uni.showToast({ title: '请填写申请金额', icon: 'none' })
 			return
 		}
+		const firstItem = orderItems.value[0]
+		if (!firstItem?.orderItemId) {
+			uni.showToast({ title: '订单商品信息异常', icon: 'none' })
+			return
+		}
 		const body = {
 			orderId: orderId.value,
-			orderItemId: orderItemId.value,
+			// 接口仍要求 orderItemId；整单售后传首行 ID，金额/数量为整单口径
+			orderItemId: firstItem.orderItemId,
 			applyType: applyType.value,
 			applyReason: applyReason.value,
 			applyAmount: amount,
@@ -196,13 +213,12 @@ function onSubmit() {
 onLoad((options) => {
 	if (!ensureApiToken(true)) return
 	orderId.value = options.orderId || ''
-	orderItemId.value = options.itemId || options.orderItemId || ''
-	if (!orderId.value || !orderItemId.value) {
-		uni.showToast({ title: '参数缺失', icon: 'none' })
+	if (!orderId.value) {
+		uni.showToast({ title: '订单信息缺失', icon: 'none' })
 		setTimeout(() => uni.navigateBack(), 800)
 		return
 	}
-	loadOrderItem()
+	loadOrder()
 })
 </script>
 
@@ -232,6 +248,15 @@ onLoad((options) => {
 	font-weight: 600;
 	color: #333;
 }
+.as-submit-card__tip {
+	display: block;
+	margin-bottom: 12rpx;
+	font-size: 24rpx;
+	color: #999;
+}
+.as-submit-goods :deep(.order-goods-row + .order-goods-row) {
+	border-top: 1rpx solid #f5f5f5;
+}
 .as-type-opt,
 .as-reason-opt {
 	padding: 16rpx 20rpx;

shop-app/subpackage/order/list.vue

@@ -51,7 +51,10 @@
 					<view class="order-card__head">
 						<image class="order-card__shop-avatar" :src="card.shopAvatar" mode="aspectFill" />
 						<text class="order-card__shop-name">{{ card.shopName }}</text>
-						<text class="order-card__status">{{ card.statusText }}</text>
+						<text
+							class="order-card__status"
+							:class="{ 'order-card__status--aftersale': card.statusIsAftersale }"
+						>{{ card.statusText }}</text>
 					</view>
 
 					<view v-if="card.items && card.items.length" class="order-card__goods">
@@ -67,7 +70,8 @@
 					<view class="order-card__sum">
 						<text class="order-card__time">{{ card.createTime }}</text>
 						<text class="order-card__amount">
-							实付 <text class="order-card__price">¥{{ card.payAmountText }}</text>
+							{{ card.amountLabel }}
+							<text class="order-card__price">¥{{ card.payAmountText }}</text>
 						</text>
 					</view>
 
@@ -330,6 +334,9 @@ onShow(() => {
 	font-size: 26rpx;
 	color: #e65100;
 }
+.order-card__status--aftersale {
+	color: #1976d2;
+}
 .order-card__goods :deep(.order-goods-row + .order-goods-row) {
 	border-top: 1rpx solid #f5f5f5;
 }

shop-app/utils/cartDisplay.js

@@ -74,21 +74,62 @@ function mapCheckedSummary(summary) {
   }
 }
 
+/** 扁平 items[] 按店铺分组（保持接口 cart_item_id 倒序下的店组顺序） */
+function groupCartItemsByShop(flatItems) {
+  const groups = []
+  const groupIndex = new Map()
+  for (const row of flatItems || []) {
+    const item = mapCartItem(row)
+    if (!item) continue
+    const shopId = row.shopId
+    let group
+    if (groupIndex.has(shopId)) {
+      group = groups[groupIndex.get(shopId)]
+    } else {
+      group = {
+        shopId,
+        shopName: row.shopName || '',
+        shopStatus: row.shopStatus,
+        isClosed: String(row.shopStatus) === SHOP_STATUS_CLOSED,
+        items: []
+      }
+      groupIndex.set(shopId, groups.length)
+      groups.push(group)
+    }
+    group.items.push(item)
+  }
+  return groups
+}
+
 /** 列表接口 data → 页面模型 */
 export function mapCartList(data) {
   if (!data) {
     return { groups: [], checkedSummary: mapCheckedSummary(null) }
   }
+  const groups = Array.isArray(data.groups) && data.groups.length
+    ? data.groups.map(mapShopGroup).filter(Boolean)
+    : groupCartItemsByShop(data.items || [])
   return {
-    groups: (data.groups || []).map(mapShopGroup).filter(Boolean),
+    groups,
     checkedSummary: mapCheckedSummary(data.checkedSummary)
   }
 }
 
 /** 是否存在失效行 */
 export function hasInvalidCartItems(groups) {
-  if (!Array.isArray(groups)) return false
-  return groups.some((g) => (g.items || []).some((item) => !item.purchasable))
+  return countInvalidCartItems(groups) > 0
+}
+
+/** 失效商品件数（清理失效前展示） */
+export function countInvalidCartItems(groups) {
+  if (!Array.isArray(groups)) return 0
+  let count = 0
+  groups.forEach((g) => {
+    ;(g.items || []).forEach((item) => {
+      if (!item.purchasable) count += 1
+    })
+  })
+  return count
 }
 
 /** 当前勾选的可购行 shopId 集合 */

shop-app/utils/orderAction.js

@@ -52,25 +52,11 @@ function doBuyAgain(ctx) {
 }
 
 function openAftersalePicker(ctx) {
-  const items = ctx.items || []
-  if (!items.length) {
-    uni.showToast({ title: '暂无可售后商品', icon: 'none' })
+  if (!ctx.orderId) {
+    uni.showToast({ title: '订单信息缺失', icon: 'none' })
     return Promise.resolve()
   }
-  if (items.length === 1) {
-    goAftersaleSubmit(ctx.orderId, items[0].orderItemId)
-    return Promise.resolve()
-  }
-  const names = items.map((row) => row.goodsName || '商品')
-  uni.showActionSheet({
-    itemList: names,
-    success: (res) => {
-      const row = items[res.tapIndex]
-      if (row && row.orderItemId) {
-        goAftersaleSubmit(ctx.orderId, row.orderItemId)
-      }
-    }
-  })
+  goAftersaleSubmit(ctx.orderId)
   return Promise.resolve()
 }
 

shop-app/utils/orderDisplay.js

@@ -5,7 +5,9 @@ import {
   ORDER_ACTION,
   ORDER_ACTION_LABEL,
   REVIEW_ITEM_STATUS,
-  AFTERSALE_APPLY_TYPE_OPTIONS
+  AFTERSALE_APPLY_TYPE_OPTIONS,
+  ORDER_STATUS,
+  ORDER_AFTERSALE_CARD_LABEL
 } from '@/constants/order'
 
 /** 订单级不再展示的评价按钮（改在商品行） */
@@ -151,6 +153,17 @@ function trimText(text, maxLen, emptyFallback = '') {
   return `${s.slice(0, maxLen)}…`
 }
 
+/**
+ * 列表卡片状态文案（MO-L4）
+ * 有 aftersaleStatus 时优先展示售后态，否则用订单主状态文案
+ */
+export function mapOrderCardStatusText(orderStatusText, aftersaleStatus) {
+  if (aftersaleStatus && ORDER_AFTERSALE_CARD_LABEL[aftersaleStatus]) {
+    return ORDER_AFTERSALE_CARD_LABEL[aftersaleStatus]
+  }
+  return orderStatusText || ''
+}
+
 /** 列表行 VO → 卡片模型 */
 export function mapOrderListRow(row) {
   if (!row) return null
@@ -161,11 +174,17 @@ export function mapOrderListRow(row) {
       : []
   const items = rawItems.map(mapFirstItem).filter(Boolean)
   const firstItem = items[0] || mapFirstItem(row.firstItem)
+  const orderStatusText = row.orderStatusText || ''
+  const aftersaleStatus = row.aftersaleStatus || null
   return {
     orderId: row.orderId,
     orderNo: row.orderNo || '',
     orderStatus: row.orderStatus,
-    statusText: row.orderStatusText || '',
+    orderStatusText,
+    aftersaleStatus,
+    statusText: mapOrderCardStatusText(orderStatusText, aftersaleStatus),
+    statusIsAftersale: !!aftersaleStatus,
+    amountLabel: row.orderStatus === ORDER_STATUS.PENDING_PAY ? '应付' : '实付',
     shopId: row.shopId,
     shopName: row.shopName || '',
     shopAvatar: resolveFileUrl(row.shopAvatar) || SHOP_PLACEHOLDER,

shop-app/utils/orderNav.js

@@ -72,10 +72,10 @@ export function goAftersaleDetail(aftersaleId) {
   })
 }
 
-/** 提交售后 */
-export function goAftersaleSubmit(orderId, orderItemId) {
-  if (!orderId || !orderItemId) return
+/** 提交售后（整单，仅需 orderId） */
+export function goAftersaleSubmit(orderId) {
+  if (!orderId) return
   uni.navigateTo({
-    url: `${PAGE_ORDER_AFTERSALE_SUBMIT}?orderId=${orderId}&itemId=${orderItemId}`
+    url: `${PAGE_ORDER_AFTERSALE_SUBMIT}?orderId=${orderId}`
   })
 }