fix: some

openspec/changes/update-exchange-migration-and-shop-import/specs/exchange-management/spec.md

@@ -0,0 +1,66 @@
+## ADDED Requirements
+
+### Requirement: 换货业务数据迁移状态契约
+
+换货单对象 MUST 提供 migration_status（not_migrated/pending/migrated/failed）、migration_status_name（中文）与 migration_failure_reason（仅 failed 时返回）；迁移结果判定 MUST 以 migration_status 为准，前端 MUST NOT 再用 migrate_data/migration_completed/migration_balance 推断。列表、详情、创建/发货/完成返回的同一个换货对象 MUST 携带上述字段。
+
+#### Scenario: 列表与详情返回迁移状态
+
+- **GIVEN** 用户打开换货列表或详情
+- **WHEN** 响应数据加载
+- **THEN** 每单 MUST 展示 migration_status 与 migration_status_name
+- **AND** migration_status=failed 时 MUST 展示 migration_failure_reason；其他状态 MUST NOT 依赖该字段
+
+#### Scenario: 迁移结果以状态字段为准
+
+- **WHEN** 前端判定迁移结果
+- **THEN** 判定依据 MUST 使用 migration_status（pending/migrated/failed）
+- **AND** 不得使用 migrate_data/migration_completed/migration_balance 推断
+
+### Requirement: 换货列表与详情迁移状态展示
+
+换货列表 MUST 在「状态」列之后新增「迁移状态」列并展示中文名；换货详情 MUST 展示迁移状态，failed 时展示后端返回的安全失败原因。
+
+#### Scenario: 列表迁移状态列
+
+- **GIVEN** 换货列表加载完成
+- **WHEN** 渲染表格
+- **THEN** 「状态」列后 MUST 出现「迁移状态」列
+- **AND** 该列 MUST 展示 migration_status_name
+
+#### Scenario: 详情展示失败原因
+
+- **GIVEN** 某换货单 migration_status=failed
+- **WHEN** 用户打开详情
+- **THEN** 详情 MUST 展示迁移状态为「迁移失败」
+- **AND** MUST 展示后端返回的 migration_failure_reason 安全文案
+
+### Requirement: 迁移失败单的确认完成权限控制
+
+非 failed 换货单的「确认完成」权限 MUST 与既有逻辑一致（exchange:complete）；migration_status=failed 的物流换货单重试 MUST 仅对超级管理员/平台账号开放，代理/企业账号前端 MUST NOT 渲染该入口，后端仍以 403/1005 兜底。
+
+#### Scenario: 代理/企业账号隐藏重试入口
+
+- **GIVEN** 当前账号为代理或企业账号
+- **AND** 换货单 migration_status=failed 且 status=3
+- **WHEN** 渲染行操作
+- **THEN** 前端 MUST NOT 显示「确认完成」操作
+
+#### Scenario: 超管/平台账号可重试
+
+- **GIVEN** 当前账号为超级管理员或平台账号
+- **AND** 换货单 migration_status=failed
+- **WHEN** 渲染行操作
+- **THEN** 前端 MUST 提供「确认完成」重试入口
+
+### Requirement: 迁移执行失败（1206）处理
+
+确认完成触发迁移执行失败时后端返回 code=1206 与安全文案，换货单保持「已发货待确认」，修复条件后可重试；前端 MUST 展示后端安全文案且不得改变订单状态展示。
+
+#### Scenario: 1206 提示并可重试
+
+- **GIVEN** 用户对含迁移的换货单执行确认完成
+- **WHEN** 后端返回 code=1206
+- **THEN** 前端 MUST 展示后端安全文案（不含数据库/渠道原文）
+- **AND** 换货单状态仍展示为「已发货待确认」
+- **AND** 用户可以修复条件后再次发起确认完成