Files
go-sms-V2/internal/model/entity/callback.go
T
Tory bb60d60529
ci / test (push) Canceled after 0s
ci / web-test (push) Canceled after 0s
ci / build (push) Canceled after 0s
ci / deploy-dev (push) Canceled after 0s
S4-D1/D2: C1 回调推送引擎+C2 上行自动拉黑——验收项「死信可查/拒收即拉黑」✅: ①C1=callback_task 队列表(迁移 v21,状态机 pending→sent/dead+attempt/next_retry_at/last_code)+PushWorker(2s 扫/批 100/并发 8/2^n 秒指数退避封顶 10min/10 次耗尽死信/UPDATE CAS 防竞态)+双挂点(report 终态首锁[Consumer+PairService,与 CMPP Deliver 同点同语义]+uplink 消费尾)+URL 门控 account_config.report_url/uplink_url(60s TTL 缓存,未配置零任务)+GET /ops/callback(列表+状态计数面板)/POST /ops/callback/:id/resend(casbin ops callback:read/write v21 所种)+前端回调管理页(ops-callback 路由系统管理组+api/callback.ts+状态面板/筛选/载荷展开/死信重派;matrix+guard 33 菜单显式更)+metrics callback_push_total{type,result}/blacklist_total+openapi v1.4.0;②C2=AutoBlacklister 等值词表(trim+lower 防误伤,默认 R/TD/退订/拒收;SystemConfig uplink.blacklist.keywords 可配 60s 刷新)→policy_blacklist(source=2/账号级/uk 幂等)+Redis Set 即时生效,拉黑不影响上行推送(需求原文);③真机全链六步实证(dev 中间件):回执 DELIVRD→detail 终态→HTTP 回调 JSON 送达(200/sent)+上行 R→拉黑(source=2+Redis=1)+推送送达+坏 URL→attempt10→dead→resend ISC:000→修复重投 sent+status_counts 面板;一次性探针 cmd/cbprobe 用后即删+冒烟数据全清;④单测 +13(callback 6[入队门控/载荷/状态机全链/并发批]+uplink 5[词表/配置覆盖/幂等缓存/消费链]+report 2[首锁一次/nil]);⑤门禁=build/vet/-race 40 包/lint 0/eslint0/vue-tsc0/vitest 148/build 全绿;迁移测试 v15..v21 两遍幂等+dev 实跑 v21;gofmt 存量 8 文件顺手清零(S2 遗留);⑥口径诚实标注:载荷无签名挂账/拦截终态 HTTP 未挂(CMPP 侧已有)/PushWorker 单实例 at-least-once;验收单 s4-d1d2-callback.md+CHANGELOG+memory-bank 回填
2026-11-16 11:19:55 +08:00

39 lines
1.8 KiB
Go

package entity
import "time"
// Callback 回调任务类型(S4·C1)。
const (
CallbackTypeReport int8 = 1 // 回执终态推送(账号 report_url)
CallbackTypeUplink int8 = 2 // 上行消息推送(账号 uplink_url)
)
// Callback 回调任务状态机(S4·C1)。
const (
CallbackPending int8 = 0 // 待推送(含退避等待)
CallbackSent int8 = 1 // 已送达(2xx)
CallbackDead int8 = 2 // 死信(重试耗尽,可重派)
)
// CallbackTask HTTP 回调推送任务(S4·C1:指数退避+死信可查)。
// 入队源=report 终态首锁/report 手动配对(EnqueueReport)与 uplink 消费
// (EnqueueUplink);PushWorker 扫描投递。幂等锚=无(每终态一条;report 侧
// 由 finalizeDetail 首锁语义天然至多一次,重放由 detail 终态锁定挡住)。
type CallbackTask struct {
ID int64 `gorm:"primaryKey;autoIncrement" json:"id"`
AccountID int64 `gorm:"index:idx_cb_account,priority:1" json:"account_id"`
Type int8 `gorm:"default:1" json:"type"` // 1 回执 2 上行(CallbackType*)
URL string `gorm:"size:512" json:"url"`
Payload string `gorm:"type:text" json:"payload"` // 客户回调 JSON 载荷
Status int8 `gorm:"index:idx_cb_status_retry,priority:1;default:0" json:"status"`
Attempt int `gorm:"default:0" json:"attempt"`
NextRetryAt time.Time `gorm:"index:idx_cb_status_retry,priority:2" json:"next_retry_at"`
LastCode int `json:"last_code"` // 最近一次 HTTP 状态码(0=连接层错误)
LastErr string `gorm:"size:255" json:"last_err"`
SentAt *time.Time `json:"sent_at"`
CreatedAt time.Time `gorm:"autoCreateTime;index:idx_cb_account,priority:2" json:"created_at"`
UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updated_at"`
}
func (CallbackTask) TableName() string { return "callback_task" }