junhong_cmp_fiber/internal/query/h5popup/query.go

// Package h5popup 提供 H5 运营弹窗配置的后台只读投影。
// 该投影只读，不修改任何状态；启停与版本递增由 application 层写用例完成。
package h5popup

import (
	"context"
	"strconv"

	"gorm.io/gorm"

	"github.com/break/junhong_cmp_fiber/internal/model"
	"github.com/break/junhong_cmp_fiber/internal/model/dto"
	"github.com/break/junhong_cmp_fiber/pkg/constants"
	"github.com/break/junhong_cmp_fiber/pkg/errors"
)

// Query 提供 H5 运营弹窗配置的后台列表与详情查询。
type Query struct {
	db *gorm.DB
}

// NewQuery 创建 H5 运营弹窗配置查询。
func NewQuery(db *gorm.DB) *Query {
	return &Query{db: db}
}

// List 按最近更新时间倒序分页查询运营弹窗配置。
func (q *Query) List(ctx context.Context, request dto.H5PopupConfigurationListRequest) (*dto.H5PopupConfigurationListResponse, error) {
	page, pageSize, offset, err := normalizePagination(request.Page, request.PageSize)
	if err != nil {
		return nil, err
	}
	base := q.db.WithContext(ctx).Model(&model.H5PopupConfiguration{})
	if request.Enabled != nil {
		status := constants.H5PopupStatusDisabled
		if *request.Enabled {
			status = constants.H5PopupStatusEnabled
		}
		base = base.Where("enabled = ?", status)
	}
	var total int64
	if err := base.Count(&total).Error; err != nil {
		return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询运营弹窗配置总数失败")
	}
	var records []model.H5PopupConfiguration
	if err := base.Order("updated_at DESC, id DESC").Offset(offset).Limit(pageSize).Find(&records).Error; err != nil {
		return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询运营弹窗配置列表失败")
	}
	items := make([]dto.H5PopupConfigurationResponse, 0, len(records))
	for index := range records {
		items = append(items, *toConfigurationResponse(&records[index]))
	}
	return &dto.H5PopupConfigurationListResponse{Items: items, Total: total, Page: page, Size: pageSize}, nil
}

// Get 按 ID 查询运营弹窗配置详情。
func (q *Query) Get(ctx context.Context, id uint) (*dto.H5PopupConfigurationResponse, error) {
	if id == 0 {
		return nil, errors.New(errors.CodeH5PopupConfigurationNotFound)
	}
	var record model.H5PopupConfiguration
	if err := q.db.WithContext(ctx).Where("id = ?", id).Take(&record).Error; err != nil {
		if err == gorm.ErrRecordNotFound {
			return nil, errors.New(errors.CodeH5PopupConfigurationNotFound)
		}
		return nil, errors.Wrap(errors.CodeDatabaseError, err, "查询运营弹窗配置失败")
	}
	return toConfigurationResponse(&record), nil
}

// normalizePagination 归一化页码与每页数量并返回偏移量。
func normalizePagination(page, pageSize int) (int, int, int, error) {
	if page <= 0 {
		page = 1
	}
	if page > constants.NotificationMaxPage {
		return 0, 0, 0, errors.New(errors.CodeInvalidParam, "页码超出允许范围")
	}
	if pageSize <= 0 {
		pageSize = constants.DefaultPageSize
	}
	if pageSize > constants.MaxPageSize {
		return 0, 0, 0, errors.New(errors.CodeInvalidParam, "每页数量超出允许范围")
	}
	return page, pageSize, (page - 1) * pageSize, nil
}

// toConfigurationResponse 将配置投影为对外响应，范围维度空数组表示全量。
func toConfigurationResponse(record *model.H5PopupConfiguration) *dto.H5PopupConfigurationResponse {
	if record == nil {
		return nil
	}
	return &dto.H5PopupConfigurationResponse{
		ID: record.ID, Title: record.Title, Content: record.Content,
		PopupType:     record.PopupType,
		PopupTypeText: constants.GetH5PopupTypeName(record.PopupType),
		Pages:         append([]string{}, record.Pages...),
		ShopIDs:       toShopIDs(record.ShopIDs),
		DeviceTypes:   append([]string{}, record.DeviceTypes...),
		CardTypes:     append([]string{}, record.CardTypes...),
		Priority:      record.Priority,
		Frequency:     record.Frequency,
		FrequencyText: constants.GetH5PopupFrequencyName(record.Frequency),
		Enabled:       record.Enabled == constants.H5PopupStatusEnabled,
		EnabledText:   constants.GetH5PopupEnabledName(record.Enabled),
		ActionType:    record.ActionType,
		StartsAt:      record.StartsAt,
		EndsAt:        record.EndsAt,
		Version:       record.Version,
		CreatedAt:     record.CreatedAt,
		UpdatedAt:     record.UpdatedAt,
		Creator:       record.Creator,
		Updater:       record.Updater,
	}
}

// toShopIDs 将 JSONB 文本数组还原为店铺 ID 列表；非法项在写入侧已被拒绝，这里按跳过处理保证读取可用。
func toShopIDs(values model.StringJSONBArray) []uint {
	shopIDs := make([]uint, 0, len(values))
	for _, value := range values {
		parsed, err := strconv.ParseUint(value, 10, 64)
		if err != nil || parsed == 0 {
			continue
		}
		shopIDs = append(shopIDs, uint(parsed))
	}
	return shopIDs
}