- [x] 1.1 定义 ExchangeOrder 模型（含 BaseModel、旧/新资产字段、收货字段、物流字段、迁移字段、shop_id）
- [x] 1.2 新增换货状态常量（1待填写、2待发货、3已发货待确认、4已完成、5已取消）
- [x] 1.3 实现换货单号生成函数（EXC + 日期时间 + 随机数）
- [x] 1.4 新增后台/客户端换货相关 DTO（请求参数、响应结构、错误字段）

- [x] 2.1 创建数据库迁移：新增 tb_exchange_order 表
- [x] 2.2 创建数据库迁移：将 tb_card_replacement_record 改名为 tb_card_replacement_record_legacy

- [x] 3.1 实现 ExchangeOrderStore：创建换货单、按ID查询、按条件分页查询
- [x] 3.2 实现 ExchangeOrderStore：状态更新（含前置状态校验）
- [x] 3.3 实现 ExchangeOrderStore：按旧资产查询进行中换货单

- [x] 4.1 实现换货 Service：H1 创建换货单与重复进行中校验
- [x] 4.2 实现换货 Service：状态流转校验（1->2->3->4、1/2->5）
- [x] 4.3 实现换货 Service：H4 发货同类型资产校验与新资产在库校验
- [x] 4.4 实现换货 Service：H5 确认完成与可选全量迁移入口
- [x] 4.5 实现换货 Service：全量迁移事务（11张表规则）
- [x] 4.6 实现换货 Service：H7 转新逻辑（generation+1、状态重置、清除绑定、新钱包）

- [x] 5.1 新增后台 Exchange Handler（H1~H7）
- [x] 5.2 在 admin 路由注册 H1~H7（使用 Register() + RouteSpec 完整元数据）

- [x] 6.1 新增客户端 Exchange Handler（G1~G2）
- [x] 6.2 在客户端路由注册 G1~G2（使用 Register() + RouteSpec 完整元数据）

- [x] 7.1 清理旧模型引用：移除/停用 card_replacement.go 在业务流程中的使用
- [x] 7.2 修改 iot_card_store.go 的 is_replaced 过滤逻辑，改为查询 ExchangeOrder

- [x] 8.1 更新 bootstrap/types.go：新增后台与客户端换货 Handler 字段
- [x] 8.2 更新 bootstrap/handlers.go：实例化换货相关 Handler
- [x] 8.3 更新 cmd/api/docs.go：注册换货 Handler 到文档生成器
- [x] 8.4 更新 cmd/gendocs/main.go：注册换货 Handler 到文档生成器

- [x] 9.1 执行 go build 验证编译通过
- [x] 9.2 执行 lsp_diagnostics 检查改动文件诊断信息
- [x] 9.3 使用数据库验证流程核对 tb_exchange_order 与 legacy 表结构
- [x] 9.4 在 docs/client-exchange-system/ 补充功能总结文档
