## 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** 用户可以修复条件后再次发起确认完成