Files
go-sms-V2/internal/pkg
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
..
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

internal/pkg 组件手册(Day 18)

各组件均有单元/集成测试;本文示例为最小用法,完整字段见 go doc ./internal/pkg/<name>。

cache(Redis 客户端 + 多级缓存)

// 单机/集群/哨兵统一客户端
rc, _ := cache.New(cache.Options{Mode: cache.ModeSingle, Addrs: []string{"127.0.0.1:16379"}})
_ = rc.Set(ctx, "k", []byte("v"), time.Minute).Err()

// 两级缓存:本地 freecache 优先,Miss 查 Redis 并回填;全 Miss 回源
ml := cache.NewMultiLevel(rc, cache.MultiLevelOptions{LocalSizeMB: 16, LocalTTL: 30 * time.Second, RemoteTTL: 10 * time.Minute})
v, hitRemote, _ := ml.GetOrLoad(ctx, "account:cfg:1001", func(ctx context.Context) ([]byte, error) { return loadFromDB(1001) })

lock(Redis 分布式锁)

lk := lock.New(rc)
l, err := lk.TryLock(ctx, "job:dispatch", 30*time.Second) // SETNX+PX
defer func() { _ = l.Unlock(ctx) }()                        // Lua 原子释放(防误删)
// watchdog 每 TTL/3 自动续期;锁丢失即停;Unlock 幂等停止

logger(zap + lumberjack)

_ = logger.Init(logger.Options{Level: "info", Format: "json", Output: []string{"stdout", "file"},
    File: logger.FileOptions{Path: "/var/log/gosms/app.log", MaxSizeMB: 100, Compress: true}})
logger.L().Info("order_created", zap.Int64("order_id", 42))
logger.Level().SetLevel(zap.DebugLevel) // 动态级别(ETCD 热更新联动)

metrics(Prometheus)

// app 已装配 GET /metrics;业务埋点示例:
metrics.SMSSubmitTotal.WithLabelValues("ok").Inc()
metrics.HTTPRequestDuration.WithLabelValues("GET", "/health").Observe(0.012)

queue(Kafka 生产/消费/死信)

p, _ := queue.NewProducer(queue.ProducerConfig{Brokers: brokers, Logger: lg})
_ = p.Send(queue.TopicSubmit, []byte(mobile), payload) // 失败自动重试→<topic>.dlq

cg, _ := queue.NewConsumerGroup(queue.ConsumerGroupConfig{
    Consumer: queue.ConsumerConfig{Brokers: brokers, GroupID: "sender", Topics: []string{queue.TopicSubmit}, Handler: handle},
    Producer: queue.ProducerConfig{Brokers: brokers, Logger: lg}, // 死信转投
    MaxRetry: 3,                                                  // 单消息重试 3 次(指数退避)
})
go func() { _ = cg.Run(ctx) }()
cg.Pause(); cg.Resume() // 消费暂停/恢复(运维窗口)

errors / response(ISC:xxx 错误码与统一响应)

response.Success(c, data)
response.Error(c, errors.Blacklist)   // 403 {"code":"ISC:006","msg":"黑名单"}
response.Page(c, list, total, page, 20)

jwt(签发/解析)

m := jwt.NewManager(secret, 2*time.Hour)
tok, _ := m.Sign(1001, "alice", []string{"ops"}, []string{"account:read"})
claims, err := m.Parse(tok) // 强制 HMAC;过期/篡改返回错误

casbin(RBAC,策略存 MySQL)

e, _ := casbin.New(gormDB) // 自动建 casbin_rule 并加载
ok, _ := e.Check(1001, "channel", "write") // account_id → resource:action
_, _ = e.BindRole(1001, "ops")              // 开户时绑定角色

util(工具库)

util.IsValidMainlandMobile("+86 138-0013-8000") // true
c, n := util.SmsLength("你好世界")                 // (4, 1) UCS2 计费
util.ExtractVariables("尊敬的{name}")              // [name]
sf, _ := util.NewSnowflake(1); id := sf.NextID() // 雪花 ID(多实例用 WorkerIDFromETCD)
enc, _ := util.EncryptSecret(passphrase, apiKey)  // AES-GCM 落库加密