feat(admin): 新增角色权限与客服群管理

This commit is contained in:
yml2213
2026-10-30 16:08:54 +08:00
parent 81a19431fa
commit a54680f59a
9 changed files with 1114 additions and 1 deletions
@@ -0,0 +1,110 @@
# Phase 2 验收报告(角色权限与客服群)
> 日期:2026-10-30
> 项目:解忧商行(hfb_jysh)
> 范围:后台角色权限矩阵、客服群组管理、菜单与路由接入
> 结论:**页面、接口、类型检查与构建全部通过;写操作未在验收中执行**
---
## 1. 角色权限
- 页面:`frontend/src/features/admin/AdminRolesPage.tsx`
- 路由:`/console-jy8k3m/roles`
- 权限:`role:manage`
- 接口:
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | `/api/admin/roles` | 角色列表(含 `perm_count`) |
| GET | `/api/admin/roles/:id` | 角色详情与权限 ID |
| POST | `/api/admin/roles` | 创建角色 |
| PUT | `/api/admin/roles/:id` | 编辑角色 |
| DELETE | `/api/admin/roles/:id` | 删除角色(内置角色返回 `ErrProtectedRole`) |
| GET | `/api/admin/permissions` | 全量权限字典 |
| PUT | `/api/admin/roles/:id/permissions` | 覆盖式保存角色权限 |
- 能力:
- 角色列表、创建、编辑、删除;内置角色删除由后端拦截并在前端透出后端错误信息。
- 权限分配弹窗按 `resource` 分组,使用 `Checkbox.Group`;
- 勾选变更只替换当前资源组的权限,其他资源已选权限原样保留后整体提交。
- 弹窗顶部展示已选数量,并提示「保存后立即影响该角色下所有管理员」。
- 样式:`.admin-role-permission-loading`、`.admin-permission-groups`、`.admin-permission-group` 落在 `frontend/src/styles/admin-misc.css`,权限项在宽屏双列以上自适应、768px 以下单列。
## 2. 客服群组
- 页面:`frontend/src/features/admin/AdminSupportGroupsPage.tsx`
- 路由:`/console-jy8k3m/chat-support-groups`
- 权限:`chat:manage`
- 接口:
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | `/api/admin/chat-support-groups` | 客服群列表 |
| POST | `/api/admin/chat-support-groups` | 创建客服群 |
| PUT | `/api/admin/chat-support-groups/:id` | 编辑客服群 |
| DELETE | `/api/admin/chat-support-groups/:id` | 删除客服群 |
| GET | `/api/admin/chat-support-groups/support-admins` | 可选坐席(管理员)列表 |
- 能力:群编码/名称/描述/状态/排序维护,成员多选绑定坐席;创建、编辑、删除后失效 `admin-support-groups` 查询缓存。
- 成员来源为 `support-admins`,接口当前返回空数组时页面按空成员处理,不报错。
## 3. 菜单与路由接入
- `frontend/src/layouts/AdminLayout.tsx`
- 「客服」菜单组:`/chat-support-groups` → 客服群组(`chat:manage`)。
- 「系统」菜单组新增:`/roles` → 角色权限(`role:manage`)。
- `sectionMeta` 补 `/roles` 与 `/chat-support-groups` 的标题与描述。
- `frontend/src/app/AppRouter.tsx`:`AdminRolesPage`、`AdminSupportGroupsPage` 均为 lazy import。
## 4. 只读回归
开发环境:
```text
前端 http://localhost:5289
后端 http://127.0.0.1:18089
Cookie /tmp/jysh-admin-cookie2.txt(HttpOnly,withCredentials)
```
页面路由:
| 路径 | 状态 |
|---|---|
| `/console-jy8k3m/roles` | 200 |
| `/console-jy8k3m/chat-support-groups` | 200 |
接口(携带已有管理端 cookie,未触发 refresh):
| 路径 | 状态 |
|---|---|
| `GET /api/admin/roles` | 200(含 `super_admin`,`perm_count=78`) |
| `GET /api/admin/permissions` | 200 |
| `GET /api/admin/chat-support-groups` | 200(含 `owner_onboarding` 收号组-客服) |
| `GET /api/admin/chat-support-groups/support-admins` | 200 |
写操作(创建/编辑/删除角色与客服群、保存权限)本轮未执行,避免影响开发库既有权限数据。
## 5. 类型检查与构建
```bash
cd frontend && npx tsc --noEmit # 通过
cd frontend && npm run build # 通过
```
构建结果(无超大包告警):
```text
dist/assets/index-C5HmO9XZ.js 493.43 kB │ gzip: 155.88 kB
dist/assets/vendor-react-BKj2bk8R.js 282.79 kB │ gzip: 90.00 kB
dist/assets/vendor-mobile-DQjalTEh.js 307.07 kB │ gzip: 103.63 kB
dist/assets/vendor-antd-icons-SRcm2AV6.js 102.44 kB │ gzip: 29.73 kB
dist/assets/Table-CUTV1oFv.js 144.26 kB │ gzip: 47.07 kB
```
修复项:`AdminRolesPage.tsx` 移除未使用的 `AdminRolePayload` 类型导入(`TS6196`)。
## 6. 仍未覆盖
- 角色权限与客服群的写操作、内置角色删除拦截的真实响应未做端到端验证。
- 客服坐席为空时,真实会话分流链路未验证。
+4 -1
View File
@@ -395,7 +395,7 @@ hfb_jysh/
### Phase 4:管理后台核心(4–5 周)
> 状态:**进行中(2026-10-30)**。已完成仪表盘、订单、退款、提现、商品、用户、申诉、财务看板、资金出款、运营开支、公告管理、审计日志、系统配置、支付配置、分销站点、分销看板、站点钱包、分销订单、结算批次、分销用户、站点公告、分销商品、支付通道、规则版本、二维码池、站点短信与邀请返利;分销账号同步入口已接入,订单结算比例已 bps 化;剩余真实外部支付 E2E、真实站点数据业务回归与上线准备。
> 状态:**进行中(2026-10-30)**。已完成仪表盘、订单、退款、提现、商品、用户、申诉、财务看板、资金出款、运营开支、公告管理、审计日志、系统配置、支付配置、角色权限、客服群组、分销站点、分销看板、站点钱包、分销订单、结算批次、分销用户、站点公告、分销商品、支付通道、规则版本、二维码池、站点短信与邀请返利;分销账号同步入口已接入,订单结算比例已 bps 化;剩余真实外部支付 E2E、真实站点数据业务回归与上线准备。
- 后台登录、工作台、订单列表、订单详情。
- 商品列表、商品详情、审核。
@@ -410,9 +410,12 @@ hfb_jysh/
- 财务看板、资金明细、运营支出。
- 申诉仲裁、手工订单、提号、客服群、快捷回复。
- 已落地:客服群组(`/chat-support-groups`,权限 `chat:manage`),角色权限矩阵(`/roles`,权限 `role:manage`)。
- 待落地:手工录单 `/api/admin/manual-entries`、快捷回复 `/api/admin/chats/quick-replies`、推广追踪链接 `/api/admin/tracking-links`。
- 分销站点、规则、订单、结算、二维码池、分销用户、公告。
- 公告、邀请返利、推送、追踪链接。
- 系统配置、支付配置、备份、管理员管理。
- 待落地:管理员账号管理 `/api/admin/admin-users`。
- 现有 React 分销后台仅做品牌主题、Logo、登录页、Shell 和文案轻改,不改功能。
**验收:** 43 个后台页面全部可用,分销后台与主站视觉统一,分销业务流程不变。