Files
go-sms-V2/internal/service/uplink/blacklist.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

146 lines
4.4 KiB
Go

// blacklist.go S4·C2:上行自动拉黑——回复「R/退订/拒收」等(词表 SystemConfig
// 可配,等值匹配)→ 写 policy_blacklist(source=2 上行拒收,账号级=归属账号)
// + Redis 黑名单缓存即时生效(拦截链检测 IN (0, account_id),下一单即拦)。
// 语义(需求 2.5/实施计划 5.7):拉黑不影响上行推送与 message_uplink 记录。
package uplink
import (
"context"
"strings"
"sync"
"time"
"go-sms/internal/model/entity"
"go-sms/internal/pkg/logger"
"go-sms/internal/pkg/metrics"
"go-sms/internal/service/interceptor"
"go.uber.org/zap"
"gorm.io/gorm"
"gorm.io/gorm/clause"
"github.com/redis/go-redis/v9"
)
// CfgKeyBlacklistWords 拉黑词表 SystemConfig 键(逗号分隔;等值匹配,
// 大小写不敏感;未配置=默认词表)。
const CfgKeyBlacklistWords = "uplink.blacklist.keywords"
// DefaultBlacklistWords 默认拉黑词表(需求原文「回复"拒收"等」+通用退订惯例)。
var DefaultBlacklistWords = []string{"R", "TD", "退订", "拒收"}
// defaultReloadEvery 词表刷新周期(运营改配置最迟生效窗口)。
const defaultReloadEvery = 60 * time.Second
// AutoBlacklister 上行自动拉黑器(词表内存缓存+定时刷新)。
type AutoBlacklister struct {
db *gorm.DB
rdb redis.UniversalClient
mu sync.RWMutex
words map[string]struct{} // lower(trim(word))
}
// NewAutoBlacklister 构造(首次 Reload 失败仅记日志,用默认词表)。
func NewAutoBlacklister(db *gorm.DB, rdb redis.UniversalClient) *AutoBlacklister {
b := &AutoBlacklister{db: db, rdb: rdb, words: lowerSet(DefaultBlacklistWords)}
if err := b.Reload(context.Background()); err != nil {
logger.L().Warn("uplink_blacklist_reload_failed_use_default", zap.Error(err))
}
return b
}
func lowerSet(words []string) map[string]struct{} {
m := make(map[string]struct{}, len(words))
for _, w := range words {
if w = strings.ToLower(strings.TrimSpace(w)); w != "" {
m[w] = struct{}{}
}
}
return m
}
// Reload 从 SystemConfig 重载词表(空/缺省行=默认词表)。
func (b *AutoBlacklister) Reload(ctx context.Context) error {
var row entity.SystemConfig
err := b.db.WithContext(ctx).
Where("cfg_key = ?", CfgKeyBlacklistWords).First(&row).Error
if err != nil {
if err == gorm.ErrRecordNotFound {
b.mu.Lock()
b.words = lowerSet(DefaultBlacklistWords)
b.mu.Unlock()
return nil
}
return err
}
parts := strings.Split(row.CfgValue, ",")
words := lowerSet(parts)
if len(words) == 0 {
words = lowerSet(DefaultBlacklistWords)
}
b.mu.Lock()
b.words = words
b.mu.Unlock()
return nil
}
// Start 定时刷新(caller 起 goroutine;ctx 取消即退出)。
func (b *AutoBlacklister) Start(ctx context.Context) {
t := time.NewTicker(defaultReloadEvery)
defer t.Stop()
for {
select {
case <-ctx.Done():
return
case <-t.C:
if err := b.Reload(ctx); err != nil {
logger.L().Warn("uplink_blacklist_reload_failed", zap.Error(err))
}
}
}
}
// hit 内容等值命中(trim+lower;非前缀/包含,防正常回复误伤)。
func (b *AutoBlacklister) hit(content string) bool {
w := strings.ToLower(strings.TrimSpace(content))
if w == "" {
return false
}
b.mu.RLock()
defer b.mu.RUnlock()
_, ok := b.words[w]
return ok
}
// MaybeBlock 拉黑判定+落库:命中词表→INSERT policy_blacklist(uk 幂等,
// OnConflict DoNothing)→ Redis 缓存即时生效。返回是否新增(已存在=幂等跳过)。
func (b *AutoBlacklister) MaybeBlock(ctx context.Context, accountID int64, mobile, content string) bool {
if !b.hit(content) {
return false
}
row := entity.PolicyBlacklist{
Mobile: mobile, Source: 2, AccountID: accountID, Operator: "uplink-auto",
}
res := b.db.WithContext(ctx).Clauses(clause.OnConflict{DoNothing: true}).
Create(&row)
if res.Error != nil {
logger.L().Warn("uplink_blacklist_insert_failed",
zap.Int64("account_id", accountID), zap.String("mobile", mobile), zap.Error(res.Error))
return false
}
if res.RowsAffected == 0 {
return false // 已在黑名单(手工/先前拉黑):幂等跳过
}
metrics.CallbackBlacklistTotal.Inc()
if b.rdb != nil {
if err := interceptor.AddBlacklistCache(ctx, b.rdb, mobile); err != nil {
logger.L().Warn("uplink_blacklist_cache_add_failed", zap.String("mobile", mobile), zap.Error(err))
}
}
logger.L().Info("uplink_blacklist_added",
zap.Int64("account_id", accountID), zap.String("mobile", mobile),
zap.String("content", content))
return true
}