// template_handler.go Day 41:模板 CRUD+审核端点+发送预估(D17 群发工作台实时计费条数)。 package v1 import ( "strconv" "github.com/gin-gonic/gin" "go-sms/internal/middleware" "go-sms/internal/model/entity" "go-sms/internal/pkg/errors" "go-sms/internal/pkg/response" "go-sms/internal/service/send" "go-sms/internal/service/template" ) // templateHandler 模板接口。 type templateHandler struct{ svc *template.Service } func registerTemplateRoutes(protected *gin.RouterGroup, perm middleware.PermissionChecker, svc *template.Service) { h := &templateHandler{svc: svc} gate := func(obj, act string) gin.HandlerFunc { return middleware.RequirePermission(perm, obj, act) } protected.GET("/templates", h.list) protected.POST("/templates", gate("message", "write"), h.create) protected.GET("/templates/:id", h.get) protected.PUT("/templates/:id", gate("message", "write"), h.update) protected.DELETE("/templates/:id", gate("message", "write"), h.remove) protected.PUT("/templates/:id/review", gate("message", "write"), h.review) // Day 44(D20):批量审核(事务内原子翻转 WHERE status=0;已审跳过)。 protected.PUT("/templates/batch-review", gate("message", "write"), h.batchReview) // 发送预估:模板短信自动带出模板内容渲染(D17 实时条数与后端同源) protected.POST("/send/estimate", gate("message", "write"), h.estimate) } func (h *templateHandler) list(c *gin.Context) { q := &template.Query{ Page: intQuery(c, "page", 1), PageSize: intQuery(c, "page_size", 20), Name: c.Query("name"), } if v := c.Query("account_id"); v != "" { id, _ := strconv.ParseInt(v, 10, 64) q.AccountID = id } if v := c.Query("status"); v != "" { st, _ := strconv.Atoi(v) s := int8(st) q.Status = &s } list, total, err := h.svc.List(c.Request.Context(), q) if err != nil { bizResp(c, err) return } response.Success(c, gin.H{"total": total, "list": list}) } func (h *templateHandler) create(c *gin.Context) { var req template.CreateReq if err := c.ShouldBindJSON(&req); err != nil { response.ErrorWithMsg(c, errors.InvalidParam, "参数错误: "+err.Error()) return } t, err := h.svc.Create(c.Request.Context(), &req) if err != nil { bizResp(c, err) return } response.Success(c, t) } func (h *templateHandler) get(c *gin.Context) { id, _ := strconv.ParseInt(c.Param("id"), 10, 64) t, err := h.svc.GetByID(c.Request.Context(), id) if err != nil { bizResp(c, err) return } response.Success(c, t) } func (h *templateHandler) update(c *gin.Context) { id, _ := strconv.ParseInt(c.Param("id"), 10, 64) var body map[string]any if err := c.ShouldBindJSON(&body); err != nil || len(body) == 0 { response.ErrorWithMsg(c, errors.InvalidParam, "请求体需为字段对象") return } if err := h.svc.Update(c.Request.Context(), id, body); err != nil { bizResp(c, err) return } response.Success(c, gin.H{"id": id}) } func (h *templateHandler) remove(c *gin.Context) { id, _ := strconv.ParseInt(c.Param("id"), 10, 64) if err := h.svc.Delete(c.Request.Context(), id); err != nil { bizResp(c, err) return } response.Success(c, gin.H{"id": id}) } // review PUT /templates/:id/review {pass: bool, reason}。 func (h *templateHandler) review(c *gin.Context) { id, _ := strconv.ParseInt(c.Param("id"), 10, 64) var req struct { Pass bool `json:"pass"` Reason string `json:"reason"` } if err := c.ShouldBindJSON(&req); err != nil { response.ErrorWithMsg(c, errors.InvalidParam, "参数错误: "+err.Error()) return } if err := h.svc.Review(c.Request.Context(), id, req.Pass, req.Reason); err != nil { bizResp(c, err) return } response.Success(c, gin.H{"id": id}) } // batchReview PUT /templates/batch-review {ids:[], pass, reason} → {ok, total}。 func (h *templateHandler) batchReview(c *gin.Context) { var req struct { IDs []int64 `json:"ids"` Pass bool `json:"pass"` Reason string `json:"reason"` } if err := c.ShouldBindJSON(&req); err != nil || len(req.IDs) == 0 { response.ErrorWithMsg(c, errors.InvalidParam, "参数错误: ids 非空数组") return } ok, err := h.svc.BatchReview(c.Request.Context(), req.IDs, req.Pass, req.Reason) if err != nil { bizResp(c, err) return } response.Success(c, gin.H{"ok": ok, "total": len(req.IDs)}) } // estimate POST /send/estimate(SubmitReq;template_id>0 时服务端取模板渲染)。 func (h *templateHandler) estimate(c *gin.Context) { var req send.SubmitReq if err := c.ShouldBindJSON(&req); err != nil { response.ErrorWithMsg(c, errors.InvalidParam, "参数错误: "+err.Error()) return } var tpl *entity.TemplateSMS if req.TemplateID > 0 { t, err := h.svc.GetByID(c.Request.Context(), req.TemplateID) if err != nil { bizResp(c, err) return } tpl = t } est, err := req.Validate(tpl) if err != nil { bizResp(c, err) return } response.Success(c, est) }