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

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

摘要

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