starpivot/apps/services/comm/apprelease.go

package comm

import "strings"

// 应用发版与入口控制配置（表 TableAppRelease，存 console 共享库 postgres）。
//
// 一行 = 一个应用（`app_name=”` 为全局默认兜底），**不分渠道**。对应后台
// 「服务配置 → 版本控制」与「服务配置 → 游客显隐控制」两个页面。
//
// 为什么从 ChannelApp 里拆出来：版本号、强更、游客开关这几项本来就是「整个应用一套」，
// 按渠道各存一份的直接后果是同一个开关有 8 处能改、客户端只读其中一处 —— 线上真出过
// 「后台明明开了游客登录、App 就是不显示」的事故。拆出来之后这些字段**只有这一个来源**。
//
// 仍留在 ChannelApp 里的是真正因渠道而异的东西：下载地址、上架状态、支付渠道、
// 是否允许跳过设备绑定。其中下载地址在这里也有一份**默认值**，渠道没单独填时用它 ——
// 华为/小米/App Store 的商店链接各不相同，客户端是直接把它当 URL 打开的，
// 一套地址会把小米用户引到华为商店，所以渠道级覆盖必须保留。
type AppRelease struct {
	RowId   uint64 `gorm:"primaryKey;autoIncrement;column:row_id" json:"row_id"`
	AppName string `gorm:"column:app_name;size:64;uniqueIndex:uidx_app_release" json:"app_name"` // ''=全局默认

	// ── 版本控制 ──
	Version       string `gorm:"column:version;size:32" json:"version"`               // 当前线上版本
	MinVersion    string `gorm:"column:min_version;size:32" json:"min_version"`       // 最低支持版本，低于它的客户端必须更新
	ForceUpdate   bool   `gorm:"column:force_update" json:"force_update"`             // 强制更新总开关（配合 MinVersion）
	Changelog     string `gorm:"column:changelog" json:"changelog"`                   // 更新日志，下发给客户端展示
	Address       string `gorm:"column:address" json:"address"`                       // 默认下载地址；渠道填了自己的则以渠道为准
	ReviewVersion string `gorm:"column:review_version;size:32" json:"review_version"` // 送审版本号；客户端报这一版时隐藏未过审功能

	// ── 游客显隐 ──
	Tourists        bool   `gorm:"column:tourists" json:"tourists"`                       // 允许游客登录（总开关）
	TouristsVersion string `gorm:"column:touristsversion;size:32" json:"touristsversion"` // 生效版本，白名单语义见 ShowTourists

	Createtime int64 `gorm:"column:createtime" json:"createtime"`
	Updatetime int64 `gorm:"column:updatetime" json:"updatetime"`
}

// NeedForceUpdate 判断某客户端版本是否必须更新：开了强更开关、配了最低版本、且客户端版本低于它。
//
// 客户端版本为空（老客户端没上报）时不强更，避免把所有人挡在门外 —— 这个判定一旦判宽只是
// 少弹一次强更框，判严就是全员无法使用，失败方向必须偏向放行。
func (r *AppRelease) NeedForceUpdate(clientVersion string) bool {
	if r == nil || !r.ForceUpdate || strings.TrimSpace(r.MinVersion) == "" {
		return false
	}
	if strings.TrimSpace(clientVersion) == "" {
		return false
	}
	return CompareVersion(clientVersion, r.MinVersion) < 0
}

// NeedUpdate 判断是否有更新可用：线上版本高于客户端版本。
func (r *AppRelease) NeedUpdate(clientVersion string) bool {
	if r == nil || strings.TrimSpace(r.Version) == "" || strings.TrimSpace(clientVersion) == "" {
		return false
	}
	return CompareVersion(clientVersion, r.Version) < 0
}

// IsReviewing 判断某客户端版本是否正是「送审版本」——客户端据此隐藏未过审的功能。
func (r *AppRelease) IsReviewing(clientVersion string) bool {
	if r == nil || strings.TrimSpace(r.ReviewVersion) == "" {
		return false
	}
	return CompareVersion(clientVersion, r.ReviewVersion) == 0
}

// ShowTourists 判断某客户端版本是否该看到「游客登录」入口。
//
// 判定一律在服务端做：客户端只拿结论，不拿规则。各端各写一遍版本比较必然出现实现不一致，
// 而这个开关直接关系到应用商店过审，判错代价很高。
//
// 语义是「白名单」：**只有被点名的那一个版本可见，其余一律隐藏**。
//   - Tourists=false                      → 一律隐藏（总开关关掉）
//   - Tourists=true  且 TouristsVersion="" → 一律隐藏（没点名任何版本 = 谁都不放行）
//   - Tourists=true  且 TouristsVersion=X → 只有版本号等于 X 的客户端可见
//
// 送审场景：只给正在审核的那一版开游客登录，线上其它版本不受影响。
//
// ⚠️ 留空按「全隐藏」而非「全放行」处理，是刻意选的失败方向：这个开关一旦判宽，
// 后果是不该露出游客入口的版本露了出去（过审风险、白嫖开户礼）；判严只是入口少显示。
// 后台保存时会拦住「勾了开关却没填版本」这种等于没开的配置，避免运营踩空。
//
// 客户端没上报版本时同样隐藏——点名了版本却认不出来是哪一版，只能从严。
func (r *AppRelease) ShowTourists(clientVersion string) bool {
	if r == nil || !r.Tourists {
		return false
	}
	want := strings.TrimSpace(r.TouristsVersion)
	if want == "" {
		return false
	}
	if strings.TrimSpace(clientVersion) == "" {
		return false
	}
	return CompareVersion(clientVersion, want) == 0
}

// DownloadAddress 取该渠道实际生效的下载地址：渠道填了就用渠道的，没填回退到应用默认。
func (r *AppRelease) DownloadAddress(channelAddress string) string {
	if s := strings.TrimSpace(channelAddress); s != "" {
		return channelAddress
	}
	if r == nil {
		return ""
	}
	return r.Address
}

// PickAppRelease 从「应用行 + 全局行」里挑生效的一条：应用行覆盖全局行，都没有返回 nil。
// 与 agent / 第三方服务 / 渠道分发下发同语义（应用优先、无则回退全局）。
func PickAppRelease(rows []*AppRelease, app string) *AppRelease {
	var global, scoped *AppRelease
	for _, r := range rows {
		if r == nil {
			continue
		}
		switch r.AppName {
		case app:
			scoped = r
		case "":
			global = r
		}
	}
	if scoped != nil {
		return scoped
	}
	return global
}