909f4d0ec2
Some checks failed
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Failing after 8m39s
- 迁移 000259～000265：套餐记录沉默期字段与扫描索引、套餐默认沉默期、延期政策/流水/订单/批次/明细 5 张表、默认政策与系统配置（总开关默认关闭）、企微审批白名单、卡与设备出库时间及出库记录 - 沉默期设置（订单发放、自动购包、钱包续费）、后台购买时调整（超默认值按政策免审或企微审批）、统一判定与激活闸门、排队与孤儿扫描跳过过期套餐、过期套餐禁止退款、每 10 分钟扫描 - 总开关专用接口与打开前 4 项检查；延期政策；延期资格与计费；H5 自助与后台二维码在线支付（商户池路由）、支付回调与查单恢复、线下登记、特殊/批量延期、异常重试与原路退款；沉默期审批场景与终态处理 - 换货沉默期流水与出库时间；卡/设备列表、详情、导出与出库记录接口；延期订单与即将过期套餐列表及导出；财务流水纳入延期支付 - 沉默期与出库时间回填工具 cmd/silence-backfill；前端接口变更说明 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
340 lines
14 KiB
Go
340 lines
14 KiB
Go
package routes
|
||
|
||
import (
|
||
"github.com/gofiber/fiber/v2"
|
||
|
||
"github.com/break/junhong_cmp_fiber/internal/bootstrap"
|
||
apphandler "github.com/break/junhong_cmp_fiber/internal/handler/app"
|
||
"github.com/break/junhong_cmp_fiber/internal/middleware"
|
||
"github.com/break/junhong_cmp_fiber/internal/model/dto"
|
||
"github.com/break/junhong_cmp_fiber/pkg/config"
|
||
"github.com/break/junhong_cmp_fiber/pkg/openapi"
|
||
)
|
||
|
||
// RegisterPersonalCustomerRoutes 注册个人客户路由
|
||
// 路由挂载在 /api/c/v1 下
|
||
//
|
||
// 重要：Fiber 的 Group.Use() 会在路由表中注册全局 USE 处理器，
|
||
// 匹配该前缀下的所有请求（不区分 Group 对象）。
|
||
// 因此公开路由必须在任何 Use() 调用之前注册，利用 Fiber 按注册顺序匹配的机制，
|
||
// 确保公开路由优先命中并直接返回，不会被后续的认证中间件拦截。
|
||
func RegisterPersonalCustomerRoutes(router fiber.Router, doc *openapi.Generator, basePath string, handlers *bootstrap.Handlers, personalAuthMiddleware *middleware.PersonalAuthMiddleware) {
|
||
authBasePath := "/auth"
|
||
|
||
// === 公开路由（无需认证）===
|
||
// 代理扫码注册必须在任何 Use() 调用之前注册，否则会被后续认证中间件拦截。
|
||
registerAgentDistributionPublicRoutes(router, handlers.AgentDistribution, doc, basePath)
|
||
|
||
Register(router, doc, basePath, "GET", "/wechat/appid", handlers.ClientWechat.GetAppID, RouteSpec{
|
||
Summary: "获取当前生效的公众号 AppID",
|
||
Description: "用于 C 端免登录场景获取当前生效微信配置中的公众号 AppID，响应仅返回 app_id 字段",
|
||
Tags: []string{"个人客户 - 微信"},
|
||
Auth: false,
|
||
Input: nil,
|
||
Output: &dto.WechatAppIDResponse{},
|
||
})
|
||
|
||
Register(router, doc, basePath, "GET", "/wechat/jssdk-config", handlers.ClientWechat.GetJSSDKConfig, RouteSpec{
|
||
Summary: "获取微信 JSSDK 签名配置",
|
||
Description: "前端调用 wx.config() 初始化微信 JS-SDK 时所需的签名参数，需传入当前页面完整 URL",
|
||
Tags: []string{"个人客户 - 微信"},
|
||
Auth: false,
|
||
Input: &dto.JSSDKConfigRequest{},
|
||
Output: &dto.JSSDKConfigResponse{},
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", authBasePath+"/verify-asset", handlers.ClientAuth.VerifyAsset, RouteSpec{
|
||
Summary: "资产验证",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: false,
|
||
Input: &dto.VerifyAssetRequest{},
|
||
Output: &dto.VerifyAssetResponse{},
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", authBasePath+"/wechat-login", handlers.ClientAuth.WechatLogin, RouteSpec{
|
||
Summary: "公众号登录",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: false,
|
||
Input: &dto.WechatLoginRequest{},
|
||
Output: &dto.WechatLoginResponse{},
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", authBasePath+"/miniapp-login", handlers.ClientAuth.MiniappLogin, RouteSpec{
|
||
Summary: "小程序登录",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: false,
|
||
Input: &dto.MiniappLoginRequest{},
|
||
Output: &dto.WechatLoginResponse{},
|
||
})
|
||
|
||
Register(router, doc, basePath, "POST", authBasePath+"/send-code", handlers.ClientAuth.SendCode, RouteSpec{
|
||
Summary: "发送验证码",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: false,
|
||
Input: &dto.ClientSendCodeRequest{},
|
||
Output: &dto.ClientSendCodeResponse{},
|
||
})
|
||
|
||
// 开发模式测试登录接口（仅 logging.development=true 时注册）
|
||
if cfg := config.Get(); cfg != nil && cfg.Logging.Development {
|
||
Register(router, doc, basePath, "POST", authBasePath+"/dev-login", handlers.ClientAuth.DevLogin, RouteSpec{
|
||
Summary: "开发环境测试登录",
|
||
Description: "⚠️ 仅开发模式可用。传入资产标识符（ICCID等），自动绑定测试客户并签发 JWT，用于接口测试。",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: false,
|
||
Input: &dto.DevLoginRequest{},
|
||
Output: &dto.DevLoginResponse{},
|
||
})
|
||
}
|
||
|
||
// === 需要认证的 auth 路由 ===
|
||
authProtectedGroup := router.Group(authBasePath)
|
||
authProtectedGroup.Use(personalAuthMiddleware.Authenticate())
|
||
|
||
Register(authProtectedGroup, doc, basePath+authBasePath, "POST", "/bind-phone", handlers.ClientAuth.BindPhone, RouteSpec{
|
||
Summary: "绑定手机号",
|
||
Description: "客户手机号与资产手机号相互独立：无手机号且资产无关联时同时写入两者；有手机号且资产无关联时只为资产建立关联，号码可与客户手机号不同；" +
|
||
"无手机号而资产已绑定时只写客户手机号；资产已绑定其他号码时返回 1192“该资产已绑定手机号，如需更换请联系管理员”，响应不含号码。",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: true,
|
||
Input: &dto.BindPhoneRequest{},
|
||
Output: &dto.BindPhoneResponse{},
|
||
})
|
||
|
||
Register(authProtectedGroup, doc, basePath+authBasePath, "POST", "/change-phone", handlers.ClientAuth.ChangePhone, RouteSpec{
|
||
Summary: "更换手机号",
|
||
Description: "同时验证旧、新号码，只更换客户手机号，不迁移、复制或失效任何资产手机号关联。",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: true,
|
||
Input: &dto.ChangePhoneRequest{},
|
||
Output: &dto.ChangePhoneResponse{},
|
||
})
|
||
|
||
Register(authProtectedGroup, doc, basePath+authBasePath, "POST", "/logout", handlers.ClientAuth.Logout, RouteSpec{
|
||
Summary: "退出登录",
|
||
Tags: []string{"个人客户 - 认证"},
|
||
Auth: true,
|
||
Input: nil,
|
||
Output: &dto.LogoutResponse{},
|
||
})
|
||
|
||
// 需要认证的路由
|
||
authGroup := router.Group("")
|
||
authGroup.Use(personalAuthMiddleware.Authenticate())
|
||
if handlers.ClientNotification != nil {
|
||
registerPersonalNotificationRoutes(authGroup, handlers.ClientNotification, doc, basePath)
|
||
}
|
||
if handlers.ClientPopup != nil {
|
||
registerPersonalPopupRoutes(authGroup, handlers.ClientPopup, doc, basePath)
|
||
}
|
||
if handlers.ClientPackageSilence != nil {
|
||
registerPersonalPackageSilenceRoutes(authGroup, handlers.ClientPackageSilence, doc, basePath)
|
||
}
|
||
|
||
// 获取个人资料
|
||
Register(authGroup, doc, basePath, "GET", "/profile", handlers.PersonalCustomer.GetProfile, RouteSpec{
|
||
Summary: "获取个人资料",
|
||
Description: "获取当前登录客户的个人资料",
|
||
Tags: []string{"个人客户 - 账户"},
|
||
Auth: true,
|
||
Input: nil,
|
||
Output: &apphandler.PersonalCustomerDTO{},
|
||
})
|
||
|
||
// 更新个人资料
|
||
Register(authGroup, doc, basePath, "PUT", "/profile", handlers.PersonalCustomer.UpdateProfile, RouteSpec{
|
||
Summary: "更新个人资料",
|
||
Description: "更新当前登录客户的昵称和头像",
|
||
Tags: []string{"个人客户 - 账户"},
|
||
Auth: true,
|
||
Input: &apphandler.UpdateProfileRequest{},
|
||
Output: nil,
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/asset/info", handlers.ClientAsset.GetAssetInfo, RouteSpec{
|
||
Summary: "资产信息",
|
||
Description: "资产剩余 0～15 个上海自然日且当前客户当天首次进入时返回 expiry_reminder，并为该客户、该资产写一条套餐临期通知；同一客户、同一资产当天只返回一次。",
|
||
Tags: []string{"个人客户 - 资产"},
|
||
Auth: true,
|
||
Input: &dto.AssetInfoRequest{},
|
||
Output: &dto.AssetInfoResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/asset/packages", handlers.ClientAsset.GetAvailablePackages, RouteSpec{
|
||
Summary: "资产可购套餐列表",
|
||
Tags: []string{"个人客户 - 资产"},
|
||
Auth: true,
|
||
Input: &dto.AssetPackageListRequest{},
|
||
Output: &dto.AssetPackageListResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/asset/package-history", handlers.ClientAsset.GetPackageHistory, RouteSpec{
|
||
Summary: "资产套餐历史",
|
||
Description: "查询客户已绑定资产当前世代的套餐历史层级。每个主套餐及其关联加油包占一个分页名额，total 为筛选后的顶层项数量；status 与 package_type 必须由同一使用记录联合命中，命中任一成员即返回完整关系组。关联主套餐物理缺失返回异常独立项，存在但不可展示的关联主套餐返回统一读取错误。",
|
||
Tags: []string{"个人客户 - 资产"},
|
||
Auth: true,
|
||
Input: &dto.AssetPackageHistoryRequest{},
|
||
Output: &dto.AssetPackageHistoryResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/asset/refresh", handlers.ClientAsset.RefreshAsset, RouteSpec{
|
||
Summary: "资产刷新",
|
||
Tags: []string{"个人客户 - 资产"},
|
||
Auth: true,
|
||
Input: &dto.AssetRefreshRequest{},
|
||
Output: &dto.AssetRefreshResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/wallet/detail", handlers.ClientWallet.GetWalletDetail, RouteSpec{
|
||
Summary: "钱包详情",
|
||
Tags: []string{"个人客户 - 钱包"},
|
||
Auth: true,
|
||
Input: &dto.WalletDetailRequest{},
|
||
Output: &dto.WalletDetailResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/wallet/transactions", handlers.ClientWallet.GetWalletTransactions, RouteSpec{
|
||
Summary: "钱包流水列表",
|
||
Tags: []string{"个人客户 - 钱包"},
|
||
Auth: true,
|
||
Input: &dto.WalletTransactionListRequest{},
|
||
Output: &dto.WalletTransactionListResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/wallet/recharge-check", handlers.ClientWallet.GetRechargeCheck, RouteSpec{
|
||
Summary: "充值前校验",
|
||
Tags: []string{"个人客户 - 钱包"},
|
||
Auth: true,
|
||
Input: &dto.ClientRechargeCheckRequest{},
|
||
Output: &dto.ClientRechargeCheckResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/wallet/recharge", handlers.ClientWallet.CreateRecharge, RouteSpec{
|
||
Summary: "创建充值订单",
|
||
Tags: []string{"个人客户 - 钱包"},
|
||
Auth: true,
|
||
Input: &dto.ClientCreateRechargeRequest{},
|
||
Output: &dto.ClientRechargeResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/wallet/recharges", handlers.ClientWallet.GetRechargeList, RouteSpec{
|
||
Summary: "充值记录列表",
|
||
Tags: []string{"个人客户 - 钱包"},
|
||
Auth: true,
|
||
Input: &dto.ClientRechargeListRequest{},
|
||
Output: &dto.ClientRechargeListResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/recharge-orders", handlers.ClientRechargeOrder.ListRechargeOrders, RouteSpec{
|
||
Summary: "充值订单列表",
|
||
Tags: []string{"个人客户 - 充值订单"},
|
||
Auth: true,
|
||
Input: &dto.ClientRechargeOrderListRequest{},
|
||
Output: nil,
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/recharge-orders/:id", handlers.ClientRechargeOrder.GetRechargeOrderDetail, RouteSpec{
|
||
Summary: "充值订单详情",
|
||
Tags: []string{"个人客户 - 充值订单"},
|
||
Auth: true,
|
||
Input: &dto.IDReq{},
|
||
Output: nil,
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/orders/create", handlers.ClientOrder.CreateOrder, RouteSpec{
|
||
Summary: "创建订单",
|
||
Tags: []string{"个人客户 - 订单"},
|
||
Auth: true,
|
||
Input: &dto.ClientCreateOrderRequest{},
|
||
Output: &dto.ClientCreateOrderResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/orders", handlers.ClientOrder.ListOrders, RouteSpec{
|
||
Summary: "订单列表",
|
||
Tags: []string{"个人客户 - 订单"},
|
||
Auth: true,
|
||
Input: &dto.ClientOrderListRequest{},
|
||
Output: &dto.ClientOrderListResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/orders/:id", handlers.ClientOrder.GetOrderDetail, RouteSpec{
|
||
Summary: "订单详情",
|
||
Tags: []string{"个人客户 - 订单"},
|
||
Auth: true,
|
||
Input: &dto.IDReq{},
|
||
Output: &dto.ClientOrderDetailResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/orders/:id/pay", handlers.ClientOrder.PayOrder, RouteSpec{
|
||
Summary: "订单支付",
|
||
Tags: []string{"个人客户 - 订单"},
|
||
Auth: true,
|
||
Input: &dto.ClientPayOrderParams{},
|
||
Output: &dto.ClientPayOrderResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/exchange/pending", handlers.ClientExchange.GetPending, RouteSpec{
|
||
Summary: "查询待处理换货单",
|
||
Tags: []string{"个人客户 - 换货"},
|
||
Auth: true,
|
||
Input: &dto.ClientExchangePendingRequest{},
|
||
Output: &dto.ClientExchangePendingResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/exchange/:id/shipping-info", handlers.ClientExchange.SubmitShippingInfo, RouteSpec{
|
||
Summary: "提交收货信息",
|
||
Tags: []string{"个人客户 - 换货"},
|
||
Auth: true,
|
||
Input: &dto.ClientShippingInfoParams{},
|
||
Output: nil,
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/realname/link", handlers.ClientRealname.GetRealnameLink, RouteSpec{
|
||
Summary: "获取实名认证链接",
|
||
Tags: []string{"个人客户 - 实名"},
|
||
Auth: true,
|
||
Input: &dto.RealnimeLinkRequest{},
|
||
Output: &dto.RealnimeLinkResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "GET", "/device/cards", handlers.ClientDevice.GetDeviceCards, RouteSpec{
|
||
Summary: "获取设备卡列表",
|
||
Tags: []string{"个人客户 - 设备"},
|
||
Auth: true,
|
||
Input: &dto.DeviceCardListRequest{},
|
||
Output: &dto.DeviceCardListResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/device/reboot", handlers.ClientDevice.RebootDevice, RouteSpec{
|
||
Summary: "设备重启",
|
||
Tags: []string{"个人客户 - 设备"},
|
||
Auth: true,
|
||
Input: &dto.DeviceRebootRequest{},
|
||
Output: &dto.DeviceOperationResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/device/factory-reset", handlers.ClientDevice.FactoryResetDevice, RouteSpec{
|
||
Summary: "恢复出厂设置",
|
||
Tags: []string{"个人客户 - 设备"},
|
||
Auth: true,
|
||
Input: &dto.DeviceFactoryResetRequest{},
|
||
Output: &dto.DeviceOperationResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/device/wifi", handlers.ClientDevice.SetWiFi, RouteSpec{
|
||
Summary: "设备WiFi配置",
|
||
Tags: []string{"个人客户 - 设备"},
|
||
Auth: true,
|
||
Input: &dto.DeviceWifiRequest{},
|
||
Output: &dto.DeviceOperationResponse{},
|
||
})
|
||
|
||
Register(authGroup, doc, basePath, "POST", "/device/switch-card", handlers.ClientDevice.SwitchCard, RouteSpec{
|
||
Summary: "设备切卡",
|
||
Tags: []string{"个人客户 - 设备"},
|
||
Auth: true,
|
||
Input: &dto.DeviceSwitchCardRequest{},
|
||
Output: &dto.DeviceSwitchCardResponse{},
|
||
})
|
||
}
|