3.6 KiB
3.6 KiB
ADDED Requirements
Requirement: 业务用户组维护
后台 MUST 提供业务用户组列表、详情、创建、更新与删除能力（GET/POST /api/admin/business-user-groups、GET/PUT/DELETE /api/admin/business-user-groups/{id}）。列表 MUST 支持 page/page_size/enabled/keyword/business_line 筛选，且每项 MUST 返回 business_line_name。创建时 code（1-64）与 name 必填，编码未删除组内唯一且创建后不可修改；business_line 可空（standard/smart/other），sort/enabled/remark 可选。更新 MUST 仅允许名称、业务线、排序、启停与备注，且 business_line 支持三态：字段缺失不修改、传 "" 清空、传枚举设置；删除 MUST 携带 {"confirm": true}，仅无成员组可删除。
Scenario: 查询业务用户组列表
- GIVEN 用户进入业务用户组维护页
- WHEN 前端以 page/page_size/enabled/keyword/business_line 发起列表查询
- THEN 前端 MUST 展示分页结果且每项显示 business_line_name
- AND 下拉数据源复用该列表接口
Scenario: 创建时编码不可变
- GIVEN 用户填写名称与稳定编码创建用户组
- WHEN 提交成功或编码重复被后端拒绝
- THEN 编码在创建后 MUST NOT 出现在编辑表单中
- AND 编码重复时 MUST 展示后端返回的"业务用户组编码已存在"
Scenario: 业务线三态更新
- GIVEN 用户编辑某组的业务线
- WHEN 表单传 ""、传枚举或省略该字段
- THEN 前端 MUST 分别按"清空 / 设置 / 不修改"构造请求体
Scenario: 删除需二次确认
- GIVEN 用户点击删除某组
- WHEN 确认弹窗提交
- THEN 前端 MUST 携带 {"confirm": true}
- AND 有成员时 MUST 提示"用户组仍有成员，只能停用或先移走成员"且不做物理删除
- AND 无成员时删除成功并刷新列表
Requirement: 成员归属批量维护
后台 MUST 支持按平台用户账号把成员批量设置进组（PUT /api/admin/business-user-groups/{id}/members）与批量清空（DELETE /api/admin/business-user-groups/members，携带 body account_ids）。两种操作 MUST 复用同一校验：所有账号必须是启用平台用户且目标组启用，任一账号无效则整批不生效；清空后账号回到未分组；一账号至多一组。
Scenario: 批量设置成员
- GIVEN 用户在成员管理中选择多个启用平台账号
- WHEN 保存成员归属
- THEN 前端 MUST 以 account_ids 数组整体替换每个账号原归属
- AND 刷新后成员关系与最新分组一致
Scenario: 批量清空成员
- GIVEN 用户选择若干账号执行清空
- WHEN 提交清空
- THEN 前端 MUST 调用 DELETE /api/admin/business-user-groups/members 并携带 account_ids body
- AND 清空成功的账号回到未分组
Scenario: 停用组的成员展示
- GIVEN 某组被停用但仍有成员
- WHEN 用户在成员管理或店铺列表看到该组
- THEN 前端 MUST 展示"已停用"标记并提供改组/清空入口
Requirement: 访问控制与入口
业务用户组维护入口 MUST 仅对超级管理员与平台账号可见，代理/企业账号 MUST NOT 渲染入口；所有按钮 MUST 受权限码控制。
Scenario: 菜单按角色隐藏
- GIVEN 代理或企业账号登录
- WHEN 系统渲染菜单
- THEN MUST NOT 展示业务用户组菜单项
Scenario: 按钮权限控制
- GIVEN 平台账号具备部分业务用户组权限
- WHEN 渲染操作按钮
- THEN 前端 MUST 按 business_user_group:create/update/delete/members 控制显隐