query

type BaseInfoFilter struct {
	DBField    string        // 数据库字段名
	Values     []interface{} // 过滤值列表
	ExactMatch bool          // 是否精确匹配（默认 false 表示 LIKE）
	AllRegex   bool          // 是否全部匹配正则（所有值都包含）
}

type Filter struct {
	Field    string      // 字段名
	Operator Operator    // 操作符
	Value    interface{} // 值（可能是单个值或数组）
	Logic    string      // AND / OR
}

type FilterGroup struct {
	Filters []*Filter
	Groups  []*FilterGroup
	Logic   string // AND / OR
}

type FindOption struct {
	BusinessId    string        // 业务 ID
	ShopId        string        // 店铺 ID
	TablePrefix   string        // 表名前缀
	ExcludeField  bool          // 是否排除字段
	ExcludeFields []string      // 排除字段列表
	IncludeFields []string      // 包含字段列表
	NoCache       bool          // 是否不使用缓存
	CacheTTL      time.Duration // 缓存过期时间
}

type Operator string

type OrderBy struct {
	Field string // 字段名
	Order string // ASC / DESC
}

type PageBean struct {
	Page     int         `json:"page"`      // 当前页码
	PageSize int         `json:"page_size"` // 每页数量
	Total    int64       `json:"total"`     // 总数
	Pages    int         `json:"pages"`     // 总页数
	Rows     interface{} `json:"rows"`      // 数据行
}

type Param struct {
	Filters       []*Filter                 // 过滤条件
	FilterGroups  []*FilterGroup            // 过滤组（支持 AND/OR 混合）
	TimeRanges    map[string][2]interface{} // 时间范围 field -> [startTime, endTime]
	FindInSets    map[string][]string       // FIND_IN_SET 条件
	Orders        []*OrderBy                // 排序条件
	Page          int                       // 页码（从 1 开始）
	PageSize      int                       // 每页数量
	Offset        int                       // 偏移量（与 Page 互斥）
	Limit         int                       // 限制数量
	Distinct      bool                      // 是否去重
	SelectFields  []string                  // 指定查询字段
	HavingClauses []string                  // HAVING 子句
}