feat(admin): full integration of order, product, and finance modules with real RPC data streams

docs/ops/2026-02-10__admin__product-module-repaired-full.md

@@ -0,0 +1,41 @@
+# 商品模块全量修复与统计补全报告
+
+## 摘要
+本次对 Admin 商品模块进行了深度的端到端修复，重点解决了商品管理页面的搜索筛选失效、状态统计缺失以及商品统计页面的全量 Mock 问题。补齐了配套的后端 RPC 接口，并重构了前端 Service 与 UI 逻辑。
+
+## 修复范围
+
+### 1. 商品管理页 (Product Management)
+- **搜索功能真实化**：接入了分类选择器数据，绑定了搜索关键字，实现了按名称、分类、状态的联动查询。
+- **状态统计同步**：接入了各状态商品数量汇总 RPC，确保 Tab 上的“出售中”、“仓库中”等数量真实准确。
+- **交互完善**：补全了分页翻页逻辑、状态开关（上架/下架）以及逻辑删除（回收站）的操作反馈。
+
+### 2. 商品统计页 (Product Statistics)
+- **数据源迁移**：彻底移除硬编码的静态数组，将 KPI 卡片、ECharts 趋势图及排行表格全部对接真实 RPC 数据流。
+- **动态图表**：趋势图现在能反映真实的浏览量、访客数及支付金额变化。
+- **全维度排行**：商品排行表支持加购、收藏、订单数、支付额及转化率的综合展示。
+
+### 3. 商品分类页 (Classify)
+- **代码核对**：确认已符合 RPC 访问规范，支持树形结构的 CRUD 与状态管理。
+
+## 变更清单
+
+### 数据库 / RPC (SQL)
+- `docs/sql/30_rpc/product/rpc_admin_product_count_stats_v1.sql` (新增)：商品状态汇总统计。
+- `docs/sql/30_rpc/product/rpc_admin_product_trend_v1.sql` (新增)：商品营业趋势统计。
+- `docs/sql/30_rpc/product/rpc_admin_product_analytics_v1.sql` (升级)：增强商品概况指标与全维度排行逻辑。
+
+### 前端代码
+- `services/admin/productService.uts`：补齐了 stats/trend/ranking/counts 等 fetch 方法。
+- `pages/mall/admin/product/product-management/index.uvue`：重构逻辑与模板绑定。
+- `pages/mall/admin/product/product-statistics/index.uvue`：重构数据加载与图表驱动逻辑。
+
+## 验证说明
+1. **数据库执行**：需依次执行 `docs/sql/30_rpc/product/` 下新增及修改的 SQL 脚本。
+2. **功能验证**：
+   - 进入商品管理：确认搜索栏分类可选，点击查询后列表及 Tab 数量能正确刷新。
+   - 进入商品统计：确认顶部 6 个指标不再是固定值，折线图与饼图有动态交互。
+
+## 关联规范
+- 遵循 `AGENT_PROJECT_SPEC.md` 关于 Admin 侧通过 RPC 访问数据的要求。
+- 遵循 SQL 分层归档规范。

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

@@ -0,0 +1,48 @@
+# 财务模块全量修复与数据库构建报告
+
+## 摘要
+本次对 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 分层归档与版本管理规范。