junhong_cmp_fiber/pkg/constants/h5_popup.go

package constants

const (
	// H5PopupPageHome 表示 H5 首页。
	H5PopupPageHome = "home"
	// H5PopupPageAssetDetail 表示 H5 资产详情页。
	H5PopupPageAssetDetail = "asset_detail"
	// H5PopupPagePackagePurchase 表示 H5 套餐购买页。
	H5PopupPagePackagePurchase = "package_purchase"
	// H5PopupPageAssetWalletRecharge 表示 H5 资产钱包充值页。
	H5PopupPageAssetWalletRecharge = "asset_wallet_recharge"

	// H5PopupFrequencyOnce 表示每客户每配置版本仅投放一次。
	H5PopupFrequencyOnce = "once"
	// H5PopupFrequencyDaily 表示每客户每配置版本每个上海自然日投放一次。
	H5PopupFrequencyDaily = "daily"

	// H5PopupActionPackagePurchase 表示受控动作套餐购买。
	H5PopupActionPackagePurchase = "package_purchase"
	// H5PopupActionAssetWalletRecharge 表示受控动作资产钱包充值。
	H5PopupActionAssetWalletRecharge = "asset_wallet_recharge"

	// H5PopupStatusDisabled 表示运营弹窗配置已停用。
	H5PopupStatusDisabled = 0
	// H5PopupStatusEnabled 表示运营弹窗配置已启用。
	H5PopupStatusEnabled = 1

	// H5PopupCandidateTypeRiskExchange 表示候选为风险换卡弹窗。
	H5PopupCandidateTypeRiskExchange = "risk_exchange"
	// H5PopupCandidateTypeOperation 表示候选为运营弹窗。
	H5PopupCandidateTypeOperation = "operation"

	// H5PopupTypePromotion 表示运营弹窗类型为套餐政策推广。
	H5PopupTypePromotion = "promotion"
	// H5PopupTypeAnnouncement 表示运营弹窗类型为通用公告。
	H5PopupTypeAnnouncement = "announcement"

	// H5PopupTypeDefaultPriorityPromotion 是套餐政策推广未显式指定优先级时的缺省优先级（对应 111.md §13.3 的「中」）。
	H5PopupTypeDefaultPriorityPromotion = 100
	// H5PopupTypeDefaultPriorityAnnouncement 是通用公告未显式指定优先级时的缺省优先级（对应 111.md §13.3 的「低」）。
	H5PopupTypeDefaultPriorityAnnouncement = 0

	// H5PopupRiskExchangeReason 是客户自助风险换卡单的固定换货原因，保证换货原因非空且可追溯来源。
	H5PopupRiskExchangeReason = "运营商风险停机，客户自助申请寄送新卡"

	// H5PopupDisplayDays 表示弹窗投放通知的展示保留天数，与投放时间共同决定 expires_at。
	H5PopupDisplayDays = 90

	// H5PopupRiskEventKeyPrefix 是风险换卡候选通知的事件键前缀，键内包含上海自然日以保证一天一条。
	H5PopupRiskEventKeyPrefix = "h5popup.risk"
	// H5PopupOperationOnceEventKeyPrefix 是仅一次运营弹窗通知的事件键前缀。
	H5PopupOperationOnceEventKeyPrefix = "h5popup.once"
	// H5PopupOperationDailyEventKeyPrefix 是每天一次运营弹窗通知的事件键前缀，键内包含上海自然日。
	H5PopupOperationDailyEventKeyPrefix = "h5popup.daily"

	// H5PopupAuditConfigKeyPrefix 表示运营弹窗配置审计配置键前缀。
	H5PopupAuditConfigKeyPrefix = "h5_popup_configuration"
	// H5PopupAuditModule 表示 H5 弹窗能力的审计模块标识。
	H5PopupAuditModule = "h5_popup"
)

// IsH5PopupPage 判断页面是否为受控的 H5 弹窗页面。
func IsH5PopupPage(page string) bool {
	switch page {
	case H5PopupPageHome, H5PopupPageAssetDetail, H5PopupPagePackagePurchase, H5PopupPageAssetWalletRecharge:
		return true
	default:
		return false
	}
}

// IsH5PopupFrequency 判断投放频率是否为受控值。
func IsH5PopupFrequency(frequency string) bool {
	switch frequency {
	case H5PopupFrequencyOnce, H5PopupFrequencyDaily:
		return true
	default:
		return false
	}
}

// IsH5PopupActionType 判断受控动作是否合法；空值表示无受控动作。
func IsH5PopupActionType(actionType string) bool {
	switch actionType {
	case "", H5PopupActionPackagePurchase, H5PopupActionAssetWalletRecharge:
		return true
	default:
		return false
	}
}

// IsH5PopupType 判断运营弹窗类型是否合法；类型为必填单选，空值不合法。
func IsH5PopupType(popupType string) bool {
	switch popupType {
	case H5PopupTypePromotion, H5PopupTypeAnnouncement:
		return true
	default:
		return false
	}
}

// GetH5PopupTypeName 获取运营弹窗类型的中文名称。
func GetH5PopupTypeName(popupType string) string {
	switch popupType {
	case H5PopupTypePromotion:
		return "套餐政策推广"
	case H5PopupTypeAnnouncement:
		return "通用公告"
	default:
		return ""
	}
}

// H5PopupTypeDefaultPriority 返回该类型未显式指定优先级时的缺省优先级。
// 类别本身已由候选排序的类别表达式保证「推广高于公告」，缺省值只决定同类别内的默认次序。
func H5PopupTypeDefaultPriority(popupType string) int {
	switch popupType {
	case H5PopupTypePromotion:
		return H5PopupTypeDefaultPriorityPromotion
	default:
		return H5PopupTypeDefaultPriorityAnnouncement
	}
}

// IsCarrierType 判断卡类型是否为受控运营商类型；用于范围配置的取值校验。
func IsCarrierType(carrierType string) bool {
	switch carrierType {
	case CarrierTypeCMCC, CarrierTypeCUCC, CarrierTypeCTCC, CarrierTypeCBN:
		return true
	default:
		return false
	}
}

// IsH5PopupNotificationType 判断通知类型是否为弹窗投放类型；只有弹窗类型才写投放快照。
func IsH5PopupNotificationType(notificationType string) bool {
	switch notificationType {
	case NotificationTypeH5PopupRiskExchange, NotificationTypeH5PopupOperation:
		return true
	default:
		return false
	}
}

// GetH5PopupFrequencyName 获取运营弹窗投放频率名称。
func GetH5PopupFrequencyName(frequency string) string {
	switch frequency {
	case H5PopupFrequencyOnce:
		return "仅一次"
	case H5PopupFrequencyDaily:
		return "每天一次"
	default:
		return ""
	}
}

// GetH5PopupEnabledName 获取运营弹窗启停状态名称。
func GetH5PopupEnabledName(status int) string {
	switch status {
	case H5PopupStatusEnabled:
		return "启用"
	case H5PopupStatusDisabled:
		return "停用"
	default:
		return ""
	}
}

// GetH5PopupPageName 获取 H5 弹窗页面名称。
func GetH5PopupPageName(page string) string {
	switch page {
	case H5PopupPageHome:
		return "首页"
	case H5PopupPageAssetDetail:
		return "资产详情"
	case H5PopupPagePackagePurchase:
		return "套餐购买"
	case H5PopupPageAssetWalletRecharge:
		return "资产钱包充值"
	default:
		return ""
	}
}