fix: order

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

@@ -0,0 +1,42 @@
+# 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` 当佣金结果的代码都需要调整