# 商品模块全量修复与统计补全报告

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