实施业务用户组成员管理

internal/handler/admin/business_user_group.go

@@ -147,9 +147,65 @@ func (h *BusinessUserGroupHandler) Delete(c *fiber.Ctx) error {
 	return response.Success(c, nil)
 }
 
-// SetMembers 批量设置平台用户的业务用户组归属，直接替换原归属。
-// PUT /api/admin/business-user-groups/:id/members
-func (h *BusinessUserGroupHandler) SetMembers(c *fiber.Ctx) error {
+// ListMembers 查询指定业务用户组保留的成员关系。
+// GET /api/admin/business-user-groups/:id/members
+func (h *BusinessUserGroupHandler) ListMembers(c *fiber.Ctx) error {
+	if err := requirePlatformManagement(c); err != nil {
+		return err
+	}
+	var request dto.BusinessUserGroupMemberListParams
+	if err := c.QueryParser(&request); err != nil {
+		return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
+	}
+	id, err := pathID(c)
+	if err != nil {
+		return err
+	}
+	request.ID = id
+	if err := h.validate(&request); err != nil {
+		return errors.New(errors.CodeInvalidParam)
+	}
+	if h.query == nil {
+		return errors.New(errors.CodeInternalError, "业务用户组成员查询尚未配置")
+	}
+	result, err := h.query.ListMembers(c.UserContext(), request.ID, request.BusinessUserGroupMemberListRequest)
+	if err != nil {
+		return err
+	}
+	return response.SuccessWithPagination(c, result.Items, result.Total, result.Page, result.Size)
+}
+
+// ListMemberCandidates 查询指定业务用户组的成员候选。
+// GET /api/admin/business-user-groups/:id/member-candidates
+func (h *BusinessUserGroupHandler) ListMemberCandidates(c *fiber.Ctx) error {
+	if err := requirePlatformManagement(c); err != nil {
+		return err
+	}
+	var request dto.BusinessUserGroupMemberCandidateParams
+	if err := c.QueryParser(&request); err != nil {
+		return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
+	}
+	id, err := pathID(c)
+	if err != nil {
+		return err
+	}
+	request.ID = id
+	if err := h.validate(&request); err != nil {
+		return errors.New(errors.CodeInvalidParam)
+	}
+	if h.query == nil {
+		return errors.New(errors.CodeInternalError, "业务用户组候选查询尚未配置")
+	}
+	result, err := h.query.ListMemberCandidates(c.UserContext(), request.ID, request.BusinessUserGroupMemberCandidateRequest)
+	if err != nil {
+		return err
+	}
+	return response.SuccessWithPagination(c, result.Items, result.Total, result.Page, result.Size)
+}
+
+// AddMembers 增量增加平台用户到指定业务用户组。
+// POST /api/admin/business-user-groups/:id/members
+func (h *BusinessUserGroupHandler) AddMembers(c *fiber.Ctx) error {
 	if err := requirePlatformManagement(c); err != nil {
 		return err
 	}
@@ -157,34 +213,38 @@ func (h *BusinessUserGroupHandler) SetMembers(c *fiber.Ctx) error {
 	if err != nil {
 		return err
 	}
-	var request dto.SetBusinessUserGroupMembersRequest
+	var request dto.AddBusinessUserGroupMembersRequest
 	if err := c.BodyParser(&request); err != nil {
 		return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
 	}
 	if err := h.validate(&request); err != nil {
 		return errors.New(errors.CodeInvalidParam)
 	}
-	result, err := h.service.SetMembers(c.UserContext(), id, &request)
+	result, err := h.service.AddMembers(c.UserContext(), id, &request)
 	if err != nil {
 		return err
 	}
 	return response.Success(c, result)
 }
 
-// ClearMembers 批量清空平台用户的业务用户组归属。
-// DELETE /api/admin/business-user-groups/members
-func (h *BusinessUserGroupHandler) ClearMembers(c *fiber.Ctx) error {
+// RemoveMembers 从指定业务用户组增量移除成员。
+// DELETE /api/admin/business-user-groups/:id/members
+func (h *BusinessUserGroupHandler) RemoveMembers(c *fiber.Ctx) error {
 	if err := requirePlatformManagement(c); err != nil {
 		return err
 	}
-	var request dto.ClearBusinessUserGroupMembersRequest
+	id, err := pathID(c)
+	if err != nil {
+		return err
+	}
+	var request dto.RemoveBusinessUserGroupMembersRequest
 	if err := c.BodyParser(&request); err != nil {
 		return errors.New(errors.CodeInvalidParam, "请求参数解析失败")
 	}
 	if err := h.validate(&request); err != nil {
 		return errors.New(errors.CodeInvalidParam)
 	}
-	result, err := h.service.ClearMembers(c.UserContext(), &request)
+	result, err := h.service.RemoveMembers(c.UserContext(), id, &request)
 	if err != nil {
 		return err
 	}