feat: 添加用户租户管理功能，优化用户列表和租户信息展示，增强查询过滤条件

backend/app/http/super/dto/user.go

@@ -1,24 +1,57 @@
 package dto
 
 import (
+	"strings"
+	"time"
+
 	"quyun/v2/app/requests"
-	"quyun/v2/database/models"
 	"quyun/v2/pkg/consts"
+
+	"go.ipao.vip/gen/types"
 )
 
 type UserPageFilter struct {
-	requests.Pagination
-	requests.SortQueryFilter
+	requests.Pagination      `json:",inline" query:",inline"`
+	requests.SortQueryFilter `json:",inline" query:",inline"`
 
-	Username *string            `query:"username"`
-	Status   *consts.UserStatus `query:"status"`
-	TenantID *int64             `query:"tenant_id"`
+	ID       *int64             `json:"id,omitempty" query:"id"`
+	Username *string            `json:"username,omitempty" query:"username"`
+	Status   *consts.UserStatus `json:"status,omitempty" query:"status"`
+
+	// TenantID filters users by membership in the given tenant.
+	TenantID *int64 `json:"tenant_id,omitempty" query:"tenant_id"`
+
+	// Role filters users containing a role (user/super_admin).
+	Role *consts.Role `json:"role,omitempty" query:"role"`
+
+	CreatedAtFrom  *time.Time `json:"created_at_from,omitempty" query:"created_at_from"`
+	CreatedAtTo    *time.Time `json:"created_at_to,omitempty" query:"created_at_to"`
+	VerifiedAtFrom *time.Time `json:"verified_at_from,omitempty" query:"verified_at_from"`
+	VerifiedAtTo   *time.Time `json:"verified_at_to,omitempty" query:"verified_at_to"`
+}
+
+func (f *UserPageFilter) UsernameTrimmed() string {
+	if f == nil || f.Username == nil {
+		return ""
+	}
+	return strings.TrimSpace(*f.Username)
 }
 
 type UserItem struct {
-	*models.User
+	ID                int64                    `json:"id"`
+	Username          string                   `json:"username"`
+	Roles             types.Array[consts.Role] `json:"roles"`
+	Status            consts.UserStatus        `json:"status"`
+	StatusDescription string                   `json:"status_description,omitempty"`
 
-	StatusDescription string `json:"status_description,omitempty"`
+	Balance       int64     `json:"balance"`
+	BalanceFrozen int64     `json:"balance_frozen"`
+	VerifiedAt    time.Time `json:"verified_at"`
+	CreatedAt     time.Time `json:"created_at"`
+	UpdatedAt     time.Time `json:"updated_at"`
+
+	OwnedTenantCount  int64 `json:"owned_tenant_count"`
+	JoinedTenantCount int64 `json:"joined_tenant_count"`
 }
 
 type UserStatusUpdateForm struct {

backend/app/http/super/dto/user_tenant.go

@@ -0,0 +1,60 @@
+package dto
+
+import (
+	"strings"
+	"time"
+
+	"quyun/v2/app/requests"
+	"quyun/v2/pkg/consts"
+
+	"go.ipao.vip/gen/types"
+)
+
+type UserTenantPageFilter struct {
+	requests.Pagination `json:",inline" query:",inline"`
+
+	TenantID *int64  `json:"tenant_id,omitempty" query:"tenant_id"`
+	Code     *string `json:"code,omitempty" query:"code"`
+	Name     *string `json:"name,omitempty" query:"name"`
+
+	// Role filters tenant_users.role containing a role (tenant_admin/member).
+	Role *consts.TenantUserRole `json:"role,omitempty" query:"role"`
+	// Status filters tenant_users.status.
+	Status *consts.UserStatus `json:"status,omitempty" query:"status"`
+
+	CreatedAtFrom *time.Time `json:"created_at_from,omitempty" query:"created_at_from"`
+	CreatedAtTo   *time.Time `json:"created_at_to,omitempty" query:"created_at_to"`
+}
+
+func (f *UserTenantPageFilter) CodeTrimmed() string {
+	if f == nil || f.Code == nil {
+		return ""
+	}
+	return strings.ToLower(strings.TrimSpace(*f.Code))
+}
+
+func (f *UserTenantPageFilter) NameTrimmed() string {
+	if f == nil || f.Name == nil {
+		return ""
+	}
+	return strings.TrimSpace(*f.Name)
+}
+
+type UserTenantItem struct {
+	TenantID int64  `json:"tenant_id"`
+	Code     string `json:"code"`
+	Name     string `json:"name"`
+
+	TenantStatus            consts.TenantStatus `json:"tenant_status"`
+	TenantStatusDescription string              `json:"tenant_status_description,omitempty"`
+	ExpiredAt               time.Time           `json:"expired_at"`
+
+	Owner *TenantOwnerUserLite `json:"owner,omitempty"`
+
+	Role types.Array[consts.TenantUserRole] `json:"role"`
+
+	MemberStatus            consts.UserStatus `json:"member_status"`
+	MemberStatusDescription string            `json:"member_status_description,omitempty"`
+
+	JoinedAt time.Time `json:"joined_at"`
+}

backend/app/http/super/routes.gen.go

@@ -99,6 +99,12 @@ func (r *Routes) Register(router fiber.Router) {
 		r.user.list,
 		Query[dto.UserPageFilter]("filter"),
 	))
+	r.log.Debugf("Registering route: Get /super/v1/users/:userID/tenants -> user.tenants")
+	router.Get("/super/v1/users/:userID/tenants"[len(r.Path()):], DataFunc2(
+		r.user.tenants,
+		PathParam[int64]("userID"),
+		Query[dto.UserTenantPageFilter]("filter"),
+	))
 	r.log.Debugf("Registering route: Get /super/v1/users/statistics -> user.statistics")
 	router.Get("/super/v1/users/statistics"[len(r.Path()):], DataFunc0(
 		r.user.statistics,

backend/app/http/super/user.go

@@ -15,7 +15,7 @@ type user struct{}
 
 // list
 //
-//	@Summary	租户列表
+//	@Summary	用户列表
 //	@Tags		Super
 //	@Accept		json
 //	@Produce	json
@@ -28,6 +28,23 @@ func (*user) list(ctx fiber.Ctx, filter *dto.UserPageFilter) (*requests.Pager, e
 	return services.User.Page(ctx, filter)
 }
 
+// tenants
+//
+//	@Summary	用户加入的租户列表
+//	@Tags		Super
+//	@Accept		json
+//	@Produce	json
+//	@Param		userID	path	int64					true	"UserID"
+//	@Param		filter	query	dto.UserTenantPageFilter	true	"Filter"
+//	@Success	200		{object}	requests.Pager{items=dto.UserTenantItem}
+//
+//	@Router		/super/v1/users/:userID/tenants [get]
+//	@Bind		userID path
+//	@Bind		filter query
+func (*user) tenants(ctx fiber.Ctx, userID int64, filter *dto.UserTenantPageFilter) (*requests.Pager, error) {
+	return services.User.TenantsPage(ctx, userID, filter)
+}
+
 // updateStatus
 //
 //	@Summary	更新用户状态