junhong_cmp_fiber/internal/routes/order.go

package routes

import (
	"github.com/gofiber/fiber/v2"

	"github.com/break/junhong_cmp_fiber/internal/handler/admin"
	"github.com/break/junhong_cmp_fiber/internal/handler/callback"
	"github.com/break/junhong_cmp_fiber/internal/model/dto"
	"github.com/break/junhong_cmp_fiber/pkg/openapi"
)

// registerAdminOrderRoutes 注册后台订单路由
func registerAdminOrderRoutes(router fiber.Router, handler *admin.OrderHandler, doc *openapi.Generator, basePath string) {
	Register(router, doc, basePath, "POST", "/orders", handler.Create, RouteSpec{
		Summary: "创建订单",
		Tags:    []string{"订单管理"},
		Input:   new(dto.CreateAdminOrderRequest),
		Output:  new(dto.OrderResponse),
		Auth:    true,
	})

	Register(router, doc, basePath, "GET", "/orders", handler.List, RouteSpec{
		Summary:     "获取订单列表",
		Description: "平台订单、代理商订单、在线支付订单全部返回；按类别查看请用 `/orders/platform`、`/orders/agent`、`/orders/online`。代理账号只看到买家是本店铺的订单。企业账号无权访问。",
		Tags:        []string{"订单管理"},
		Input:       new(dto.OrderListRequest),
		Output:      new(dto.OrderListResponse),
		Auth:        true,
	})

	// 按类别拆分的列表是静态路径，必须注册在 /orders/:id 之前，否则会被当作订单 ID 解析。
	Register(router, doc, basePath, "GET", "/orders/platform", handler.ListPlatform, RouteSpec{
		Summary:     "获取平台订单列表",
		Description: "平台订单：后台下单且不走代理钱包（线下支付），含平台自营、赠送、平台代购代理名下的卡。查询参数、分页、响应结构、权限与数据范围与 `GET /orders` 相同，只额外固定订单类别，不接收类别参数。代理账号只看到买家是本店铺的订单。企业账号无权访问。",
		Tags:        []string{"订单管理"},
		Input:       new(dto.OrderListRequest),
		Output:      new(dto.OrderListResponse),
		Auth:        true,
	})

	Register(router, doc, basePath, "GET", "/orders/agent", handler.ListAgent, RouteSpec{
		Summary:     "获取代理商订单列表",
		Description: "代理商订单：后台下单且从代理钱包扣款，含代理自购、代理给下级购买、平台代扣代理钱包、代理 OpenAPI 下单。查询参数、分页、响应结构、权限与数据范围与 `GET /orders` 相同，只额外固定订单类别，不接收类别参数。代理账号只看到买家是本店铺的订单。企业账号无权访问。",
		Tags:        []string{"订单管理"},
		Input:       new(dto.OrderListRequest),
		Output:      new(dto.OrderListResponse),
		Auth:        true,
	})

	Register(router, doc, basePath, "GET", "/orders/online", handler.ListOnline, RouteSpec{
		Summary:     "获取在线支付订单列表",
		Description: "在线支付订单：个人客户在客户端下的全部订单，含微信、支付宝、卡钱包支付、自动续费、自动购买与待支付订单。查询参数、分页、响应结构、权限与数据范围与 `GET /orders` 相同，只额外固定订单类别，不接收类别参数。代理账号只看到买家是本店铺的订单。企业账号无权访问。在线支付订单的买家是个人客户，代理账号调用结果为空。",
		Tags:        []string{"订单管理"},
		Input:       new(dto.OrderListRequest),
		Output:      new(dto.OrderListResponse),
		Auth:        true,
	})

	Register(router, doc, basePath, "GET", "/orders/:id", handler.Get, RouteSpec{
		Summary:     "获取订单详情",
		Description: "企业账号无权访问。",
		Tags:        []string{"订单管理"},
		Input:       new(dto.GetOrderRequest),
		Output:      new(dto.OrderDetailResponse),
		Auth:        true,
	})

	Register(router, doc, basePath, "POST", "/orders/:id/cancel", handler.Cancel, RouteSpec{
		Summary: "取消订单",
		Tags:    []string{"订单管理"},
		Input:   new(dto.CancelOrderRequest),
		Output:  nil,
		Auth:    true,
	})

	Register(router, doc, basePath, "POST", "/orders/purchase-check", handler.PurchaseCheck, RouteSpec{
		Summary:     "套餐购买预检",
		Description: "企业账号无权访问。",
		Tags:        []string{"订单管理"},
		Input:       new(dto.PurchaseCheckRequest),
		Output:      new(dto.PurchaseCheckResponse),
		Auth:        true,
	})
}

