Files
junhong_cmp_fiber/internal/domain/cardobservation/realname_time.go
邹进 4967f4df43
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
feat: 卡实名时间以上游 archiveTime 为准并记录实名时间历史,新增二次实名批次
2026-11-08 19:12:46 +09:00

145 lines
5.2 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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
}