package packagedomain import ( "slices" "time" ) // 沉默期领域规则(add-package-silence-period,技术方案 §4.2、§5.2、§8.2、§3.6)。 // 本文件只放纯函数:不读库、不读配置。所有截止时间与延期计费只能由这里计算,禁止各处自写 AddDate 或 SQL interval。 const ( silenceDaysPerMonth = 30 silenceStatusWait = "waiting" ) var silenceLocation = loadSilenceLocation() func loadSilenceLocation() *time.Location { location, err := time.LoadLocation("Asia/Shanghai") if err != nil { return time.FixedZone("CST", 8*3600) } return location } // SilenceLocation 返回沉默期计算使用的时区 Asia/Shanghai。 func SilenceLocation() *time.Location { return silenceLocation } // SilenceDate 返回时间点在 Asia/Shanghai 下的日期(当日 00:00:00)。 func SilenceDate(t time.Time) time.Time { local := t.In(silenceLocation) year, month, day := local.Date() return time.Date(year, month, day, 0, 0, 0, 0, silenceLocation) } // SilenceDeadline 返回 (日期 + days 天) 当日 23:59:59(Asia/Shanghai)。 // 例:2026-09-24 10:00 购买、30 天 → 2026-10-24 23:59:59。 func SilenceDeadline(date time.Time, days int) time.Time { local := date.In(silenceLocation) year, month, day := local.Date() return time.Date(year, month, day+days, 23, 59, 59, 0, silenceLocation) } // SilenceDaysBetween 返回两个时间点按 Asia/Shanghai 日期相差的天数(to − from)。 func SilenceDaysBetween(from, to time.Time) int { start := SilenceDate(from) end := SilenceDate(to) // 用 UTC 日期差避免夏令时影响(上海无夏令时,这里保持通用)。 startUTC := time.Date(start.Year(), start.Month(), start.Day(), 0, 0, 0, 0, time.UTC) endUTC := time.Date(end.Year(), end.Month(), end.Day(), 0, 0, 0, 0, time.UTC) return int(endUTC.Sub(startUTC).Hours() / 24) } // SilenceDecision 是一次沉默期判定的结果。 type SilenceDecision string const ( // SilenceDecisionNoop 状态不变(不适用沉默期、已结束 / 已过期、仍在期内等待实名、调整审批中)。 SilenceDecisionNoop SilenceDecision = "noop" // SilenceDecisionWait 仍在期内等待实名(与 noop 一样不写库,供展示区分)。 SilenceDecisionWait SilenceDecision = "wait" // SilenceDecisionEnd 期内已实名,沉默期结束。 SilenceDecisionEnd SilenceDecision = "end" // SilenceDecisionExpire 已到期且期内未实名,沉默期过期。 SilenceDecisionExpire SilenceDecision = "expire" ) // SilenceFacts 是判定所需的事实。 type SilenceFacts struct { Status string // 当前 silence_status(空表示不适用) DeadlineAt *time.Time // 当前截止时间 Realnamed bool // 资产当前是否已实名 RealnameAt *time.Time // 实名时间(设备为绑定卡 max(实名, 绑定) 的最小值) AdjustPending bool // 购买时调整审批是否进行中 Now time.Time } // SilenceJudgement 是判定结果与补写信息。 type SilenceJudgement struct { Decision SilenceDecision // BackfillRealnameAt 为 true 表示资产已实名但实名时间为空,按规则视为期内实名并需补写实名时间。 BackfillRealnameAt bool } // JudgeSilence 执行统一判定(技术方案 §5.2): // // waiting 且 期内已实名 → end // waiting 且 已到期 且 期内未实名 且 无调整审批 → expire // 其他 → 不变 // // 已实名但实名时间为空的资产视为期内已实名(生产存在 first_realname_at 为空的已实名卡)。 func JudgeSilence(facts SilenceFacts) SilenceJudgement { if facts.Status != silenceStatusWait || facts.DeadlineAt == nil { return SilenceJudgement{Decision: SilenceDecisionNoop} } deadline := *facts.DeadlineAt if facts.Realnamed { if facts.RealnameAt == nil { return SilenceJudgement{Decision: SilenceDecisionEnd, BackfillRealnameAt: true} } if !facts.RealnameAt.After(deadline) { return SilenceJudgement{Decision: SilenceDecisionEnd} } } if facts.Now.After(deadline) && !facts.AdjustPending { return SilenceJudgement{Decision: SilenceDecisionExpire} } return SilenceJudgement{Decision: SilenceDecisionWait} } // IsSilenceEffectivelyExpired 判断展示层是否应显示"沉默期已过期":已过期,或待实名但已过截止且无调整审批。 func IsSilenceEffectivelyExpired(status string, deadlineAt *time.Time, adjustPending bool, now time.Time) bool { if status == "expired" { return true } return status == silenceStatusWait && deadlineAt != nil && now.After(*deadlineAt) && !adjustPending } // SilenceMonthsForDays 按每月 30 天向上取整:返回计费月数与计费 / 延长天数。 // 例:1→(1,30);30→(1,30);31→(2,60);60→(2,60)。 func SilenceMonthsForDays(inputDays int) (months int, billedDays int) { if inputDays <= 0 { return 0, 0 } months = (inputDays + silenceDaysPerMonth - 1) / silenceDaysPerMonth return months, months * silenceDaysPerMonth } // SilencePolicySnapshot 是延期计价与上限使用的政策快照。 type SilencePolicySnapshot struct { PolicyID uint Name string UnitPrice int64 FreeExtensionLimit int PaidMaxMonths int SingleMaxMonths *int ApprovalExemptTypes []string } // SilenceQuoteKind 是延期报价类型。 type SilenceQuoteKind string const ( // SilenceQuotePaid 付费延期(在线与线下):受政策累计与单次上限约束。 SilenceQuotePaid SilenceQuoteKind = "paid" // SilenceQuoteSpecial 特殊延期(含免费):只要求不少于最少月数。 SilenceQuoteSpecial SilenceQuoteKind = "special" ) // SilenceQuoteInput 是延期报价输入。 type SilenceQuoteInput struct { DeadlineAt time.Time Now time.Time InputDays int // 0 表示只算资格,不校验输入 Policy *SilencePolicySnapshot PaidExtendedDays int Kind SilenceQuoteKind } // SilenceQuoteOption 是一个月数档位的展示信息。 type SilenceQuoteOption struct { Months int BilledDays int Amount int64 NewDeadline time.Time } // SilenceQuote 是延期报价结果。 type SilenceQuote struct { OverdueDays int MinMonths int MaxMonths int // 付费延期上限;特殊延期无上限时为 0 MinDays int MaxDays int UnitPrice int64 // 以下字段仅在 InputDays > 0 时有值 Months int BilledDays int Amount int64 NewDeadline time.Time // CanExtend 表示该类型(付费 / 特殊)能否办理;Reason 为不能办理的原因码 CanExtend bool Reason string // InputValid 表示输入天数换算后的月数是否在允许范围内(InputDays > 0 时有意义) InputValid bool } // 报价原因码(与 constants.SilenceReason* 取值一致)。 const ( silenceReasonNoPolicy = "no_policy" silenceReasonExceedsLimit = "exceeds_limit" ) // QuoteSilenceExtension 计算延期报价(技术方案 §8.2): // // overdue_days = 今天日期 − 截止日期(不小于 0) // min_months = floor(overdue_days / 30) + 1 // remain = paid_max_months − paid_extended_days / 30 // max_months = min(remain, single_max_months) // months = ceil(input_days / 30);延长天数 = months × 30 // new_deadline = (截止日期 + 延长天数) 当日 23:59:59 // amount = months × unit_price(特殊延期由调用方按类型决定金额) func QuoteSilenceExtension(input SilenceQuoteInput) SilenceQuote { overdue := SilenceDaysBetween(input.DeadlineAt, input.Now) if overdue < 0 { overdue = 0 } quote := SilenceQuote{ OverdueDays: overdue, MinMonths: overdue/silenceDaysPerMonth + 1, MinDays: overdue + 1, } if input.Policy != nil { quote.UnitPrice = input.Policy.UnitPrice } switch input.Kind { case SilenceQuoteSpecial: quote.CanExtend = true default: if input.Policy == nil { quote.Reason = silenceReasonNoPolicy } else { remain := input.Policy.PaidMaxMonths - input.PaidExtendedDays/silenceDaysPerMonth if remain < 0 { remain = 0 } maxMonths := remain if input.Policy.SingleMaxMonths != nil && *input.Policy.SingleMaxMonths < maxMonths { maxMonths = *input.Policy.SingleMaxMonths } quote.MaxMonths = maxMonths quote.MaxDays = maxMonths * silenceDaysPerMonth quote.CanExtend = quote.MinMonths <= quote.MaxMonths if !quote.CanExtend { quote.Reason = silenceReasonExceedsLimit } } } if input.InputDays > 0 { months, billed := SilenceMonthsForDays(input.InputDays) quote.Months = months quote.BilledDays = billed quote.NewDeadline = SilenceDeadline(input.DeadlineAt, billed) quote.Amount = int64(months) * quote.UnitPrice quote.InputValid = quote.CanExtend && months >= quote.MinMonths && (input.Kind == SilenceQuoteSpecial || months <= quote.MaxMonths) && quote.NewDeadline.After(SilenceDeadline(input.Now, 0)) } return quote } // SilenceQuoteOptions 返回付费延期 min~max 每档的计费天数、金额与新截止日;档位数最多 limit 个。 func SilenceQuoteOptions(quote SilenceQuote, deadlineAt time.Time, limit int) []SilenceQuoteOption { if !quote.CanExtend || quote.MaxMonths < quote.MinMonths { return nil } options := make([]SilenceQuoteOption, 0, quote.MaxMonths-quote.MinMonths+1) for months := quote.MinMonths; months <= quote.MaxMonths && len(options) < limit; months++ { billed := months * silenceDaysPerMonth options = append(options, SilenceQuoteOption{ Months: months, BilledDays: billed, Amount: int64(months) * quote.UnitPrice, NewDeadline: SilenceDeadline(deadlineAt, billed), }) } return options } // SilencePolicyCandidate 是政策匹配与重叠校验的输入。 type SilencePolicyCandidate struct { ID uint ScopeType string // all / series / package ScopeIDs []uint Enabled bool EffectiveFrom time.Time EffectiveTo *time.Time } func silenceScopePriority(scopeType string) int { switch scopeType { case "package": return 3 case "series": return 2 case "all": return 1 default: return 0 } } func (c SilencePolicyCandidate) effectiveAt(now time.Time) bool { if !c.Enabled || now.Before(c.EffectiveFrom) { return false } return c.EffectiveTo == nil || c.EffectiveTo.After(now) } func (c SilencePolicyCandidate) covers(packageID, seriesID uint) bool { switch c.ScopeType { case "all": return true case "series": return seriesID != 0 && slices.Contains(c.ScopeIDs, seriesID) case "package": return packageID != 0 && slices.Contains(c.ScopeIDs, packageID) default: return false } } // MatchSilencePolicy 按"指定套餐 > 套餐系列 > 全部套餐"选出当前生效的政策,返回下标;未匹配返回 -1。 // 同一优先级理论上不重叠(保存时校验),若历史数据重叠则取 ID 较大的一条。 func MatchSilencePolicy(candidates []SilencePolicyCandidate, packageID, seriesID uint, now time.Time) int { best := -1 for index, candidate := range candidates { if !candidate.effectiveAt(now) || !candidate.covers(packageID, seriesID) { continue } if best < 0 { best = index continue } current := candidates[best] if silenceScopePriority(candidate.ScopeType) > silenceScopePriority(current.ScopeType) || (candidate.ScopeType == current.ScopeType && candidate.ID > current.ID) { best = index } } return best } // SilencePolicyOverlaps 判断两条政策是否在同一优先级上适用范围与生效时间段重叠(只比较启用的政策)。 func SilencePolicyOverlaps(a, b SilencePolicyCandidate) bool { if !a.Enabled || !b.Enabled || a.ScopeType != b.ScopeType { return false } if a.ScopeType != "all" && !silenceIDsIntersect(a.ScopeIDs, b.ScopeIDs) { return false } return silenceRangesOverlap(a.EffectiveFrom, a.EffectiveTo, b.EffectiveFrom, b.EffectiveTo) } func silenceIDsIntersect(a, b []uint) bool { for _, id := range a { if slices.Contains(b, id) { return true } } return false } // silenceRangesOverlap 判断 [fromA, toA) 与 [fromB, toB) 是否相交,to 为空表示长期。 func silenceRangesOverlap(fromA time.Time, toA *time.Time, fromB time.Time, toB *time.Time) bool { aBeforeB := toA != nil && !toA.After(fromB) bBeforeA := toB != nil && !toB.After(fromA) return !aBeforeB && !bBeforeA } // IsSilenceApprovalExempt 判断场景是否在政策快照的免审批场景内;无政策快照时全部需要审批。 func IsSilenceApprovalExempt(exemptTypes []string, scene string) bool { return scene != "" && slices.Contains(exemptTypes, scene) } // SilenceSpecialApprovalScene 返回特殊延期判断免审批时使用的场景:批量看 batch,否则看延期类型。 func SilenceSpecialApprovalScene(extensionType string, isBatch bool) string { if isBatch { return "batch" } return extensionType }