package cardobservation import ( "time" "github.com/break/junhong_cmp_fiber/pkg/constants" ) // RealnameTimeSnapshot 是卡当前实名记录的最小快照;Exists=false 表示还没有当前实名记录。 type RealnameTimeSnapshot struct { Exists bool RealnameAt *time.Time RealnameAtSource string UpstreamRealnameAt *time.Time FirstObservedAt *time.Time ResetStatus string ResetBaselineAt *time.Time } // RealnameResetGate 描述二次实名等待期间对一次"已实名"观测的处理。 type RealnameResetGate int const ( // RealnameResetGateNone 卡不在等待二次实名,或本次不是已实名观测。 RealnameResetGateNone RealnameResetGate = iota // RealnameResetGateBlocked 读到的仍是旧实名(或没有上游实名时间),不得改实名状态。 RealnameResetGateBlocked // RealnameResetGateCompleted 上游实名时间晚于清除前时间,二次实名完成。 RealnameResetGateCompleted ) // EvaluateRealnameResetGate 判断等待二次实名的卡本次已实名观测是新实名还是旧实名。 // 以上游 archiveTime 为准:晚于清除前的上游实名时间才算新实名;没有上游时间一律视为旧实名。 // 人工纠偏是运营明确操作,不受拦截。 func EvaluateRealnameResetGate(snapshot RealnameTimeSnapshot, observation RealnameObservation) RealnameResetGate { if !observation.Verified || snapshot.ResetStatus != constants.RealnameResetStatusPending { return RealnameResetGateNone } if observation.Metadata.Source == constants.CardObservationSourceManualOverride { return RealnameResetGateCompleted } upstream := observation.UpstreamRealnameAt if upstream == nil || snapshot.ResetBaselineAt == nil || !upstream.After(*snapshot.ResetBaselineAt) { return RealnameResetGateBlocked } return RealnameResetGateCompleted } // RealnameTimeDecision 描述一次已实名观测后当前实名记录应如何更新。 type RealnameTimeDecision struct { // Changed 表示当前实名记录有任何字段需要写入(含不写历史的上游最近时间等)。 Changed bool // RealnameAt / Source 是写入后的当前实名时间与来源。 RealnameAt *time.Time Source string // UpstreamRealnameAt / FirstObservedAt 是写入后的值。 UpstreamRealnameAt *time.Time FirstObservedAt *time.Time // ClearReset 表示清除二次实名等待状态。 ClearReset bool // WriteHistory 仅在当前实名时间变化时为 true。 WriteHistory bool ChangeType string BeforeAt *time.Time } // DecideRealnameTime 根据已被采纳为"已实名"的观测确定当前实名时间: // 1. 有上游实名时间 → 以它为准(来源 upstream); // 2. 否则已有当前实名时间 → 保持不变; // 3. 否则 → 取本次观测时间(来源 first_observed)。 // // 只有当前实名时间变化才写历史;相同时间只可能静默更新来源或上游最近返回时间。 // 调用方只应在观测被采纳为已实名(卡最终为已实名、且未被二次实名拦截)时调用。 func DecideRealnameTime(snapshot RealnameTimeSnapshot, observation RealnameObservation, gate RealnameResetGate) RealnameTimeDecision { decision := RealnameTimeDecision{ RealnameAt: snapshot.RealnameAt, Source: snapshot.RealnameAtSource, UpstreamRealnameAt: snapshot.UpstreamRealnameAt, FirstObservedAt: snapshot.FirstObservedAt, BeforeAt: snapshot.RealnameAt, } if !snapshot.Exists { decision.Changed = true } observedAt := observation.Metadata.ObservedAt if decision.FirstObservedAt == nil { decision.FirstObservedAt = timePtr(observedAt) decision.Changed = true } upstream := observation.UpstreamRealnameAt if upstream != nil && !sameTime(decision.UpstreamRealnameAt, upstream) { decision.UpstreamRealnameAt = timePtr(*upstream) decision.Changed = true } var next *time.Time source := decision.Source switch { case upstream != nil: next, source = timePtr(*upstream), constants.RealnameAtSourceUpstream case snapshot.RealnameAt != nil: next = snapshot.RealnameAt default: next, source = timePtr(observedAt), constants.RealnameAtSourceFirstObserved } if gate == RealnameResetGateCompleted { decision.ClearReset = true decision.Changed = true decision.ChangeType = constants.RealnameChangeResetCompleted } if !sameTime(snapshot.RealnameAt, next) { decision.RealnameAt, decision.Source = next, source decision.Changed = true decision.WriteHistory = true if decision.ChangeType == "" { if snapshot.RealnameAt == nil { decision.ChangeType = constants.RealnameChangeFirst } else { decision.ChangeType = constants.RealnameChangeUpstreamFix } } return decision } if source != decision.Source { // 时间相同只是来源不同(如迁移时间恰好等于上游时间):静默更正来源,不写历史。 decision.Source = source decision.Changed = true } if gate == RealnameResetGateCompleted { // 二次实名完成但时间未变(理论上不会发生,上游时间一定晚于基准):仍记一条完成历史。 decision.WriteHistory = true } return decision } func sameTime(left, right *time.Time) bool { if left == nil || right == nil { return left == nil && right == nil } return left.Equal(*right) } func timePtr(value time.Time) *time.Time { return &value }