Files
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

114 lines
3.4 KiB
Go

// callback_handler.go S4·C1:回调任务管理端点(死信可查/重派)。
// 投递引擎(PushWorker)在 consumer 进程,gateway 侧仅管理面;
// 端点=GET /ops/callback(列表,状态/类型/账号筛选)+ POST /ops/callback/:id/resend
// (死信重派);casbin 策略 v21 所种(ops callback:read/write)。
package v1
import (
"strconv"
"github.com/gin-gonic/gin"
"gorm.io/gorm"
"go-sms/internal/middleware"
"go-sms/internal/model/entity"
"go-sms/internal/pkg/errors"
"go-sms/internal/pkg/response"
"go-sms/internal/service/callback"
)
func registerCallbackRoutes(protected *gin.RouterGroup, deps Deps) {
h := &callbackHandler{svc: deps.Callback, db: deps.DB}
// 任务列表(含死信;缺省不过滤状态,传 status=0/1/2 精筛)。
protected.GET("/ops/callback",
middleware.RequirePermission(deps.Perm, "callback", "read"), h.list)
// 死信重派(status 2→0;非死信 0 行影响=幂等拒绝)。
protected.POST("/ops/callback/:id/resend",
middleware.RequirePermission(deps.Perm, "callback", "write"), h.resend)
}
type callbackHandler struct {
svc *callback.Service
db *gorm.DB
}
// list GET /ops/callback?page=&page_size=&status=&type=&account_id=。
func (h *callbackHandler) list(c *gin.Context) {
q := h.db.WithContext(c.Request.Context()).Model(&entity.CallbackTask{})
if s := c.Query("status"); s != "" {
v, err := strconv.Atoi(s)
if err != nil || v < 0 || v > 2 {
response.ErrorWithMsg(c, errors.InvalidParam, "status 须为 0/1/2")
return
}
q = q.Where("status = ?", int8(v))
}
if s := c.Query("type"); s != "" {
v, err := strconv.Atoi(s)
if err != nil || v < 1 || v > 2 {
response.ErrorWithMsg(c, errors.InvalidParam, "type 须为 1/2")
return
}
q = q.Where("type = ?", int8(v))
}
if s := c.Query("account_id"); s != "" {
v, err := strconv.ParseInt(s, 10, 64)
if err != nil || v <= 0 {
response.ErrorWithMsg(c, errors.InvalidParam, "account_id 非法")
return
}
q = q.Where("account_id = ?", v)
}
page, size := 1, 20
if v, err := strconv.Atoi(c.Query("page")); err == nil && v > 0 {
page = v
}
if v, err := strconv.Atoi(c.Query("page_size")); err == nil && v > 0 && v <= 200 {
size = v
}
var total int64
if err := q.Count(&total).Error; err != nil {
bizResp(c, err)
return
}
var rows []entity.CallbackTask
if err := q.Order("id DESC").Limit(size).Offset((page - 1) * size).Find(&rows).Error; err != nil {
bizResp(c, err)
return
}
// 状态计数面板(死信可查验收项:一眼看死信存量)。
var statusAgg []struct {
Status int8
N int64
}
_ = h.db.WithContext(c.Request.Context()).Model(&entity.CallbackTask{}).
Select("status, COUNT(*) AS n").Group("status").Scan(&statusAgg).Error
agg := gin.H{}
for _, r := range statusAgg {
key := map[int8]string{0: "pending", 1: "sent", 2: "dead"}[r.Status]
if key != "" {
agg[key] = r.N
}
}
response.Success(c, gin.H{"total": total, "list": rows, "status_counts": agg})
}
// resend POST /ops/callback/:id/resend:死信重派(attempt 清零/立即到期)。
func (h *callbackHandler) resend(c *gin.Context) {
id, err := strconv.ParseInt(c.Param("id"), 10, 64)
if err != nil || id <= 0 {
response.ErrorWithMsg(c, errors.InvalidParam, "id 非法")
return
}
n, err := h.svc.Resend(c.Request.Context(), id)
if err != nil {
bizResp(c, err)
return
}
if n == 0 {
response.Error(c, errors.NotFound.WithMsg("任务不存在或非死信状态"))
return
}
response.Success(c, gin.H{"id": id, "resent": true})
}