53 lines
3.1 KiB
Markdown
53 lines
3.1 KiB
Markdown
# 订单模块全量修复与功能补全报告 (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` 的映射函数。
|