medical-mall/docs/ops/2026-02-11__admin__finance-module-repaired-full.md

财务模块全量修复与数据库构建报告

摘要

本次对 Admin 侧财务模块进行了深度的端到端修复，完成了核心财务表（提现、充值、流水）的数据库构建、行级安全策略（RLS）配置、管理端 RPC 接口补全，以及前端 5 个核心页面的全量重构。彻底解决了财务数据展示依赖 Mock 的问题。

修复范围

1. 数据库构建 (Schema & RLS)

• ml_extract (提现表)：支持支付宝/微信/银行卡多渠道快照，补齐手续费、余额快照及审核流字段。
• ml_user_recharge (充值表)：支持支付状态追踪、渠道类型及订单关联。
• ml_user_bill (资金流水表)：统一收支原子日志，支持业务大类与细分类型筛选。
• RLS 策略：为上述表配置了行级安全，确保普通用户仅能访问个人数据，Admin 侧通过 RPC 访问。

2. RPC 接口升级 (SECURITY DEFINER)

• 列表类：补全了提现、充值、流水的管理端分页查询，支持复杂的名称/订单号/时间筛选。
• 操作类：补全了提现审核（通过/驳回）、充值审计逻辑。
• 统计类：
  • rpc_admin_finance_overview：提供营业额、充值、提现等核心 KPI。
  • rpc_admin_finance_bill_summary：支持日/周/月维度的收支聚合。

3. 前端页面重构

• 提现申请 (withdrawal.uvue)：接入审核流逻辑，展示账号快照，实现实时统计更新。
• 充值记录 (recharge.uvue)：接入真实充值流水，对齐支付状态。
• 资金流水 (capital_flow.uvue)：接入原子流水展示，支持收支筛选。
• 账单记录 (bill.uvue)：基于周期聚合 RPC 实现动态账单切换。
• 交易统计 (transaction_stats.uvue)：接入真实 KPI 指标，动态驱动趋势折线图。

变更清单

数据库 SQL

• docs/sql/10_schema/finance/：ml_extract_v1.sql, ml_user_recharge_v1.sql, ml_user_bill_v1.sql
• docs/sql/20_rls/finance/：ml_extract_rls_v1.sql, ml_user_recharge_rls_v1.sql, ml_user_bill_rls_v1.sql
• docs/sql/30_rpc/finance/：补齐了 rpc_admin_finance_overview_v1.sql, rpc_admin_finance_bill_summary_v1.sql 等共 7 个接口。

前端代码

• services/admin/financeService.uts：补全 DTO 结构与汇总统计方法。
• pages/mall/admin/finance/ 目录下 5 个 .uvue 文件的逻辑与 UI 重构。

验证说明

1. 数据库执行：需依次执行 10_schema -> 20_rls -> 30_rpc 下的财务脚本。
2. 功能验证：
   • 进入财务统计：确认营业额等指标不再是固定值。
   • 提现审核：确认点击通过/驳回能真实联动数据库状态。
   • 筛选/分页：确认所有财务列表的分页与日期筛选均真实生效。

关联规范

• 遵循 AGENT_PROJECT_SPEC.md 中关于 Admin 数据访问必须走 RPC 的要求。
• 遵循 SQL 分层归档与版本管理规范。