From c5018f110f5cfb1ac44de8f649eacbda11fb7f52 Mon Sep 17 00:00:00 2001 From: huang Date: Wed, 4 Mar 2026 11:36:20 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E7=B3=BB=E5=88=97?= =?UTF-8?q?=E6=8E=88=E6=9D=83=20Handler=20=E5=92=8C=E8=B7=AF=E7=94=B1?= =?UTF-8?q?=EF=BC=88/shop-series-grants=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Handler 实现 POST /shop-series-grants（创建）、GET /shop-series-grants（列表）、GET /shop-series-grants/:id（详情）、PUT /shop-series-grants/:id（更新佣金和强充配置）、PUT /shop-series-grants/:id/packages（管理授权内套餐）、DELETE /shop-series-grants/:id（删除）六个接口。 Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus --- internal/handler/admin/shop_series_grant.go | 131 ++++++++++++++++++++ internal/routes/shop_series_grant.go | 62 +++++++++ 2 files changed, 193 insertions(+) create mode 100644 internal/handler/admin/shop_series_grant.go create mode 100644 internal/routes/shop_series_grant.go diff --git a/internal/handler/admin/shop_series_grant.go b/internal/handler/admin/shop_series_grant.go new file mode 100644 index 0000000..ff23c9c --- /dev/null +++ b/internal/handler/admin/shop_series_grant.go @@ -0,0 +1,131 @@ +package admin + +import ( + "strconv" + + "github.com/gofiber/fiber/v2" + + "github.com/break/junhong_cmp_fiber/internal/model/dto" + grantService "github.com/break/junhong_cmp_fiber/internal/service/shop_series_grant" + "github.com/break/junhong_cmp_fiber/pkg/errors" + "github.com/break/junhong_cmp_fiber/pkg/response" +) + +// ShopSeriesGrantHandler 代理系列授权 Handler +type ShopSeriesGrantHandler struct { + service *grantService.Service +} + +// NewShopSeriesGrantHandler 创建代理系列授权 Handler +func NewShopSeriesGrantHandler(service *grantService.Service) *ShopSeriesGrantHandler { + return &ShopSeriesGrantHandler{service: service} +} + +// Create 创建系列授权 +// POST /api/admin/shop-series-grants +func (h *ShopSeriesGrantHandler) Create(c *fiber.Ctx) error { + var req dto.CreateShopSeriesGrantRequest + 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/shop-series-grants +func (h *ShopSeriesGrantHandler) List(c *fiber.Ctx) error { + var req dto.ShopSeriesGrantListRequest + if err := c.QueryParser(&req); err != nil { + return errors.New(errors.CodeInvalidParam, "请求参数解析失败") + } + + result, err := h.service.List(c.UserContext(), &req) + if err != nil { + return err + } + + return response.SuccessWithPagination(c, result.List, result.Total, result.Page, result.PageSize) +} + +// Get 查询系列授权详情 +// GET /api/admin/shop-series-grants/:id +func (h *ShopSeriesGrantHandler) Get(c *fiber.Ctx) error { + idStr := c.Params("id") + id, err := strconv.ParseUint(idStr, 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/shop-series-grants/:id +func (h *ShopSeriesGrantHandler) Update(c *fiber.Ctx) error { + idStr := c.Params("id") + id, err := strconv.ParseUint(idStr, 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的授权ID") + } + + var req dto.UpdateShopSeriesGrantRequest + 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) +} + +// ManagePackages 管理授权套餐 +// PUT /api/admin/shop-series-grants/:id/packages +func (h *ShopSeriesGrantHandler) ManagePackages(c *fiber.Ctx) error { + idStr := c.Params("id") + id, err := strconv.ParseUint(idStr, 10, 64) + if err != nil { + return errors.New(errors.CodeInvalidParam, "无效的授权ID") + } + + var req dto.ManageGrantPackagesRequest + if err := c.BodyParser(&req); err != nil { + return errors.New(errors.CodeInvalidParam, "请求参数解析失败") + } + + result, err := h.service.ManagePackages(c.UserContext(), uint(id), &req) + if err != nil { + return err + } + + return response.Success(c, result) +} + +// Delete 删除系列授权 +// DELETE /api/admin/shop-series-grants/:id +func (h *ShopSeriesGrantHandler) Delete(c *fiber.Ctx) error { + idStr := c.Params("id") + id, err := strconv.ParseUint(idStr, 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) +} diff --git a/internal/routes/shop_series_grant.go b/internal/routes/shop_series_grant.go new file mode 100644 index 0000000..b01b399 --- /dev/null +++ b/internal/routes/shop_series_grant.go @@ -0,0 +1,62 @@ +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/openapi" +) + +func registerShopSeriesGrantRoutes(router fiber.Router, handler *admin.ShopSeriesGrantHandler, doc *openapi.Generator, basePath string) { + grants := router.Group("/shop-series-grants") + groupPath := basePath + "/shop-series-grants" + + Register(grants, doc, groupPath, "GET", "", handler.List, RouteSpec{ + Summary: "查询代理系列授权列表", + Tags: []string{"代理系列授权"}, + Input: new(dto.ShopSeriesGrantListRequest), + Output: new(dto.ShopSeriesGrantPageResult), + Auth: true, + }) + + Register(grants, doc, groupPath, "POST", "", handler.Create, RouteSpec{ + Summary: "创建代理系列授权", + Tags: []string{"代理系列授权"}, + Input: new(dto.CreateShopSeriesGrantRequest), + Output: new(dto.ShopSeriesGrantResponse), + Auth: true, + }) + + Register(grants, doc, groupPath, "GET", "/:id", handler.Get, RouteSpec{ + Summary: "查询代理系列授权详情", + Tags: []string{"代理系列授权"}, + Input: new(dto.IDReq), + Output: new(dto.ShopSeriesGrantResponse), + Auth: true, + }) + + Register(grants, doc, groupPath, "PUT", "/:id", handler.Update, RouteSpec{ + Summary: "更新代理系列授权", + Tags: []string{"代理系列授权"}, + Input: new(dto.UpdateShopSeriesGrantParams), + Output: new(dto.ShopSeriesGrantResponse), + Auth: true, + }) + + Register(grants, doc, groupPath, "DELETE", "/:id", handler.Delete, RouteSpec{ + Summary: "删除代理系列授权", + Tags: []string{"代理系列授权"}, + Input: new(dto.IDReq), + Output: nil, + Auth: true, + }) + + Register(grants, doc, groupPath, "PUT", "/:id/packages", handler.ManagePackages, RouteSpec{ + Summary: "管理授权套餐（新增/更新/删除）", + Tags: []string{"代理系列授权"}, + Input: new(dto.ManageGrantPackagesParams), + Output: new(dto.ShopSeriesGrantResponse), + Auth: true, + }) +}