feat(admin): 新增角色权限与客服群管理
This commit is contained in:
@@ -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
@@ -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 个后台页面全部可用,分销后台与主站视觉统一,分销业务流程不变。
|
||||
|
||||
Reference in New Issue
Block a user