// sysconfig_handler.go Issue#3 方案B:系统参数配置端点(system_config KV 表)。 // - GET /system/config 全量列表(登录即可,管理页数据源) // - PUT /system/config 新增/更新(system:write——admin 直通;UPSERT+缓存即刻失效) // 已知键:cmpp.default_ext_code(系统默认接入码前缀,账号 ext_code 空时回退, // 受理热路径 30s 读缓存)/uplink.blacklist.keywords(上行拉黑词表,uplink 域 // 自刷新 60s 生效)。表结构无白名单约束,新键=新能力按需扩展。 package v1 import ( "github.com/gin-gonic/gin" "go-sms/internal/middleware" "go-sms/internal/pkg/errors" "go-sms/internal/pkg/response" "go-sms/internal/service/sysconfig" ) type sysConfigHandler struct{ svc *sysconfig.Service } func registerSysConfigRoutes(protected *gin.RouterGroup, perm middleware.PermissionChecker, svc *sysconfig.Service) { h := &sysConfigHandler{svc: svc} protected.GET("/system/config", h.list) protected.PUT("/system/config", middleware.RequirePermission(perm, "system", "write"), h.set) } // list GET /system/config(全量,cfg_key 升序)。 func (h *sysConfigHandler) list(c *gin.Context) { rows, err := h.svc.List(c.Request.Context()) if err != nil { response.Error(c, errors.InternalError) return } response.Success(c, gin.H{"list": rows}) } // sysConfigReq PUT 请求体。 type sysConfigReq struct { CfgKey string `json:"cfg_key" binding:"required"` CfgValue string `json:"cfg_value"` // 空串=合法值(清空语义) Remark string `json:"remark"` } // set PUT /system/config(cfg_key 唯一 UPSERT;审计由 AuditTrail 写方法自动留痕)。 func (h *sysConfigHandler) set(c *gin.Context) { var req sysConfigReq if err := c.ShouldBindJSON(&req); err != nil { response.ErrorWithMsg(c, errors.InvalidParam, "参数错误: "+err.Error()) return } claims := operatorClaims(c) operator := "" if claims != nil { operator = claims.Username } row, err := h.svc.Set(c.Request.Context(), req.CfgKey, req.CfgValue, req.Remark, operator) if err != nil { if bizErr, ok := err.(*errors.Error); ok { response.Error(c, bizErr) return } c.Set("biz_error", err.Error()) response.Error(c, errors.InternalError) return } response.Success(c, row) }