145 lines
5.2 KiB
Go
145 lines
5.2 KiB
Go
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
|
||
}
|