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

## 摘要
本次对 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 分层归档与版本管理规范。
