From 248ed55f4e66bfd3a52b6b75da72a9739b6f2909 Mon Sep 17 00:00:00 2001 From: huang Date: Thu, 30 Apr 2026 10:52:33 +0800 Subject: [PATCH] =?UTF-8?q?=E8=8E=B7=E5=8F=96=E5=BD=93=E5=89=8D=E7=94=9F?= =?UTF-8?q?=E6=95=88=E7=9A=84appid?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 1 + internal/handler/app/client_wechat.go | 18 ++++++++++++++++++ internal/model/dto/wechat_dto.go | 5 +++++ internal/routes/personal.go | 9 +++++++++ 4 files changed, 33 insertions(+) diff --git a/README.md b/README.md index 6360daa..8ae9b11 100644 --- a/README.md +++ b/README.md @@ -225,6 +225,7 @@ default: - **分佣验证指引**：对代理分佣的冻结、解冻、提现校验流程进行了结构化说明与流程图，详见 [分佣逻辑正确与否验证](docs/优化说明/分佣逻辑正确与否验证.md) - **对象存储**：S3 兼容的对象存储服务集成（联通云 OSS），支持预签名 URL 上传、文件下载、临时文件处理；用于 ICCID 批量导入、数据导出等场景；详见 [使用指南](docs/object-storage/使用指南.md) 和 [前端接入指南](docs/object-storage/前端接入指南.md) - **微信集成**：完整的微信公众号 OAuth 认证和微信支付功能（JSAPI + H5），使用 PowerWeChat v3 SDK；支持个人客户微信授权登录、账号绑定、微信内支付和浏览器 H5 支付；支付回调自动验证签名和幂等性处理；详见 [使用指南](docs/wechat-integration/使用指南.md) 和 [API 文档](docs/wechat-integration/API文档.md) +- **C 端微信 AppID 获取接口**：新增免登录接口 `GET /api/c/v1/wechat/appid`，仅返回当前生效微信配置中的公众号 `app_id`，供前端在拉起微信授权或初始化微信能力前动态获取；详见 [功能总结](docs/client-wechat-appid/功能总结.md) - **订单超时自动取消**：待支付订单（微信/支付宝）30 分钟超时自动取消，支持钱包余额解冻；使用 Asynq Scheduler 每分钟扫描，取代原有 time.Ticker 实现；同时将告警检查和数据清理迁移至 Asynq Scheduler 统一调度；详见 [功能总结](docs/order-expiration/功能总结.md) ### 导出任务接口示例 diff --git a/internal/handler/app/client_wechat.go b/internal/handler/app/client_wechat.go index 8cab416..fcba7d4 100644 --- a/internal/handler/app/client_wechat.go +++ b/internal/handler/app/client_wechat.go @@ -1,6 +1,8 @@ package app import ( + "strings" + "github.com/ArtisanCloud/PowerWeChat/v3/src/kernel" "github.com/break/junhong_cmp_fiber/internal/model/dto" wechatConfigSvc "github.com/break/junhong_cmp_fiber/internal/service/wechat_config" @@ -76,3 +78,19 @@ func (h *ClientWechatHandler) GetJSSDKConfig(c *fiber.Ctx) error { Signature: jssdkConfig.Signature, }) } + +// GetAppID 获取当前生效的公众号 AppID +// GET /api/c/v1/wechat/appid +func (h *ClientWechatHandler) GetAppID(c *fiber.Ctx) error { + wechatConfig, err := h.wechatConfigService.GetActiveConfig(c.UserContext()) + if err != nil { + return err + } + if wechatConfig == nil || strings.TrimSpace(wechatConfig.OaAppID) == "" { + return errors.New(errors.CodeWechatConfigUnavailable) + } + + return response.Success(c, &dto.WechatAppIDResponse{ + AppID: wechatConfig.OaAppID, + }) +} diff --git a/internal/model/dto/wechat_dto.go b/internal/model/dto/wechat_dto.go index 9439595..9462c3d 100644 --- a/internal/model/dto/wechat_dto.go +++ b/internal/model/dto/wechat_dto.go @@ -68,3 +68,8 @@ type JSSDKConfigResponse struct { NonceStr string `json:"nonce_str" description:"随机字符串"` Signature string `json:"signature" description:"签名（SHA1）"` } + +// WechatAppIDResponse 微信 AppID 响应 +type WechatAppIDResponse struct { + AppID string `json:"app_id" description:"当前生效的公众号 AppID"` +} diff --git a/internal/routes/personal.go b/internal/routes/personal.go index 26b2419..cede97b 100644 --- a/internal/routes/personal.go +++ b/internal/routes/personal.go @@ -22,6 +22,15 @@ func RegisterPersonalCustomerRoutes(router fiber.Router, doc *openapi.Generator, authBasePath := "/auth" // === 公开路由（无需认证）=== + 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",