# 订单模块全量修复与功能补全报告 (Stage A+B+C)

## 摘要
本次对 Admin 侧订单模块进行了深度的端到端修复，涵盖了核销记录、售后订单、收银订单、订单统计、订单配置及主列表。彻底解决了从 Mock 数据到真实数据库 RPC 接入的断层，并补齐了缺失的数据库字段。

## 修复范围 (Stage A+B+C)

### Stage A: 核销记录模块
- **UI 重构**：完全移除 `write-off-records/index.uvue` 的 Mock 数据。
- **功能补全**：接入 `rpc_admin_write_off_record_list`，实现真实的分页、搜索及状态展示。

### Stage B: 售后/收银/配置模块
- **售后订单**：修正了表头“实际支付”为“退款金额”的歧义，补齐了退款状态真实筛选逻辑。
- **收银订单**：重构为调用 `orderService.fetchCashierOrderPage`，对齐支付与用户信息字段。
- **订单配置**：将原本的 UI 模拟改为真实的 `get/save` 持久化逻辑，对接系统配置表。

### Stage C: 扩展字段与统计升级
- **Schema 补全**：通过 `ml_orders_schema_update_v1.sql` 补齐了 `pay_type`（支付方式）和 `channel_type`（订单渠道）字段。
- **RPC 升级**：
    - `rpc_admin_order_list`：现在返回真实的支付和渠道信息。
    - `rpc_admin_order_source_stats`：从 `unknown` 汇总升级为真实的按渠道分组统计。
    - `rpc_admin_order_type_stats`：新增订单类型分析统计（普通/收银/核销）。
- **页面对齐**：列表页和统计页现在展示真实的“微信支付”、“小程序”等业务标签。

## 变更清单

### 数据库/RPC (SQL)
- `docs/sql/10_schema/order/ml_orders_schema_update_v1.sql` (新增)
- `docs/sql/30_rpc/order/rpc_admin_order_list_v1.sql` (升级)
- `docs/sql/30_rpc/order/rpc_admin_order_stats_v1.sql` (升级)
- `docs/sql/30_rpc/order/rpc_admin_order_trend_v1.sql` (升级)
- `docs/sql/30_rpc/order/rpc_admin_order_source_stats_v1.sql` (升级)
- `docs/sql/30_rpc/order/rpc_admin_order_type_stats_v1.sql` (新增)

### 前端代码
- `services/orderService.uts` (补全统计与列表方法)
- `pages/mall/admin/order/list.uvue` (逻辑与 UI 重构)
- `pages/mall/admin/order/order-statistics/index.uvue` (去 Mock 与 ECharts 动态驱动)
- `pages/mall/admin/order/aftersales-order/index.uvue` (标签修正与筛选逻辑)
- `pages/mall/admin/order/cashier-order/index.uvue` (RPC 接入与字段对齐)
- `pages/mall/admin/order/write-off-records/index.uvue` (完全重构接入)
- `pages/mall/admin/order/order-configuration/index.uvue` (配置持久化闭环)

## 验证说明
1. **数据库**：需依次执行 `10_schema` 下的补丁和 `30_rpc` 下的所有订单相关 SQL。
2. **功能**：
    - 订单管理列表：检查 Tabs 切换、搜索、分页是否联动后端。
    - 订单统计：观察趋势图和饼图是否不再是 30 天固定静态值。
    - 各子模块：确保进入页面后 Loading 结束能展示真实记录。

## 风险与后续
- **支付方式映射**：当前 UI 按 1:余额, 2:微信, 3:支付宝, 4:线下 进行了硬编码映射，若后续支付方式变更，需同步更新 `list.uvue` 的映射函数。
