# Change: 更新订单管理响应语义与展示规则 ## Why 订单管理页面已经接入 `/api/admin/orders` 相关接口,但当前前端实现仍带有旧语义假设: - `operator_*` 在部分场景被当成代理店铺信息理解和展示。 - `commission_status` 仍被当成“是否有佣金”的单一结果使用。 - 订单列表和详情页没有显式表达“真实操作者”和“业务归属店铺”的区别。 后端最新 `OrderResponse` 已经明确拆分了这些概念,并新增了 `seller_shop_*` 与 `commission_result*` 字段。如果前端不跟进,用户会在订单列表和详情页看到混淆信息,且“已完成但无佣金”和“已完成且有佣金”无法被正确区分。 ## What Changes - 更新订单管理前端对 `OrderResponse` 的类型定义和字段语义解释: - `operator_*` 统一表示真实操作者 - `seller_shop_*` 统一表示业务归属店铺 - `commission_status` 统一表示佣金流程状态 - `commission_result` 统一表示佣金业务结果 - 更新订单列表页展示规则: - 增加“销售店铺/归属店铺”展示 - 佣金信息必须同时呈现“流程状态”和“业务结果”两个维度 - 具体呈现形式可以是两列,或“主状态 + 副标签” - 更新订单详情页信息结构: - 单独展示操作者信息 - 单独展示业务归属信息 - 对齐创建订单成功后的响应处理,避免继续使用旧语义做前端判断 ## Impact - Affected specs: - `order-management` - Affected code: - `src/types/api/order.ts` - `src/api/modules/order.ts` - `src/views/order-management/order-list/index.vue` - `src/views/order-management/order-list/detail.vue` - Dependencies: - 依赖后端已提供最新 `OrderResponse` 字段和语义 - 与活跃变更 `add-order-management`、`update-order-upload-and-device-switch-mode` 属于同一能力域,落地时需要一起核对订单模块现状 - Breaking changes: - 前端内部对订单字段的解释逻辑会变化;任何把 `operator_name` 当店铺名、把 `commission_status` 当佣金结果的代码都需要调整