// registerCarrierCallbackRoutes 注册运营商业务回调路由。
func registerCarrierCallbackRoutes(router fiber.Router, handler *callback.CTCCRealnameHandler, doc *openapi.Generator, basePath string) {
	Register(router, doc, basePath, "POST", "/carriers/ctcc/realname", handler.Realname, RouteSpec{
		Summary:     "电信实名结果回调",
		Description: "接收电信 XML 实名补录结果，固定返回运营商成功应答。",
		Tags:        []string{"运营商回调"},
		Input:       nil,
		Output:      nil,
		Auth:        false,
	})
}

// registerCMCCCallbackRoutes 注册中国移动实名回调路由。
func registerCMCCCallbackRoutes(router fiber.Router, handler *callback.CMCCRealnameHandler, doc *openapi.Generator, basePath string) {
	Register(router, doc, basePath, "POST", "/carriers/cmcc/realname", handler.Realname, RouteSpec{
		Summary: "移动实名结果回调", Description: "接收中国移动 JSON 实名成功结果，固定返回运营商成功应答。",
		Tags: []string{"运营商回调"}, Input: nil, Output: nil, Auth: false,
	})
}

// registerCUCCRealnameCallbackRoutes 注册中国联通实名成功回调路由。
func registerCUCCRealnameCallbackRoutes(router fiber.Router, handler *callback.CUCCRealnameHandler, doc *openapi.Generator, basePath string) {
	Register(router, doc, basePath, "POST", "/carriers/cucc/realname", handler.Realname, RouteSpec{
		Summary: "联通实名结果回调", Description: "接收中国联通嵌套 JSON 实名成功结果，固定返回运营商成功应答。",
		Tags: []string{"运营商回调"}, Input: nil, Output: nil, Auth: false,
	})
}

// registerCUCCCallbackRoutes 注册中国联通解除实名回调路由。
func registerCUCCCallbackRoutes(router fiber.Router, handler *callback.CUCCRealnameRemovalHandler, doc *openapi.Generator, basePath string) {
	Register(router, doc, basePath, "POST", "/carriers/cucc/realname/remove", handler.Remove, RouteSpec{
		Summary: "联通解除实名回调", Description: "识别中国联通解除实名 JSON，仅留痕且不修改本地实名事实。",
		Tags: []string{"运营商回调"}, Input: nil, Output: nil, Auth: false,
	})
}

// registerPaymentCallbackRoutes 注册支付回调路由
func registerPaymentCallbackRoutes(router fiber.Router, handler *callback.PaymentHandler, doc *openapi.Generator, basePath string) {
	Register(router, doc, basePath, "POST", "/wechat-pay", handler.WechatPayCallback, RouteSpec{
		Summary: "微信支付回调",
		Tags:    []string{"支付回调"},
		Input:   nil,
		Output:  nil,
		Auth:    false,
	})

	Register(router, doc, basePath, "POST", "/alipay", handler.AlipayCallback, RouteSpec{
		Summary: "支付宝回调",
		Tags:    []string{"支付回调"},
		Input:   nil,
		Output:  nil,
		Auth:    false,
	})

	Register(router, doc, basePath, "POST", "/fuiou-pay", handler.FuiouPayCallback, RouteSpec{
		Summary: "富友支付回调",
		Tags:    []string{"支付回调"},
		Input:   nil,
		Output:  nil,
		Auth:    false,
	})
}