feat(admin): 新增后台分销站点管理
This commit is contained in:
yml2213
+3
-3
@@ -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` / `order:close`，商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`，用户 `user:view` / `user:freeze` / `user:unfreeze` / `user:deposit_free` / `user:growth_points` / `user:manual_realname` / `user:revoke_realname` / `user:wallet_adjust`，提现 `withdrawal:list` / `withdrawal:detail` / `withdrawal:review` / `withdrawal:pay`，申诉 `dispute:view` / `dispute:arbitrate`，财务 `wallet:view`，公告 `announcement:view` / `announcement:manage`，审计日志 `audit_log:view`，系统配置 `system_config:view` / `system_config:update`；分销站点仍需核对。
|
||||
4. 后台菜单权限码按后端逐个核对：订单 `order:list` / `order:view` / `order:close`，商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`，用户 `user:view` / `user:freeze` / `user:unfreeze` / `user:deposit_free` / `user:growth_points` / `user:manual_realname` / `user:revoke_realname` / `user:wallet_adjust`，提现 `withdrawal:list` / `withdrawal:detail` / `withdrawal:review` / `withdrawal:pay`，申诉 `dispute:view` / `dispute:arbitrate`，财务 `wallet:view`，公告 `announcement:view` / `announcement:manage`，审计日志 `audit_log:view`，系统配置 `system_config:view` / `system_config:update`，分销站点 `distribution:site_view` / `distribution:site_manage`（列表也接受 `qrcode:view`）；当前菜单权限码已全部对照后端。
|
||||
5. SVG 中文尚未转曲。
|
||||
6. 入口包已降至 495 kB（gzip 161 kB）；AntD 共享基础设施仍在入口，后续可拆独立入口。
|
||||
7. 移动端、订单、分销轻改与首屏优化均已提交；商品管理、审核、退款、提现、用户、申诉、财务、公告、审计日志与系统配置已按批次提交。
|
||||
7. 移动端、订单、分销轻改与首屏优化均已提交；商品管理、审核、退款、提现、用户、申诉、财务、公告、审计日志、系统配置与分销站点已按批次提交。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,96 @@
|
||||
# Phase 2 验收报告（后台分销站点）
|
||||
|
||||
> 日期：2026-10-30
|
||||
> 项目：解忧商行（hfb_jysh）
|
||||
> 范围：`/console-jy8k3m/distribution/sites`
|
||||
> 结论：**本切片通过，分销站点列表、详情、基础资料编辑与启停已接真实接口**
|
||||
|
||||
---
|
||||
|
||||
## 1. 接口与权限
|
||||
|
||||
| 能力 | 接口 | 权限码 |
|
||||
| --- | --- | --- |
|
||||
| 站点列表 | `GET /api/admin/distribution/sites` | `distribution:site_view` 或 `qrcode:view` |
|
||||
| 站点详情 | `GET /api/admin/distribution/sites/:id` | `distribution:site_view` |
|
||||
| 更新站点 | `PUT /api/admin/distribution/sites/:id` | `distribution:site_manage` |
|
||||
|
||||
后端更新规则：
|
||||
|
||||
- 超级管理员或具备全量分销权限的账号可修改站点名称、域名、状态、展示账号、发布二维码、分成系数、税费与结算冷却。
|
||||
- 站点成员（`member_type` 非空）只能修改本站 `receive_ratio_delta` 与 `receive_cost_delta`，其他字段会被后端忽略。
|
||||
- `receive_ratio_delta` 与 `receive_cost_delta` 取值 0–20，超出会被归一化。
|
||||
- `settlement_hold_days` 取值 0–365。
|
||||
- 状态仅允许 `active` / `disabled`。
|
||||
- 专属域名与其他站点重复时更新失败。
|
||||
|
||||
## 2. 页面
|
||||
|
||||
`frontend/src/features/admin/AdminDistributionSitesPage.tsx`
|
||||
|
||||
- 读取全量可见站点，前端按关键字与状态即时筛选
|
||||
- 关键字覆盖站点名称、站点标识、域名、站长账号与昵称
|
||||
- 列：站点（名称/标识/域名）、站长、状态、用户、分成与结算、创建时间、操作
|
||||
- 顶部统计：站点总数、运营中数量
|
||||
- 「前往分销后台」按 `VITE_DISTRIBUTION_ADMIN_URL` 打开现有分销后台
|
||||
- 无查看权限时停止请求并显示提示
|
||||
- 无 `distribution:site_manage` 时只读
|
||||
|
||||
## 3. 详情抽屉
|
||||
|
||||
- 站点概览：名称、标识、专属域名、状态、展示账号、公告模式、创建/更新时间
|
||||
- 站长与成员：站长账号、成员角色、默认客服群、用户/下单用户数
|
||||
- 分成与结算：收号比例系数、收号成本系数、结算冷却、税费
|
||||
- 品牌与页面配置：Logo、Favicon、发布二维码；轮播/公告/页脚/回收入口/合作反馈/卖场文案是否已配置
|
||||
- 底部操作：编辑站点、停用/启用站点（仅全量权限账号）
|
||||
|
||||
## 4. 编辑弹窗
|
||||
|
||||
全量权限账号：
|
||||
|
||||
- 站点名称、专属域名、站点状态
|
||||
- 展示账号开关
|
||||
- 结算冷却天数 0–365
|
||||
- 发布二维码地址
|
||||
- 税费开关与税率（bps，100 bps = 1%）
|
||||
- 收号比例调整点数、收号成本调整点数 0–20
|
||||
|
||||
站点成员：
|
||||
|
||||
- 只展示收号比例与收号成本两个字段
|
||||
- 弹窗内提示「只能调整本站分成系数」
|
||||
|
||||
所有更新保存前二次确认；更新成功后回填详情并刷新列表。
|
||||
|
||||
## 5. 菜单与路由
|
||||
|
||||
- 路由：`frontend/src/app/AppRouter.tsx` 新增 `distribution/sites`
|
||||
- 菜单：`frontend/src/layouts/AdminLayout.tsx` 使用 `distribution:site_view`
|
||||
- 移除最后一个后台占位页面映射，未知路由仍进入统一占位
|
||||
|
||||
## 6. 验证结果
|
||||
|
||||
```text
|
||||
npx tsc --noEmit 通过
|
||||
npm run build 通过（入口 497.59 kB，gzip 161.33 kB）
|
||||
GET /api/admin/distribution/sites ok，开发库当前 0 个站点
|
||||
GET /console-jy8k3m/distribution/sites 200
|
||||
```
|
||||
|
||||
开发库没有分销站点，列表读取已实测为空；未执行 `PUT` 写操作，避免创建或改动分销站点。
|
||||
|
||||
## 7. 已知限制
|
||||
|
||||
1. 不提供新建站点/一键开通分销商，开通仍走现有分销后台流程，避免重复实现站长账号与初始权限逻辑。
|
||||
2. 不提供删除站点、重置站长密码。
|
||||
3. 品牌素材、轮播、公告、页脚等 JSON 不在本页编辑，仍由分销后台或系统配置维护。
|
||||
4. 站点钱包、提现审核、短信配置、邀请配置、二维码池、收货商品列表尚未迁入主后台。
|
||||
5. 站点成员只能调整分成系数，表单按后端实际权限收窄。
|
||||
|
||||
## 8. 下一步建议
|
||||
|
||||
1. 站点钱包与提现审核。
|
||||
2. 分销规则版本与结算快照。
|
||||
3. 分销后台品牌素材配置迁移。
|
||||
4. 线下出款/运营支出登记。
|
||||
5. 移动端下单、支付与交接/归还/结账。
|
||||
+1
-1
@@ -395,7 +395,7 @@ hfb_jysh/
|
||||
|
||||
### Phase 4：管理后台核心（4–5 周）
|
||||
|
||||
> 状态：**进行中（2026-10-30）**。已完成仪表盘、订单、退款、提现、商品、用户、申诉、财务看板、公告管理、审计日志与系统配置；线下出款/运营支出待迁移。
|
||||
> 状态：**进行中（2026-10-30）**。已完成仪表盘、订单、退款、提现、商品、用户、申诉、财务看板、公告管理、审计日志、系统配置与分销站点；线下出款/运营支出及分销长尾能力待迁移。
|
||||
|
||||
- 后台登录、工作台、订单列表、订单详情。
|
||||
- 商品列表、商品详情、审核。
|
||||
|
||||
Reference in New Issue
Block a user