one-pipe-system/openspec/changes/update-order-management-response-semantics/proposal.md

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 当佣金结果的代码都需要调整