301 lines
19 KiB
Go
301 lines
19 KiB
Go
package model
|
|
|
|
import (
|
|
"time"
|
|
|
|
"gorm.io/gorm"
|
|
)
|
|
|
|
// Rock 相关常量
|
|
const (
|
|
// RockDefaultBaseURL 是 Rock 上游平台的默认地址，只作为「初始值 / 兜底值」。
|
|
// 运行期一律以 rock_configs.base_url 为准：启动时由
|
|
// RockService.ApplyConfigToClient 同步到 HTTP 客户端，否则后台改过的地址
|
|
// 会在进程重启后失效。
|
|
//
|
|
// 注意：迁移文件 012_rock_fulfillment.sql 中的默认值受 checksum 保护，
|
|
// 不能为了统一而修改它，否则已有部署会因 checksum mismatch 启动失败。
|
|
RockDefaultBaseURL = "https://0666.pro"
|
|
|
|
RockColorBlack = "black"
|
|
RockColorBlue = "blue"
|
|
|
|
RockStatusAvailable = "available" // 可用库存
|
|
RockStatusUsing = "using" // 已分配给订单，正在提货扫码
|
|
RockStatusBound = "bound" // 扫码绑定成功
|
|
RockStatusRedeemed = "redeemed" // 发货完成
|
|
RockStatusMismatch = "mismatch" // UID 校验不符阻断（绑错）
|
|
RockStatusAbnormal = "abnormal" // 异常/作废
|
|
|
|
// 虚拟筛选状态：不落库，仅用于列表查询换算。
|
|
// RockStatusAnomaly 表示「历史流转中出现过异常」的 Token，不改变其主状态。
|
|
RockStatusAnomaly = "anomaly"
|
|
|
|
// Rock 发货异常事件。
|
|
RockIncidentStatusOpen = "open"
|
|
RockIncidentStatusResolved = "resolved"
|
|
RockIncidentStatusIgnored = "ignored"
|
|
|
|
RockIncidentCategoryNoEntitlement = "no_entitlement"
|
|
RockIncidentCategoryDuplicateItem = "duplicate_item"
|
|
RockIncidentCategoryGiftExhausted = "gift_exhausted"
|
|
RockIncidentCategoryTokenRedeemed = "token_already_redeemed"
|
|
RockIncidentCategoryTokenNotRedeemable = "token_not_redeemable"
|
|
RockIncidentCategoryTokenNotFound = "token_not_found"
|
|
RockIncidentCategoryUpstreamTimeout = "upstream_timeout"
|
|
RockIncidentCategoryRateLimited = "upstream_rate_limited"
|
|
RockIncidentCategoryShipTimeout = "ship_timeout"
|
|
RockIncidentCategoryBindMismatch = "bind_mismatch"
|
|
RockIncidentCategoryOrderCancelled = "order_cancelled"
|
|
RockIncidentCategoryOther = "other"
|
|
|
|
RockSKUBlackTshirt = "rock_black_tshirt"
|
|
RockSKUBlueSportswear = "rock_blue_sportswear"
|
|
|
|
RockSkinBlackTshirt = "黑色ROCK长袖T恤"
|
|
RockSkinBlueSportswear = "蓝色运动服上衣"
|
|
)
|
|
|
|
// RockConfig 平台配置项
|
|
type RockConfig struct {
|
|
ID uint `gorm:"primaryKey;default:1" json:"id"`
|
|
AutoDeliveryEnabled bool `gorm:"not null;default:true" json:"auto_delivery_enabled"` // 全局自动发货总开关
|
|
BaseURL string `gorm:"size:255;not null;default:'https://0666.pro'" json:"base_url"` // 默认值见 RockDefaultBaseURL
|
|
BearerToken string `gorm:"type:text;not null;default:''" json:"bearer_token"`
|
|
LoginUsername string `gorm:"size:128;not null;default:''" json:"login_username"`
|
|
LoginPasswordCiphertext string `gorm:"type:text;not null;default:''" json:"-"`
|
|
LoginPasswordSet bool `gorm:"-" json:"login_password_set"`
|
|
LastTokenRefreshAt *time.Time `json:"last_token_refresh_at,omitempty"`
|
|
LastTokenError string `gorm:"type:text;not null;default:''" json:"last_token_error,omitempty"`
|
|
Username string `gorm:"size:128;not null;default:''" json:"username"`
|
|
Points float64 `gorm:"type:numeric(12,2);not null;default:0.00" json:"points"`
|
|
MinPointsWarning float64 `gorm:"type:numeric(12,2);not null;default:1050.00" json:"min_points_warning"`
|
|
BlackTokenCost float64 `gorm:"type:numeric(12,2);not null;default:20.00" json:"black_token_cost"`
|
|
TokenWarningStock int `gorm:"not null;default:10" json:"token_warning_stock"`
|
|
UsingWarnDays int `gorm:"not null;default:3" json:"using_warn_days"` // 使用中超过 N 天橙色预警
|
|
UsingDangerDays int `gorm:"not null;default:5" json:"using_danger_days"` // 使用中超过 N 天红色预警
|
|
BoundWarnDays int `gorm:"not null;default:2" json:"bound_warn_days"` // 已绑定超过 N 天预警
|
|
AutoRefreshMismatchEnabled bool `gorm:"not null;default:false" json:"auto_refresh_mismatch_enabled"` // 绑定错误自动刷新
|
|
AutoPurchaseEnabled bool `gorm:"not null;default:false" json:"auto_purchase_enabled"`
|
|
AutoPurchaseCount int `gorm:"not null;default:50" json:"auto_purchase_count"`
|
|
PurchaseCooldownMinutes int `gorm:"not null;default:10" json:"purchase_cooldown_minutes"`
|
|
LastPurchasedAt *time.Time `json:"last_purchased_at"`
|
|
LastAttemptAt *time.Time `json:"last_attempt_at,omitempty"` // 最近一次采购尝试（成功/失败）时间，用于失败冷却
|
|
LastAutoAttemptAt *time.Time `json:"last_auto_attempt_at,omitempty"` // 最近一次自动补货尝试时间，自动冷却只认这个
|
|
LastError string `gorm:"type:text;not null;default:''" json:"last_error"` // 最近一次补货/打包错误，成功后清空
|
|
LastErrorAt *time.Time `json:"last_error_at,omitempty"`
|
|
LastHeartbeatAt *time.Time `json:"last_heartbeat_at"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
func (RockConfig) TableName() string {
|
|
return "rock_configs"
|
|
}
|
|
|
|
// RockToken 通用 Token 本地库存池记录
|
|
type RockToken struct {
|
|
ID uint `gorm:"primaryKey" json:"id"`
|
|
UpstreamTokenID string `gorm:"size:64;not null;default:''" json:"upstream_token_id"`
|
|
Token string `gorm:"type:text;not null" json:"-"`
|
|
RedeemCode string `gorm:"size:64;not null;index" json:"redeem_code"`
|
|
Color string `gorm:"size:32;not null;default:'black';index" json:"color"`
|
|
Region string `gorm:"size:64;not null;default:'Q/V可用'" json:"region"`
|
|
Status string `gorm:"size:32;not null;default:'available';index" json:"status"`
|
|
PackageID *int64 `gorm:"index" json:"package_id,omitempty"`
|
|
PackageShareCode string `gorm:"size:64;not null;default:''" json:"package_share_code"`
|
|
AssignedOrderNo string `gorm:"size:128;index" json:"assigned_order_no"`
|
|
ClientOrderNo string `gorm:"-" json:"client_order_no,omitempty"` // 关联的创建订单商户单号
|
|
TokenCode string `gorm:"-" json:"token,omitempty"` // 提取码，仅管理端响应展示，不持久化
|
|
ExpectedUID string `gorm:"size:64" json:"expected_uid"`
|
|
ActualRoleName string `gorm:"size:128" json:"actual_role_name"`
|
|
ActualRoleID string `gorm:"size:64" json:"actual_role_id"`
|
|
ActualChannel string `gorm:"size:64" json:"actual_channel"`
|
|
InitialBoundSnapshot string `gorm:"type:text" json:"-"` // 分配时初始旧数据快照 JSON
|
|
UpstreamFulfillID int64 `json:"upstream_fulfill_id"`
|
|
TargetSkin string `gorm:"size:128" json:"target_skin"`
|
|
TargetCurrency string `gorm:"size:64;not null;default:'幸运币'" json:"target_currency"`
|
|
TargetCurrencyQuantity int `gorm:"not null;default:0" json:"target_currency_quantity"`
|
|
MismatchAt *time.Time `gorm:"index" json:"mismatch_at"`
|
|
MismatchReason string `gorm:"size:255" json:"mismatch_reason"`
|
|
Remark string `gorm:"type:text;not null;default:''" json:"remark"`
|
|
RawData string `gorm:"type:text;not null;default:''" json:"raw_data,omitempty"`
|
|
Source string `gorm:"size:32;not null;default:'purchase';index" json:"source"`
|
|
ClaimedAt *time.Time `json:"claimed_at"`
|
|
UsingAt *time.Time `gorm:"index" json:"using_at"` // 变为 using 的时间，超时预警起点
|
|
RestockedAt *time.Time `gorm:"index" json:"restocked_at,omitempty"` // 人工释放回库存的时间，分配时优先（FIFO）
|
|
BoundAt *time.Time `json:"bound_at"`
|
|
RedeemedAt *time.Time `json:"redeemed_at"`
|
|
|
|
// 发货确认中（上游异步兑奖）标记字段。
|
|
// 注意：这不是状态。Token 主状态保持 bound，pending 期间只写这些标记，
|
|
// 用 redeem_requested_at 非空且 redeemed_at 为空来判定「发货确认中」。
|
|
RedeemRequestedAt *time.Time `gorm:"index" json:"redeem_requested_at,omitempty"` // 提交兑换的时间，pending 起点
|
|
RedeemCheckedAt *time.Time `json:"redeem_checked_at,omitempty"` // 最近一次查询上游结果的时间
|
|
RedeemAttempts int `gorm:"not null;default:0" json:"redeem_attempts"`
|
|
RedeemNextRetryAt *time.Time `gorm:"index" json:"redeem_next_retry_at,omitempty"`
|
|
RedeemLastMessage string `gorm:"type:text;not null;default:''" json:"redeem_last_message,omitempty"`
|
|
RedeemLastError string `gorm:"type:text;not null;default:''" json:"redeem_last_error,omitempty"`
|
|
RedeemTimeoutWarnedAt *time.Time `json:"redeem_timeout_warned_at,omitempty"`
|
|
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
|
|
DeletedAtText string `gorm:"-" json:"deleted_at,omitempty"` // 回收站展示用，仅管理端响应返回
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
|
|
// 以下为列表派生字段，不落库：由后端用与筛选/统计完全相同的 now 计算。
|
|
BoundOverdue bool `gorm:"-" json:"bound_overdue"`
|
|
UsingOverdue bool `gorm:"-" json:"using_overdue"`
|
|
UsingDanger bool `gorm:"-" json:"using_danger"`
|
|
BoundDays float64 `gorm:"-" json:"bound_days"`
|
|
UsingDays float64 `gorm:"-" json:"using_days"`
|
|
|
|
// 异常标记（派生，不落库）：来自状态流转历史，不改变主状态。
|
|
HasAnomaly bool `gorm:"-" json:"has_anomaly"`
|
|
AnomalyType string `gorm:"-" json:"anomaly_type,omitempty"`
|
|
AnomalyReason string `gorm:"-" json:"anomaly_reason,omitempty"`
|
|
AnomalyAt *time.Time `gorm:"-" json:"anomaly_at,omitempty"`
|
|
AnomalyCount int `gorm:"-" json:"anomaly_count"`
|
|
|
|
// 当前开放异常，供列表筛选和人工处理入口使用。
|
|
HasOpenIncident bool `gorm:"-" json:"has_open_incident"`
|
|
IncidentCategory string `gorm:"-" json:"incident_category,omitempty"`
|
|
IncidentMessage string `gorm:"-" json:"incident_message,omitempty"`
|
|
IncidentAt *time.Time `gorm:"-" json:"incident_at,omitempty"`
|
|
IncidentCount int64 `gorm:"-" json:"incident_count,omitempty"`
|
|
}
|
|
|
|
func (RockToken) TableName() string {
|
|
return "rock_tokens"
|
|
}
|
|
|
|
// RockTokenStatusLog 记录 Token 的生命周期与状态流转，供状态历史时间线使用。
|
|
type RockTokenStatusLog struct {
|
|
ID uint `gorm:"primaryKey" json:"id"`
|
|
TokenID uint `gorm:"not null;index" json:"token_id"`
|
|
UpstreamTokenID string `gorm:"size:64;not null;default:''" json:"upstream_token_id"`
|
|
EventType string `gorm:"size:32;not null" json:"event_type"` // created / status_changed / deleted / restored
|
|
FromStatus string `gorm:"size:32;not null;default:''" json:"from_status"`
|
|
ToStatus string `gorm:"size:32;not null;default:''" json:"to_status"`
|
|
Source string `gorm:"size:32;not null;default:''" json:"source"`
|
|
Reason string `gorm:"size:255;not null;default:''" json:"reason"`
|
|
Forced bool `gorm:"not null;default:false" json:"forced"`
|
|
ActorUserID *uint `gorm:"index" json:"actor_user_id,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
func (RockTokenStatusLog) TableName() string {
|
|
return "rock_token_status_logs"
|
|
}
|
|
|
|
// RockDeliveryLog 记录一次发货链路的完整报文（本系统入站 / 上游请求 / 上游响应 / 内部状态）。
|
|
// 用于订单排障与对账；按 180 天保留，由后台任务定期清理。
|
|
type RockDeliveryLog struct {
|
|
ID uint `gorm:"primaryKey" json:"id"`
|
|
TraceID string `gorm:"size:64;not null;default:'';index:idx_rock_delivery_logs_trace" json:"trace_id"`
|
|
TokenID uint `gorm:"not null;default:0;index:idx_rock_delivery_logs_token" json:"token_id"`
|
|
UpstreamTokenID string `gorm:"size:64;not null;default:''" json:"upstream_token_id"`
|
|
OrderNo string `gorm:"size:128;not null;default:'';index:idx_rock_delivery_logs_order" json:"order_no"`
|
|
Step string `gorm:"size:40;not null;default:'';index" json:"step"`
|
|
Direction string `gorm:"size:16;not null;default:''" json:"direction"` // inbound / outbound / internal
|
|
Status string `gorm:"size:16;not null;default:'';index" json:"status"` // started / success / pending / failed / skipped
|
|
HTTPMethod string `gorm:"size:8;not null;default:''" json:"http_method"`
|
|
HTTPURL string `gorm:"type:text;not null;default:''" json:"http_url"`
|
|
HTTPStatus int `gorm:"not null;default:0" json:"http_status"`
|
|
RequestHeaders string `gorm:"type:text;not null;default:''" json:"request_headers"`
|
|
RequestBody string `gorm:"type:text;not null;default:''" json:"request_body"`
|
|
ResponseHeaders string `gorm:"type:text;not null;default:''" json:"response_headers"`
|
|
ResponseBody string `gorm:"type:text;not null;default:''" json:"response_body"`
|
|
DurationMs int `gorm:"not null;default:0" json:"duration_ms"`
|
|
ErrorMessage string `gorm:"type:text;not null;default:''" json:"error_message"`
|
|
ActorUserID *uint `gorm:"index" json:"actor_user_id,omitempty"`
|
|
ActorIP string `gorm:"size:64;not null;default:''" json:"actor_ip"`
|
|
UserAgent string `gorm:"size:512;not null;default:''" json:"user_agent"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
FinishedAt *time.Time `json:"finished_at,omitempty"`
|
|
}
|
|
|
|
func (RockDeliveryLog) TableName() string {
|
|
return "rock_delivery_logs"
|
|
}
|
|
|
|
// RockDeliveryIncident 是需要人工处理的发货异常事件。
|
|
// 原始报文仍保存在 rock_delivery_logs，本表只保存分类和处理状态。
|
|
type RockDeliveryIncident struct {
|
|
ID uint `gorm:"primaryKey" json:"id"`
|
|
TokenID uint `gorm:"not null;index:idx_rock_delivery_incidents_token" json:"token_id"`
|
|
OrderNo string `gorm:"size:128;not null;default:'';index:idx_rock_delivery_incidents_order" json:"order_no"`
|
|
UpstreamTokenID string `gorm:"size:64;not null;default:''" json:"upstream_token_id"`
|
|
Category string `gorm:"size:40;not null;index:idx_rock_delivery_incidents_filter" json:"category"`
|
|
Status string `gorm:"size:16;not null;default:'open';index:idx_rock_delivery_incidents_filter" json:"status"`
|
|
BlockingRetry bool `gorm:"not null;default:true" json:"blocking_retry"`
|
|
Message string `gorm:"type:text;not null;default:''" json:"message"`
|
|
UpstreamHTTPStatus int `gorm:"not null;default:0" json:"upstream_http_status"`
|
|
UpstreamResponse string `gorm:"type:text;not null;default:''" json:"upstream_response"`
|
|
Occurrences int `gorm:"not null;default:1" json:"occurrences"`
|
|
FirstSeenAt time.Time `json:"first_seen_at"`
|
|
LastSeenAt time.Time `json:"last_seen_at"`
|
|
ResolvedAt *time.Time `json:"resolved_at,omitempty"`
|
|
ResolvedBy *uint `gorm:"index" json:"resolved_by,omitempty"`
|
|
ResolutionAction string `gorm:"size:32;not null;default:''" json:"resolution_action"`
|
|
ResolutionNote string `gorm:"type:text;not null;default:''" json:"resolution_note"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
func (RockDeliveryIncident) TableName() string {
|
|
return "rock_delivery_incidents"
|
|
}
|
|
|
|
// RockPurchaseLog 是一次采购尝试的主记录。
|
|
// 每一次真正进入采购流程的尝试都会落一条，包含降级原因与各阶段汇总。
|
|
type RockPurchaseLog struct {
|
|
ID uint `gorm:"primaryKey" json:"id"`
|
|
TriggerType string `gorm:"size:16;not null;default:'auto';index:idx_rock_purchase_logs_trigger_status" json:"trigger_type"` // auto / manual
|
|
Status string `gorm:"size:16;not null;default:'running'" json:"status"` // running / success / partial / failed / skipped
|
|
RequestedCount int `gorm:"not null;default:0" json:"requested_count"`
|
|
PlannedCount int `gorm:"not null;default:0" json:"planned_count"`
|
|
ClaimedCount int `gorm:"not null;default:0" json:"claimed_count"`
|
|
ImportedCount int `gorm:"not null;default:0" json:"imported_count"`
|
|
UpstreamAvailable int `gorm:"not null;default:0" json:"upstream_available"`
|
|
PointsBefore float64 `gorm:"type:numeric(12,2);not null;default:0" json:"points_before"`
|
|
UnitCost float64 `gorm:"type:numeric(12,2);not null;default:0" json:"unit_cost"`
|
|
MaxByPoints int `gorm:"not null;default:0" json:"max_by_points"`
|
|
MaxByStock int `gorm:"not null;default:0" json:"max_by_stock"`
|
|
LimitReason string `gorm:"size:32;not null;default:''" json:"limit_reason"` // points / upstream_stock / points_and_stock
|
|
PointsSource string `gorm:"size:16;not null;default:''" json:"points_source"` // live / snapshot
|
|
Stage string `gorm:"size:32;not null;default:''" json:"stage"`
|
|
ErrorMessage string `gorm:"type:text;not null;default:''" json:"error_message"`
|
|
PackageID *int64 `json:"package_id,omitempty"`
|
|
ShareCode string `gorm:"size:64;not null;default:''" json:"share_code"`
|
|
DurationMs int `gorm:"not null;default:0" json:"duration_ms"`
|
|
StartedAt time.Time `json:"started_at"`
|
|
FinishedAt *time.Time `json:"finished_at,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
func (RockPurchaseLog) TableName() string {
|
|
return "rock_purchase_logs"
|
|
}
|
|
|
|
// RockPurchaseStage 记录一次采购中单个上游调用的原始请求与响应。
|
|
// ResponseBody 保存上游返回的原始 JSON 原文；超过 512KB 时截断并置 Truncated。
|
|
type RockPurchaseStage struct {
|
|
ID uint `gorm:"primaryKey" json:"id"`
|
|
LogID uint `gorm:"not null;index:idx_rock_purchase_stages_log_id" json:"log_id"`
|
|
Seq int `gorm:"not null;default:0" json:"seq"`
|
|
Stage string `gorm:"size:32;not null" json:"stage"`
|
|
Method string `gorm:"size:8;not null;default:''" json:"method"`
|
|
URL string `gorm:"type:text;not null;default:''" json:"url"`
|
|
RequestBody string `gorm:"type:text;not null;default:''" json:"request_body"`
|
|
HTTPStatus int `gorm:"not null;default:0" json:"http_status"`
|
|
ResponseBody string `gorm:"type:text;not null;default:''" json:"response_body"`
|
|
Truncated bool `gorm:"not null;default:false" json:"truncated"`
|
|
DurationMs int `gorm:"not null;default:0" json:"duration_ms"`
|
|
ErrorMessage string `gorm:"type:text;not null;default:''" json:"error_message"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
}
|
|
|
|
func (RockPurchaseStage) TableName() string {
|
|
return "rock_purchase_stages"
|
|
}
|