csxj2026/junhong_cmp_fiber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

实施业务用户组成员管理
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 9m42s
Details

Browse Source
This commit is contained in:
break
2026-09-21 21:20:38 +08:00
parent 4a16eb0b1e
commit 22c3e7cc1a
14 changed files with 836 additions and 106 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
internal/routes/business_user_group.go
View File

@@ -60,13 +60,22 @@ func registerBusinessUserGroupRoutes(router fiber.Router, handler *admin.Busines
Auth: true,
})
// 批量清空归属使用静态路径 /members，必须先于动态 /:id 注册，否则会被 :id 吞掉。
Register(groups, doc, groupPath, "DELETE", "/members", handler.ClearMembers, RouteSpec{
Summary: "批量清空平台用户业务用户组归属",
Description: "仅超级管理员和平台账号可操作。与批量设置使用同一校验：所有账号必须是启用平台用户，任一账号无效则全量回滚。清空后账号回到未分组。",
// 成员查询路径必须先于动态组详情注册，避免动态参数吞掉子路径。
Register(groups, doc, groupPath, "GET", "/:id/members", handler.ListMembers, RouteSpec{
Summary: "查询业务用户组成员",
Description: "仅超级管理员和平台账号可操作。分页返回目标组保留的启用、禁用及已删除账号关系，支持用户名或脱敏手机号关键字及账号状态筛选。",
Tags: []string{"业务用户组"},
Input: new(dto.ClearBusinessUserGroupMembersParams),
Output: new(dto.BusinessUserGroupMembersResult),
Input: new(dto.BusinessUserGroupMemberListParams),
Output: new(dto.BusinessUserGroupMemberPageResult),
Auth: true,
})
Register(groups, doc, groupPath, "GET", "/:id/member-candidates", handler.ListMemberCandidates, RouteSpec{
Summary: "查询业务用户组成员候选",
Description: "仅超级管理员和平台账号可操作。分页返回启用且未删除的平台用户及当前归属，手机号仅返回脱敏值；支持全部、未分组、当前组和其他组筛选，停用目标组不可新增。",
Tags: []string{"业务用户组"},
Input: new(dto.BusinessUserGroupMemberCandidateParams),
Output: new(dto.BusinessUserGroupMemberCandidatePageResult),
Auth: true,
})
@@ -98,13 +107,23 @@ func registerBusinessUserGroupRoutes(router fiber.Router, handler *admin.Busines
Auth: true,
})
Register(groups, doc, groupPath, "PUT", "/:id/members", handler.SetMembers, RouteSpec{
Summary: "批量设置平台用户业务用户组归属",
Description: "仅超级管理员和平台账号可操作。请求为账号ID数组，所有账号必须是启用平台用户且目标组启用；事务内直接替换每个账号原归属，任一账号无效则全量回滚。停用组不得作为目标，已有成员关系保留并显示已停用。",
Register(groups, doc, groupPath, "POST", "/:id/members", handler.AddMembers, RouteSpec{
Summary: "增量增加业务用户组成员",
Description: "仅超级管理员和平台账号可操作。目标组必须启用；未分组账号新增、其他组账号直接迁入、当前组账号幂等不变；任一无效账号整批回滚。",
Tags: []string{"业务用户组"},
Input: new(dto.BusinessUserGroupMemberRequest),
Body: new(dto.SetBusinessUserGroupMembersRequest),
Output: new(dto.BusinessUserGroupMembersResult),
Body: new(dto.AddBusinessUserGroupMembersRequest),
Output: new(dto.BusinessUserGroupMemberMutationResult),
Auth: true,
})
Register(groups, doc, groupPath, "DELETE", "/:id/members", handler.RemoveMembers, RouteSpec{
Summary: "增量移除业务用户组成员",
Description: "仅超级管理员和平台账号可操作。目标组启用或停用均可移除；请求账号必须全部属于目标组，禁用或已删除账号关系也可清理，任一不匹配整批冲突。",
Tags: []string{"业务用户组"},
Input: new(dto.BusinessUserGroupMemberRequest),
Body: new(dto.RemoveBusinessUserGroupMembersRequest),
Output: new(dto.BusinessUserGroupMemberMutationResult),
Auth: true,
})
}