From 30c56e66dd26d11aad74685942c29f3de18a8fe7 Mon Sep 17 00:00:00 2001 From: huang Date: Mon, 16 Mar 2026 23:29:31 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E5=BE=AE=E4=BF=A1?= =?UTF-8?q?=E5=8F=82=E6=95=B0=E9=85=8D=E7=BD=AE=E7=AE=A1=E7=90=86=20Handle?= =?UTF-8?q?r=20=E5=92=8C=E8=B7=AF=E7=94=B1=EF=BC=88=E4=BB=85=E5=B9=B3?= =?UTF-8?q?=E5=8F=B0=E8=B4=A6=E5=8F=B7=E5=8F=AF=E8=AE=BF=E9=97=AE=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - wechat_config.go Handler: Create/List/Get/Update/Delete/Activate/Deactivate/GetActive 共 8 个方法 - wechat_config.go 路由: 注册到 /api/admin/wechat-configs/*，路由层限制平台账号权限 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus --- internal/handler/admin/wechat_config.go | 153 ++++++++++++++++++++++++ internal/routes/wechat_config.go | 89 ++++++++++++++ 2 files changed, 242 insertions(+) create mode 100644 internal/handler/admin/wechat_config.go create mode 100644 internal/routes/wechat_config.go diff --git a/internal/handler/admin/wechat_config.go b/internal/handler/admin/wechat_config.go new file mode 100644 index 0000000..271fcbd --- /dev/null +++ b/internal/handler/admin/wechat_config.go @@ -0,0 +1,153 @@ +package admin + +import ( + "strconv" + + "github.com/gofiber/fiber/v2" + + "github.com/break/junhong_cmp_fiber/internal/model/dto" + wechatConfigService "github.com/break/junhong_cmp_fiber/internal/service/wechat_config" + "github.com/break/junhong_cmp_fiber/pkg/errors" + "github.com/break/junhong_cmp_fiber/pkg/response" +) + +// WechatConfigHandler 微信参数配置 HTTP 处理器 +type WechatConfigHandler struct { + service *wechatConfigService.Service +} + +// NewWechatConfigHandler 创建微信参数配置处理器实例 +func NewWechatConfigHandler(service *wechatConfigService.Service) *WechatConfigHandler { + return &WechatConfigHandler{service: service} +} + +// Create 创建微信参数配置 +// POST /api/admin/wechat-configs +func (h *WechatConfigHandler) Create(c *fiber.Ctx) error { + var req dto.CreateWechatConfigRequest + if err := c.BodyParser(&req); err != nil { + return errors.New(errors.CodeInvalidParam, "请求参数解析失败") + } + + result, err := h.service.Create(c.UserContext(), &req) + if err != nil { + return err + } + + return response.Success(c, result) +} + +// List 获取微信参数配置列表 +// GET /api/admin/wechat-configs +func (h *WechatConfigHandler) List(c *fiber.Ctx) error { + var req dto.WechatConfigListRequest + if err := c.QueryParser(&req); err != nil { + return errors.New(errors.CodeInvalidParam, "请求参数解析失败") + } + + configs, total, err := h.service.List(c.UserContext(), &req) + if err != nil { + return err + } + + return response.SuccessWithPagination(c, configs, total, req.Page, req.PageSize) +} + +// Get 获取微信参数配置详情 +// GET /api/admin/wechat-configs/:id +func (h *WechatConfigHandler) Get(c *fiber.Ctx) error { + id, err := strconv.ParseUint(c.Params("id"), 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的配置 ID") + } + + result, err := h.service.Get(c.UserContext(), uint(id)) + if err != nil { + return err + } + + return response.Success(c, result) +} + +// Update 更新微信参数配置 +// PUT /api/admin/wechat-configs/:id +func (h *WechatConfigHandler) Update(c *fiber.Ctx) error { + id, err := strconv.ParseUint(c.Params("id"), 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的配置 ID") + } + + var req dto.UpdateWechatConfigRequest + if err := c.BodyParser(&req); err != nil { + return errors.New(errors.CodeInvalidParam, "请求参数解析失败") + } + + result, err := h.service.Update(c.UserContext(), uint(id), &req) + if err != nil { + return err + } + + return response.Success(c, result) +} + +// Delete 删除微信参数配置 +// DELETE /api/admin/wechat-configs/:id +func (h *WechatConfigHandler) Delete(c *fiber.Ctx) error { + id, err := strconv.ParseUint(c.Params("id"), 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的配置 ID") + } + + if err := h.service.Delete(c.UserContext(), uint(id)); err != nil { + return err + } + + return response.Success(c, nil) +} + +// Activate 激活微信参数配置 +// POST /api/admin/wechat-configs/:id/activate +func (h *WechatConfigHandler) Activate(c *fiber.Ctx) error { + id, err := strconv.ParseUint(c.Params("id"), 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的配置 ID") + } + + result, err := h.service.Activate(c.UserContext(), uint(id)) + if err != nil { + return err + } + + return response.Success(c, result) +} + +// Deactivate 停用微信参数配置 +// POST /api/admin/wechat-configs/:id/deactivate +func (h *WechatConfigHandler) Deactivate(c *fiber.Ctx) error { + id, err := strconv.ParseUint(c.Params("id"), 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的配置 ID") + } + + result, err := h.service.Deactivate(c.UserContext(), uint(id)) + if err != nil { + return err + } + + return response.Success(c, result) +} + +// GetActive 获取当前生效的微信参数配置 +// GET /api/admin/wechat-configs/active +func (h *WechatConfigHandler) GetActive(c *fiber.Ctx) error { + result, err := h.service.GetActiveConfigForAPI(c.UserContext()) + if err != nil { + return err + } + + if result == nil { + return response.SuccessWithMessage(c, nil, "当前无生效的支付配置，仅支持钱包支付") + } + + return response.Success(c, result) +} diff --git a/internal/routes/wechat_config.go b/internal/routes/wechat_config.go new file mode 100644 index 0000000..3d81a04 --- /dev/null +++ b/internal/routes/wechat_config.go @@ -0,0 +1,89 @@ +package routes + +import ( + "github.com/gofiber/fiber/v2" + + "github.com/break/junhong_cmp_fiber/internal/handler/admin" + "github.com/break/junhong_cmp_fiber/internal/model/dto" + "github.com/break/junhong_cmp_fiber/pkg/constants" + "github.com/break/junhong_cmp_fiber/pkg/errors" + "github.com/break/junhong_cmp_fiber/pkg/middleware" + "github.com/break/junhong_cmp_fiber/pkg/openapi" +) + +func registerWechatConfigRoutes(router fiber.Router, handler *admin.WechatConfigHandler, doc *openapi.Generator, basePath string) { + // 平台用户权限中间件：仅超级管理员和平台用户可访问支付配置管理 + group := router.Group("/wechat-configs", func(c *fiber.Ctx) error { + userType := middleware.GetUserTypeFromContext(c.UserContext()) + if userType != constants.UserTypeSuperAdmin && userType != constants.UserTypePlatform { + return errors.New(errors.CodeForbidden, "无权限访问支付配置管理功能") + } + return c.Next() + }) + groupPath := basePath + "/wechat-configs" + + // active 路由必须在 /:id 之前注册，否则 "active" 会被当作 id 解析 + Register(group, doc, groupPath, "GET", "/active", handler.GetActive, RouteSpec{ + Summary: "获取当前生效的支付配置", + Tags: []string{"微信支付配置管理"}, + Input: nil, + Output: new(dto.WechatConfigResponse), + Auth: true, + }) + + Register(group, doc, groupPath, "GET", "", handler.List, RouteSpec{ + Summary: "获取支付配置列表", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.WechatConfigListRequest), + Output: new(dto.WechatConfigListResponse), + Auth: true, + }) + + Register(group, doc, groupPath, "POST", "", handler.Create, RouteSpec{ + Summary: "创建支付配置", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.CreateWechatConfigRequest), + Output: new(dto.WechatConfigResponse), + Auth: true, + }) + + Register(group, doc, groupPath, "GET", "/:id", handler.Get, RouteSpec{ + Summary: "获取支付配置详情", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.IDReq), + Output: new(dto.WechatConfigResponse), + Auth: true, + }) + + Register(group, doc, groupPath, "PUT", "/:id", handler.Update, RouteSpec{ + Summary: "更新支付配置", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.UpdateWechatConfigRequest), + Output: new(dto.WechatConfigResponse), + Auth: true, + }) + + Register(group, doc, groupPath, "DELETE", "/:id", handler.Delete, RouteSpec{ + Summary: "删除支付配置", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.IDReq), + Output: nil, + Auth: true, + }) + + Register(group, doc, groupPath, "POST", "/:id/activate", handler.Activate, RouteSpec{ + Summary: "激活支付配置", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.IDReq), + Output: new(dto.WechatConfigResponse), + Auth: true, + }) + + Register(group, doc, groupPath, "POST", "/:id/deactivate", handler.Deactivate, RouteSpec{ + Summary: "停用支付配置", + Tags: []string{"微信支付配置管理"}, + Input: new(dto.IDReq), + Output: new(dto.WechatConfigResponse), + Auth: true, + }) +}