medical-mall/docs/ops/2026-02-10__admin__order-module-repaired-full.md

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