feat(admin): 新增后台商品管理与审核视图

2026-10-30 13:01:55 +08:00
parent a978ec07f4
commit cd66bca9d5
9 changed files with 1052 additions and 7 deletions
@@ -194,12 +194,12 @@ dist/assets/AdminLayout-*.js               36.87 kB │ gzip  13.02 kB
 ## 5. 已知限制

 1. 移动端订单列表/详情与消息中心已接入真实接口；下单、支付、交接、归还、结账等操作仍待迁移。
-2. 后台除仪表盘、订单列表与订单详情外，其余页面仍为统一占位。
+2. 后台已完成仪表盘、订单列表/详情、商品列表/详情与商品审核，其余页面仍为统一占位。
 3. 分销后台已完成主题、Logo、登录页与 Shell 轻改，页面结构未重写。
-4. 后台菜单权限码基于旧项目推断：订单页已核对为 `order:list`（列表）与 `order:view`（详情），其余页面仍需逐一核对。
+4. 后台菜单权限码按后端逐个核对：订单 `order:list` / `order:view`，商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`；其余页面仍需核对。
 5. SVG 中文尚未转曲。
-6. 首屏包体仍偏大。
-7. 移动端 `ef01486`、后台订单 `17b985a`、移动订单与消息 `e8a20eb` 已提交；分销后台轻改在后续批次提交。
+6. 入口包已降至 495 kB（gzip 161 kB）；AntD 共享基础设施仍在入口，后续可拆独立入口。
+7. 移动端、订单、分销轻改与首屏优化均已提交；商品管理与审核在本批次提交。

 ---

@@ -0,0 +1,82 @@
+# Phase 2 验收报告（后台商品管理与审核）
+
+> 日期：2026-10-30  
+> 项目：解忧商行（hfb_jysh）  
+> 范围：`/console-jy8k3m/listings`、`/console-jy8k3m/listings/review`  
+> 结论：**本切片通过，商品列表、详情与审核动作已接真实接口**
+
+---
+
+## 1. 接口与权限
+
+| 能力 | 接口 | 权限码 |
+| --- | --- | --- |
+| 商品列表 | `GET /api/admin/listings` | `listing:view` |
+| 商品详情 | `GET /api/admin/listings/:id` | `listing:view` |
+| 待审核队列 | `GET /api/admin/listings/pending` | `listing:approve` |
+| 通过审核 | `POST /api/admin/listings/:id/approve` | `listing:approve` |
+| 拒绝审核 | `POST /api/admin/listings/:id/reject` | `listing:reject` |
+| 下架 | `POST /api/admin/listings/:id/offline` | `listing:offline` |
+| 标记异常 | `POST /api/admin/listings/:id/mark-abnormal` | `listing:offline` |
+
+前端菜单权限已核对：商品管理 `listing:view`、商品审核 `listing:approve`，与后端一致。
+
+## 2. 商品列表
+
+`frontend/src/features/admin/AdminListingsPage.tsx`
+
+- 筛选：关键词（商品编号 / 标题 / 号主手机号）、商品状态、审核状态
+- 列：商品（标题/编号/区服/平台）、号主、价格与押金、商品状态、审核状态、审核意见、更新时间、详情
+- 分页 10 / 20 / 50，翻页保留上页数据
+- 点击标题、行或「详情」打开详情抽屉
+- 无 `listing:view` 时隐藏详情入口与行点击
+
+## 3. 商品审核队列
+
+同一页面的 `mode="review"`：
+
+- 使用 `GET /api/admin/listings/pending`，只取待审核商品
+- 关键词与商品状态在本地过滤，分页在前端切片
+- 审核通过 / 拒绝后同时失效列表与待审核缓存
+
+## 4. 商品详情抽屉
+
+`frontend/src/features/admin/AdminListingDetailDrawer.tsx`
+
+- 标题区：商品标题、编号、号主手机号、商品/审核/交易中标签
+- 分段：商品概览、商品信息、价格与押金、号主与来源、审核意见、资产摘要、商品截图
+- 资产摘要按已知字段映射中文名，`online_time` 渲染为「开始 至 结束」
+- 截图支持 AntD 图片预览
+- 操作按钮按权限与状态显示：
+  - 待审核 + `listing:approve`：通过审核
+  - 待审核 + `listing:reject`：拒绝（必填原因）
+  - 非下架/完成/封存 + `listing:offline`：下架、标记异常（必填原因）
+- 操作成功后刷新详情、商品列表、待审核队列
+
+## 5. 验证结果
+
+```text
+npx tsc --noEmit                                     通过
+npm run build                                        通过（入口 495.21 kB，gzip 160.95 kB，无体积警告）
+GET /api/admin/listings?page=1&page_size=5             ok，返回商品 DTO 与资产摘要
+GET /api/admin/listings/1                             ok，返回完整详情
+GET /api/admin/listings/pending                       ok，{"items":[]}
+GET /console-jy8k3m/listings                          200
+GET /console-jy8k3m/listings/review                   200
+```
+
+开发库当前 1 个已上架商品、0 个待审核商品，因此审核动作未做真实写入验证，避免污染开发数据；审核接口契约与按钮权限已按后端路由核对。
+
+## 6. 已知限制
+
+1. 审核调价、转移号主、修改截图、外链商品调价尚未接入。
+2. 未做批量通过/批量拒绝。
+3. 资产摘要未知字段仍回退英文 key。
+4. 主包体积已达标，但 AntD 共享基础设施仍在入口包内。
+
+## 7. 下一步建议
+
+1. 后台用户管理列表与用户详情，接通订单/商品深链。
+2. 商品审核调价与转移号主。
+3. 后台退款审核、申诉仲裁。
+4. 移动端下单、支付与交接/归还/结账。
@@ -395,6 +395,8 @@ hfb_jysh/

 ### Phase 4：管理后台核心（4–5 周）

+> 状态：**进行中（2026-10-30）**。已完成仪表盘、订单列表/详情、商品列表/详情与商品审核；退款、提现、用户、申诉与系统配置待迁移。
+
 - 后台登录、工作台、订单列表、订单详情。
 - 商品列表、商品详情、审核。
 - 用户列表、用户详情、实名信息。