// 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}) }